Instructions to use tsilva/NES-SuperMarioBros_Level1-4_gray84-hudcrop-stack4-simple_ppo with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- stable-baselines3
How to use tsilva/NES-SuperMarioBros_Level1-4_gray84-hudcrop-stack4-simple_ppo with stable-baselines3:
from huggingface_sb3 import load_from_hub checkpoint = load_from_hub( repo_id="tsilva/NES-SuperMarioBros_Level1-4_gray84-hudcrop-stack4-simple_ppo", filename="{MODEL FILENAME}.zip", ) - Notebooks
- Google Colab
- Kaggle
SuperMarioBros-Nes-v0 β Level1-4 β PPO
Stable-Baselines3 PPO policy for SuperMarioBros-Nes-v0 Level1-4, trained and evaluated with
rlab.
At a Glance
| Item | Value |
|---|---|
| Task | Complete SuperMarioBros-Nes-v0 Level1-4 |
| Provider | supermariobrosnes-turbo |
| Algorithm | ppo |
| Checkpoint | Step 4500000 |
| Evaluation | deterministic full evaluation, 100 episodes |
| Success | minimum 100.0%, mean 100.0% |
| Mean return | 2353.900 |
| Release | legacy-deterministic |
| Preview | Root replay.mp4 |
| YouTube | Watch on YouTube |
Quick Start
Follow the current rlab installation instructions in the source repository.
Import the ROM, then play or evaluate the immutable checkpoint:
uv run rlab import-roms ~/roms --game SuperMarioBros-Nes-v0
uv run rlab play https://huggingface.co/tsilva/NES-SuperMarioBros_Level1-4_gray84-hudcrop-stack4-simple_ppo/resolve/legacy-deterministic/model.zip
uv run rlab eval https://huggingface.co/tsilva/NES-SuperMarioBros_Level1-4_gray84-hudcrop-stack4-simple_ppo/resolve/legacy-deterministic/model.zip
Evaluation
Action selection was deterministic under the published evaluation environment contract.
| Start | Episodes | Successes | Success rate | Mean return |
|---|---|---|---|---|
| Level1-4 | 100 | 100 | 100.0% | 2353.900 |
Environment and Policy Contract
| Item | Value |
|---|---|
| Environment | supermariobrosnes-turbo:SuperMarioBros-Nes-v0 |
| Environment hash | sha256:632366761cde740d340dc3c5361a85db81020920afc1ecec8e9de772aa944e61 |
| Preprocessing | {"frame_skip":4,"frame_stack":4,"maxpool_last_two":false,"obs_copy":"safe_view","obs_crop":[32,0,0,0],"obs_crop_mode":"remove","obs_grayscale":true,"obs_resize":[84,84],"obs_resize_algorithm":"area","pipeline":"supermariobrosnes_turbo_native_vec_env","policy_observation_layout":"channel_first","sticky_action_prob":0.0} |
| Action contract | {"set":"simple"} |
Provenance
| Item | Value |
|---|---|
| Source | rlab |
| Run | Level1-4_base_s_20260704T081304Z |
| Recipe | base |
| Seed | legacy |
| Source commit | not recorded |
| Evaluated artifact | tsilva/SuperMarioBros-Nes-v0/Level1-4_base_s_20260704T081304Z-checkpoint:step-4500000 |
Files
| File | Purpose |
|---|---|
model.zip |
Stable-Baselines3 policy checkpoint |
model_metadata.json |
Portable model, environment, runtime, and provenance metadata |
release_manifest.json |
Legacy release identity and deterministic evaluation evidence |
replay.mp4 |
Browser-safe representative episode |
LICENSE |
License for rlab-authored policy weights and publication material |
Limitations
Evaluation establishes performance only for the published environment hash, start distribution, policy preprocessing, and action-selection protocol. It does not establish generalization to other levels, environments, ROM revisions, or contracts.
Release Status
This repository preserves a legacy release evaluated with deterministic action selection. It is
not a schema-v1 release and has no v1 tag. A current release requires new stochastic evaluation.
Licensing
The rlab-authored policy weights and publication material are licensed under the MIT License in
LICENSE. Emulator/runtime software and game assets remain governed by their own licenses and
terms. This repository does not redistribute a game ROM.
- Downloads last month
- 32