Create a Project

agno create my-os

agno create clones a starter template into a new directory, strips its git history, and seeds .env from the template's example.env when it ships one.

Add your secrets to my-os/.env, then:

cd my-os
agno up       # start it with docker compose
agno connect  # make it available in your coding agents

Interactive Mode

Run agno create with no arguments and the CLI walks you through both choices:

agno create

In capable terminals, select a starter with the arrow keys or a numeric shortcut, then press Enter; the default is agentos-docker. The plain-terminal fallback accepts a number or template name. It then asks for a project name (default agentos) and re-prompts until the name is valid and the directory is free.

Passing --template or --url skips the template question. An unknown --template fails before the first prompt appears.

With --json, or in any run where stdin is not a TTY, nothing prompts and the name argument is required.

Starter Templates

Pick a starter with --template:

agno create my-os --template agentos-aws

Every starter ships an AgentOS application, an example.env, and a compose file that agno up picks up. See Templates for the full catalog, including pre-built agent systems.

Custom Templates

Scaffold from any git repository, such as your team's internal starter:

agno create my-os --url https://github.com/acme/agentos-internal

How It Works

1. Validates the name. It becomes a directory under the current directory, so it must be a single path segment of letters, digits, -, and _.
2. Runs git clone --depth 1 on the template repository (git must be installed).
3. Removes the cloned .git directory, giving you a clean tree to init your own repo in.
4. Copies example.env to .env with owner-only permissions when the template ships one. An existing .env is never overwritten. If seeding fails, the cloned directory is removed so a retry starts clean.

The command fails if the target directory already exists. The CLI doesn't keep a registry of projects; up, down, and restart operate on whatever directory you run them from.

Next Steps