Get started — grok-faf-voice

The Voice Memory Layer (VML) for Grok Voice. LiveKit enabled.

.fafm 🐘🎙️ — the voice variant of the .faf 🐘 family.

Five minutes from a fresh terminal to a voice agent that remembers across sessions.

v0.1.2 · Python 3.10+ · MIT

System requirements

Four keys. Get them once, paste into .env.

XAI_API_KEY
LIVEKIT_URL
LIVEKIT_API_KEY
same LiveKit project dashboard
LIVEKIT_API_SECRET
same LiveKit project dashboard

+ One namepoint your soul address

Where your agent's memories live. Free tier: name + 2 digits:

james77 · amy123 · atlanta96

Premium tiers (paid): 3-letter $9, 4+ letters $2. Claim yours at mcpaas.live, then set FAF_SOUL=<your-namepoint> in .env.

The namepoint is your etch destination — not a token. Reads against public souls (grok, faf, nelly, spacex) work today without any auth.

Voice API key COMING SOON

A free Voice API key flow is launching on mcpaas.live. Once shipped, set MCPAAS_API_KEY=<your-voice-api-key> in .env and your namepoint becomes write-capable.

Until then, FAFMemory is read-only against public souls — useful for exercising the recall path. Don't use the paid /slash/dashboard tokens for Voice writes; that's the Slash API gateway product, separate path.

The four steps

1

Clone + venv

git clone https://github.com/Wolfe-Jam/grok-faf-voice
cd grok-faf-voice
python3 -m venv .venv && source .venv/bin/activate
2

Install + configure

pip install -e ".[dev]"
cp .env.example .env       # paste your 4 keys + namepoint
3

Verify with WJTTC

./scripts/wjttc.sh             # BRAKE + ENGINE + AERO (default)
./scripts/wjttc.sh --tyres     # + live probes against xAI + MCPaaS

Green across every tier = your setup is healthy. Red on a tier tells you which layer broke. WJTTC.md explains what each tier guards against.

4

Talk to your agent

python examples/hello_grok_with_etch.py console

In the voice loop, try:

"Etch this — first contact verified."

Close the session. Restart. Then ask:

"What do you remember?"

The agent recalls — that's the cross-session loop, persisted to your namepoint via MCPaaS.

Today vs. coming releases

Today (v0.1.2)

Beyond onboarding

CONTRIBUTING.md →
PR conventions, code style, architecture rules, contract pin discipline
WJTTC.md →
F1-inspired four-tier test regime spec — BRAKE / ENGINE / AERO / TYRES
README →
Architecture, primitives, Tool Latency Budget, Context Bus event vocabulary