cartesia 0.1.1__py2.py3-none-any.whl → 1.0.1__py2.py3-none-any.whl

cartesia/utils.py

@@ -1,87 +0,0 @@
-import time
-
-from aiohttp.client_exceptions import ServerDisconnectedError
-import asyncio
-from functools import wraps
-from http.client import RemoteDisconnected
-from httpx import TimeoutException
-from requests.exceptions import ConnectionError
-
-
-def retry_on_connection_error(max_retries=3, backoff_factor=1, logger=None):
-    """Retry a function if a ConnectionError, RemoteDisconnected, ServerDisconnectedError, or TimeoutException occurs.
-
-    Args:
-        max_retries (int): The maximum number of retries.
-        backoff_factor (int): The factor to increase the delay between retries.
-        logger (logging.Logger): The logger to use for logging.
-    """
-
-    def decorator(func):
-        @wraps(func)
-        def wrapper(*args, **kwargs):
-            retry_count = 0
-            while retry_count < max_retries:
-                try:
-                    return func(*args, **kwargs)
-                except (
-                    ConnectionError,
-                    RemoteDisconnected,
-                    ServerDisconnectedError,
-                    TimeoutException,
-                ) as e:
-                    logger.info(f"Retrying after exception: {e}")
-                    retry_count += 1
-                    if retry_count < max_retries:
-                        delay = backoff_factor * (2 ** (retry_count - 1))
-                        logger.warn(
-                            f"Attempt {retry_count + 1}/{max_retries} in {delay} seconds..."
-                        )
-                        time.sleep(delay)
-                    else:
-                        raise Exception(f"Exception occurred after {max_retries} tries.") from e
-
-        return wrapper
-
-    return decorator
-
-
-def retry_on_connection_error_async(max_retries=3, backoff_factor=1, logger=None):
-    """Retry an asynchronous function if a ConnectionError, RemoteDisconnected, ServerDisconnectedError, or TimeoutException occurs.
-
-    Args:
-        max_retries (int): The maximum number of retries.
-        backoff_factor (int): The factor to increase the delay between retries.
-        logger (logging.Logger): The logger to use for logging.
-    """
-
-    def decorator(func):
-        @wraps(func)
-        async def wrapper(*args, **kwargs):
-            retry_count = 0
-            while retry_count < max_retries:
-                try:
-                    async for chunk in func(*args, **kwargs):
-                        yield chunk
-                    # If the function completes without raising an exception return
-                    return
-                except (
-                    ConnectionError,
-                    RemoteDisconnected,
-                    ServerDisconnectedError,
-                    TimeoutException,
-                ) as e:
-                    logger.info(f"Retrying after exception: {e}")
-                    retry_count += 1
-                    if retry_count < max_retries:
-                        delay = backoff_factor * (2 ** (retry_count - 1))
-                        logger.warn(
-                            f"Attempt {retry_count + 1}/{max_retries} in {delay} seconds..."
-                        )
-                        await asyncio.sleep(delay)
-                    else:
-                        raise Exception(f"Exception occurred after {max_retries} tries.") from e
-
-        return wrapper
-
-    return decorator

cartesia-0.1.1.dist-info/METADATA

@@ -1,189 +0,0 @@
-Metadata-Version: 2.1
-Name: cartesia
-Version: 0.1.1
-Summary: The official Python library for the Cartesia API.
-Home-page: 
-Author: Cartesia, Inc.
-Author-email: support@cartesia.ai
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.8.0
-Description-Content-Type: text/markdown
-Requires-Dist: aiohttp
-Requires-Dist: httpx
-Requires-Dist: pytest-asyncio
-Requires-Dist: requests
-Requires-Dist: websockets
-Provides-Extra: all
-Requires-Dist: pytest >=8.0.2 ; extra == 'all'
-Requires-Dist: pytest-cov >=4.1.0 ; extra == 'all'
-Requires-Dist: twine ; extra == 'all'
-Requires-Dist: setuptools ; extra == 'all'
-Requires-Dist: wheel ; extra == 'all'
-Requires-Dist: numpy ; extra == 'all'
-Provides-Extra: dev
-Requires-Dist: pytest >=8.0.2 ; extra == 'dev'
-Requires-Dist: pytest-cov >=4.1.0 ; extra == 'dev'
-Requires-Dist: twine ; extra == 'dev'
-Requires-Dist: setuptools ; extra == 'dev'
-Requires-Dist: wheel ; extra == 'dev'
-Requires-Dist: numpy ; extra == 'dev'
-
-
-# Cartesia Python API Library
-The official Cartesia Python library which provides convenient access to the Cartesia REST and Websocket API from any Python 3.8+ application.
-
-**Note:** This API is still in alpha. Please expect breaking changes and report any issues you encounter.
-
-## Installation
-```bash
-pip install cartesia
-
-# pip install in editable mode w/ dev dependencies
-pip install -e '.[dev]'
-```
-
-## Usage
-```python
-from cartesia.tts import CartesiaTTS
-import pyaudio
-import os
-
-client = CartesiaTTS(api_key=os.environ.get("CARTESIA_API_KEY"))
-voices = client.get_voices()
-voice = client.get_voice_embedding(voice_id=voices["Ted"]["id"])
-transcript = "Hello! Welcome to Cartesia"
-model_id = "genial-planet-1346" # (Optional) We'll specify a default if you don't have a specific model in mind
-
-p = pyaudio.PyAudio()
-
-stream = None
-
-# Generate and stream audio
-for output in client.generate(transcript=transcript, voice=voice, model_id=model_id, stream=True):
-    buffer = output["audio"]
-    rate = output["sampling_rate"]
-
-    if not stream:
-        stream = p.open(format=pyaudio.paFloat32,
-                        channels=1,
-                        rate=rate,
-                        output=True)
-
-    # Write the audio data to the stream
-    stream.write(buffer)
-
-stream.stop_stream()
-stream.close()
-p.terminate()
-```
-
-You can also use the async client if you want to make asynchronous API calls:
-```python
-from cartesia.tts import AsyncCartesiaTTS
-import asyncio
-import pyaudio
-import os
-
-async def write_stream():
-    client = AsyncCartesiaTTS(api_key=os.environ.get("CARTESIA_API_KEY"))
-    voices = client.get_voices()
-    voice = client.get_voice_embedding(voice_id=voices["Ted"]["id"])
-    transcript = "Hello! Welcome to Cartesia"
-    model_id = "genial-planet-1346" # (Optional) We'll specify a default if you don't have a specific model in mind
-
-    p = pyaudio.PyAudio()
-
-    stream = None
-
-    # Generate and stream audio
-    async for output in await client.generate(transcript=transcript, voice=voice, model_id=model_id, stream=True):
-        buffer = output["audio"]
-        rate = output["sampling_rate"]
-
-        if not stream:
-            stream = p.open(format=pyaudio.paFloat32,
-                            channels=1,
-                            rate=rate,
-                            output=True)
-
-        # Write the audio data to the stream
-        stream.write(buffer)
-
-    stream.stop_stream()
-    stream.close()
-    p.terminate()
-
-asyncio.run(write_stream())
-```
-
-If you are using Jupyter Notebook or JupyterLab, you can use IPython.display.Audio to play the generated audio directly in the notebook.
-Additionally, in these notebook examples we show how to use the client as a context manager (though this is not required).
-
-```python
-from IPython.display import Audio
-import io
-import os
-import numpy as np
-
-from cartesia.tts import CartesiaTTS
-
-with CartesiaTTS(api_key=os.environ.get("CARTESIA_API_KEY")) as client:
-    voices = client.get_voices()
-    voice = client.get_voice_embedding(voice_id=voices["Ted"]["id"])
-    transcript = "Hello! Welcome to Cartesia"
-
-    # Create a BytesIO object to store the audio data
-    audio_data = io.BytesIO()
-
-    # Generate and stream audio
-    for output in client.generate(transcript=transcript, voice=voice, stream=True):
-        buffer = output["audio"]
-        audio_data.write(buffer)
-
-# Set the cursor position to the beginning of the BytesIO object
-audio_data.seek(0)
-
-# Create an Audio object from the BytesIO data
-audio = Audio(np.frombuffer(audio_data.read(), dtype=np.float32), rate=output["sampling_rate"])
-
-# Display the Audio object
-display(audio)
-```
-
-Below is the same example using the async client:
-```python
-from IPython.display import Audio
-import io
-import os
-import numpy as np
-
-from cartesia.tts import AsyncCartesiaTTS
-
-async with AsyncCartesiaTTS(api_key=os.environ.get("CARTESIA_API_KEY")) as client:
-    voices = client.get_voices()
-    voice = client.get_voice_embedding(voice_id=voices["Ted"]["id"])
-    transcript = "Hello! Welcome to Cartesia"
-
-    # Create a BytesIO object to store the audio data
-    audio_data = io.BytesIO()
-
-    # Generate and stream audio
-    async for output in await client.generate(transcript=transcript, voice=voice, stream=True):
-        buffer = output["audio"]
-        audio_data.write(buffer)
-
-# Set the cursor position to the beginning of the BytesIO object
-audio_data.seek(0)
-
-# Create an Audio object from the BytesIO data
-audio = Audio(np.frombuffer(audio_data.read(), dtype=np.float32), rate=output["sampling_rate"])
-
-# Display the Audio object
-display(audio)
-```
-
-To avoid storing your API key in the source code, we recommend doing one of the following:
-1. Use [`python-dotenv`](https://pypi.org/project/python-dotenv/) to add `CARTESIA_API_KEY="my-api-key"` to your .env file. 
-1. Set the `CARTESIA_API_KEY` environment variable, preferably to a secure shell init file (e.g. `~/.zshrc`, `~/.bashrc`)

cartesia-0.1.1.dist-info/RECORD

@@ -1,9 +0,0 @@
-cartesia/__init__.py,sha256=uIc9xGNPs8_A6eAvbTUY1geazunYoEZVWFKhCwC9TRA,102
-cartesia/_types.py,sha256=602535A2Qpk-546dxRNPj3uvznJmBQcOa4Kkv0nSQKQ,1054
-cartesia/tts.py,sha256=vCrcBqkFCmmv16uNPlzqmARNLdKUN6XC2yxwEuxdOHc,25881
-cartesia/utils.py,sha256=nuwWRfu3MOVTxIQMLjYf6WLaxSlnu_GdE3QjTV0zisQ,3339
-cartesia/version.py,sha256=rnObPjuBcEStqSO0S6gsdS_ot8ITOQjVj_-P1LUUYpg,22
-cartesia-0.1.1.dist-info/METADATA,sha256=VLtJRjJPczIafLgiHMjpNf3c4lkMArXf6FlLAa1ojm8,6038
-cartesia-0.1.1.dist-info/WHEEL,sha256=DZajD4pwLWue70CAfc7YaxT1wLUciNBvN_TTcvXpltE,110
-cartesia-0.1.1.dist-info/top_level.txt,sha256=rTX4HnnCegMxl1FK9czpVC7GAvf3SwDzPG65qP-BS4w,9
-cartesia-0.1.1.dist-info/RECORD,,