Metadata-Version: 2.4
Name: owai
Version: 0.1.0
Summary: An opinionated way of doing AI - Task-oriented ai nodes for general-computing
Author-email: SURUS AI <contact@surus.lat>
License: MIT
Project-URL: Homepage, https://surus.lat
Project-URL: Repository, https://github.com/surus-lat/owai
Project-URL: Documentation, https://docs.surus.lat
Keywords: ai,transcription,audio,whisper,canary,speech-to-text
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: twine>=6.1.0; extra == "dev"
Requires-Dist: pytest>=8.3.5; extra == "dev"
Dynamic: license-file

<div align="center">
  <h1>owai</h1>
  <img src="public/icon.png" alt="icon" width="80" height="80">
  <p><em>an Opinionated Way of doing AI</em></p>
</div>

## Installation

```bash
uv venv
source .venv/bin/activate
uv pip install -e .
```

## Usage

```python
import owai

# Basic transcription
text = owai.transcribe("audio.wav")

# control source and target langs
text = owai.transcribe("audio.wav", source_lang="es", target_lang="es")
```

### Environment Setup

Create a `.env` file in your project root:

```bash
# .env
SURUS_API_KEY=your_api_key_here
```

Or set the environment variable directly:
```bash
export SURUS_API_KEY="your_api_key"
```

## Development

```bash
# Setup environment
uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

# Run tests
pytest tests/
```
