Metadata-Version: 2.4
Name: wraipperz
Version: 0.1.2
Summary: Simple wrappers for various AI APIs including LLMs, ASR, and TTS
Project-URL: Homepage, https://github.com/Ahaeflig/wraipperz
Project-URL: Bug Tracker, https://github.com/Ahaeflig/wraipperz/issues
Author-email: Adan Häfliger <adan.haefliger@gmail.com>
License: MIT
Keywords: ai,anthropic,asr,google,llm,openai,tts,wrapper
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: anthropic>=0.49.0
Requires-Dist: cartesia>=1.4.0
Requires-Dist: deepgram-sdk>=3.10.1
Requires-Dist: google-genai>=1.5.0
Requires-Dist: google-generativeai>=0.8.4
Requires-Dist: openai>=1.66.3
Requires-Dist: pillow>=11.1.0
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: soundfile>=0.13.1
Requires-Dist: tenacity>=9.0.0
Requires-Dist: websocket-client>=1.8.0
Requires-Dist: websockets>=14.2
Description-Content-Type: text/markdown

# wraipperz (WIP - agent generated)

Simple wrappers for various AI APIs including LLMs, ASR, and TTS.

## Installation

```bash
pip install wraipperz
uv add wraipperz
```

## Features

- **LLM API Wrappers**: Unified interface for OpenAI, Anthropic, Google, and other LLM providers
- **ASR (Automatic Speech Recognition)**: Convert speech to text
- **TTS (Text-to-Speech)**: Convert text to speech
- **Async Support**: Asynchronous API calls for improved performance

## Quick Start

### LLM

```python
import os
from wraipperz import call_ai, MessageBuilder

os.environ["OPENAI_API_KEY"] = "your_openai_key" # if not defined in environment variables
messages = MessageBuilder().add_system("You are a helpful assistant.").add_user("What's 1+1?")

# Call an LLM with a simple interface
response, cost = call_ai(
    model="openai/gpt-4o",
    messages=messages
)
```

### TTS

```python
from wraipperz.api.tts import create_tts_manager

tts_manager = create_tts_manager()

# Generate speech using OpenAI Realtime TTS
response = tts_manager.generate_speech(
    "openai_realtime",
    text="This is a demonstration of my voice capabilities!",
    output_path="realtime_output.mp3",
    voice="ballad",
    context="Speak in a extremelly calm, soft, and relaxed voice.",
    return_alignment=True,
    speed=1.1,
)

# Convert speech using ElevenLabs
# TODO add example

```

## Environment Variables

Set up your API keys in environment variables to enable providers.

```bash
OPENAI_API_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GOOGLE_API_KEY=your_google_key
# ...  todo add all
```

## License

MIT

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.
