wrappers-recording
Apply, inspect, author, and troubleshoot Gymnasium single-environment wrappers, recording helpers, and rendering helpers.
- License 许可
- MIT
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- wrappers-recording
- license
- MIT
- metadata
- { "disco-role": "operating" }
- description
- Apply, inspect, author, and troubleshoot Gymnasium single-environment wrappers, recording helpers, and rendering helpers.
- disable-model-invocation
- true
02 资源文件 4
- 参考文档references/custom-wrappers.md5.4 KB
- 参考文档references/recording-and-rendering.md4.8 KB
- 参考文档references/troubleshooting.md5.6 KB
- 参考文档references/wrapper-catalog.md8.2 KB
03 SKILL.md 正文
Gymnasium Wrappers and Recording
Use this sub-skill when a task needs single-environment Gymnasium wrappers: applying wrapper chains, inspecting wrapped environments, writing custom wrappers, recording episode statistics or videos, and diagnosing wrapper or render-mode failures.
Start Here
- Build the base environment with
gymnasium.make(...); most made environments already includeTimeLimit<OrderEnforcing<PassiveEnvChecker<...>>>unless the spec/options disable parts of that stack. - Add wrappers outside-in:
env = Wrapper(env, ...); the last wrapper assigned is the first object the agent interacts with. - Inspect
envfor the full chain,env.envfor the next inner layer, andenv.unwrappedfor the original base environment. - After any wrapper that changes observations or actions, verify
env.observation_space,env.action_space,reset(), and onestep()agree. - Use
RecordEpisodeStatisticsfor lightweight metrics; addRecordVideoonly when the environment was created with image-returning rendering such asrender_mode="rgb_array"andmoviepyis installed.
Route by Task
| Task | Read |
|---|---|
| Choose or order built-in wrappers | references/wrapper-catalog.md |
| Record episode returns, lengths, videos, or render frames | references/recording-and-rendering.md |
Write Wrapper, ObservationWrapper, ActionWrapper, or RewardWrapper subclasses |
references/custom-wrappers.md |
| Diagnose wrapper order, changed spaces, render/video, image wrapper, Atari, or array conversion errors | references/troubleshooting.md |
| Prove a local wrapper chain works | scripts/wrapper_smoke.py |
Common Patterns
import gymnasium as gym
from gymnasium.wrappers import FlattenObservation, RecordEpisodeStatistics, TimeLimit
env = gym.make("CartPole-v1")
env = TimeLimit(env, max_episode_steps=200)
env = FlattenObservation(env)
env = RecordEpisodeStatistics(env)
obs, info = env.reset(seed=123)
obs, reward, terminated, truncated, info = env.step(env.action_space.sample())
import gymnasium as gym
from gymnasium.wrappers import RecordVideo
env = gym.make("CartPole-v1", render_mode="rgb_array")
env = RecordVideo(env, video_folder="videos", episode_trigger=lambda episode: True)
Boundaries
- For vector environments and
gymnasium.wrappers.vector, use../vectorization/SKILL.md. - For detailed
Spaceconstructor, flattening, dtype, andcontainsguidance, use../spaces-data/SKILL.md. - For environment registration,
check_env, and customEnvlifecycle, use../environment-api/SKILL.md. - For built-in environment family extras such as Box2D, MuJoCo, Atari/ALE IDs, or Toy Text action masks, use
../builtin-envs/SKILL.md.
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.