Get started

Welcome to Astro AI

Astro AI is a platform for deploying and running AI agents. It provides agent-native infrastructure including models, knowledge bases, tool integrations, and observability. Agents are defined with a declarative spec, built and pushed with the CLI, and deployed through the API or dashboard.

Quickstart

Start here

The agent lifecycle

How a project becomes a running agent, and which page covers each stage

Install the CLI

Download and install the ast CLI for your platform

Your first project

Create an agent, configure it, and run it locally in three steps

Your first blueprint

Build and push your agent to the registry with ast blueprint push

Deploy your first agent

Run a blueprint as a live hosted agent with ast blueprint deploy

Explore

AI Gateway

Call managed models through an OpenAI-compatible API, with no provider key

Guides

Task walkthroughs: frontends, storage, MCP servers, authorization

Messaging SDK

Connect your agent to Slack, web chat, and other platforms over gRPC

CLI

Every ast command, grouped by what it operates on

API reference

The REST API behind the CLI and the dashboard

Knowledge stores

Connect a database once and share it across your agents

Monitor your agents

Trace token usage, tool calls, and latency from any framework

Concepts

Project: A local agent codebase with an astropods.yml spec. Use ast project create to create an agent harness, ast project configure to set credentials, and ast project start to run it locally.
Astropods Spec: Declarative YAML format (astropods.yml) that describes an agent’s topology: container image, models, knowledge stores, tools, and ingestion pipelines. See Astropods Spec.
Blueprint: A versioned snapshot of a project pushed to the Astropods registry. Created with ast blueprint push <name>. The same project can produce multiple blueprints under different names (e.g. staging vs. production).
Agent: A live, running instance of a blueprint deployed on the platform. Created with ast blueprint deploy <name>. Managed with ast agent commands.
Account: The scope for all platform resources. Blueprints, agents, and secrets belong to an account. Use ast account switch to work across personal and org accounts.
Secrets: Encrypted credentials stored in the account vault with ast secrets. Referenced at deploy time as KEY=@SECRET_NAME.
Agent Card: A Markdown file with YAML frontmatter (AGENT.md) that controls how a blueprint appears in the catalog: description, tags, authors, and integrations. See Make your agent discoverable.