Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.motus.lithosai.com/llms.txt

Use this file to discover all available pages before exploring further.

Package and deploy your agent to Motus Cloud. motus deploy opens an authentication dialog similar to motus login when the user is unauthenticated.

​
Usage

motus deploy [import-path] [options]

​
Options

FlagDefaultDescription
import-pathRead from motus.tomlPython import path to your agent in module:variable format (e.g., myapp:agent)
--name—Project name. Creates a new project if none exists with this name. Mutually exclusive with --project-id.
--project-idRead from motus.tomlID of an existing project to deploy to. Mutually exclusive with --name.
--git-url—Git repository URL. When provided, the build service clones the repo instead of uploading local files.
--git-ref—Branch, tag, or commit SHA to check out. Requires --git-url.
--secret—KEY=VALUE secret injected into the agent container. Use KEY alone to read the value from your local environment. Repeatable.
On your first deploy, you must provide either --name or --project-id. After a successful deploy, Motus writes project_id, build_id, and import_path to motus.toml in your project directory, so subsequent deploys can run without any flags.

​
How it works

When you run motus deploy, it:
  1. Validates your import path by importing it locally.
  2. Resolves or creates the project using --project-id or --name.
  3. Packs your project files into a .tar.zst archive (skipping dotfiles, __pycache__, .pyc, virtualenvs, and .gitignore-excluded paths) and uploads them — or, for Git deploys, instructs the build service to clone the repository directly.
  4. Streams build status via SSE: queued → building → built → deploying → deployed → healthy.

​
Examples

​
First deploy

motus deploy --name my-project myapp:agent

​
Subsequent deploy

# Reads project ID and import path from motus.toml
motus deploy

​
Deploy with secrets

motus deploy --secret OPENAI_API_KEY=sk-123 --secret DATABASE_URL

​
Deploy from a Git repository

motus deploy --name my-project \
  --git-url https://github.com/org/repo.git \
  --git-ref main \
  myapp:agent