Skip to content

Quickstart

The shortest command path once the environment is already installed. Commands are written as a bare genelab, which assumes the venv is active (source .venv/bin/activate); see Installation → Run commands for the why and for the uv run --no-sync alternative.

1. Listing registered content

genelab list robots
genelab list envs
genelab list tasks

If a task is missing, load its extension explicitly:

PYTHONPATH=examples/inverted_pendulum/src \
  genelab --import genelab_inverted_pendulum.tasks list tasks

2. Inspecting a task

genelab info GeneLab-Inverted-Pendulum-v0

Copy override paths from the printed config tree instead of guessing blindly.

3. Play

genelab play GeneLab-Inverted-Pendulum-v0 --steps 64
genelab play GeneLab-Inverted-Pendulum-v0 --vis --steps 500
genelab play GeneLab-Inverted-Pendulum-v0 --agent random --steps 128

4. Train

genelab train GeneLab-Inverted-Pendulum-v0 \
  --num_envs 64 \
  --max_iterations 2

Longer run:

genelab train GeneLab-Inverted-Pendulum-v0 \
  --num_envs 4096 \
  --max_iterations 300

5. Scaffolding a project

genelab project new my_robot_project
uv pip install -e my_robot_project
genelab list tasks

See also