Files
UniversalTrain-ai/pyproject.toml
T
chenlin d5e9004f6c
Checks / Layout, translation and Colab checks (push) Has been cancelled
Checks / Ruff (push) Has been cancelled
Checks / Framework tests (native backend, CPU) (push) Has been cancelled
Checks / Portable Rust controller (push) Has been cancelled
docs: add AI agent workflow guide and clean up residual single-robot references
2026-11-05 11:52:07 +08:00

132 lines
5.8 KiB
TOML

[project]
name = "mjrl-lab"
version = "0.0.1"
description = "Robot asset onboarding, deterministic controllers, locked reinforcement-learning templates and self-contained MuJoCo applications"
requires-python = ">=3.10,<3.14"
# mjlab and rsl_rl are vendored copies under rl/ (see docs/VENDOR.md), so what
# is listed here is their **transitive dependencies** rather than the two of
# them. Do not pip install mjlab / rsl-rl-lib into the environment as well:
# that creates a shadowing ambiguity with the in-repository copies.
dependencies = [
# ── mjlab 1.6.0's dependencies ──
"mujoco~=3.11.0",
"mujoco-warp~=3.11.0",
"warp-lang>=1.14.0",
"torch>=2.7.0",
"torchrunx>=0.3.4",
"tyro>=1.0.1",
"trimesh>=4.8.3",
"scipy>=1.15",
"viser>=1.0.27",
"mjviser>=0.0.14",
"mediapy>=1.2.7",
"imageio-ffmpeg",
"prettytable",
"tqdm",
# The next two turned up during a clean macOS install on 2026-09-02 and had
# been missing all along -- the training machine happened to have wandb
# installed, so it never showed.
"wandb", # imported at the top of mjlab/utils/wandb.py and
# tasks/manipulation/rl/runner.py, and `import mjlab.tasks`
# imports every task package in turn, so it always gets hit
"PyYAML", # dump_yaml in mjlab/utils/os.py, which writes params/*.yaml at
# the start of training
# ── rsl_rl 5.4.2's dependencies ──
"torchvision>=0.5.0",
"tensordict>=0.7.0",
"tensorboard",
"GitPython",
"onnx",
"onnxscript>=0.5.4",
# Note: rsl_rl also has utils/neptune_log_writer.py, but that is an
# **optional** logger backend, imported only under --agent.logger neptune,
# so it is not a dependency.
# ── Common ──
"numpy",
# ── Deploy ──
# scripts/deploy.py holds every bundle it writes to deploy/app.schema.
"jsonschema",
# Runs the exported ONNX on this machine: export.py's numerical check of the
# graph against the checkpoint, the reference vectors every app carries
# (deploy.py refuses an app without them), and `play --app`'s policies. It
# was left out as something "a machine that only trains has no use for", and
# the result was a default build that stopped on a missing module.
"onnxruntime>=1.17",
# `play --app` reads the app's controller.toml, and `tomllib` arrived in
# Python 3.11; this is the same parser under its original name, for 3.10.
"tomli>=1.1; python_version < '3.11'",
]
[project.optional-dependencies]
dev = ["pytest", "ruff"]
[build-system]
requires = ["setuptools>=64"]
build-backend = "setuptools.build_meta"
# Two package roots: `rl/` holds every RL library (the framework itself, mjrl,
# plus the vendored mjlab / rsl_rl) and the repository root holds tasks. `rl/`
# itself has **no** __init__.py, so all three below remain top-level packages:
# `import mjrl` / `import mjlab` are written the same way and upstream code
# needs no change at all.
#
# Note: with those packages moved out of the repository root, `pip install -e .`
# is no longer optional -- it is the only way imports resolve (the old layout
# relied on the repository root being on sys.path by default).
[tool.setuptools.packages.find]
where = [".", "rl"]
include = ["tasks*", "scenes*", "controller*", "mjrl*", "mjlab*", "rsl_rl*"]
# Scene images live inside the `scenes` package, beside the code that describes
# them. setuptools collects only .py by default, so a built wheel would have the
# scene modules and none of their textures -- and the failure would be a missing
# file at scene-load time, long after the build looked fine. Editable installs
# never hit it, which is exactly what makes it easy to ship.
[tool.setuptools.package-data]
scenes = ["assets/*/*.png"]
tasks = ["templates/**/AGENTS.md"]
# The gamepad dictionary is data, read at run time by `controller.vocabulary`
# and at compile time by `deploy/fsm`. Same reason as the scene textures: a
# wheel with the module and not the file fails on first use, not on build.
controller = ["vocabulary.json"]
# Native app builders and validators use these trusted resources in wheels.
# tests/test_app_schema.py checks them against the published files.
"mjrl.platform" = ["app.schema", "LICENSE"]
[tool.ruff]
line-length = 100
# Exclude the vendored copies only (they stay word-for-word with upstream to
# keep rebases workable).
# Note it must not be written as exclude = ["rl"] -- that would exclude our own
# rl/mjrl along with them.
exclude = ["rl/mjlab", "rl/rsl_rl"]
[tool.ruff.lint]
# Written out rather than left to ruff's default, because the default moved
# under this repository once already: `ruff` is unpinned in the dev extra, and
# ruff 0.16 enables 415 rules where 0.12 enabled these four groups, so
# `ruff check .` went from 83 findings to 350 on 2026-10-08 with no change to
# the code. These are the rules the code is kept clean against, on either
# version.
select = ["E4", "E7", "E9", "F"]
[tool.ruff.lint.per-file-ignores]
# A test that `importorskip`s torch or mjlab has to do so before the imports
# that need them, which is E402 by construction.
"tests/*" = ["E402"]
# A notebook cell imports where it first needs a name, after the form fields
# Colab reads off the top of the cell; ruff 0.16 lints notebooks by default.
"notebooks/*.ipynb" = ["E402"]
# One-off checks are written dense -- several statements to a line, an import
# where it is first needed -- on purpose: each is read once, beside the
# measurement it produced. Only the layout is exempt; a dead import or an empty
# f-string is still a finding there.
"tools/checks/*" = ["E401", "E402", "E701", "E702"]
[tool.pytest.ini_options]
testpaths = ["tests"]
# The vendored copies' own tests are not this repository's responsibility;
# keep pytest from recursing into them.
norecursedirs = ["rl", "assets", "docs"]