# swaram.live

> Real-time Malayalam voice API. Send a user's voice over one WebSocket and hear natural Malayalam stream back. Two opaque modes (Simple, Premium); OpenAI-Realtime-compatible event protocol; bring your own instructions and tools.

## Docs

- [Introduction](https://swaram.live/docs/index.md): What swaram is, the base URL, and the two modes.
- [Quickstart](https://swaram.live/docs/quickstart.md): Connect, configure a session, stream audio, play the reply (Python/Node/browser).
- [Authentication](https://swaram.live/docs/authentication.md): Server-side secret keys and short-lived browser tokens.
- [Sessions & context](https://swaram.live/docs/sessions.md): Configure instructions, voice, and tools at the start of a session.
- [Function calling](https://swaram.live/docs/tools.md): Give swaram tools to act on; the call/return round-trip (Python/Node/browser).
- [Audio](https://swaram.live/docs/audio.md): PCM16 24 kHz mono base64 audio in and out; chunking, playback, and echo cancellation.
- [Transcripts](https://swaram.live/docs/transcripts.md): Read the text of what the user said and what swaram said back.
- [Turn-taking & barge-in](https://swaram.live/docs/turn-taking.md): Automatic turns, interrupting a reply, and sending only the user's voice (client VAD / push-to-talk).
- [Events reference](https://swaram.live/docs/events.md): Every client and server event, plus close codes.
- [Errors](https://swaram.live/docs/errors.md): Error events, close codes, and reconnection.
- [FAQ](https://swaram.live/docs/faq.md): Common questions about modes, languages, billing, and data.