# Fish Audio Text-to-Speech Plugin
A high-quality Text-to-Speech (TTS) plugin for Vision Agents that uses the Fish Audio API.
## Installation
```bash
pip install vision-agents-plugins-fish
```
## Usage
```python
from vision_agents.plugins.fish import TTS
from getstream.video.rtc.audio_track import AudioStreamTrack
# Initialize with API key from environment variable
tts = TTS()
# Or specify API key directly
tts = TTS(api_key="your_fish_audio_api_key")
# Create an audio track to output speech
track = AudioStreamTrack(framerate=16000)
tts.set_output_track(track)
# Register event handlers
@tts.on("audio")
def on_audio(audio_data, user):
print(f"Received audio chunk: {len(audio_data)} bytes")
# Send text to be converted to speech
await tts.send("Hello, this is a test of the Fish Audio text-to-speech plugin.")
```
## Configuration Options
- `api_key`: Fish Audio API key (default: reads from FISH_AUDIO_API_KEY environment variable)
- `reference_id`: Optional reference voice ID to use for synthesis
- `base_url`: Optional custom API endpoint (default: uses Fish Audio's default endpoint)
## Reference Audio
Fish Audio supports using reference audio for voice cloning:
```python
from vision_agents.plugins.fish import TTS
# Using a reference voice ID
tts = TTS(reference_id="your_reference_voice_id")
# Or pass reference audio dynamically when sending text
# (See Fish Audio SDK documentation for advanced usage)
```
## Requirements
- Python 3.10+
- fish-audio-sdk>=2025.4.2
Raw data
{
"_id": null,
"home_page": null,
"name": "vision-agents-plugins-fish",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "AI, TTS, agents, fish-audio, text-to-speech, voice agents",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/a7/d4/b2fa1129a8af346cedcca8ab92225499c3413cfad545ca61c2d6203c4497/vision_agents_plugins_fish-0.1.8.tar.gz",
"platform": null,
"description": "# Fish Audio Text-to-Speech Plugin\n\nA high-quality Text-to-Speech (TTS) plugin for Vision Agents that uses the Fish Audio API.\n\n## Installation\n\n```bash\npip install vision-agents-plugins-fish\n```\n\n## Usage\n\n```python\nfrom vision_agents.plugins.fish import TTS\nfrom getstream.video.rtc.audio_track import AudioStreamTrack\n\n# Initialize with API key from environment variable\ntts = TTS()\n\n# Or specify API key directly\ntts = TTS(api_key=\"your_fish_audio_api_key\")\n\n# Create an audio track to output speech\ntrack = AudioStreamTrack(framerate=16000)\ntts.set_output_track(track)\n\n# Register event handlers\n@tts.on(\"audio\")\ndef on_audio(audio_data, user):\n print(f\"Received audio chunk: {len(audio_data)} bytes\")\n\n# Send text to be converted to speech\nawait tts.send(\"Hello, this is a test of the Fish Audio text-to-speech plugin.\")\n```\n\n## Configuration Options\n\n- `api_key`: Fish Audio API key (default: reads from FISH_AUDIO_API_KEY environment variable)\n- `reference_id`: Optional reference voice ID to use for synthesis\n- `base_url`: Optional custom API endpoint (default: uses Fish Audio's default endpoint)\n\n## Reference Audio\n\nFish Audio supports using reference audio for voice cloning:\n\n```python\nfrom vision_agents.plugins.fish import TTS\n\n# Using a reference voice ID\ntts = TTS(reference_id=\"your_reference_voice_id\")\n\n# Or pass reference audio dynamically when sending text\n# (See Fish Audio SDK documentation for advanced usage)\n```\n\n## Requirements\n\n- Python 3.10+\n- fish-audio-sdk>=2025.4.2\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Fish Audio TTS integration for Vision Agents",
"version": "0.1.8",
"project_urls": {
"Documentation": "https://visionagents.ai/",
"Source": "https://github.com/GetStream/Vision-Agents",
"Website": "https://visionagents.ai/"
},
"split_keywords": [
"ai",
" tts",
" agents",
" fish-audio",
" text-to-speech",
" voice agents"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "84524cbddb98ae9d9b330c66a30f4bcc728e53784cba75c2b51116a4d978854b",
"md5": "b564be8578d98c394a199b88f5811f31",
"sha256": "c0965a53318a4be5373fe600ff14e8e87331df9439092e8c4c5df3595d6bd27b"
},
"downloads": -1,
"filename": "vision_agents_plugins_fish-0.1.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b564be8578d98c394a199b88f5811f31",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 9375,
"upload_time": "2025-10-22T01:51:04",
"upload_time_iso_8601": "2025-10-22T01:51:04.655847Z",
"url": "https://files.pythonhosted.org/packages/84/52/4cbddb98ae9d9b330c66a30f4bcc728e53784cba75c2b51116a4d978854b/vision_agents_plugins_fish-0.1.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a7d4b2fa1129a8af346cedcca8ab92225499c3413cfad545ca61c2d6203c4497",
"md5": "1a98bd5b556cfb84e4a0a59f02f60fa2",
"sha256": "0925f356fe237a0e82693a421005a8de3d411360ec1b543e0c801931dea19e87"
},
"downloads": -1,
"filename": "vision_agents_plugins_fish-0.1.8.tar.gz",
"has_sig": false,
"md5_digest": "1a98bd5b556cfb84e4a0a59f02f60fa2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 3519,
"upload_time": "2025-10-22T01:51:05",
"upload_time_iso_8601": "2025-10-22T01:51:05.447900Z",
"url": "https://files.pythonhosted.org/packages/a7/d4/b2fa1129a8af346cedcca8ab92225499c3413cfad545ca61c2d6203c4497/vision_agents_plugins_fish-0.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-22 01:51:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GetStream",
"github_project": "Vision-Agents",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "vision-agents-plugins-fish"
}
JSON
