Get started

Your first Astropods project

Create and run your first agent locally
View as Markdown

Go from zero to a running agent in three steps. Have the CLI installed and Docker ready. You can also try a pre-built agent.

1

Create an agent

Scaffold a new project: Use —yes to skip prompts and use defaults (HTTP interface, Anthropic model, no knowledge or tools).

2

Run locally

Start a local dev environment with hot-reload: Edit code and the agent restarts automatically. Run ast configure to set API keys as needed (e.g. ANTHROPIC_API_KEY).

3

Next step

When you’re ready to publish your agent to the Astropods registry, see Publish to registry. Pushing requires an account and ast login.

Try a pre-built agent

We have built and shared several agents in the astropods/agents open-source repo. You can try any of them with ast dev. Here’s an example:

GitHub Issue Analyzer — Ingests GitHub issues from a repo into a Neo4j knowledge graph, enriches them with OpenAI analysis (categories, solutions, workarounds), and answers questions via Cypher queries and comment summarization. Requires GITHUB_TOKEN and OPENAI_API_KEY.

$git clone git@github.com:astropods/agents.git
$cd agents/github-issue-analyzer
$ast configure   # set required API keys
$ast dev

More commands

Run ast --help to see all available commands.