Quick start
This quick start walks you through creating and deploying your first agent:
- Install the Astropods CLI
- Describe your agent and build it with a coding agent like Claude Code
- Publish it to the Astropods registry as a blueprint
- Deploy it as a hosted agent you can chat with in your browser
The starter agent calls models through the AI Gateway, so you don’t need a model provider key.
Before you start
To complete this quick start, you’ll need the following:
- An Astropods account. You use it to log in and to sign in to your deployed agent.
- Docker, installed and running. The CLI uses it to build your agent’s image.
- A coding agent, such as Claude Code, Cursor, or GitHub Copilot. It turns your description into a working agent.
Install the CLI
macOS / Linux
Windows (PowerShell)
Open a new terminal and confirm the install:
For manual installs, Windows with WSL, and upgrades, see Install the CLI.
Create your agent
The CLI creates a my-agent directory with starter source code and an astropods.yml configuration file for your agent. When prompted, enter a description of what you want your agent to do. The CLI prints a new prompt based on your description.
Open the my-agent directory in your editor or terminal, start your coding agent, and paste the new prompt into it. The coding agent reviews the project, asks clarifying questions, and writes the project’s source code.
Publish it
When the coding agent has finished, run the following command to publish your agent:
The command builds your agent’s container image and pushes it to the registry as a private blueprint. The first build takes a few minutes. When it finishes, the CLI prints Pushed successfully! and a link to the blueprint page.
Chat with your agent
- Go to astropods.com and sign in.
- On the Blueprints page that opens, click the dropdown list next to Blueprints and select Agents.
- On the Agents page under my-agent, click Launch. If the Launch button is dimmed, wait a minute or two for the deployment to finish, then click Launch.
- Send your agent a message like “What are you?” to confirm it responds.
Watch the walkthrough
Next steps
- Run your agent locally: chat with your agent and iterate on it before you publish
- How Astropods works: see how projects, blueprints, and agents fit together
- Managing your agents: update, pause, and delete a running agent
- Monitor your agents: see traces and token usage