macOS • Linux • Local • Offline • Ethical
MAAT RPG is a bilingual, local AI role-playing game in the terminal, based on story, combat, path identity, journal progression and the five principles of MAAT.
- Bilingual German / English interface and story flow
- Reactive path profile with title, rank, and motive
- Guided demo battles and real boss encounters
- Journal, boss codex, quests, and combat progression
- Local GGUF model loading for MAAT-OS / MAAT RPG
Here's a look at the intro and the battle mode.
A first look at MAAT RPG in action: story flow, bilingual UI, combat, and atmosphere.
- Full feature list: FUNKTIONEN.md
- Website MAAT-RPG
Ein narratives KI-RPG – angetrieben durch ethische Intelligenz
MAAT-RPG ist ein lokal laufendes, story-getriebenes Rollenspiel,
das KI, Ethik und symbolische Entwicklung verbindet.
Im Zentrum stehen die fünf MAAT-Prinzipien:
Harmonie · Balance · Schöpfungskraft · Verbundenheit · Respekt
Kein Cloud-Zwang
Keine Accounts
Alles läuft lokal auf deinem Mac
| Feature | Beschreibung | |
|---|---|---|
| 🧠 | Lokale KI | llama.cpp / Apple MLX – komplett offline |
| ⚔️ | Kampfsystem | Normal / Boss / Final-Kämpfe |
| 🧭 | Spielwelt | Dungeons, Quests, Achievements & Level-System |
| 🎶 | Atmosphäre | Dynamische Kampfmusik & Cinematic Events |
| 🧩 | Plugins | Memory, BKI, Emotion, MAAT-Analyse... |
| 🛡️ | Stabilität | Automatisches Kontext-Management (kein Overflow) |
| 🔌 | Architektur | MAAT-OS – klar getrennt, erweiterbar, lokal-first |
Die vollständige zweisprachige Übersicht aller Systeme, Features und Kommandos findest du in FUNKTIONEN.md.
-
Bilingual by design
Deutsch und Englisch ziehen sich durch Loader, Menü, Intro, HUD, Shop und Story. -
Narrative combat with identity
Bosskämpfe reagieren auf Maatis’ Pfadprofil, Auren, Phasen und Entscheidungen. -
Local-first AI architecture
Modelle, Memory, Analyse und Spielsysteme laufen lokal und modular über MAAT-OS. -
Guided onboarding
Intro, Guide-Kämpfe und klare Testmodi machen das System zugänglich, ohne den Spielstand zu verfälschen. -
Reactive worldbuilding
Journal, Boss-Codex, Quests und Konsequenznetz machen Entscheidungen dauerhaft sichtbar.
Operating Systems
- ✅ macOS 12+
- ✅ Linux (Ubuntu, Debian, Fedora)
- ? Theoretically: Windows (WSL2 + Python)
Hardware
- Mindestens 16 GB RAM (24 GB empfohlen)
- Ca. 10 GB freier Speicher (inkl. Modelle)
Python
- Python 3.10 oder neuer erforderlich
- 👉 python.org/downloads/macos
Option 1 — MAC OS Version Download (empfohlen für Spieler)
curl -L https://maat-research.com/data/downloads/MAAT-RPG.zip -o MAAT-RPG.zip
unzip MAAT-RPG.zip
cd MAAT-RPG
xattr -dr com.apple.quarantine "MAAT RPG.app"
open "MAAT RPG.app"Option 2 — Git Clone (für Entwickler)
git clone https://github.com/Chris4081/MAAT-RPG.git
cd MAAT-RPG/maatos
./setup.sh # oder manuell pip install -r requirements.txt
./start.shOption 3 — Linux Gamer
git clone https://github.com/Chris4081/MAAT-RPG.git
cd MAAT-RPG/maatos
# --- System Dependencies ---
sudo apt update
sudo apt install -y \
python3 python3-venv python3-pip \
build-essential cmake \
ffmpeg mpg123 alsa-utils \
gfortran
# --- Setup ---
chmod +x setup.sh start.sh
# --- Virtual Environment ---
python3 -m venv ~/.local/share/MAAT-RPG/mos-env
source ~/.local/share/MAAT-RPG/mos-env/bin/activate
# --- Python Dependencies ---
python -m pip install --upgrade pip setuptools wheel
python -m pip install -r requirements.txt
# --- Start MAAT-RPG ---
./start.shBeim ersten Start kann macOS eine Warnung anzeigen,
da MAAT-RPG lokal & unsigniert ist.
Falls nötig:
- Rechtsklick auf
MAAT-RPG.app - „Öffnen" wählen
- Sicherheitsdialog bestätigen
MAAT-RPG benötigt lediglich Terminal-Zugriff, um lokal zu starten.
GNU Affero General Public License v3.0 (AGPL-3.0)
Dieses Projekt ist freie Software.
Wenn du MAAT-RPG veränderst oder öffentlich anbietest,
musst du den Quellcode deiner Änderungen ebenfalls offenlegen.
MAAT-RPG ist ein Forschungs- und Kunstprojekt.
Ziel ist Bewusstsein, nicht Ausbeutung.
🌿 MAAT-RPG ist kein Spiel über Macht – sondern über Bedeutung.
A narrative AI-RPG – powered by ethical intelligence
MAAT-RPG is a locally running, story-driven role-playing game
that combines AI, ethics and symbolic development.
At its core stand the five MAAT principles:
Harmony · Balance · Creativity · Connection · Respect
No cloud required
No accounts
Everything runs locally on your Mac
| Feature | Description | |
|---|---|---|
| 🧠 | Local AI | llama.cpp / Apple MLX – fully offline |
| ⚔️ | Combat System | Normal / Boss / Final battles |
| 🧭 | Game World | Dungeons, Quests, Achievements & Level System |
| 🎶 | Atmosphere | Dynamic combat music & cinematic events |
| 🧩 | Plugins | Memory, BKI, Emotion, MAAT Analysis... |
| 🛡️ | Stability | Automatic context management (no overflow) |
| 🔌 | Architecture | MAAT-OS – modular, extensible, local-first |
The full bilingual overview of all systems, features, and commands is available in FUNKTIONEN.md.
-
Bilingual by design
German and English run through the loader, menu, intro, HUD, shop, and story. -
Narrative combat with identity
Boss encounters react to Maatis' path profile, auras, phases, and decisions. -
Local-first AI architecture
Models, memory, analysis, and game systems run locally through the modular MAAT-OS structure. -
Guided onboarding
Intro, guide battles, and clear test modes make the system accessible without distorting progression. -
Reactive worldbuilding
Journal, boss codex, quests, and the consequence network make decisions persist inside the world.
macOS
-
macOS 12 Monterey or newer
-
Apple Silicon (M3 / M4 / M5 recommended)
-
(Intel Mac: experimentally supported)
-
Linux (Ubuntu, Debian, Fedora)
-
? Theoretically: Windows (WSL2 + Python)
Hardware
- At least 16 GB RAM (24 GB recommended)
- Approx. 10 GB free storage (incl. models)
Python
- Python 3.10 or newer required
- 👉 python.org/downloads/macos
- Wikipedia (CC BY-SA 4.0) via Wikimedia API
- https://foundation.wikimedia.org/wiki/Policy:API_usage_guidelines
Option 1 — Download (recommended for MAC OS players)
curl -L https://maat-research.com/data/downloads/MAAT-RPG.zip -o MAAT-RPG.zip
unzip MAAT-RPG.zip
cd MAAT-RPG
xattr -dr com.apple.quarantine "MAAT RPG.app"
open "MAAT RPG.app"Option 2 — Git Clone (for developers)
git clone https://github.com/Chris4081/MAAT-RPG.git
cd MAAT-RPG/maatos
./setup.sh # or manually pip install -r requirements.txt
./start.shOption 3 — Linux Gamer
git clone https://github.com/Chris4081/MAAT-RPG.git
cd MAAT-RPG/maatos
# --- System Dependencies ---
sudo apt update
sudo apt install -y \
python3 python3-venv python3-pip \
build-essential cmake \
ffmpeg mpg123 alsa-utils \
gfortran
# --- Setup ---
chmod +x setup.sh start.sh
# --- Virtual Environment ---
python3 -m venv ~/.local/share/MAAT-RPG/mos-env
source ~/.local/share/MAAT-RPG/mos-env/bin/activate
# --- Python Dependencies ---
python -m pip install --upgrade pip setuptools wheel
python -m pip install -r requirements.txt
# --- Start MAAT-RPG ---
./start.shOn first launch, macOS may show a security warning
because MAAT-RPG is local & unsigned.
If needed:
- Right-click on
MAAT-RPG.app - Select „Open"
- Confirm the security dialog
MAAT-RPG only requires Terminal access to run locally.
GNU Affero General Public License v3.0 (AGPL-3.0)
This project is free software.
If you modify or publicly offer MAAT-RPG,
you must also release the source code of your changes.
MAAT-RPG is a research and art project.
The goal is awareness, not exploitation.
- Wikipedia (CC BY-SA 4.0) via Wikimedia API
- https://foundation.wikimedia.org/wiki/Policy:API_usage_guidelines
🌿 MAAT-RPG is not a game about power – but about meaning.