{"id":37652478,"url":"https://github.com/murf-ai/murf-python-sdk","last_synced_at":"2026-01-16T11:35:19.816Z","repository":{"id":277325056,"uuid":"913194897","full_name":"murf-ai/murf-python-sdk","owner":"murf-ai","description":"Python sdk for Murf text to speech API","archived":false,"fork":false,"pushed_at":"2025-11-11T07:59:59.000Z","size":145,"stargazers_count":110,"open_issues_count":0,"forks_count":6,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-11T09:12:48.729Z","etag":null,"topics":["artificial-intelligence","multilingual","text-to-speech","voice-ai"],"latest_commit_sha":null,"homepage":"https://murf.ai/api/docs","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/murf-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-07T08:06:14.000Z","updated_at":"2025-11-11T08:00:03.000Z","dependencies_parsed_at":"2025-07-24T08:34:18.010Z","dependency_job_id":"191295b8-22b2-4e00-abf4-6d926a6c4b09","html_url":"https://github.com/murf-ai/murf-python-sdk","commit_stats":null,"previous_names":["murf-ai/murf-python-sdk"],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/murf-ai/murf-python-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murf-ai%2Fmurf-python-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murf-ai%2Fmurf-python-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murf-ai%2Fmurf-python-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murf-ai%2Fmurf-python-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/murf-ai","download_url":"https://codeload.github.com/murf-ai/murf-python-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murf-ai%2Fmurf-python-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478349,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T06:30:42.265Z","status":"ssl_error","status_checked_at":"2026-01-16T06:30:16.248Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["artificial-intelligence","multilingual","text-to-speech","voice-ai"],"created_at":"2026-01-16T11:35:19.085Z","updated_at":"2026-01-16T11:35:19.809Z","avatar_url":"https://github.com/murf-ai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Murf Python SDK\n\n![Murf AI Logo](https://murf.ai/public-assets/home/Murf_Logo.png)\n\n[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github\u0026utm_medium=github\u0026utm_campaign=readme\u0026utm_source=https%3A%2F%2Fgithub.com%2Fmurf-ai%2Fmurf-python-sdk)\n[![pypi](https://img.shields.io/pypi/v/murf)](https://pypi.python.org/pypi/murf)\n[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/gist/devgeetech-murf/bbe2c7eb01433f4a151f0fd2be23b1c8/murf-python-sdk.ipynb)\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Installation](#installation)\n- [Getting Started](#getting-started)\n- [Features](#features)\n- [Asynchronous Usage](#async-client)\n- [Exception Handling](#exception-handling)\n- [Advanced Configuration](#advanced)\n- [Contributing](#contributing)\n- [License](#license)\n\n---\n\n## Overview\n\nThe Murf Python SDK offers seamless integration with the [Murf AI](https://murf.ai/) [text-to-speech software](https://murf.ai/text-to-speech), enabling developers and creators to convert text into lifelike speech effortlessly. With over 130 natural-sounding voices across 21 languages and 20+ speaking styles, Murf provides unparalleled speech customization for a wide range of applications. The SDK is designed for both synchronous and asynchronous workflows, featuring robust error handling, advanced configuration options, and support for real-time applications.\n\n---\n\n## Installation\n\nCheck out the [HTTP API documentation](https://murf.ai/api/docs/introduction/quickstart).\n\nInstall the SDK using pip:\n\n```bash\npip install murf\n```\n\n---\n\n## Getting Started\n\nHere's a quick example to get you started with the Murf SDK:\n\n```python\nfrom murf import Murf\n\nclient = Murf(\n    api_key=\"YOUR_API_KEY\",\n)\nclient.text_to_speech.generate(\n    format=\"MP3\",\n    sample_rate=44100.0,\n    text=\"Hello, world!\",\n    voice_id=\"en-US-natalie\",\n)\n```\n\nFor more detailed information, refer to the [official documentation](https://murf.ai/api/docs/introduction/quickstart).\n\n---\n\n## Features\n\n- **Text-to-Speech Conversion:** Transform text into natural-sounding speech.\n- **Multilingual Support:** Access voices in over 21 languages, including English, French, German, Spanish, Italian, Hindi, Portuguese, Dutch, Korean, Chinese (Mandarin), Bengali, Tamil, Polish, Japanese, Turkish, Indonesian, Croatian, Greek, Romanian, Slovak, and Bulgarian.\n\n![Murf AI Languages](https://murf.ai/public-assets/home/Murf_Languages_21.jpg)\n\n- **Multiple Voice Styles:** Choose from 20+ speaking styles to suit your application's needs.\n- **Advanced Voice Customization:** Adjust parameters like pitch, speed, pauses, and pronunciation for optimal output. Fine-grained controls let you tailor the voice output to match your specific requirements.\n- **Multiple Audio Formats:** Generate audio in various formats (e.g., MP3, WAV) with configurable sample rates for optimal quality.\n- **Real-Time Processing:** Benefit from asynchronous API calls that support non-blocking, real-time audio generation and streaming scenarios.\n\n\n---\n\n## Async Client\n\nThe SDK also exports an `async` client so that you can make non-blocking calls to our API.\n\n```python\nimport asyncio\n\nfrom murf import AsyncMurf\n\nclient = AsyncMurf(\n    api_key=\"YOUR_API_KEY\",\n)\n\n\nasync def main() -\u003e None:\n    await client.text_to_speech.generate(\n        format=\"MP3\",\n        sample_rate=44100.0,\n        text=\"Hello, world!\",\n        voice_id=\"en-US-natalie\",\n    )\n\n\nasyncio.run(main())\n```\n\n---\n\n## Exception Handling\n\nWhen the API returns a non-success status code (4xx or 5xx response), a subclass of the following error\nwill be thrown.\n\n```python\nfrom murf.core.api_error import ApiError\n\ntry:\n    client.text_to_speech.generate(...)\nexcept ApiError as e:\n    print(e.status_code)\n    print(e.body)\n```\n\n---\n\n## Advanced\n\n### Retries\n\nThe SDK is instrumented with automatic retries with exponential backoff. A request will be retried as long\nas the request is deemed retriable and the number of retry attempts has not grown larger than the configured\nretry limit (default: 2).\n\nA request is deemed retriable when any of the following HTTP status codes is returned:\n\n- [408](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/408) (Timeout)\n- [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) (Too Many Requests)\n- [5XX](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) (Internal Server Errors)\n\nUse the `max_retries` request option to configure this behavior.\n\n```python\nclient.text_to_speech.generate(..., request_options={\n    \"max_retries\": 1\n})\n```\n\n### Timeouts\n\nThe SDK defaults to a 60 second timeout. You can configure this with a timeout option at the client or request level.\n\n```python\n\nfrom murf import Murf\n\nclient = Murf(\n    ...,\n    timeout=20.0,\n)\n\n\n# Override timeout for a specific method\nclient.text_to_speech.generate(..., request_options={\n    \"timeout_in_seconds\": 1\n})\n```\n\n### Custom Client\n\nYou can override the `httpx` client to customize it for your use-case. Some common use-cases include support for proxies\nand transports.\n```python\nimport httpx\nfrom murf import Murf\n\nclient = Murf(\n    ...,\n    httpx_client=httpx.Client(\n        proxies=\"http://my.test.proxy.example.com\",\n        transport=httpx.HTTPTransport(local_address=\"0.0.0.0\"),\n    ),\n)\n```\n\n---\n\n## Contributing\n\nWe welcome contributions to enhance the Murf Python SDK. Please note that this library is generated programmatically, so direct modifications may be overwritten. We suggest opening an issue first to discuss your ideas or improvements. Contributions to the documentation are especially appreciated! For any support queries email to support@murf.ai \n\n---\n\n## License\n\nMurf Python SDK is released under the [MIT License](LICENSE).\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmurf-ai%2Fmurf-python-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmurf-ai%2Fmurf-python-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmurf-ai%2Fmurf-python-sdk/lists"}