A (Very) Quick Start

To begin, make sure civis is installed and your API key is in your R environment. You can quickly test that civis is working by invoking

name <- civis::users_list_me()$name
paste(name, "is really awesome!")

If civis is working, you’ll see a friendly message. Otherwise, you might see an error like this when civis wasn’t installed properly:

Error in loadNamespace(name) : there is no package called 'civis'

or like this if you haven’t set your API key correctly:

Error in api_key() : The environmental variable CIVIS_API_KEY is not set. Add this to your .Renviron or call Sys.setenv(CIVIS_API_KEY = '<api_key>')

With civis, moving data to and from the cloud takes only a few lines of code. Your data can be stored as rows in a table, CSVs on remote file system or even as serialized R objects like nested lists. For example,

civis also includes functionality for working with CivisML, Civis’ machine learning ecosystem. With the combined power of CivisML and civis, you can build models in the cloud where the models can use as much memory as they need and there’s no chance of your laptop crashing.

For a comprehensive list of functions in civis, see Reference in the full documentation. The full documentation also includes a set of Articles for detailed documentation on common workflows, including data manipulation and building models in parallel.