Migrating from Training Gym to Modal Dojo

"# Migrating from Training Gym to Modal Dojo\n\nThe Training Gym has been renamed to Modal Dojo. This guide will break down how to migrate your existing Training Gym setup to the new name, as well as some common things to be aware of.\n\n## Package, imports, and environment variables\n\nThe repository has been renamed to [modal-dojo](https://github.com/modal-projects/modal-dojo), and the Python package is now imported as `modal_dojo`.\n\nTo replace your existing Training Gym dependency:\n\n```bash\nuv remove modal-training-gym\nuv add git+https://github.com/modal-projects/modal-dojo.git@main\n```\n\nOnce you have the new package, update your imports to use the new name. In addition to the package itself, be sure to update any symbols that have been renamed as well:\n\n```python\n# Before\nfrom modal_training_gym import TrainConfig, TrainingGymError, TrainingGymConfigError\n\n# After\nfrom modal_dojo import TrainConfig, DojoError, DojoConfigError\n```\n\nIf you're using any `TRAINING_GYM_*` environment variables, be sure to update them to `MODAL_DOJO_*`.\n\n## Dashboard and CLI\n\nThe `training-gym` command has been renamed to `modal-dojo`, and the dashboard is now deployed at `dojo-dashboard` instead of `training-gym-dashboard`. Many other things have also been renamed:\n\n* The `~/.training-gym.toml` config file is now `~/.modal-dojo.toml`.\n* The `training-gym-overview` skill is now `modal-dojo-overview`.\n* Volumes such as `training-gym-metadata` have been renamed to `modal-dojo-metadata`.\n* The default Trackio app name is now `modal-dojo-trackio`.\n\nTo migrate your configuration and deploy a new `dojo-dashboard` with an updated URL, ensure there are no active training runs, then run:\n\n```bash\nmodal-dojo migrate\n```\n\nThe command will stop old dashboards, move your config file, rename any volumes, and redeploy Modal Dojo apps using their new names.\n\n## Metrics\n\nIf you're using Weights & Biases or Trackio, the default project name is now `modal-dojo`.\n"

The Training Gym has been renamed to Modal Dojo. This guide will break down how to migrate your existing Training Gym setup to the new name, as well as some common things to be aware of.

Package, imports, and environment variables

The repository has been renamed to modal-dojo, and the Python package is now imported as modal_dojo.

To replace your existing Training Gym dependency:

uv remove modal-training-gym
uv add git+https://github.com/modal-projects/modal-dojo.git@main

Once you have the new package, update your imports to use the new name. In addition to the package itself, be sure to update any symbols that have been renamed as well:

# Before
from modal_training_gym import TrainConfig, TrainingGymError, TrainingGymConfigError

# After
from modal_dojo import TrainConfig, DojoError, DojoConfigError

If you’re using any TRAINING_GYM_* environment variables, be sure to update them to MODAL_DOJO_*.

Dashboard and CLI

The training-gym command has been renamed to modal-dojo, and the dashboard is now deployed at dojo-dashboard instead of training-gym-dashboard. Many other things have also been renamed:

The ~/.training-gym.toml config file is now ~/.modal-dojo.toml.
The training-gym-overview skill is now modal-dojo-overview.
Volumes such as training-gym-metadata have been renamed to modal-dojo-metadata.
The default Trackio app name is now modal-dojo-trackio.

To migrate your configuration and deploy a new dojo-dashboard with an updated URL, ensure there are no active training runs, then run:

modal-dojo migrate

The command will stop old dashboards, move your config file, rename any volumes, and redeploy Modal Dojo apps using their new names.

Metrics

If you’re using Weights & Biases or Trackio, the default project name is now modal-dojo.