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

# Desi Vocal

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

DesiVocalTools is a legacy text-to-speech adapter for Indian languages.

<Warning>
  DesiVocal sunset its public service on June 30, 2026, and disabled new purchases. Do not start a new integration with this example. 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>

## Prerequisites

* Install dependencies: `uv pip install agno openai requests`.
* Export your DesiVocal API key: `export DESI_VOCAL_API_KEY=your_api_key`.
* Export your OpenAI API key: `export OPENAI_API_KEY=your_openai_key`.

```python theme={null}

from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools.desi_vocal import DesiVocalTools

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------


audio_agent = Agent(
    model=OpenAIChat(id="gpt-4o"),
    tools=[DesiVocalTools()],
    description="You are an AI agent that can generate audio using the DesiVocal API.",
    instructions=[
        "When the user asks you to generate audio, use the `text_to_speech` tool to generate the audio.",
        "You'll generate the appropriate prompt to send to the tool to generate audio.",
        "You don't need to find the appropriate voice first, I already specified the voice to user.",
        "Return the audio file name in your response. Don't convert it to markdown.",
        "Generate the text prompt we send in hindi language",
    ],
    markdown=True,
)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    audio_agent.print_response(
        "Generate a very small audio of history of french revolution"
    )
```

## Legacy Setup

These commands apply only to accounts for which DesiVocal has arranged continued API support.

```bash theme={null}
# Clone and setup repo
git clone https://github.com/agno-agi/agno.git
cd agno

# Create and activate virtual environment
./scripts/demo_setup.sh
source .venvs/demo/bin/activate

python cookbook/91_tools/desi_vocal_tools.py
```

For details, see [Desi vocal cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/91_tools/desi_vocal_tools.py).