Skip to content

Chris4081/MAAT-RPG

BranchesTags

Repository files navigation

🇩🇪 Deutsch · 🇬🇧 English

🌿 MAAT-RPG ALPHA

macOS • Linux • Windows (experimental) • 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.

Platforms: 🍎 macOS · 🐧 Linux · 🪟 Windows (experimental)

Highlights

  • 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

Gameplay Videos

Here's a look at the intro and the battle mode.

MAAT RPG Gameplay

A first look at MAAT RPG in action: story flow, bilingual UI, combat, and atmosphere.

MAAT RPG Gameplay

Links

🇩🇪 Deutsch

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 Rechner

✨ Features

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

📚 Funktionsübersicht

Die vollständige zweisprachige Übersicht aller Systeme, Features und Kommandos findest du in FUNKTIONEN.md.

🛠️ Entwickler-Dokumentation

Wenn du MAAT-RPG erweitern oder daran mitarbeiten willst, findest du hier die wichtigsten technischen Dokumente:

🌟 Highlights

  • 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.

🖥️ Systemanforderungen

Operating Systems

  • ✅ macOS 12+
  • ✅ Linux (Ubuntu, Debian, Fedora)
  • 🧪 Windows 10/11 (experimental, PowerShell + Python)

Hardware

  • Mindestens 16 GB RAM (24 GB empfohlen)
  • Ca. 10 GB freier Speicher (inkl. Modelle)

Python

  • Empfohlen: Python 3.11 oder 3.12
  • Python 3.10 kann funktionieren, ist aber nicht die bevorzugte Zielversion
  • Python 3.13 wird derzeit nicht empfohlen, da einzelne Abhängigkeiten (z. B. scipy) bei der Installation scheitern können
  • 👉 python.org/downloads/macos

🚀 Installation

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 (empfohlen für Entwickler auf Linux/macOS)

git clone https://github.com/Chris4081/MAAT-RPG.git && cd MAAT-RPG && bash setup.sh

Der Installer bevorzugt automatisch:

  • python3.12
  • dann python3.11
  • erst danach python3

Wenn dein System standardmäßig Python 3.13 nutzt, installiere am besten Python 3.11 oder 3.12 und starte dann:

MAAT_SETUP_PYTHON=python3.11 bash setup.sh

Option 3 — Linux (Ubuntu / Debian)

sudo apt update
sudo apt install -y \
    python3.11 python3.11-venv python3.11-dev \
    build-essential cmake \
    ffmpeg mpg123 alsa-utils \
    speech-dispatcher espeak-ng

git clone https://github.com/Chris4081/MAAT-RPG.git
cd MAAT-RPG
MAAT_SETUP_PYTHON=python3.11 bash setup.sh

Option 4 — Windows (experimentell, PowerShell)

git clone https://github.com/Chris4081/MAAT-RPG.git
cd MAAT-RPG
powershell -ExecutionPolicy Bypass -File .\setup.ps1

Danach:

powershell -ExecutionPolicy Bypass -File .\start.ps1

Hinweise:

  • Empfohlen: Python 3.11 oder 3.12
  • Musik funktioniert auf Windows am besten mit ffplay aus ffmpeg
  • Für llama-cpp-python werden in der Regel cmake und Visual Studio Build Tools benötigt
  • Details: docs/INSTALL_WINDOWS.md

Troubleshooting

Wenn bei der Installation ein Fehler rund um scipy auftaucht, verwendest du sehr wahrscheinlich eine ungeeignete Python-Version, oft Python 3.13.

Empfohlene Lösung:

MAAT_SETUP_PYTHON=python3.11 bash setup.sh

🔐 macOS Sicherheit (Gatekeeper)

Beim ersten Start kann macOS eine Warnung anzeigen,
da MAAT-RPG lokal & unsigniert ist.

Falls nötig:

  1. Rechtsklick auf MAAT RPG.app
  2. „Öffnen" wählen
  3. Sicherheitsdialog bestätigen

MAAT-RPG benötigt lediglich Terminal-Zugriff, um lokal zu starten.

📜 Lizenz

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.

Data Sources

🎵 Musik

Die in diesem Projekt verwendete Musik wurde mit Suno unter Verwendung eines lizenzierten Accounts generiert.

Sie dient zur Unterstützung des Spielerlebnisses von MAAT RPG.

🌿 MAAT-RPG ist kein Spiel über Macht – sondern über Bedeutung.

🇬🇧 English

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 machine

✨ Features

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

📚 Feature Overview

The full bilingual overview of all systems, features, and commands is available in FUNKTIONEN.md.

🛠️ Developer Documentation

If you want to extend or contribute to MAAT-RPG, start here:

🌟 Highlights

  • 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.

🖥️ System Requirements

Operating Systems

  • macOS 12 Monterey or newer
  • Linux (Ubuntu, Debian, Fedora)
  • 🧪 Windows 10/11 (experimental, PowerShell + Python)

macOS note

  • Apple Silicon (M3 / M4 / M5 recommended)
  • (Intel Mac: experimentally supported)

Hardware

  • At least 16 GB RAM (24 GB recommended)
  • Approx. 10 GB free storage (incl. models)

Python

  • Recommended: Python 3.11 or 3.12
  • Python 3.10 may work, but it is not the preferred target version
  • Python 3.13 is currently not recommended, because some dependencies (for example scipy) may fail during installation
  • 👉 python.org/downloads/macos

🚀 Installation

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 (recommended for developers on Linux/macOS)

git clone https://github.com/Chris4081/MAAT-RPG.git && cd MAAT-RPG && bash setup.sh

The installer automatically prefers:

  • python3.12
  • then python3.11
  • and only after that python3

If your system default is Python 3.13, install Python 3.11 or 3.12 first and then run:

MAAT_SETUP_PYTHON=python3.11 bash setup.sh

Option 3 — Linux (Ubuntu / Debian)

sudo apt update
sudo apt install -y \
    python3.11 python3.11-venv python3.11-dev \
    build-essential cmake \
    ffmpeg mpg123 alsa-utils \
    speech-dispatcher espeak-ng

git clone https://github.com/Chris4081/MAAT-RPG.git
cd MAAT-RPG
MAAT_SETUP_PYTHON=python3.11 bash setup.sh

Option 4 — Windows (experimental, PowerShell)

git clone https://github.com/Chris4081/MAAT-RPG.git
cd MAAT-RPG
powershell -ExecutionPolicy Bypass -File .\setup.ps1

After that:

powershell -ExecutionPolicy Bypass -File .\start.ps1

Notes:

  • Recommended: Python 3.11 or 3.12
  • Music works best on Windows with ffplay from ffmpeg
  • llama-cpp-python usually needs cmake and Visual Studio Build Tools
  • Details: docs/INSTALL_WINDOWS.md

Troubleshooting

If installation fails around scipy, you are most likely using an unsupported Python version, often Python 3.13.

Recommended fix:

MAAT_SETUP_PYTHON=python3.11 bash setup.sh

🔐 macOS Security (Gatekeeper)

On first launch, macOS may show a security warning
because MAAT-RPG is local & unsigned.

If needed:

  1. Right-click on MAAT RPG.app
  2. Select „Open"
  3. Confirm the security dialog

MAAT-RPG only requires Terminal access to run locally.

📜 License

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.

Data Sources

🎵 Music

Some music in this project was generated using Suno with a licensed account.

All tracks are used as part of the MAAT RPG experience.

🌿 MAAT-RPG is not a game about power – but about meaning.

About

A conscious AI-powered terminal RPG where your choices shape identity, story, and world. Guided by the MAAT principles: Harmony, Balance, Creativity, Connection, and Respect. Fully local. No cloud. No accounts. Just you and the system.

Topics

offline-first storytelling game-development artificial-intelligence text-adventure rpg-game terminal-based python-cli deutsch terminal-app terminal-game macos-app indie-game narrative-game ethical-ai ai-assistant kuenstlicheintelligenz ai-storytelling ai-rpg ai-rpg-engine

Resources

Readme

License

AGPL-3.0 license

Contributing

Contributing
Activity

Stars

1 star

Watchers

1 watching

Forks

0 forks
Report repository

Releases

1 tags

Packages

 
 
 

Contributors

Languages