Skip to main content

Strongly typed, zero-effort CLI interfaces

Project description


tyro logo

Documentation   •   pip install tyro

build mypy pyright ruff codecov codecov


tyro is a tool for generating command-line interfaces and configuration objects in Python.

Our core API, tyro.cli(),

  • Generates CLI interfaces from Python type signatures.
  • Populates helptext automatically from defaults, annotations, and docstrings.
  • Understands nesting of dataclasses, pydantic, and attrs structures.
  • Prioritizes static analysis for type checking and autocompletion with tools like Pylance, Pyright, and mypy.

For advanced users, it also supports:

  • Subcommands, as well as choosing between and overriding values in configuration objects.
  • Completion script generation for bash, zsh, and tcsh.
  • Fine-grained configuration via PEP 529 runtime annotations (tyro.conf.*).

For examples and the API reference, see our documentation.

In the wild

tyro is designed to be lightweight enough for throwaway scripts, while facilitating type safety and modularity for larger projects. Examples:

nerfstudio-project/nerfstudio
GitHub star count
Open-source tools for neural radiance fields.
Sea-Snell/JAXSeq
GitHub star count
Library for distributed training of large language models in JAX.
kevinzakka/obj2mjcf
GitHub star count
Interface for processing composite Wavefront OBJ files for Mujoco.
blurgyy/jaxngp
GitHub star count
CUDA-accelerated implementation of instant-ngp, in JAX.
NVIDIAGameWorks/kaolin-wisp
GitHub star count
PyTorch library for neural fields.
autonomousvision/sdfstudio
GitHub star count
Unified framework for surface reconstruction.
openrlbenchmark/openrlbenchmark
GitHub star count
Collection of tracked experiments for reinforcement learning.

Alternatives

tyro bakes many opinions into its design decisions. If any of them don't make sense, feel free to file an issue!

You might also consider one of many alternative libraries. Some that we particularly like:

  • simple-parsing and jsonargparse, which provide deeper integration with configuration file formats like YAML and JSON.
  • clipstick, which focuses on generating CLIs from Pydantic models.
  • datargs, which provides a minimal API for dataclasses.
  • fire and clize, which support arguments without type annotations.

We also have some notes on tyro's design goals and other alternatives in the docs here.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tyro-0.6.6.tar.gz (106.4 kB view details)

Uploaded Source

Built Distribution

tyro-0.6.6-py3-none-any.whl (79.6 kB view details)

Uploaded Python 3

File details

Details for the file tyro-0.6.6.tar.gz.

File metadata

  • Download URL: tyro-0.6.6.tar.gz
  • Upload date:
  • Size: 106.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.18

File hashes

Hashes for tyro-0.6.6.tar.gz
Algorithm Hash digest
SHA256 5a7ae6034beeecea28b3bd0fbe2c9a09f55c7a1a37a0c7cd47df29a8ce4e08db
MD5 aa2b27a315a8156c09324c25abe65e13
BLAKE2b-256 a87cf9443ac752f8ed977d2882aace889096341cf83408b91e8c2bc20ddaeb40

See more details on using hashes here.

File details

Details for the file tyro-0.6.6-py3-none-any.whl.

File metadata

  • Download URL: tyro-0.6.6-py3-none-any.whl
  • Upload date:
  • Size: 79.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.18

File hashes

Hashes for tyro-0.6.6-py3-none-any.whl
Algorithm Hash digest
SHA256 05c2b199cabdf61b475dd6d398541b25862cd21b5ff2d57be86d7c69097bd7e2
MD5 a23ad90b9bdca2641f69d9384bcdb52e
BLAKE2b-256 96b4467ae1bb12b2e7fd71262a19b1b4a83cadd59826ad8f444cfa3fab89f634

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page