orbitalsai 1.1.0__py3-none-any.whl → 1.2.0__py3-none-any.whl

orbitalsai-1.2.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+orbitalsai/__init__.py,sha256=qG0e47rvbUtkcvCqLXD6v6TLa-6jy3JDz4GPcnySLqM,2289
+orbitalsai/async_client.py,sha256=zW8eJrGTnu7Z0mDKo6y8b732s_oGpM9zXWWukj_QQhQ,14983
+orbitalsai/client.py,sha256=5pUFDVWXfRbrMVUx7Pw7lV7fvEJfaCqexmNk8aTOHjo,12352
+orbitalsai/exceptions.py,sha256=5jdLYiWUXsbpifFV4-rY4FRZtmRqnqvqXTlunh5DxgE,1390
+orbitalsai/models.py,sha256=ktmZJoYRnEuCZ1bGhR8vy6eBXkXC-wNMdA11CalZ458,3373
+orbitalsai/utils.py,sha256=HtRCWfg7xmk3c_KPqm2-P5kx178QZYxy2hDGv1IS9hM,2791
+orbitalsai/streaming/__init__.py,sha256=Pk-7cmVnOFM8VG8ZPW8LoD3C6D64oFONuIWGNmkP2vc,2912
+orbitalsai/streaming/async_client.py,sha256=L83VQ5UWWbb4_F6KSudSxeAlCfkRqF2zBMIxMXBbk-I,17801
+orbitalsai/streaming/client.py,sha256=QgBOQfYzuaNBl-Rdd0LCFxs45d7cyI49A4BZBtTNQwo,12004
+orbitalsai/streaming/config.py,sha256=jVNO677dCux-5mYPAg8mbyLAU1gFSjjycKVR2tei2OU,6725
+orbitalsai/streaming/connection.py,sha256=tEZTVmiccSgu98Gb7zafnnD9gfzy7jcPloP73akpzqE,9021
+orbitalsai/streaming/events.py,sha256=2ehPPK2nFaLbu50KvU_WIWFKOXggzdygxGE94leXuKg,12607
+orbitalsai/streaming/exceptions.py,sha256=TI8srw_IpmSLHK1iwju9MfwUaL9in3OhbgeDmqAQlpY,4443
+orbitalsai/streaming/protocol.py,sha256=4vCNav1jAWvDNNfpMpjPk9zBLe3U6TmIITgs3fF2-EQ,7085
+orbitalsai/streaming/audio/__init__.py,sha256=dPC3ONAJvfGtRzEjqP3Fswoh4cz8zJHOG4MlLMAZ3Sc,638
+orbitalsai/streaming/audio/buffer.py,sha256=tArUj9lzys4-lK_kbmvYlu1EbJ7aeqE3UET2qTg4ccA,4915
+orbitalsai/streaming/audio/converter.py,sha256=urY9Ho-6juHfoByqAC7QQ3lg_YXBjLO_0ne4OsT8Peo,9517
+orbitalsai/streaming/audio/formats.py,sha256=eUHVlVhCZs1bDc1OnHke9ixfXuPZAvzXX_XgPoBsdFM,2528
+orbitalsai/streaming/audio/source.py,sha256=BWPyHNUaFXVU0jihq6GIBmVa46U1Qf_UYsK6f37Wk0g,9457
+orbitalsai-1.2.0.dist-info/licenses/LICENSE,sha256=C7Eee8rAV6XiweKYlvcabxiMvFX75B_0arFlrLnfnf0,1067
+orbitalsai-1.2.0.dist-info/METADATA,sha256=PBVuPwEWY5ZhD2dzFAXh_OLVHtVrNk33JnzguLuO3Sc,23351
+orbitalsai-1.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+orbitalsai-1.2.0.dist-info/top_level.txt,sha256=KZ4ueNRg-PyNeu3RKTOpe5PRCSidh3ieL70-YGf62ro,11
+orbitalsai-1.2.0.dist-info/RECORD,,

{orbitalsai-1.1.0.dist-info → orbitalsai-1.2.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

orbitalsai-1.1.0.dist-info/METADATA

@@ -1,491 +0,0 @@
-Metadata-Version: 2.4
-Name: orbitalsai
-Version: 1.1.0
-Summary: A simple and powerful Python SDK for the OrbitalsAI API
-Home-page: https://github.com/orbitalsai/orbitalsai-python-sdk
-Author: OrbitalsAI
-Author-email: OrbitalsAI <support@orbitalsai.com>
-Maintainer-email: OrbitalsAI <support@orbitalsai.com>
-License: MIT
-Project-URL: Homepage, https://github.com/orbitalsai/orbitalsai-python-sdk
-Project-URL: Documentation, https://docs.orbitalsai.com
-Project-URL: Repository, https://github.com/orbitalsai/orbitalsai-python-sdk
-Project-URL: Bug Tracker, https://github.com/orbitalsai/orbitalsai-python-sdk/issues
-Keywords: ai,transcription,audio,speech,african languages,srt,subtitles
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-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 :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests>=2.25.0
-Requires-Dist: aiohttp>=3.8.0
-Requires-Dist: python-dateutil>=2.8.0
-Provides-Extra: dev
-Requires-Dist: pytest>=6.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.18.0; extra == "dev"
-Requires-Dist: black>=21.0; extra == "dev"
-Requires-Dist: flake8>=3.9; extra == "dev"
-Requires-Dist: mypy>=0.910; extra == "dev"
-Dynamic: author
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-python
-
-# OrbitalsAI Python SDK
-
-[![PyPI version](https://badge.fury.io/py/orbitalsai.svg)](https://badge.fury.io/py/orbitalsai)
-[![Python Support](https://img.shields.io/pypi/pyversions/orbitalsai.svg)](https://pypi.org/project/orbitalsai/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-A simple and powerful Python SDK for the OrbitalsAI API. Transcribe audio files in multiple African languages with optional SRT subtitle generation.
-
-## ✨ Features
-
-- 🚀 **Simple API** - Just 3 lines to transcribe audio
-- 🔄 **Sync & Async** - Use synchronously or asynchronously
-- 🌍 **African Languages** - Support for Hausa, Igbo, Yoruba, Swahili, and more
-- 📝 **SRT Subtitles** - Generate subtitle files automatically
-- 💰 **Balance Management** - Built-in billing and usage tracking
-- 🔒 **Secure** - API key authentication
-- 📦 **Easy Installation** - `pip install orbitalsai`
-
-## 🚀 Quick Start
-
-### Installation
-
-```bash
-pip install orbitalsai
-```
-
-### Basic Usage
-
-```python
-import orbitalsai
-
-# Initialize client
-client = orbitalsai.Client(api_key="your_api_key_here")
-
-# Transcribe audio (waits automatically)
-transcript = client.transcribe("audio.mp3")
-print(transcript.text)
-```
-
-That's it! 🎉
-
-## 📖 Table of Contents
-
-- [Installation](#installation)
-- [Quick Start](#quick-start)
-- [Authentication](#authentication)
-- [Basic Transcription](#basic-transcription)
-- [Advanced Features](#advanced-features)
-- [Async Usage](#async-usage)
-- [Error Handling](#error-handling)
-- [API Reference](#api-reference)
-- [Supported Languages](#supported-languages)
-- [Supported Formats](#supported-formats)
-- [Troubleshooting](#troubleshooting)
-
-## 🔑 Authentication
-
-Get your API key from the [OrbitalsAI Dashboard](https://dashboard.orbitalsai.com).
-
-```python
-import orbitalsai
-
-client = orbitalsai.Client(api_key="your_api_key_here")
-```
-
-## 🎵 Basic Transcription
-
-### Simple Transcription
-
-```python
-import orbitalsai
-
-client = orbitalsai.Client(api_key="your_api_key_here")
-
-# Transcribe audio file
-transcript = client.transcribe("audio.mp3")
-print(transcript.text)
-```
-
-### With Language and SRT
-
-```python
-import orbitalsai
-
-client = orbitalsai.Client(api_key="your_api_key_here")
-
-# Transcribe in Hausa with SRT subtitles
-transcript = client.transcribe(
-    "audio.mp3",
-    language="hausa",
-    generate_srt=True
-)
-
-print(transcript.text)
-print(transcript.srt_content)  # SRT subtitle content
-```
-
-## 🤖 AI Model Selection
-
-Choose which AI model to use for transcription. Different models may have different pricing and capabilities.
-
-### List Available Models
-
-```python
-import orbitalsai
-
-client = orbitalsai.Client(api_key="your_api_key_here")
-
-# Get all available models
-models = client.get_models()
-
-for model in models:
-    print(f"{model.model_name}: ${model.transcription_rate_per_hour:.2f}/hour")
-```
-
-### Transcribe with Specific Model
-
-```python
-import orbitalsai
-
-client = orbitalsai.Client(api_key="your_api_key_here")
-
-# Transcribe with Perigee-1 model
-transcript = client.transcribe(
-    "audio.mp3",
-    language="hausa",
-    model_name="Perigee-1"  # Specify the model
-)
-
-print(transcript.text)
-```
-
-### Choose Model Based on Budget
-
-```python
-import orbitalsai
-
-client = orbitalsai.Client(api_key="your_api_key_here")
-
-# Get the cheapest available model
-models = client.get_models()
-cheapest_model = min(models, key=lambda m: m.transcription_rate_per_hour)
-
-print(f"Using {cheapest_model.model_name} at ${cheapest_model.transcription_rate_per_hour:.2f}/hour")
-
-transcript = client.transcribe(
-    "audio.mp3",
-    language="english",
-    model_name=cheapest_model.model_name
-)
-```
-
-## 🔄 Async Usage
-
-Perfect for processing multiple files or building web applications.
-
-```python
-import asyncio
-import orbitalsai
-
-async def main():
-    async with orbitalsai.AsyncClient(api_key="your_api_key_here") as client:
-        # List available models
-        models = await client.get_models()
-        print(f"Available models: {[m.model_name for m in models]}")
-        
-        # Transcribe multiple files concurrently
-        tasks = await asyncio.gather(
-            client.transcribe("audio1.mp3", model_name="Perigee-1"),
-            client.transcribe("audio2.wav", model_name="Perigee-1"),
-            client.transcribe("audio3.m4a", model_name="Perigee-1")
-        )
-        
-        for transcript in tasks:
-            print(transcript.text)
-
-asyncio.run(main())
-```
-
-## 💰 Balance Management
-
-### Check Balance
-
-```python
-import orbitalsai
-
-client = orbitalsai.Client(api_key="your_api_key_here")
-
-balance = client.get_balance()
-print(f"Current balance: ${balance.balance:.2f}")
-print(f"Last updated: {balance.last_updated}")
-```
-
-### Usage History
-
-```python
-import orbitalsai
-from datetime import date, timedelta
-
-client = orbitalsai.Client(api_key="your_api_key_here")
-
-# Get last 7 days of usage
-end_date = date.today()
-start_date = end_date - timedelta(days=7)
-
-usage = client.get_daily_usage(start_date=start_date, end_date=end_date)
-print(f"Total cost: ${usage.total_cost:.2f}")
-print(f"Total audio processed: {usage.total_audio_seconds:.1f} seconds")
-
-for day in usage.daily_records:
-    print(f"{day.date}: ${day.total_cost:.4f} ({day.transcription_usage:.1f}s transcription)")
-```
-
-## 🛠️ Advanced Features
-
-### List All Tasks
-
-```python
-import orbitalsai
-
-client = orbitalsai.Client(api_key="your_api_key_here")
-
-tasks = client.list_tasks()
-for task in tasks:
-    print(f"Task {task.task_id}: {task.status} - {task.original_filename}")
-```
-
-### Get User Information
-
-```python
-import orbitalsai
-
-client = orbitalsai.Client(api_key="your_api_key_here")
-
-user = client.get_user()
-print(f"User: {user.first_name} {user.last_name} ({user.email})")
-print(f"Verified: {user.is_verified}")
-```
-
-## ⚠️ Error Handling
-
-The SDK provides specific exceptions for different error scenarios.
-
-```python
-import orbitalsai
-from orbitalsai.exceptions import (
-    AuthenticationError, InsufficientBalanceError, 
-    UnsupportedFileError, UnsupportedLanguageError,
-    TranscriptionError, TimeoutError
-)
-
-client = orbitalsai.Client(api_key="your_api_key_here")
-
-try:
-    transcript = client.transcribe("audio.mp3", language="hausa")
-    print(transcript.text)
-    
-except UnsupportedFileError:
-    print("File format not supported")
-except UnsupportedLanguageError:
-    print("Language not supported")
-except InsufficientBalanceError:
-    print("Not enough credits")
-except AuthenticationError:
-    print("Invalid API key")
-except TranscriptionError as e:
-    print(f"Transcription failed: {e}")
-except TimeoutError:
-    print("Transcription timed out")
-except Exception as e:
-    print(f"Unexpected error: {e}")
-```
-
-## 📚 API Reference
-
-### Client Methods
-
-#### `get_models()`
-
-Get all available AI models with their pricing information.
-
-**Returns:** List of `Model` objects
-
-#### `transcribe(file_path, language="english", generate_srt=False, model_name="Perigee-1", wait=True, timeout=300, poll_interval=5)`
-
-Transcribe an audio file.
-
-**Parameters:**
-- `file_path` (str): Path to the audio file
-- `language` (str): Language code (default: "english")
-- `generate_srt` (bool): Generate SRT subtitles (default: False)
-- `model_name` (str): AI model to use (default: "Perigee-1")
-- `wait` (bool): Wait for completion (default: True)
-- `timeout` (int): Maximum wait time in seconds (default: 300)
-- `poll_interval` (int): Seconds between status checks (default: 5)
-
-**Returns:** `Transcript` object (if wait=True) or `TranscriptTask` object (if wait=False)
-
-#### `get_task(task_id)`
-
-Get the status of a transcription task.
-
-**Parameters:**
-- `task_id` (int): ID of the task
-
-**Returns:** `TranscriptTask` object
-
-#### `wait_for_task(task_id, timeout=300, poll_interval=5)`
-
-Wait for a task to complete.
-
-**Parameters:**
-- `task_id` (int): ID of the task
-- `timeout` (int): Maximum wait time in seconds
-- `poll_interval` (int): Seconds between status checks
-
-**Returns:** `Transcript` object
-
-#### `list_tasks()`
-
-Get all transcription tasks for the current user.
-
-**Returns:** List of `TranscriptTask` objects
-
-#### `get_balance()`
-
-Get the current user's balance.
-
-**Returns:** `Balance` object
-
-#### `get_usage_history(start_date=None, end_date=None, page=1, page_size=50)`
-
-Get usage history for the current user.
-
-**Returns:** `UsageHistory` object
-
-#### `get_daily_usage(start_date=None, end_date=None, page=1, page_size=30)`
-
-Get daily usage history for the current user.
-
-**Returns:** `DailyUsage` object
-
-#### `get_user()`
-
-Get current user details.
-
-**Returns:** `User` object
-
-### Data Models
-
-#### `Transcript`
-- `text` (str): Transcribed text
-- `srt_content` (str, optional): SRT subtitle content
-- `task_id` (int): Task ID
-- `original_filename` (str): Original filename
-- `audio_url` (str, optional): URL to processed audio
-
-#### `TranscriptTask`
-- `task_id` (int): Task ID
-- `status` (str): Task status ("pending", "processing", "completed", "failed")
-- `original_filename` (str): Original filename
-- `audio_url` (str, optional): URL to processed audio
-- `srt_requested` (bool): Whether SRT was requested
-- `result_text` (str, optional): Transcribed text
-- `srt_content` (str, optional): SRT subtitle content
-- `error` (str, optional): Error message if failed
-
-#### `Balance`
-- `balance` (float): Current balance in credits
-- `last_updated` (datetime): Last update timestamp
-
-#### `Model`
-- `id` (int): Model ID
-- `model_name` (str): Name of the model (e.g., "Perigee-1")
-- `transcription_rate_per_second` (float): Cost per second of audio
-- `transcription_rate_per_hour` (float): Cost per hour of audio
-- `is_active` (bool): Whether the model is currently available
-
-## 🌍 Supported Languages
-
-- **English** (`english`)
-- **Hausa** (`hausa`)
-- **Igbo** (`igbo`)
-- **Yoruba** (`yoruba`)
-- **Swahili** (`swahili`)
-- **Pidgin** (`pidgin`)
-- **Kinyarwanda** (`kinyarwanda`)
-
-## 📁 Supported Formats
-
-### Audio Formats
-- WAV (`.wav`, `.wave`)
-- MP3 (`.mp3`, `.mpeg`)
-- OGG (`.ogg`, `.oga`)
-- FLAC (`.flac`)
-- AAC (`.aac`)
-- M4A (`.m4a`)
-- WMA (`.wma`)
-- AMR (`.amr`)
-- 3GP (`.3gp`)
-
-### Maximum File Size
-- **200 MB** per file
-
-## 🔧 Troubleshooting
-
-### Common Issues
-
-**Q: I get "Invalid API key" error**
-A: Make sure your API key is correct. Get it from the [OrbitalsAI Dashboard](https://dashboard.orbitalsai.com).
-
-**Q: I get "Insufficient balance" error**
-A: Add credits to your account through the dashboard.
-
-**Q: I get "Unsupported file format" error**
-A: Make sure your audio file is in a supported format (see [Supported Formats](#supported-formats)).
-
-**Q: Transcription takes too long**
-A: Large files take longer to process. You can increase the timeout:
-```python
-transcript = client.transcribe("large_file.mp3", timeout=600)  # 10 minutes
-```
-
-**Q: I get "Unsupported language" error**
-A: Make sure you're using a supported language code (see [Supported Languages](#supported-languages)).
-
-### Getting Help
-
-- 📧 Email: support@orbitalsai.com
-- 🐛 Issues: [GitHub Issues](https://github.com/orbitalsai/orbitalsai-python-sdk/issues)
-- 📖 Docs: [Documentation](https://docs.orbitalsai.com)
-
-## 📄 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## 🤝 Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-## 🙏 Acknowledgments
-
-- Built for the African AI community
-- Powered by OrbitalsAI
-
----
-
-Made by the OrbitalsAI team

orbitalsai-1.1.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-orbitalsai/__init__.py,sha256=l1PSfVe3tVHU53VWOMc7c6qx3iBP_SPyRFN98-taCo4,1634
-orbitalsai/async_client.py,sha256=zW8eJrGTnu7Z0mDKo6y8b732s_oGpM9zXWWukj_QQhQ,14983
-orbitalsai/client.py,sha256=5pUFDVWXfRbrMVUx7Pw7lV7fvEJfaCqexmNk8aTOHjo,12352
-orbitalsai/exceptions.py,sha256=5jdLYiWUXsbpifFV4-rY4FRZtmRqnqvqXTlunh5DxgE,1390
-orbitalsai/models.py,sha256=ktmZJoYRnEuCZ1bGhR8vy6eBXkXC-wNMdA11CalZ458,3373
-orbitalsai/utils.py,sha256=HtRCWfg7xmk3c_KPqm2-P5kx178QZYxy2hDGv1IS9hM,2791
-orbitalsai-1.1.0.dist-info/licenses/LICENSE,sha256=C7Eee8rAV6XiweKYlvcabxiMvFX75B_0arFlrLnfnf0,1067
-orbitalsai-1.1.0.dist-info/METADATA,sha256=wcuxtbOZRljBf1Y4DRtJO_GetzmRJILwiOzHNQDmSoo,13278
-orbitalsai-1.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orbitalsai-1.1.0.dist-info/top_level.txt,sha256=KZ4ueNRg-PyNeu3RKTOpe5PRCSidh3ieL70-YGf62ro,11
-orbitalsai-1.1.0.dist-info/RECORD,,