sarvamai/skills

sarvamai/skills

Description: A curated set of practical skills and examples for building AI applications using Sarvam APIs.

License: Apache-2.0

Stars: 63

Forks: 9

Open issues: 0

Created: 2026-02-04T12:49:56Z

Pushed: 2026-03-13T14:07:07Z

Default branch: main

Fork: no

Archived: no

README: Sarvam AI Skills

Full-stack AI for Bharat

Documentation • Get API Key • Agent Skills Spec

---

About

LLMs have fixed knowledge from their training cutoff. Sarvam AI's SDK has unique patterns that differ from standard conventions — method names that break expectations (client.text.translate() not client.translate.translate()), parameters that silently fail (output_script on sarvam-translate), and response quirks (content being None when reasoning consumes the token budget).

These skills bridge that gap. Each one gives AI coding assistants the exact SDK signatures and gotchas they need to generate correct Sarvam AI code, then routes to llms.txt for detailed documentation.

Skills

| Skill | Description | |-------|-------------| | [chat](./chat) | Chat completions with Sarvam-105B/30B. Python & JS/TS quick starts, streaming, reasoning mode, OpenAI-compatible path, and the content=None gotcha. | | [speech-to-text](./speech-to-text) | Audio transcription with Saaras v3. Python & JS/TS quick starts, Batch API (long audio + diarization), and WebSocket streaming for 23 languages. | | [text-to-speech](./text-to-speech) | Speech synthesis with Bulbul v3. Python & JS/TS quick starts, HTTP stream, WebSocket, pronunciation dictionaries, and unsupported parameter warnings. | | [translate](./translate) | Text translation with Sarvam-Translate v1 and Mayura v1. Python & JS/TS quick starts, model feature differences, and silent parameter failures. | | [voice-agents](./voice-agents) | Real-time voice agents with LiveKit and Pipecat (Python). JS/TS SDK reference for custom pipelines. |

Installation

# Install all skills
npx skills add sarvamai/skills

# Install a specific skill
npx skills add sarvamai/skills --skill chat

# Browse skills interactively
npx skills add sarvamai/skills --list

# Setup
export SARVAM_API_KEY="your-api-key" # get at dashboard.sarvam.ai
pip install sarvamai # Python
npm install sarvamai # JavaScript/TypeScript

Works with Cursor, Claude Code, Windsurf, and any agent that supports the Agent Skills specification.

How It Works

skill/SKILL.md ← SDK signatures + gotchas (what agents get wrong)
│
▼
llms.txt ← Always-fresh comprehensive docs index
│
▼
Full API docs, OpenAPI spec, cookbooks, voice catalog, streaming protocols...

Each skill is a lean correction layer with both Python and JavaScript/TypeScript SDK snippets — it contains only what AI agents are likely to get wrong when generating Sarvam AI code:

• SDK call signatures that differ from conventions (e.g., no .create() on chat)
• Parameters that silently fail (e.g., output_script ignored on sarvam-translate)
• Parameters that error (e.g., pitch/loudness returns 400 on Bulbul v3)
• Non-trivial SDK patterns (e.g., Batch API job chain, WebSocket async connect)

For everything else — full parameter tables, voice catalogs, language codes, rate limits, cookbook examples — the skill points to llms.txt, which is always up to date.

Links

• API Documentation
• llms.txt
• Dashboard
• Cookbook
• Discord
• GitHub

License

Apache-2.0