{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "xzf-thu-voicemem--try-voicemem-voice-demo-locally",
 "repo": "xzf-thu/VoiceMem",
 "repo_url": "https://github.com/xzf-thu/VoiceMem",
 "repo_slug": "xzf-thu-voicemem",
 "title": "Run the Voice Mem voice demo in a browser",
 "page_title": "How to run the Voice Mem voice demo in a browser with Voice Mem",
 "summary": "Start the local web demo and talk to a voice agent that remembers what you said.",
 "who": "A developer or product person who wants to see the streaming voice memory working before building on it.",
 "problem": "Reading about a streaming memory architecture does not show how memory is retrieved before the speaker finishes a sentence.",
 "outcome": "A local web page at localhost:8787 where you speak, see transcripts, and check that a stated fact is recalled in a later turn.",
 "steps": [
  "Clone the repo, install with `pip install voicemem`, and download models with `hf download zhifeixie/VoiceMem_Default_Models_Env --local-dir ./models`.",
  "Run `python web/run.py` from the repo folder.",
  "Open http://localhost:8787 in a browser and unmute the audio before playback.",
  "Say a fact about yourself, then ask a question about it in a later turn and check the reply."
 ],
 "agent_prompt": "In the VoiceMem repo at <repo path>, start python web/run.py and open http://localhost:8787. Ask the user to state a fact, then to ask about it. Expected output is a reply that uses the stated fact. Verify the log file in results/logs was written.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "45 minutes",
 "basis": "readme",
 "caveat": "The demo needs a microphone and browser audio permissions, and the README warns that playback needs audio unmuted.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "python",
 "requirements": [
  "Python 3.10 or newer",
  "An OpenAI API key, used for fact extraction when memories are written",
  "Git and access to GitHub and Hugging Face to clone the repo and download the default models",
  "Audio input (a WAV file or a microphone) if you want to ingest speech"
 ],
 "risk": "sensitive",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.7,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/xzf-thu-voicemem/try-voicemem-voice-demo-locally/",
 "md": "https://dedupedai.com/use-cases/xzf-thu-voicemem/try-voicemem-voice-demo-locally/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/xzf-thu-voicemem--try-voicemem-voice-demo-locally.json",
 "api_version": "v1"
}