Prerequisites
uv pip install elevenlabs
import base64
from textwrap import dedent
from agno.agent import Agent
from agno.models.google import Gemini
from agno.tools.eleven_labs import ElevenLabsTools
from agno.utils.media import save_base64_data
# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------
audio_agent = Agent(
model=Gemini(id="gemini-2.5-pro"),
tools=[
ElevenLabsTools(
voice_id="21m00Tcm4TlvDq8ikWAM",
model_id="eleven_multilingual_v2",
)
],
description="You are an AI agent that can generate audio using the ElevenLabs API.",
instructions=[
dedent(
"""
You have access to the ElevenLabs toolkit:
- Use the `text_to_speech` tool to convert text or speech content into natural voice audio.
- Use the `generate_sound_effect` tool to create sound effects from text descriptions.
Keep the audio prompt as defined by the user.
"""
),
],
markdown=True,
)
# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
response = audio_agent.run(
"Generate a very long audio of history of french revolution and tell me which subject it belongs to.",
)
if response.audio:
print("Agent response:", response.content)
base64_audio = base64.b64encode(response.audio[0].content).decode("utf-8")
save_base64_data(base64_audio, "tmp/french_revolution.mp3")
# response2 = audio_agent.run("Generate a glass breaking sound effect" , debug_mode=True)
# if response2.audio:
# print("Agent response:", response2.content)
# base64_audio = base64.b64encode(response2.audio[0].content).decode("utf-8")
# save_base64_data(base64_audio, "tmp/glass_breaking_sound_effect.mp3")
Run the Example
# Clone and setup repo
git clone https://github.com/agno-agi/agno.git
cd agno/cookbook/91_tools
# Create and activate virtual environment
./scripts/demo_setup.sh
source .venvs/demo/bin/activate
python elevenlabs_tools.py