| | --- |
| | license: gpl-3.0 |
| | language: |
| | - en |
| | tags: |
| | - python |
| | - baseline |
| | - ai |
| | --- |
| | # Mario AI Base 🎮🤖🚀 |
| |
|
| | Welcome to **Mario AI Base**! 🎉 This repository is your hub for an AI-powered *Super Mario Bros.* experience. An AI agent, trained with reinforcement learning, plays the game and streams its gameplay live to your browser. A Gradio-based updater app lets you manage daily notes from your LAN. Dive into retro gaming with a modern AI twist! 🌟 |
| |
|
| | ## Overview 🌍 |
| |
|
| | - **Mario AI Streaming App**: An AI (PPO from `stable-baselines3`) plays *Super Mario Bros.*, streamed at ~30 FPS to `http://<your-rig-ip>:5111` via MJPEG with Flask. Supports CUDA acceleration. |
| | - **Python Updater App**: Gradio-based tool to update GitHub notes daily, accessible at `http://<your-rig-ip>:2332`. |
| | - **No ROM Included**: Users must provide their own *Super Mario Bros.* ROM due to licensing. 🕹️ |
| |
|
| | ## Features ✨ |
| |
|
| | - **AI-Driven Gameplay**: Watch an AI navigate Mario levels! 🧠 |
| | - **Live Streaming**: Real-time gameplay in your browser. 📺 |
| | - **CUDA Acceleration**: Faster AI inference on GPUs like RTX 3060 Ti. ⚡ |
| | - **Daily Updates**: Log progress with the Gradio app. 📅 |
| | - **LAN Accessible**: Stream and control from your network. 🌐 |
| | - **Customizable**: Adjust AI model or add gameplay actions. 🎮 |
| |
|
| | ## Setup 🛠️ |
| |
|
| | ### Prerequisites 📋 |
| |
|
| | - **OS**: Ubuntu 20.04+ (tested on "T-1000" with RTX 3060 Ti). |
| | - **Python**: 3.8+ (`python3 --version`). |
| | - **GPU (Optional)**: NVIDIA GPU (e.g., RTX 3060 Ti) for CUDA. |
| | - **NES ROM**: Legal `Super Mario Bros.nes` (not provided) at `/home/ubuntu/mario/`. |
| | - **Git**: `sudo apt install git` for the updater. |
| | - **Dependencies**: Install with `requirements.txt`. |
| |
|
| | ### Hardware Requirements 💻 |
| |
|
| | - **CPU**: 2+ cores, 2 GHz (e.g., Intel i5). More for training. |
| | - **GPU**: RTX 3060 Ti or similar for CUDA (recommended). |
| | - **RAM**: 16 GB minimum (32 GB for training). |
| | - **Storage**: 1 GB for dependencies, ROM, and models. |
| |
|
| | ### CUDA Setup for GPU Acceleration ⚡ |
| |
|
| | Leverage your RTX 3060 Ti for AI inference and frame processing: |
| |
|
| | 1. **Install NVIDIA Drivers**: |
| | ```bash |
| | sudo apt update |
| | sudo apt install nvidia-driver-550 |
| | |
| | Website: https://ghostai.pro/ |
| | Discord: https://discord.gg/9cnJNBQtHE |
| | |
| | ## Update (April 03, 2025) 📝 |
| | - Tweaked jump controls for improved accuracy |
