# svelte-elevenlabs

> An independent, MIT licensed Svelte 5 library for ElevenLabs Conversational AI. One controller owns the browser side of a session: the WebSocket handshake, microphone capture, agent playback, transcripts, client tools, signed URLs, and teardown.

This file is a compact map for language models and coding agents. The complete reference, including every option, controller field, method, error code, and deployment note, is at https://gabryca.github.io/svelte-elevenlabs/llms-full.txt.

- Package: svelte-elevenlabs
- Version: 0.6.1
- License: MIT
- Peer dependency: Svelte 5
- Session runtime: browser with WebSocket, and Web Audio for voice
- Server runtime: Node 22.17 or newer, or Bun 1.4 or newer

## Start here

- [Install](https://gabryca.github.io/svelte-elevenlabs/docs/install): requirements, package setup, server key, and Tailwind 4 discovery.
- [Quickstart](https://gabryca.github.io/svelte-elevenlabs/docs/quickstart): a first voice session in one Svelte component.

## Guides

- [Sessions](https://gabryca.github.io/svelte-elevenlabs/docs/sessions): voice and text sessions, mute, feedback, transcripts, and controller lifecycle.
- [Audio](https://gabryca.github.io/svelte-elevenlabs/docs/audio): supported formats, capture, playback, devices, and analyser data.
- [Client tools](https://gabryca.github.io/svelte-elevenlabs/docs/client-tools): named tools, provider scoped tools, and MCP approvals.
- [Components](https://gabryca.github.io/svelte-elevenlabs/docs/components): the visualizer, widget, provider, and theme variables.
- [Signed URLs](https://gabryca.github.io/svelte-elevenlabs/docs/signed-urls): the server exchange contract and deployment checklist.

## Tooling

- [Agent kit](https://gabryca.github.io/svelte-elevenlabs/docs/agents): install one reviewed guide for Claude Code, Cursor, OpenCode, Copilot, Windsurf, Cline, Gemini CLI, and other coding agents.
- [Agent guide source](https://github.com/GABRYCA/svelte-elevenlabs/blob/main/agent-kit/instructions.md): canonical Markdown used by the installer.

Install the guide in a project with `bunx svelte-elevenlabs agents install` or `npx svelte-elevenlabs agents install`. The command detects configured tools, keeps shared files intact, and writes only local Markdown.

## Reference

- [API reference](https://gabryca.github.io/svelte-elevenlabs/docs/reference): options, reactive controller fields, methods, and public types.
- [Troubleshooting](https://gabryca.github.io/svelte-elevenlabs/docs/troubleshooting): error codes, browser limits, and common fixes.
- [Full reference](https://gabryca.github.io/svelte-elevenlabs/llms-full.txt): the complete source text in one Markdown file.

## Project

- [Human documentation](https://gabryca.github.io/svelte-elevenlabs/docs): the rendered documentation site.
- [Live demo](https://gabryca.github.io/svelte-elevenlabs/demo): the ConversationWidget running against a live agent, with a focus view.
- [Source](https://gabryca.github.io/GABRYCA/svelte-elevenlabs): repository, issues, and release notes.
- [npm package](https://www.npmjs.com/package/svelte-elevenlabs): published package.