Skip to content

Repository files navigation

Project Athena — Nexus Academy

"The OASIS school from Ready Player One, but real."

An open-world adaptive learning game for ages 2 and up. No quizzes. No tests. No essays. The world demands knowledge and rewards mastery. Playing IS learning.

Powered by Atlas Cortex. Built by DigitalBrainstem.


Architecture

graph TB
subgraph Client["🎮 Game Client (Three.js/TypeScript)"]
WE[World Engine] --> R[3D Renderer]
WE --> P[Physics]
WE --> C[Crafting]
AI[Audio/Input] --> V[Voice]
AI --> T[Touch/Gamepad]
AI --> K[Keyboard]
end
subgraph Server["⚡ Game Server (FastAPI/Python)"]
PR[Profiles] --> MS[Mastery Tracker]
CT[Content Server] --> QS[Quest System]
SY[Sync Engine] --> OF[Offline Support]
end
subgraph Atlas["🧠 Atlas Cortex"]
LLM[LLM Engine] --> CG[Content Generator]
LLM --> GA[Gap Analysis]
LLM --> DT[Difficulty Tuning]
TTS[Fish Audio TTS] --> CV[Companion Voice]
end
Client -->|REST API| Server
Server -->|Module API / Nightly Batch| Atlas
subgraph Platforms["📱 Platforms"]
B[Browser]
S[Surface Go Kiosk]
SAT[Satellite Speaker]
end
Client --- Platforms
Loading

The Game

Five mastery tiers, one seamless world that grows with the player:

TierAgesExperience
Foundation2–5Dora-style companion talks directly to the child. Touch + voice. Colors, counting, shapes, phonics.
Discovery6–10Open world unlocks. Companion becomes adventure partner. Quests teach arithmetic through calculus foundations.
Builder11–14Full crafting, Code Forge, Time Rift missions. Real chemistry formulas, structural physics, economy systems.
Innovator15–18Physics simulations, chemistry labs, historical debates. AP/college-prep level content.
Creator18+Research-grade tools. Calc 3, organic chemistry, quantum mechanics, ML, distributed systems.

Knowledge is the only currency. No microtransactions. No ads. No pay-to-play. Ever.

Documentation

20 focused spec documents in docs/:

#DocumentFocus
01VisionDesign pillars, inspirations, what this IS and ISN'T
02World DesignBiomes, morphing, procedural generation
03Travel MechanicsVillage → galaxy, ships, FTL, fuel chemistry
04Mastery TiersFoundation through Creator — detailed mastery-level gameplay
05Gameplay LoopsQuests, crafting, building, Code Forge, economy
06Mastery SystemEnder Protocol: spaced repetition, gap detection
07Subject MappingEvery subject → game mechanic, all tiers
08Atlas IntegrationInvisible architect, nightly batch
09Content PipelineGeneration, validation, caching, distribution
10Story & NarrativeThe Founders, mystery arc, endgame
11Companion SystemCharacter arc, personality, teaching
12Voice GameplayZero-screen satellite mode
13Input & ControlsTouch, voice, keyboard, gamepad
14MultiplayerCo-op, classroom mode, child safety
15ProfilesCalibration zone, sync, progression
16Art DirectionStylized 3D, per-tier visual style
17Audio DesignTTS, adaptive music, spatial audio
18Tech ArchitectureThree.js, FastAPI, DB, offline
19AccessibilityVisual, motor, cognitive, auditory
20Screen TimeParental controls, COPPA, safety

Getting Started

Prerequisites

  • Node.js 18+ (client)
  • Python 3.11+ (server)
  • Atlas Cortex instance (optional — game runs standalone)

Development

# Clone
git clone https://github.com/Digitalbrainstem/athena.git
cd athena
# Client (not yet implemented)cd client && npm install && npm run dev
# Server (not yet implemented)cd server && pip install -r requirements.txt && python -m server.app

Satellite Audio-Only Mode

The game runs on Atlas satellite speakers (Hermes) with zero screen — pure voice interaction. See Voice Gameplay for the full design.

Design Principles

  1. Learning IS gameplay — the world demands knowledge, not answers to questions
  2. The game runs standalone — Atlas is the architect, not the engine
  3. No microtransactions — knowledge is the only currency
  4. Never feels like school — no grades, no scores, the world simply responds
  5. Radians AND degrees from age 2 — angles as "turns" builds lifelong intuition
  6. Gender-neutral everything — interests tracked by behavior, never demographics
  7. Screen time is unlimited — parent-configurable, never punitive
  8. The companion grows up with you — from Dora-style friend to research partner

Atlas Ecosystem

CodenameProject
Atlas (Cortex)Self-evolving personal AI
AthenaNexus Academy — this game
ApolloContextForge — context window manager
HermesSatellite speakers (Pi/ESP32)
IrisComputer vision system

License

MIT — © 2026 DigitalBrainstem / Derek Thomas

About

Project Athena — Nexus Academy adaptive learning game. Ages 2-24. Powered by Atlas.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages