> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-update-deprecated-models.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Desi Vocal

> DesiVocalTools provides text-to-speech capabilities using Indian voices through the Desi Vocal API.

## 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.            |

## 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

* View [Tools Source](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/desi_vocal.py)
* [Desi Vocal API Documentation](https://desivocal.com/docs)
* [Indian TTS Best Practices](https://desivocal.com/best-practices)