Hugging Face's logo

ghostai1
/
ccengine1

Model card Files
xet
Community
ccengine1 / README.md
ghostai1's picture
ghostai1
Updated Mario AI status on April 03, 2025
02570da verified
preview code
|
raw
history blame
2.31 kB
metadata 
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:
    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