This is a quick tutorial to let you see the power of the Alpha Drive developer platform through the CLI.

This article focuses on our Streaming Simulation offering. If you are interested in our Cloud Based Simulation, click here to schedule a demo, request early access and to get on the waitlist for public release.

We'll get a CARLA instance up and running in the cloud and streaming to local docker based agents.

We'll take you for a spin around the CLI tools first for launching different configurations in the cloud. We'll link to areas for exploration along the way and then link to some deeper details at the very end.


Now you can install the alphadrive CLI from NPM. Fire up your command prompt/terminal and run:


sudo npm install -g @alphadrive/cli


npm install -g @alphadrive/cli

Mac Additional Steps:

The sample agents with streaming visualizations require a local X11 server. You can use to install the X11 server on mac.

brew cask install xquartz

After install, please execute these command in the terminal and launch/restart XQuartz from your /Applications folder:

defaults write org.macosforge.xquartz.X11 nolisten_tcp -int 0

Running the alpha command:

Now you will have an "alpha" command on your path and your environment configured, you can authenticate with the service and connect to your account:

alpha login

This will open a browser window where you can login and complete the authorization.

Download the demo:

alpha init demo

cd demo


You'll see some example agent scripts for CARLA simulation as well as a alphadrive.yml configuration script 

Our streaming execution command is as follows:

alpha drive <profile>

Profiles are defined in the alphadrive.yml file. (learn more about profile configuration here)

Test Drive:

Now, let's and take the CARLA simulator out for a (manual) test drive:

alpha drive manual

Now let's see a different view configuration for the CARLA simulation and launch the mapview profile:

alpha drive mapview

Now let's test an agent without the visual feedback - an agent configured for headless mode. 

alpha drive headless

(learn more about configuring for visual mode here and learn more about configuring for headless mode here)

While the agent was running, all of the output was configured to be stored in the _out folder under the session id. (learn more about configuring streaming logging here)

Take a look. 

ls _out/<session_id>

Going Beyond the Demo:

Those are the basics of how to use the Alpha Drive developer platform cloud tools.
In this example, all of the agents were running locally via a docker environment. 

Alpha Drive has support for native agents interacting with our streaming simulation service. 

We'll be writing more articles on how to get up and running from scratch, how to create your own templates and other details about agent development soon. In the mean time take a look at the files to learn more.  (and of course learn more about the CARLA simulator here)

Did this answer your question?