How openrl-lab/tizero works
TiZero is a reinforcement-learning agent and toolkit for Google Research Football. Its main workflow is to provide an agent to a football environment, where observations are handled and actions advance a match; the repository also exposes local match evaluation and post-match dump inspection, keypoint analysis, and video conversion. The source index supports the CLI-to-evaluation and CLI-to-visualization routes, plus several internal module references. Some agent and environment internals were only partially sampled, so uncertain connections are omitted rather than inferred.
Main entry points: cli.py CLI commands · submission.py Submission agent · visualizer.py Match visualizer · football_env.py Gym environment
Components 27
Agent
- Submission agent
submission/tizero/submission.py - OpenRL policy
submission/tizero/openrl_policy.py - Agent utilities
submission/tizero/openrl_utils.py - Goalkeeper logic
submission/tizero/goal_keeper.py
Football environment
- Environment config
tizero/football_env/core/config.py - Match scenarios
tizero/football_env/scenarios - Scenario builder
tizero/football_env/core/scenario_builder.py - Football engine
tizero/football_env/core/football_env_core.py - Gym environment
tizero/football_env/core/football_env.py - Environment factory
tizero/football_env/__init__.py - PettingZoo adapter
tizero/football_env/football_pettingzoo.py - JiDi evaluation env
tizero/football_env/football_jidi_eval.py
Evaluation
- CLI commands
tizero/cli/cli.py - Evaluation runner
tizero/cli/evaluation.py - Environment helpers
tizero/utils/script_helpers.py
Match visualization
- Dump to video
tizero/cli/dump2video.py - Show match dump
tizero/cli/show_dump.py - Show keypoints
tizero/cli/show_keypoint.py - Match tracer
tizero/utils/visualize_tools/tools/tracer.py - Game event graph
tizero/utils/visualize_tools/game_graph/game_graph.py - Match visualizer
tizero/utils/visualize_tools/visualizer/visualizer.py - Pitch geometry
tizero/utils/visualize_tools/tools/geometry.py - Field renderer
tizero/utils/visualize_tools/visualizer/raw_drawer.py - Ball information
tizero/utils/visualize_tools/visualizer/ball_info_table.py - Team information
tizero/utils/visualize_tools/visualizer/team_info_table.py
Other components
- Agent user
- Google Research Football
Connections 27
- Agent user → Submission agent: supplies agent
- Submission agent → OpenRL policy: uses
submission/tizero/submission.py - Submission agent → Agent utilities: uses
submission/tizero/submission.py - Submission agent → Goalkeeper logic: uses
submission/tizero/submission.py - Environment config → Scenario builder: uses
tizero/football_env/core/config.py - Gym environment → Environment config: reads
tizero/football_env/core/football_env.py - Gym environment → Football engine: delegates
tizero/football_env/core/football_env.py - Environment factory → Environment config: uses
tizero/football_env/__init__.py - Environment factory → Gym environment: wraps
tizero/football_env/__init__.py - PettingZoo adapter → JiDi evaluation env: uses
tizero/football_env/football_pettingzoo.py - Evaluation runner → PettingZoo adapter: runs
tizero/cli/evaluation.py - CLI commands → Evaluation runner: dispatches
tizero/cli/cli.py - CLI commands → Dump to video: dispatches
tizero/cli/cli.py - CLI commands → Show match dump: dispatches
tizero/cli/cli.py - CLI commands → Show keypoints: dispatches
tizero/cli/cli.py - Dump to video → Environment helpers: uses
tizero/cli/dump2video.py - Environment helpers → Environment config: uses
tizero/utils/script_helpers.py - Environment helpers → Gym environment: uses
tizero/utils/script_helpers.py - Google Research Football → Environment factory: provides game
README.md - Show match dump → Match tracer: loads dump
tizero/cli/show_dump.py - Show match dump → Match visualizer: opens
tizero/cli/show_dump.py - Show keypoints → Match tracer: loads dump
tizero/cli/show_keypoint.py - Show keypoints → Game event graph: builds
tizero/cli/show_keypoint.py - Match visualizer → Field renderer: renders with
tizero/utils/visualize_tools/visualizer/visualizer.py - Match visualizer → Ball information: updates
tizero/utils/visualize_tools/visualizer/visualizer.py - Match visualizer → Team information: updates
tizero/utils/visualize_tools/visualizer/visualizer.py - Game event graph → Pitch geometry: calculates distances
tizero/utils/visualize_tools/game_graph/game_graph.py