---
id: agnoctl
version: "0.1.3"
license: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# agnoctl — The Agno CLI: connect and operate AgentOS from the terminal, built for humans and coding agents

License: permissive · Maintenance: active · Downloads: 482.9K/mo

## What it is and what it does

agnoctl is a CLI tool for initializing and deploying AgentOS projects to multiple cloud and container platforms. It provides an interactive setup flow that clones one of nine maintained starter templates (Docker, AWS, Azure, Fly, GCP, Helm, Modal, Railway, Render), copies environment configuration, and prepares the project for deployment. The tool is designed to work both interactively for humans and non-interactively for automation workflows, accepting explicit project names and template choices via command-line flags.

The package depends on httpx for HTTP requests, rich for terminal formatting, typer for CLI argument handling, and tomli for configuration parsing. It targets Python 3.9 and later, is marked as production-stable, and has no known security vulnerabilities. The repository shows active development with recent commits and significant community interest.

Use it for:

- Quickly scaffold a new AgentOS project with interactive prompts, choosing from nine deployment templates
- Automate AgentOS project creation in CI/CD pipelines by passing template and project name as arguments
- Set up local development environments with pre-configured Docker or cloud-specific starter code
- Provision agent infrastructure on multiple platforms (AWS, Azure, GCP, Railway, Render, etc.) from a single CLI
- Generate JSON output of project creation results for downstream tooling or logging

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

agnoctl is a command-line interface for creating and managing AgentOS projects, with built-in support for nine deployment platforms including Docker, AWS, Azure, Fly, GCP, Helm, Modal, Railway, and Render.

Yes. agnoctl is actively maintained, has low install friction, carries a permissive Apache 2.0 license, and solves a clear problem—scaffolding AgentOS projects across multiple deployment targets. It's suitable for developers building agents who want to avoid manual template setup. No known vulnerabilities. Install if you're working with AgentOS.

## Install

pip install agnoctl
uv add agnoctl
poetry add agnoctl

## Installing agnoctl

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with a recent release (28 days old) and substantial repository activity (41713 stars). Supports Python 3.9 through 3.13.

License in practice: Apache License 2.0 (permissive) allows free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects provided you retain license notices.

Quickstart:

pip install agnoctl

from agnoctl import create

# Or use the CLI directly:
# agno create my-agentos --template agentos-railway --json

Verify before relying:

- Whether agnoctl can be imported and used programmatically or is CLI-only
- Whether the nine starter templates are actively maintained and up-to-date
- Performance characteristics when cloning templates or provisioning infrastructure

## Package facts

- License: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 482.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

agentos cli, agent deployment tool, create agentos project, agno command line, multi-cloud agent deployment, agent infrastructure cli, agentos project scaffolding, cli-tool, agent-framework, infrastructure-as-code

[View on SkillFed](https://skillfed.io/packages/agnoctl) · [View on PyPI](https://pypi.org/project/agnoctl/)