> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-codex-docs-audit-20260719-0149.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Project

> Scaffold an AgentOS project from one of nine deployment templates or a custom repository.

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

`agno create` clones the Docker starter into a new directory, strips its git history, and creates a private `.env` from `example.env`:

```bash theme={null}
cd my-os
agno up
```

Run `agno create` without a name in an interactive terminal to choose a template and project name. The defaults are `agentos-docker` and `agentos`.

## 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-azure`            | Azure                         | [agno-agi/agentos-azure](https://github.com/agno-agi/agentos-azure)     |
| `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-helm`             | Kubernetes with Helm          | [agno-agi/agentos-helm](https://github.com/agno-agi/agentos-helm)       |
| `agentos-modal`            | Modal                         | [agno-agi/agentos-modal](https://github.com/agno-agi/agentos-modal)     |
| `agentos-railway`          | Railway                       | [agno-agi/agentos-railway](https://github.com/agno-agi/agentos-railway) |
| `agentos-render`           | Render                        | [agno-agi/agentos-render](https://github.com/agno-agi/agentos-render)   |

Every registered starter includes an AgentOS application and `example.env`. `agno create` copies that file to `.env` with mode `0600` on platforms that support POSIX permissions. It preserves an existing tracked `.env` in a custom template.

## 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.
4. Copies `example.env` to `.env` when the template provides it.

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](/cli/operate)           |
| Connect coding agents | [agno connect](/cli/connect)      |
| Deploy to production  | [Templates](/deploy/introduction) |