--- id: cyclopts version: "4.22.5" license: Apache-2.0 license_treatment: permissive maintenance: active --- # cyclopts — Intuitive, easy CLIs based on type hints. License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI ## Install pip install cyclopts uv add cyclopts poetry add cyclopts ## Description
![Python compat](https://img.shields.io/badge/>=python-3.10-blue.svg) [![PyPI](https://img.shields.io/pypi/v/cyclopts.svg)](https://pypi.org/project/cyclopts/) [![ReadTheDocs](https://readthedocs.org/projects/cyclopts/badge/?version=latest)](https://cyclopts.readthedocs.io) [![codecov](https://codecov.io/gh/BrianPugh/cyclopts/graph/badge.svg?token=HA393WIYUK)](https://codecov.io/gh/BrianPugh/cyclopts)
--- **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](https://docs.pydantic.dev/latest/), [Dataclasses](https://docs.python.org/3/library/dataclasses.html), and... ## AI interpretation — verify before relying 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. 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. [View on SkillFed](https://skillfed.io/packages/cyclopts) · [View on PyPI](https://pypi.org/project/cyclopts/)