Skip to main content
agno create clones the Docker starter into a new directory, strips its git history, and creates a private .env from example.env:
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:
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:

​
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