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

# Desi Vocal

> Reference the retired DesiVocalTools adapter and migrate text-to-speech agents to an active provider.

**DesiVocalTools** is a legacy adapter for converting text to speech with Indian voices through the DesiVocal API.

<Warning>
  DesiVocal sunset its public service on June 30, 2026, and disabled new purchases. Do not start a new integration with this toolkit. Migrate to [ElevenLabsTools](/tools/toolkits/others/eleven-labs) or [CartesiaTools](/tools/toolkits/others/cartesia). See the [DesiVocal sunset notice](https://www.desivocal.com/pricing).
</Warning>

## Legacy Prerequisites

The following reference applies only to accounts for which DesiVocal has arranged continued API support. It requires the `openai` and `requests` libraries, a DesiVocal API key, and an OpenAI API key for the agent's default model.

```shell theme={null}
uv pip install openai requests
```

```shell theme={null}
export DESI_VOCAL_API_KEY=***
export OPENAI_API_KEY=***
```

## Legacy Example

The following agent can convert text to speech using Indian voices:

```python theme={null}
from agno.agent import Agent
from agno.tools.desi_vocal import DesiVocalTools

agent = Agent(
    instructions=[
        "You are a text-to-speech assistant that converts text to natural Indian voices",
        "Help users generate audio from text using various Indian accents and languages",
        "Provide information about available voices and their characteristics",
        "Create high-quality audio content for users",
    ],
    tools=[DesiVocalTools()],
)

agent.print_response("Convert this text to speech: 'Namaste, welcome to our service'", stream=True)
```

## Toolkit Params

| Parameter               | Type            | Default                                  | Description                                                |
| ----------------------- | --------------- | ---------------------------------------- | ---------------------------------------------------------- |
| `api_key`               | `Optional[str]` | `None`                                   | Desi Vocal API key. Uses DESI\_VOCAL\_API\_KEY if not set. |
| `voice_id`              | `Optional[str]` | `"f27d74e5-ea71-4697-be3e-f04bbd80c1a8"` | Default voice ID to use for text-to-speech.                |
| `enable_get_voices`     | `bool`          | `True`                                   | Enable voice listing functionality.                        |
| `enable_text_to_speech` | `bool`          | `True`                                   | Enable text-to-speech conversion functionality.            |
| `all`                   | `bool`          | `False`                                  | Enable all functionality when set to True.                 |
| `timeout`               | `int`           | `30`                                     | Request timeout in seconds for API calls.                  |

## Toolkit Functions

| Function         | Description                                                   |
| ---------------- | ------------------------------------------------------------- |
| `get_voices`     | Retrieve list of available voices with their IDs and details. |
| `text_to_speech` | Convert text to speech using specified or default voice.      |

## Developer Resources

* [Tools Source](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/desi_vocal.py)
* [DesiVocal sunset notice](https://www.desivocal.com/pricing)