Your first Astro AI project | Astro AI

Go from zero to a running agent in four steps. Have the CLI installed and Docker ready.

1. Log in

Authenticate with your Astro AI account:

$ ast login

Complete the browser flow to link the CLI to your account.

2. Create an agent

Scaffold a new project:

$ ast create hello-astro

Use --yes to skip prompts and use defaults (HTTP interface, Anthropic model, no knowledge or tools).

3. Run locally

Start a local dev environment with hot-reload:

$ cd hello-astro && ast dev

Edit code and the agent restarts automatically. Add API keys to .env as needed (e.g. ANTHROPIC_API_KEY).

4. Push

Push your agent to the Astro AI registry:

$ ast push

Your agent is then available in your account. You can use ast push --build to build first, then push to your OCI registry and register with the Astro AI server.

More commands

Run ast --help to see all available commands.