File size: 2,306 Bytes
83845bf b17ce1e 02570da | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 | ---
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 |