Sleeptalk docs

Install the PyPI release, choose a voice mode, and start a conversation with your agent.

Compare Cascade and Local speech, GPT Realtime, and the separate GPT Live browser preview.

Use an agent that can execute commands on the runtime host to install Sleeptalk and configure a call.

Make a voice call directly to a model without installing an agent framework.

Configure speech-to-text (STT) and text-to-speech (TTS) with one provider or separate providers.

Curated voices per provider, native voices per language, samples you can hear without a key, and changing the voice mid-call.

Streaming Moonshine with Kokoro, Piper, or Pocket TTS on the host. No speech key; add a local model for an offline call.

An OpenAI voice model handles conversation and delegates specialist work to your configured agent.

Continuous listening and speech with your agent handling specialist work; browser-only preview.

Choose a transcription model and voice that cover your language, then verify a complete spoken exchange.

Select the runtime Sleeptalk uses to handle requests and operate in your workspace.

Keep agent login, model access, speech credentials, and call access separate.

Change agent, speech, voice, language, delivery, and behavior from the settings page, the terminal, or the call.

Locate saved configuration, understand workspace binding, and replace credentials without exposing their values.

What an agent needs for Sleeptalk to drive it, when you write an adapter, and how a setup agent wires one up.

Talk to the Hermes installed on your host, over ACP or through a Hermes dashboard.

Talk to Codex through a Codex App Server thread, with structured tool activity and approval requests.

Talk to Claude Code through the Claude Agent SDK, with tool results, permission callbacks, and task lifecycle events.

Talk to Cursor's coding agent through its command-line tool over ACP, or through the Cursor Python SDK with an API key.

Sleeptalk's built-in default agent, run as a persistent RPC subprocess that streams replies, reports tools, and controls the active turn.

Talk to oh-my-pi through Pi's RPC event mapping, with an isolated SDK launcher when tool approvals stay with the caller.

Talk to OpenClaw through its gateway, with openclaw acp as a fallback; support is in preview.

Start a browser, Terminal, or Discord call using the profile saved for your workspace.

Speak through the microphone and audio output attached to the runtime machine.

Connect a dedicated Discord bot to a private voice channel and authorize the people who can use your workspace.

Use a browser microphone while the agent and workspace stay on the runtime host.

Deliver browser calls over Tailscale with tailscale serve: no relay, no TURN, no time limit.

Sleeptalk detects speech, decides when a turn is complete, and handles interruptions as separate decisions.

Keep talking while several agent tasks run, ask for progress, steer a named job, and hear the result.

The selected agent runs tools and delegates work. Sleeptalk turns the events it receives into call status and spoken updates.

Inspect the current attempt before retrying a lost or failed call start.

Keep runtime ownership, persistent services, and hosted call infrastructure separate.

Connect an ACP agent, local command, HTTP service, Agent Bridge server, or Python plugin.

Extend Sleeptalk through registered components and the documented agent contracts.

Install the development dependencies for the component you want to change.

Find the implemented command for setup, inspection, call control, or adapter development.

How Cascade, GPT Realtime, GPT Live, and background workers connect voice to your agent and workspace.

Where your keys are stored, which pages can take them, and which services see a call.

Find the message or symptom below, then check the profile and agent it applies to before repeating setup.

Sleeptalk 0.1.0 on PyPI and GitHub, supported paths, preview features, and release validation limits.

Use the guide for setup and operation, then follow the source references for detailed contracts.