BrianPugh/cyclopts

Health v2 · maintenance only

Adoption not part of the score

1244 stars · 54 forks observed · 2026-09-03

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Cyclopts is a modern Python CLI framework that builds command-line interfaces from function signatures and type hints. It supports advanced typing (Pydantic, dataclasses, attrs, Unions, Literals), automatic help generation from docstrings, and command registration via decorators.

Use cases

• build a CLI from python type hints
• create multi-command CLI apps with subcommands
• generate help pages automatically from docstrings
• parse complex types like unions and pydantic models from command-line arguments
• replace argparse or typer with a more intuitive CLI library
• add argument validation and converters to CLI tools

When to choose

• you want a terse, type-hint-driven CLI framework in Python 3.10+
• you need richer type support and docstring-based help than Typer provides
• you use Pydantic, dataclasses, or attrs models as CLI parameters

When to avoid

• you need to support Python versions older than 3.10
• you prefer minimal dependencies or the stdlib argparse
• you are building CLIs outside the Python ecosystem

Facets

library · maturity active

cli developer-tools developer-tools python cli cross-platform argument-parser type-hints cli-framework docstring-help pydantic-support command-line python

Member repositories

For agents

markdown · JSON · MCP: product_card(name="BrianPugh/cyclopts")