> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Project

> Scaffold an AgentOS project from a starter template: Docker by default, or AWS, Fly.io, GCP, and Railway.

```bash theme={null}
agno create my-os
```

`agno create` clones a starter template into a new directory, strips its git history, and prints the next steps:

```bash theme={null}
cd my-os
cp example.env .env   # then fill in your secrets
agno up               # start it with docker compose
agno connect          # make it available in your coding agents
```

## Starter Templates

Pick a starter with `--template`:

```bash theme={null}
agno create my-os --template agentos-aws
```

| Template                   | Target                        | Repository                                                              |
| -------------------------- | ----------------------------- | ----------------------------------------------------------------------- |
| `agentos-docker` (default) | Local dev and any Docker host | [agno-agi/agentos-docker](https://github.com/agno-agi/agentos-docker)   |
| `agentos-aws`              | AWS                           | [agno-agi/agentos-aws](https://github.com/agno-agi/agentos-aws)         |
| `agentos-fly`              | Fly.io                        | [agno-agi/agentos-fly](https://github.com/agno-agi/agentos-fly)         |
| `agentos-gcp`              | Google Cloud                  | [agno-agi/agentos-gcp](https://github.com/agno-agi/agentos-gcp)         |
| `agentos-railway`          | Railway                       | [agno-agi/agentos-railway](https://github.com/agno-agi/agentos-railway) |

Every starter ships an AgentOS application, an `example.env`, and a compose file that `agno up` picks up. See [Templates](/deploy/introduction) for the full catalog, including pre-built agent systems.

## Custom Templates

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

```bash theme={null}
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.

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

| Task                  | Guide                                 |
| --------------------- | ------------------------------------- |
| Start the project     | [agno up](/agent-os/cli/operate)      |
| Connect coding agents | [agno connect](/agent-os/cli/connect) |
| Deploy to production  | [Templates](/deploy/introduction)     |