Skip to main content
The Atoms CLI is built for rapid iteration. Test your agent locally with a single command, then deploy to the cloud when ready. No configuration files, no Docker, no infrastructure management.
Local-first development: Run and test your agent entirely on your machine. Deploy only when you’re satisfied.

​
Installation

The CLI comes bundled with the SDK: 
pip install smallestai
Verify the installation: 
smallestai --help

​
Local Development Workflow

The CLI’s best feature is instant local testing. No need to deploy to test changes.
1

Start Your Agent Server

Run your agent file to start a local WebSocket server:
python your_agent.py
This spins up a server on localhost:8080 that mimics the production environment.
2

Connect via CLI

In another terminal, start an interactive voice session:
smallestai agent chat
The CLI connects to your local server and lets you converse with your agent in real-time.CLI Chat
3

Iterate Rapidly

Make code changes, restart the server, and reconnect with chat. No redeploys needed.

​
Cloud Deployment

When you’re ready for production, deploy to Smallest AI’s managed infrastructure.
Prerequisite: You must first create an agent on the Atoms platform before deploying. The CLI links your local code to an existing platform agent.
1

Authenticate

smallestai auth login
Opens a browser for OAuth. Your credentials are stored locally.
2

Link to Platform Agent

smallestai agent init
Select which agent from atoms.smallest.ai to link your local code to.
3

Deploy

smallestai agent deploy --entry-point your_agent.py
Packages your code and pushes it to the cloud. Takes about 30 seconds.
4

Go Live

smallestai agent builds
Select your build and choose Make Live to start serving traffic.

​
Command Reference

​
Authentication

CommandDescription
smallestai auth loginAuthenticate with your Smallest AI account
smallestai auth logoutClear stored credentials

​
Agent Management

CommandDescription
smallestai agent initLink local directory to a platform agent
smallestai agent deployDeploy code to the cloud
smallestai agent buildsView and manage deployments
smallestai agent chatStart interactive session with local agent

​
Common Options

OptionDescription
--entry-point <file>Specify the main Python file (default: server.py)
--helpShow help for any command

​
Build Management

Deployments are not live by default. This gives you a safety buffer.
One Live Build Per Agent: Making a new build live automatically takes down the previous one.
To promote a build:
  1. Run smallestai agent builds
  2. Select the desired build
  3. Choose Make Live
To roll back:
  1. Run smallestai agent builds
  2. Select the previous build
  3. Choose Make Live
To take down completely:
  1. Run smallestai agent builds
  2. Select the LIVE build
  3. Choose Take Down