Cyclopts
Cyclopts: Typed, open-source Python framework for configurable command-line applications. Ranked #21 of 60 in Command-Line Interface Frameworks by our editors (7.2/10); pricing: Free plan; best for modern Python typed CLI applications.
At a glance
- Editor score7.2 / 10
- PricingFree plan
- Best forModern Python typed CLI applications
- Free planYes
- Paid fromFree
- Shell completionYes
- Facts checked17 Nov 2026
Where it wins
- Type hints drive parsing, conversion, validation, and custom converters
- Nested App instances support recursive subcommands and generated help
- Shell completion, TOML/YAML files, and environment-variable binding are built in
Where it doesn't
- Self-hosted deployment means no hosted service option
- Requires Python 3.11 or newer
- Support centers on documentation and community channels
Our verdict on Cyclopts
Cyclopts is an open-source Python command-line interface framework for developers building command-line tools and applications. It creates interfaces from Python functions, type annotations, and docstrings, covering argument parsing, conversion, validation, generated help, configuration loading, environment-variable defaults, and shell completion. Its self-hosted package model fits solo developers through enterprise teams that want to own runtime and deployment choices.
Type hints are Cyclopts' defining mechanism. The framework can convert annotated parameters, apply validation and custom converters, and generate help from docstrings and contextual data. App instances enable recursive nested subcommands, while completion support targets bash, zsh, fish, and PowerShell. Configuration features extend beyond command-line flags with TOML and YAML file support plus environment-variable parameter binding. Support for Pydantic, dataclasses, and attrs types can align CLI definitions with existing Python data models, making Cyclopts a fit for typed codebases that want one source of parameter structure.
Cyclopts is distributed as an open-source Python package rather than a hosted service, so teams handle installation, deployment, and operational choices themselves. The published documentation states Python 3.11 or newer, and support is centered on documentation and community channels. Choose Cyclopts when a Python project needs typed commands, nested application structure, shell completion, and configuration sources in a single framework. Teams seeking a managed CLI platform, a hosted control plane, or vendor-led support should consider a different category of tool.
Your product? Our editors can test Cyclopts in depth and publish a review, labelled as paid · from $149/mo →
Cyclopts pricing
Cyclopts fact sheet
| Free plan | Yes |
|---|---|
| Paid from | Free |
| Shell completion | Yes |
| Nested subcommands | Yes |
| Code generation | Not verified |
| Config file support | Yes |
| Environment variables | Yes |
| Typed API | Yes |
| Deployment | Self-hosted |
| Support | Docs, Community |
| Built for | Solo, Small business, Mid-market, Enterprise (editorial estimate) |
| Pricing | Free plan |
| Website | github.com |
| Facts checked | 17 Nov 2026 |
Alternatives to Cyclopts
- ClapA free Rust crate with typed parsing, nested commands, validation, and completions.9.4
- ClickA free, open-source toolkit for typed, nested Python command-line applications.9.3
- TyperFree, open-source typed CLI framework with nesting, completions, and configuration support.9.2
See all Cyclopts alternatives →
Used Cyclopts? Be the first to review it
The editor score above is our own research. What this page doesn't have yet is a reader's view — what you used Cyclopts for, what worked and what didn't. No stars are seeded and no review is paid for; an editor reads every one before it appears.
Write a reviewTwo minutes · verified accounts only · read by an editor before it appears
Featured on iTechGuides
Cyclopts is listed in our Command-Line Interface Frameworks directory. Add the badge to your site — it links back to this page.
<a href="https://www.itechguides.com/products/cyclopts/"><img src="https://www.itechguides.com/best/badge/cyclopts.svg" alt="Featured on iTechGuides" width="230" height="46"></a>
Reviewed by iTechGuides Editors · Editorial team · Updated Nov 2026
Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.
Last updated · How we research and update