Suggestions appear as you type. Use the up and down arrows to choose one and Enter to open it.

Cyclopts

Free#21 of 60 in Command-Line Interface Frameworks

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.

7.2/10Editor score
Cyclopts7.2 Visit Cyclopts

At a glance

  • Editor score
    7.2 / 10
  • Pricing
    Free plan
  • Best for
    Modern Python typed CLI applications
  • Free plan
    Yes
  • Paid from
    Free
  • Shell completion
    Yes
  • Facts checked
    17 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

Plans Free planFree Free to use — no paid tier required for the core job.
See plans on github.com

Cyclopts fact sheet

Free planYes
Paid fromFree
Shell completionYes
Nested subcommandsYes
Code generationNot verified
Config file supportYes
Environment variablesYes
Typed APIYes
DeploymentSelf-hosted
SupportDocs, Community
Built forSolo, Small business, Mid-market, Enterprise (editorial estimate)
PricingFree plan
Websitegithub.com
Facts checked17 Nov 2026

Alternatives to Cyclopts

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

Reviews come only from verified accounts. Sign in or create an account first — your e-mail is never shown.

Your rating

0 characters · at least 80, up to 3,000

Posted from your verified account. Reviews appear after an editor reads them, usually within two working days.

Featured on iTechGuides

Featured on iTechGuides — Cyclopts 7.2/10

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