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

What you can do

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

Managing secrets

Store API keys in the account vault and reference them at deploy time

Authentication

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.

Next steps

Install the CLI

Install the CLI for your platform.

Run an agent locally

Your first project: create an agent harness, configure it, and run it locally.

Publish a blueprint

Your first blueprint: push your project to the registry.

Deploy a live agent

Deploy your first agent: run a blueprint as a hosted agent.