surus-ai 0.1.0

An opinionated way of doing AI - Task-oriented ai nodes for general-computing

# surus

an opinionated way of doing ai

Installation

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

Usage

import surus

# Basic transcription (Whisper model)
text = surus.transcribe("audio.wav")

# High performance transcription (Canary model) 
text = surus.transcribe("audio.wav", high_performance=True, source_lang="es")

Environment Setup

Create a .env file in your project root:

# .env
SURUS_API_KEY=your_api_key_here

Or set the environment variable directly:

export SURUS_API_KEY="your_api_key"

Development

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

# Run tests
pytest tests/