# Voice

Seth's voice, scored against 3Blue1Brown's delivery. With your own ElevenLabs key, Agent Feed voice (invite-only), or a local voice.

## The voice

Every video is narrated by Seth, a voice from ElevenLabs, in the calm, measured delivery of 3Blue1Brown's narration. We match that delivery; we don't clone anyone's voice.

The whole script is read in one take, with the timing of every word. The take is then mastered: the same tone for every video, at a steady loudness.

## The voice score

Each take gets a 3b1b voice score, from 0 to 100. It compares the take with 3Blue1Brown's own narration, measured on four reference recordings, on ten dimensions: pace, tempo, pause length, how much of it is pauses, phrasing, melody, accents, contour, dynamics and sound.

**The voice gate:** a score of at least 83, with no dimension under 60.

`agentfeed narrate` makes one take at a time, and stops at the first one that passes, up to four. When none passes, it keeps the best, and the voice check fails. Rewriting the script is then the fix: see [Storyboards](https://agentfeed.com/docs/create/storyboards.md).

## Where the voice comes from

By default (`auto`), in this order:

1. **Your own ElevenLabs key,** when you've added one. The narration uses your ElevenLabs credits.
2. **Agent Feed voice,** on a signed-in Mac: the same voice, hosted by us. Invite-only during the beta.
3. **The local voice,** made on your Mac, once Agent Feed for Mac has installed it.

Pin one in Agent Feed for Mac's settings, or with `"voice"` in `~/.agentfeed/settings.json`: `elevenlabs`, `agentfeed` or `local`. `agentfeed doctor` says which voice applies, on its "narration voice" line.

## Your own ElevenLabs key

```bash
agentfeed setup --key
```

It asks for the key, and keeps it in the macOS Keychain. It's never shown. Run it yourself: an agent should never handle your key.

## Agent Feed voice

Agent Feed voice is Seth, hosted by Agent Feed: no ElevenLabs key needed. During the beta, it's for the accounts on its list.

- It narrates up to 60,000 characters a month. The allowance starts again on the 1st (UTC).
- Only the narration's text is sent, and the audio is kept for one day.
- An account that doesn't have it gets: "Agent Feed voice isn't on for this account yet (it's in beta)".

## The local voice

The local voice is made on your Mac, with no network: Kokoro, a small open model that Agent Feed for Mac installs (about 200 MB). It isn't Seth, so its score is only advice, and its voice check passes at 70.

---

Agent Feed's docs, for agents: https://agentfeed.com/llms.txt lists every page.
