Working with Projects

Projects are how you organize and share work in alwaysAI.

Creating a New Project

To create a new Project, log into alwaysAI and go to your Dashboard. In the Projects view select the red plus (+).

You have the option to create a Project that includes one of our starter applications or to create an empty project and add assets later.

To configure the Project you’ve just created on your Development Computer simply create an empty directory:

$ mkdir app && cd app

and run the CLI command:

$ aai app configure

From here you’ll be prompted to select the project you’re going to use and the target you’d like to install it on.

You can follow the same process to configure an older alwaysAI application directory as a working Project. This is useful if, for example, you have already downloaded the alwaysAI starter applications from the CLI. Just run the aai app configure command from within any chosen directory, pick a name, and it will be ready to go.

Running Your Application

Install the Application

You can run your application locally on your computer, or remotely on an edge device.

For detailed instructions see our guide on starter applications.

To get started quickly on your LOCAL COMPUTER, run the following command:

Note: This assumes you have selected “Your local computer” when running the aai app configure command above.

$ aai app install

This command prompts you for your alwaysAI account credentials and then installs the application’s models and a Python virtual environment (venv) into the application directory.

Start the Application

Now start your application with the command:

$ aai app start

The log output from is forwarded through the CLI to your terminal, including the labels that the model has been trained to recognize.

Once the app starts, a log will be printed with the link:

[INFO] Streamer started at http://localhost:5000

Open this URL in a browser to see the video and text data generated by the app. To stop the application, simply hit CTRL-C or click the red “stop” button on the web page.

Add Models to a Project on the Web

From the web, you can add a model to your project from the alwaysAI Model Catalog or using your own private models in your Dashboard.

Public Models

On the web, simply go to the Model Catalog. and select a model. Within the model details will be a card with instructions on using the model; select your project from the drop down at the bottom of this card. That’s it!

Private Models

Any private models you’ve uploaded to your account (or your collaborating on in another users project) will be listed in your Dashboard under My Models.

You can add a private model to a Project by clicking through to the model’s detail page and selecting your project from the drop down (similar to adding a public model) or by clicking the red plus (+) to the right of the model section on your project’s detail page, then selecting the model you’d like to add to your project from the drop down.

See here for additional detail on adding a model to your project.

Add Collaborators to a Project

Only the people specifically added to a project, Collaborators, can use it. This ensures only you determine who can use your private models and devices that run the application.

To add Collaborators to a Project you own, find the Collaborators card on the project detail page and select the red “+” button. You’ll need to know the email address of the Collaborator you invite; if they do not have an alwaysAI account already we’ll send them an email to sign up and add them to your project automatically.

Add Devices to a Project

You can add a device to your project by opening a command prompt, changing to your project directory:

$ cd app

and then executing the command:

$ aai app configure