Sleeptalk

Reference

Support and release status

What version 0.1 supports, what is preview, and how a release is checked.

Current release

Version 0.1.0 was published on October 31, 2026. Install it from PyPI in a Python 3.11+ environment, as in the Quickstart. The GitHub release also provides the wheel, installer, dependency constraints, and checksums. The release changelog describes its features and security changes.

Supported

AreaSupported in 0.1
OSCurrent macOS and current Ubuntu
Python and installation3.11 or newer; PyPI or the GitHub release bundle
RouteCascade, or GPT Realtime: OpenAI handles voice and delegates specialist work to your agent. Realtime has recorded live checks in terminal and browser calls; Discord is preview.
Background workEligible Cascade agents: three concurrent workers by default, additional jobs queue; jobs end with the call
SurfacesBrowser call, Terminal audio, Discord voice channel
Browser deliveryHosted relay (30-minute limit, announced), your tailnet with --tailnet, or a browser on the same machine
Agentspi, Hermes, Cursor, Codex, Claude Code, and oh-my-pi; OpenClaw remains preview
No agentJust a model: OpenRouter, OpenAI, Anthropic, Ollama, or an OpenAI-compatible endpoint
SpeechDeepgram, Cartesia, ElevenLabs, OpenRouter, Venice, Groq, Together, OpenAI Realtime, or Local
Local speechStreaming Moonshine Small with Kokoro, Piper, or Pocket TTS; English, CPU only, models downloaded separately
Key entryThe wizard's masked prompt, or the settings page: on this computer, or on a phone through a single-use sealed link
Setup by an agenthost ensure (offers a found key, reused only on the user's yes), host input link, host start-voice; keys never pass through the agent
Languageen-US by default; other languages follow the profile's language setting

Supported means the adapter or surface is registered, covered by automated tests, and used as a product path. It does not certify every combination of agent login, OS, workspace, and destination. The support matrix defines those paths; the release decision above records the verification limits at publication.

Preview

  • Custom agents: command, HTTP, bridge, and plugin adapters are community-supported. Sleeptalk supports the contract, the scaffolds, and sleeptalk adapter test; it does not certify your agent.
  • GPT Live: a separate browser-only integration with continuous listening, speech, and background workers on eligible agents. Terminal and Discord reject this route; broader live validation remains open.
  • OpenClaw: gateway and ACP integrations with onboarding and permission limits.
  • GPT Realtime in Discord: implemented, but not checked live.
  • Any other adapter, language tag, or OS.

Not in scope

Accounts, billing, credits, provider resale, a single Sleeptalk key, Windows as a supported OS, native mobile or desktop apps, telephony, and multi-user rooms.

How a release is checked

The release checklist defines these human acceptance scenarios. They are not a list of completed checks for 0.1.0; its unverified checks are recorded in the release decision above:

  1. A fresh install from the README on a clean macOS user.
  2. Setup by an agent from the README prompt, with a phone settings link and no key in chat.
  3. Key reuse on a host whose agent has an OpenRouter key: host ensure offers the key, and --reuse-key uses it after the user says yes.
  4. A hosted call from a phone on mobile data: audio both ways, the transcript, and a voice change from the call menu.
  5. A tailnet call from a VPS to a phone.
  6. A same-machine call with sleeptalk link.
  7. A Discord bot that answers its operator and ignores anyone else.
  8. A Terminal call with an interruption.
  9. The settings page: change voice, speech service, and delivery.
  10. A sleeptalk service install that survives a reboot.

Live microphone, Discord speech, and service restart checks are done by a person. Automated output does not replace them. See the release checklist.

Builds and versions

PyPI and the v0.1.0 tag provide the plain 0.1.0 version. Development wheels from CI carry a local version label such as 0.1.0+ci.123; they are separate from the public release. The release proof builds the wheel and source archive, checks their contents, and installs into a blank environment. Use the release bundle's constraints when you need the dependency versions tested for that release.

Get help

Open an issue on GitHub if your setup is not in the support matrix or something breaks. Report security problems privately, as described in the security policy.