mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-10-02 02:11:20 +00:00
b5d468b06e
With the dynamic schedule a captured call took 10 to 20 minutes to become memories, so a caller who rang back right away was not recalled. Capture now defaults to dreaming="instant": on LiveKit Cloud a call's content was recallable 19 seconds after it ended, and the callback answered from it. Each capture write bills one extra operation. When the organization has no balance for instant processing (HTTP 402), capture and remember fall back to the dynamic schedule for the rest of the call instead of failing. capture_dreaming="dynamic" keeps the old behaviour.
38 lines
1.7 KiB
Markdown
38 lines
1.7 KiB
Markdown
# Voice agent example
|
|
|
|
A LiveKit voice agent that remembers each caller. Tell it something on one call, hang up, and it knows it on the next.
|
|
|
|
## Setup
|
|
|
|
```bash
|
|
pip install supermemory-livekit python-dotenv
|
|
cp .env.example .env
|
|
```
|
|
|
|
Fill in `.env` with your LiveKit Cloud project keys and a [Supermemory API key](https://console.supermemory.ai). LiveKit Inference provides speech-to-text, the LLM, and text-to-speech, so no other keys are needed.
|
|
|
|
From a checkout of this repo, install the local package instead: `pip install -e .. python-dotenv`.
|
|
|
|
## Talk to it
|
|
|
|
In your terminal, through your mic:
|
|
|
|
```bash
|
|
python voice_agent.py console
|
|
```
|
|
|
|
In the browser: run `python voice_agent.py dev`, open the [Agents Playground](https://agents-playground.livekit.io), and connect to your project.
|
|
|
|
## Try memory
|
|
|
|
1. Say "My name is Priya, and please remember I'm vegetarian."
|
|
2. Hang up and start a new call.
|
|
3. The agent welcomes you back. Ask "What should I order for dinner?"
|
|
|
|
Memory is scoped per caller:
|
|
|
|
- Console mode uses the container tag `console_user`.
|
|
- In rooms, the agent uses the participant attribute `supermemory_container_tag`, or else the participant identity. The Playground gives each session a new identity, so set `SUPERMEMORY_CONTAINER_TAG` in `.env` to keep one caller across Playground calls.
|
|
- In production, dispatch the agent from your backend with `{"container_tag": "<your user id>"}` as job metadata, and set `LIVEKIT_AGENT_NAME`.
|
|
|
|
Each call is stored as one document and is usually recallable within a minute, see [when a call becomes recallable](https://supermemory.ai/docs/integrations/livekit#when-a-call-becomes-recallable). See the [integration docs](https://supermemory.ai/docs/integrations/livekit) for configuration.
|