---
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 (March 22, 2025) 📝
- Tweaked jump controls for improved accuracy