Cyclopts
Type-hint based CLI framework for creating intuitive command-line interfaces.
Dev workflow and config PyPI Apache-2.0
How Cyclopts is used
Cyclopts is a dependency in 9 of the 6,208 public GitHub projects set up for AI coding agents that we scanned, too few to describe it from them alone. Our scan also samples projects by dependency (Solana 2,661, Ethereum and EVM 1,496, 3D and games 2,818, agent frameworks and SDKs 10,983); counting those, it appears in 64 projects, and what it is used with below comes from all of them. The most used alternative in our scan is Click (155 projects). Projects that use it most often also use Pydantic (96.9%), Click (96.9%), Model Context Protocol SDK (Python) (95.3%).
Cyclopts popularity over time
Gid Score 55: downloads 90, use in agent projects 44, GitHub stars 16, downloads trend 57 (each 0-100). How it is calculated.
Often used with Cyclopts
| Pydantic | 96.9% of Cyclopts projects · 11.2× more than average |
|---|---|
| Click | 96.9% of Cyclopts projects · 38.8× more than average |
| Model Context Protocol SDK (Python) | 95.3% of Cyclopts projects · 11.9× more than average |
| Pydantic Settings | 95.3% of Cyclopts projects · 27.3× more than average |
| AnyIO | 95.3% of Cyclopts projects · 64.3× more than average |
| attrs | 95.3% of Cyclopts projects · 137.6× more than average |
| CFFI | 95.3% of Cyclopts projects · 147.9× more than average |
| cryptography | 95.3% of Cyclopts projects · 40.5× more than average |
From all 64 projects in our scan that use Cyclopts, including the dependency samples.
By coding agent
| GitHub Copilot | 0.2% of projects set up for it |
|---|---|
| Claude Code | 0.2% of projects set up for it |
Share of public repos configured for each agent that list Cyclopts as a dependency.
How Cyclopts is funded
GitHub Sponsors
| @BrianPugh | 3 current sponsors |
|---|
GitHub shows how many people and companies sponsor an account, not how much they pay. Sponsors of a person back all of their work.
Ways to fund Cyclopts
As the maintainers list them in FUNDING.yml on GitHub. Checked Oct 20, 2026.
Install
| Package | pip install cyclopts |
|---|---|
| Main stacks | Python (63), Next.js (1) |
| Example projects | prakharsr/audiobook-creator, digitranslab/allama, twjackysu/TWSEMCPServer, owenliang/openclaw, schwartz1375/genai-essentials |
Alternatives to Cyclopts
Tools that do the same job, so a project picks one or the other. Add-ons and libraries used alongside Cyclopts are not listed here; they are in "Often used with".
| Tool | Gid Score | Used in agent projects | Downloads / wk | GitHub stars | License |
|---|---|---|---|---|---|
| Click pypi Python package for composing command-line interfaces with decorators. |
81 | 155 (9.6%) | 227M | 17.8K | BSD-3-Clause |
| Typer pypi Framework for building CLI applications using Python type hints. |
79 | 125 (7.7%) | 66M | 20.1K | MIT |
More in Dev workflow and config: dotenv Husky python-dotenv lint-staged concurrently Rich Pydantic Settings cross-env