cyclopts

Intuitive, easy CLIs based on type hints.

cyclopts Permissive license Apache-2.0 Active ★ 1,228 v4.22.5 released 2026-08-04

Install

cyclopts on PyPI

pip

pip install cyclopts

uv

uv add cyclopts

poetry

poetry add cyclopts

Package facts

License	Apache-2.0 (permissive)
Python support	supports the current Python release (>=3.10)
Install friction	low — pure-Python wheel
Runtime dependencies	6 — attrs, docstring-parser, rich-rst, rich, tomli, typing-extensions
Maintenance	actively maintained — 9 days since the last release
Last repo commit	2026-08-13
First released	2023-11-03
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: cyclopts-4.22.5-py3-none-any.whl

License :: OSI Approved :: Apache Software LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14

About cyclopts

from the package's own PyPI description — quoted content, verbatim

Python compat (image)=python-3.10-blue.svg"> PyPI (image) ReadTheDocs (image) codecov (image)

</div>

Documentation: https://cyclopts.readthedocs.io

Source Code: https://github.com/BrianPugh/cyclopts

Cyclopts is a modern, easy-to-use command-line interface (CLI) framework that aims to provide an intuitive & efficient developer experience.

Why Cyclopts?

Intuitive API: Quickly write CLI applications using a terse, intuitive syntax.
Advanced Type Hinting: Full support of all builtin types and even user-specified (yes, including Pydantic, Dataclasses, and...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Cyclopts is a CLI framework that converts Python functions into command-line interfaces using type hints and docstrings, with support for complex types, validation, and automatic help generation.

Low friction: pure Python wheel with six stable runtime dependencies (attrs, docstring-parser, rich-rst, rich, tomli, typing-extensions). Active maintenance with a release 9 days ago and 1228 GitHub stars.

Apache-2.0 permissive license allows commercial and private use with minimal restrictions; attribution required but no copyleft obligations.

Usage

pip install cyclopts

from cyclopts import run

def greet(name: str, count: int = 1):
    for _ in range(count):
        print(f"Hello {name}")

run(greet)

Requires Python >=3.10

Verdict: Cyclopts is a well-maintained, actively developed CLI framework with zero known vulnerabilities, low install friction, and permissive licensing. It offers a modern alternative to argparse and Click with superior type-hint integration and docstring parsing, making it suitable for building production CLI applications.

Needs verification

Whether the package's actual test coverage and code quality match the codecov badge shown in the description
Performance characteristics compared to other CLI frameworks for large-scale applications

CLI framework python type hintscommand line interface generatorpython argparse alternativetype-driven CLI builderdocstring-based CLIpydantic dataclass CLImodern python CLI framework