Welcome
Documentation for Obscurum AI — AI survivors indistinguishable from human.
Obscurum AI
AI survivors, indistinguishable from human. Obscurum populates a survival-game server with AI players that talk, remember, get tired, panic, hold grudges and team up — live, over proximity voice. To the people in the server, they're just other survivors.
Obscurum is a clean-room, game-agnostic AI-NPC brain. The reactive core runs deterministically with no network or GPU; a deliberative LLM tier and a full voice pipeline layer on top, every part optional and configurable from a single source of truth.
Where to start
Introduction
What Obscurum is, the idea, and what the survivors can do.
Live bring-up
Take the bots from tested logic to alive on a server.
Architecture
The clean-room four-layer stack and build plan.
API reference
The control-plane API contract for sidecars and dashboards.
The thesis
Most game bots are state machines reading canned lines. Obscurum's survivors are rolled from a full psychological model and behave like a real human at a keyboard — and they speak and listen over the game's own proximity voice. The product's whole thesis: you can't tell which survivors are AI.