Obscurum AI
Getting started

Quickstart

Build and test the brain, scaffold a per-game config bundle, and estimate voice cost.

These commands get the brain building, the test suite green, and a per-game config bundle scaffolded — all without a running game server. For the full path to bots alive in-client, follow the Live bring-up guide.

Brain — build + full test suite

The reactive core is deterministic and needs no network or GPU.

cd obscurum-ai/brain
RUSTC_WRAPPER="" cargo test --features "sim server llm-http"
cargo run --example personas            # see rolled personalities + a live snap

RUSTC_WRAPPER

Build with RUSTC_WRAPPER="" so a globally-configured wrapper (e.g. sccache) doesn't interfere with the brain's feature-gated compilation.

Config — scaffold a per-game server bundle

python3 ops/tools/voice/obsconfig.py games
python3 ops/tools/voice/obsconfig.py init --game dayz --preset hardcore-pvp --out ./serverconfig

The bundle is the single source of truth: it drives flavor, population, economy, voice and policy. Its shape mirrors the Rust ConfigBundle — see the API reference.

Voice — estimate cached base-set cost

Estimate the cached base-set cost before spending anything on TTS:

python3 ops/tools/voice/base_set.py estimate --langs en,ru,de --voices 3

Landing page

open web/index.html

Introduction

An overview of Obscurum AI — the idea, the architecture, and what the survivors can do.

Live bring-up

Take the bots from tested logic to alive on a server — the full runbook.

On this page

Brain — build + full test suiteConfig — scaffold a per-game server bundleVoice — estimate cached base-set costLanding page