Skip to main content

grok-faf-voice | VML • Voice Memory Layer for Grok • Persistent across sessions, devices, models • LiveKit-enabled

Project description

grok-faf-voice

PyPI Python License Tests

Voice agents that remember.

The Voice Memory Layer (VML) for Grok Voice. .fafm 🐘🎙️ LiveKit enabled.


The Fast⚡️AF memory setup

pip install grok-faf-voice
from grok_faf_voice import VoiceAgent

VoiceAgent().run()

That's it. First run, your agent gets a namepoint — your @handle for FAF memory. Auto-generated free, no email needed. Want a branded handle tied to your email (or your X username)? Claim one anytime at mcpaas.live/voice/setup — one per valid email address.


What you need

That's it. Namepoint and Voice key are provisioned for you.

Run it:

python my_bot.py console

console mode talks locally — no LiveKit cloud needed. Deploy to LiveKit later via python my_bot.py start.


How it works

  • The agent listens via xAI realtime — five built-in voices: Ara · Eve · Leo · Rex · Sal
  • Every session opens already remembering what was etched in past ones
  • At session end, new memories consolidate silently
  • Cross-session, cross-device, cross-model — your namepoint is the address

Voice swappable, memory permanent. ElevenLabs and Hume land in upcoming releases.


Custom Voices

xAI shipped Custom Voices on 2026-05-01. We shipped support 48h later.

from grok_faf_voice import CustomVoiceClient, VoiceAgent

# Clone a voice from a 90-120s WAV sample
cv = CustomVoiceClient()  # uses $XAI_API_KEY
voice = cv.create_voice("sample.wav", name="My Clone", language="en")

# Use the cloned voice in your agent — same two-line shape
VoiceAgent(voice=voice["voice_id"]).run()

Custom voice IDs (8-char lowercase alphanumeric, e.g. nlbqfwie) flow through VoiceAgent(voice=...) unchanged. The 30 free voices via console.x.ai work too — paste the voice_id and go.


Want more?

Claim your branded @handle mcpaas.live/voice/setup
Advanced setupFAFMemory, FAFContext, custom ledgers, env-var configuration, retention tiers mcpaas.live/voice/about
Source + issues github.com/Wolfe-Jam/grok-faf-voice
Contribute CONTRIBUTING.md

We are the Open-Ended answer to Voice memory, and don't you Forget It. We won't.

.fafm 🐘🎙️ · application/vnd.fafm+yaml (IANA registration planned) · part of the FAF.one family · MIT licensed

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

grok_faf_voice-0.2.2.tar.gz (70.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

grok_faf_voice-0.2.2-py3-none-any.whl (47.4 kB view details)

Uploaded Python 3

File details

Details for the file grok_faf_voice-0.2.2.tar.gz.

File metadata

  • Download URL: grok_faf_voice-0.2.2.tar.gz
  • Upload date:
  • Size: 70.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for grok_faf_voice-0.2.2.tar.gz
Algorithm Hash digest
SHA256 239ff9c67ead076adac85bee710b79f6ddb4c897f202083751e9865840e92009
MD5 8258a8cac540df8eba77ae38f40a4aff
BLAKE2b-256 52578530991b5f764c9f2b1d1619789f81083df2e43dbcef5492f67090eca47b

See more details on using hashes here.

File details

Details for the file grok_faf_voice-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: grok_faf_voice-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 47.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for grok_faf_voice-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 03de3e2c789a89b295fe6bf84c67057b14eb77451aec5d87b82c3a3ea86bb2e1
MD5 c91b0cab4eacfcb73653233275868361
BLAKE2b-256 cbc6bdf8ea31d78ebfa69cb1d48906254995b7afac0a0278ad3e175bb518d302

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page