tyro（命令行配置库）

tyro (type-safe CLI and config generation for Python)进阶

根据 Python 类型注解和 dataclass 自动生成命令行参数的配置库

tyro 是加州大学伯克利分校的 Brent Yi 开源的 Python 库（MIT 协议，旧名 dcargs）。核心函数 tyro.cli() 读取函数或 dataclass 的类型注解、默认值和文档字符串，自动生成命令行参数和帮助信息，解析结果直接是填好值的配置对象，也支持嵌套配置和子命令。和 Hydra 主要靠 YAML 文件组合配置不同，tyro 的配置就是普通 Python 对象，IDE 能补全，类型检查工具能查错。Brent Yi 也是 nerfstudio 的作者之一，nerfstudio 的训练命令就用 tyro。具身方向的新手常在 openpi 里碰到它：scripts/train.py 用 tyro 先按名字选一份预设训练配置，再在命令行覆盖个别字段；Isaac-GR00T、ManiSkill 的部分脚本也用它。

例子在 openpi 里运行 uv run scripts/train.py pi05_libero --exp-name=my_run --batch-size=16，先选中预设的 pi05_libero 配置，再只改实验名和批大小。

也叫: tyro、dcargs
相关: Hydra 配置框架、draccus（dataclass 配置库）、openpi、Nerfstudio / gsplat（NeRF 与高斯泼溅开源工具库）、ManiSkill、超参数
来源: brentyi/tyro (GitHub)
Brent Yi 个人主页
 openpi src/openpi/training/config.py (GitHub)
信息截至: 2026-10