> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sanas.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview of Sanas

> Get started building with real-time speech AI using the Sanas SDK

## What is Sanas SDK?

The Sanas SDK processes speech audio in real time. You feed it audio frames and it returns processed audio frames — for example noise-cancelled, speech-enhanced, or accent-converted speech, or speech translated into another language.

With **audio processing** (things like noise cancellation, speech enhancement, and accent conversion), you pick the specific model you want and the system cleans up or transforms the audio almost instantly.<br />**Language Translation** works a little differently. Instead of choosing a model, you just tell it the language someone is speaking and the language you want them heard in. Behind the scenes it does three jobs — transcribes the speech, translates it, and re-speaks it in the target language — and hands you back both the translated audio and a text transcript. Because it's doing all three steps, it takes a few seconds longer than the audio-processing features, so it's best suited to conversations where a slight delay is fine.

> **The good news: setting it up is the same either way. The connection, activation, and start-up steps are identical — Language Translation just needs the language settings instead of a model choice.**

The Python package ships as a **self-contained wheel**: everything the SDK needs is bundled inside it, so there is no separate native library to install or manage. You just create a virtual environment and `pip install` the wheel. You work with **interleaved float32 PCM** audio: push frames in with `process_frame` and read processed frames back. The SDK does not open microphones or speakers for you — you bring your own audio (from a file, a socket, a media stream, etc.). Enterprise-ready with [security](/Docs/Enterprise/Security), [compliance](/Docs/Enterprise/Compliance-and-Data-Residency), and [support](/Docs/Enterprise/Support).

Sanas also offers a standalone [Language Translation API](/Docs/Language-Translation/Overview) for real-time speech-to-speech in the browser — if that's your use case, start there instead of the SDK.

## What can you do with the Sanas SDK ?

* **Audio processing** — run a model (speech enhancement, accent conversion,…) over your audio, selected by a model key.
* **Language Translation (LT)** — translate speech from one language to another and receive both translated audio and transcript segments.
* **Pipeline lifecycle** — an `audio_pipeline_state_notify` callback reports the processing pipeline state (`PipelineState`); wait for `RUNNING` before feeding frames.

**Audio processing vs. Language Translation.** The SDK supports two modes that differ in how you select them and what they return. **Audio processing** (speech enhancement, noise cancellation, accent conversion) is chosen by setting a **model key** on `AudioAttributes.model_name` — for example `SE2.2` or `AT5.2` — and returns processed audio frames with minimal latency.

**Language Translation (LT)** is selected instead by supplying a `LanguageTranslationConfig` (`lt_config`) and leaving `model_name` empty; you specify a source and target language rather than a model, and the pipeline returns both translated audio *and* transcript segments via a callback. Because LT runs speech-to-text, translation, and text-to-speech end to end, it carries higher latency than the audio-processing models, so plan for a longer buffer/drain window. Everything else stays the same: you use the identical `create_sdk` → `activate_api_key` → `create_audio_processor` flow and wait for `PipelineState.RUNNING` before feeding frames.

<Note>
  This describes Language Translation **inside the Python SDK** (`lt_config`). For real-time speech-to-speech in the browser, Sanas also offers a standalone [Language Translation API](/Docs/Language-Translation/Overview) — WebRTC / WebSocket / JavaScript client with an `init`/`configure` protocol. Use that instead of the SDK if you're building a web app.
</Note>

Key types: `InitParams`, `create_sdk`, `Sdk`, `AudioAttributes`, `ProcessorAttributes`, `AudioProcessor`, `AudioFrame`, `LanguageTranslationConfig`, `CloudInferencingParams`, `PipelineState`, `SdkResult`.

### How Audio processing works.

The Sanas SDK Connector sits between your application and Sanas Models, managing the connection to the inference engine. It sends input, receives processed output, and streams data in real-time using SIP (Session Initiation Protocol) and RTP (Real-Time Transport Protocol). The Sanas SDK can be deployed via [Sanas Cloud](/Docs/Deployment/Sanas-Cloud) (recommended) or [self-hosted](/Docs/Deployment/Self-Hosted) *(coming soon)* on your own infrastructure.

```mermaid theme={null}
graph LR
    A[Input] --> B[SDK Connector] --> C[Sanas Models] --> D[Output]
    style A fill:#F7F7F7,stroke:#E3E3E3,color:#242424
    style B fill:#44ECA0,stroke:#44ECA0,color:#000
    style C fill:#242424,stroke:#242424,color:#fff
    style D fill:#44ECA0,stroke:#44ECA0,color:#000
```

## Core Capabilities

<CardGroup cols={3}>
  <Card title="Speech Enhancement " icon="volume-slash" href="/Docs/Models/Human-Human/NC-Voice-Isolation">
    Isolate intended speech by removing background noise and voices — no quality degradation.
  </Card>

  <Card title="Speech Enhancement for Agentic Noise Cancellation" icon="robot" href="/Docs/Models/Human-Machine/Agentic-NC-Voice-Isolation">
    Clean audio before ASR/STT. Isolate primary speakers and reduce Relative Word Error Rate (RWERR).
  </Card>

  <Card title="Speech Enhancement with full-fidelity" icon="waveform-lines" href="/Docs/Models/Human-Human/SE-Standard">
    Reconstruct and restore speech quality degraded by compression and network conditions.
  </Card>

  <Card title="Live Language Translation" icon="globe">
    Real-time cross-language voice communication.
  </Card>

  <Card title="Accent Translation" icon="language">
    Convert accents while preserving voice identity.
  </Card>
</CardGroup>

<Note>
  Sanas currently offers Speech Enhancement (audio clarification), Accent Translation, and Language Translation. Speech Intelligence coming soon.
</Note>

## Available Models

<CardGroup cols={3}>
  <Card title="Voice Isolation (General)" icon="volume-slash" href="/Docs/Models/Human-Human/NC-Voice-Isolation">
    **`VI_G_SE3.0`** Isolates intended speech by removing background noise and voices. Optimized for human listeners.
  </Card>

  <Card title="Speech Enhancement · Standard" icon="microphone" href="/Docs/Models/Human-Human/SE-Standard">
    **`SE2.1`** Restores and enhances voice quality for telephony audio. Low CPU footprint.
  </Card>

  <Card title="Speech Enhancement · Full-Fidelity" icon="microphone" href="/Docs/Models/Human-Human/SE-Ultra">
    **`SE2.2`** Full-fidelity speech enhancement with bandwidth extension to ultra-fidelity 24kHz.
  </Card>

  <Card title="Agentic Speech Enhancement· Voice Isolation (General)" icon="robot" href="/Docs/Models/Human-Machine/Agentic-NC-Voice-Isolation">
    **`AGENTIC_VI_G_SE`** Removes background noise and distant voices for complete voice isolation of the primary speaker's audio stream.
  </Card>

  <Card title="Agentic Noise Clarification · Voice Isolation (Telephony)" icon="robot" href="/Docs/Models/Human-Machine/Agentic-NC-Voice-Isolation-Telephony">
    **`AGENTIC_VI_GT_SE`** Telephony-optimized variant of Voice Isolation for 8kHz narrowband audio.
  </Card>

  <Card title="Agentic Speech Enhancement · Standard" icon="robot" href="/Docs/Models/Human-Machine/Agentic-NC-Standard">
    **`AGENTIC_ST_SE`** Removes background noise while preserving all human speech for multi-speaker environments.
  </Card>

  <Card title="Accent Translation" icon="robot" href="/Docs/Models/Human-Machine/Agentic-NC-Standard">
    **`AT5.2`** Accent Translation modifies global accents in real-time, allowing your teams to be instantly understood while preserving what makes every voice unique.
  </Card>

  <Card title="Language Translation" icon="robot" href="/Docs/Models/Human-Human/Language-Translation/Language-Translation">
    [See LT Documentation](/Docs/Models/Human-Human/Language-Translation/Language-Translation) Real-time language translation that preserves your speakers' voices, tone, and intent.
  </Card>
</CardGroup>

See the [full model comparison →](/Docs/Models/Overview)

## What You Can Build

<CardGroup cols={2}>
  <Card title="Voice Agents" icon="robot">
    Enhance voice agent pipelines with real-time speech and audio processing for clearer, more accurate interactions.
  </Card>

  <Card title="Contact Centers" icon="headset">
    Power contact center audio at scale with concurrent stream processing and enterprise-grade reliability.
  </Card>

  <Card title="Conferencing & Gaming" icon="users">
    Deliver high-quality voice experiences across communication and interactive platforms.
  </Card>

  <Card title="STT Pipelines" icon="microchip">
    Improve speech-to-text accuracy by processing audio before it reaches your transcription engine.
  </Card>
</CardGroup>

## Key Features

<CardGroup cols={3}>
  <Card title="Real-Time Streaming" icon="bolt">
    **Low-latency processing** Live audio processing with SIP/RTP
  </Card>

  <Card title="High Concurrency" icon="layer-group">
    **Scalable solution** Process multiple audio streams simultaneously
  </Card>

  <Card title="Session Management" icon="link">
    **SIP protocol** Reliable connection establishment and management
  </Card>

  <Card title="Seamless Communication" icon="puzzle-piece">
    Enable clearer human-machine interactions across any environment
  </Card>

  <Card title="Easy Integration" icon="code">
    **Simple API** Initialize, create a processor, stream audio
  </Card>

  <Card title="Secure" icon="lock">
    **Enterprise security** Encrypted transmission, secure authentication
  </Card>
</CardGroup>

## Ready to Build?

Request your API keys and integration credentials, then use the Quick Start to start streaming clean audio in minutes.

<CardGroup cols={2}>
  <Card title="Sign up for account here " icon="key" href="https://share-na2.hsforms.com/1EScdGvwoQgqBiwZyic04dAczvqf">
    Get your [developer account](https://www.sanas.ai/developer-platform) to start building.
  </Card>

  <Card title="Quick Start" icon="rocket" href="/Docs/Getting-Started/Quick-Start">
    [Get up and running with Sanas SDK in under 5 minutes.](/Docs/Getting-Started/Quick-Start)
  </Card>
</CardGroup>

## Resources

<CardGroup cols={2}>
  <Card title="Pricing" icon="dollar-sign" href="/Docs/Resources/Pricing">
    [Usage-based pricing.](/Docs/Resources/Pricing)
  </Card>

  <Card title="Enterprise" icon="building" href="/Docs/Enterprise/Compliance-and-Data-Residency">
    Data residency, compliance, security, and support.
  </Card>

  <Card title="API Reference" icon="book" href="/API-Reference/Overview">
    Complete API documentation for the Sanas SDK.
  </Card>

  <Card title="Change Log" icon="clock-rotate-left" href="/Docs/Resources/Changelog">
    [Latest updates, releases, and fixes.](/Docs/Resources/Changelog)
  </Card>
</CardGroup>
