aura-llm 0.4.1__tar.gz

aura_llm-0.4.1/.gitignore

@@ -0,0 +1,119 @@
+# Generated by Cargo
+# will have compiled files and executables
+debug/
+target/
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# MSVC Windows builds of rustc generate these, which store debugging information
+*.pdb
+
+# Generated by cargo mutants
+# Contains mutation testing data
+**/mutants.out*/
+
+# Environment and secrets
+.env
+.env.*
+!.env.example
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE and editor files
+.idea/
+*.swp
+*.swo
+*~
+.vscode/
+!.vscode/settings.json
+!.vscode/extensions.json
+
+# Logs
+*.log
+logs/
+
+# Database
+*.db
+*.sqlite
+
+# Coverage
+coverage/
+*.lcov
+cobertura.xml
+tarpaulin-report.html
+
+# Documentation build
+docs/book/
+target/doc/
+
+# Research notes (not part of codebase)
+aura-research/
+
+# Claude
+.claude/
+
+# Cargo audit cache
+~/.cargo/advisory-db
+
+# Benchmarking
+criterion/
+benches/target/
+
+# Profiling
+flamegraph.svg
+perf.data
+perf.data.old
+
+# Docker volumes
+.docker/
+
+# SQLx offline mode
+.sqlx/
+
+# Testing artifacts
+*.profraw
+*.profdata
+
+# Helm chart dependencies (fetched at build time via `helm dep update`)
+deploy/charts/*/charts/
+deploy/charts/*/*.tgz
+
+# Node modules (for dashboard when added)
+node_modules/
+dist/
+.turbo/
+
+# Lock files for tools
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# Python (SDK)
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+downloads/
+eggs/
+.eggs/
+# Python install directories (but not src/lib/ application code)
+**/site-packages/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+venv/
+ENV/

aura_llm-0.4.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Umai Tech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aura_llm-0.4.1/PKG-INFO

@@ -0,0 +1,341 @@
+Metadata-Version: 2.4
+Name: aura-llm
+Version: 0.4.1
+Summary: Python SDK for Aura LLM Gateway - Open Responses API
+Project-URL: Homepage, https://github.com/UmaiTech/aura-llm-gateway
+Project-URL: Documentation, https://github.com/UmaiTech/aura-llm-gateway/tree/main/sdks/python
+Project-URL: Repository, https://github.com/UmaiTech/aura-llm-gateway
+Project-URL: Changelog, https://github.com/UmaiTech/aura-llm-gateway/blob/main/CHANGELOG.md
+Author: Aura Team
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,anthropic,api,gateway,llm,open-responses,openai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Aura LLM Gateway Python SDK
+
+[![PyPI](https://img.shields.io/pypi/v/aura-llm)](https://pypi.org/project/aura-llm/)
+[![Python](https://img.shields.io/pypi/pyversions/aura-llm)](https://pypi.org/project/aura-llm/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Python SDK for the [Aura LLM Gateway](https://github.com/UmaiTech/aura-llm-gateway), implementing the [Open Responses API](https://www.openresponses.org/specification).
+
+## Installation
+
+Using [uv](https://docs.astral.sh/uv/) (recommended):
+
+```bash
+uv add aura-llm
+```
+
+Using pip:
+
+```bash
+pip install aura-llm
+```
+
+### From Source
+
+```bash
+cd sdks/python
+
+# With uv
+uv sync
+
+# With pip
+pip install -e .
+```
+
+## Quick Start
+
+```python
+from aura import AuraClient
+
+# Initialize the client
+client = AuraClient(
+    api_key="your-api-key",  # or set AURA_API_KEY env var
+    base_url="http://localhost:8080",  # or set AURA_BASE_URL env var
+)
+
+# Simple completion
+response = client.responses.create(
+    model="gpt-5.4-mini",
+    input="What is the capital of France?"
+)
+print(response.output_text)
+# Output: The capital of France is Paris.
+```
+
+## Streaming
+
+```python
+for event in client.responses.create(
+    model="gpt-5.4-mini",
+    input="Tell me a short story about a robot",
+    stream=True
+):
+    if event.type == "response.output_text.delta":
+        print(event.delta, end="", flush=True)
+```
+
+## Async Client
+
+```python
+import asyncio
+from aura import AsyncAuraClient
+
+async def main():
+    async with AsyncAuraClient() as client:
+        response = await client.responses.create(
+            model="gpt-5.4-mini",
+            input="Hello, world!"
+        )
+        print(response.output_text)
+
+asyncio.run(main())
+```
+
+### Async Streaming
+
+```python
+async def stream_example():
+    async with AsyncAuraClient() as client:
+        stream = await client.responses.create(
+            model="gpt-5.4-mini",
+            input="Tell me a joke",
+            stream=True
+        )
+        async for event in stream:
+            if event.type == "response.output_text.delta":
+                print(event.delta, end="", flush=True)
+```
+
+## Conversation Threading
+
+Continue a conversation using `previous_response_id`:
+
+```python
+# First message
+response1 = client.responses.create(
+    model="gpt-5.4-mini",
+    input="My name is Alice."
+)
+
+# Continue the conversation
+response2 = client.responses.create(
+    model="gpt-5.4-mini",
+    input="What is my name?",
+    previous_response_id=response1.id
+)
+print(response2.output_text)
+# Output: Your name is Alice.
+```
+
+## Using Tools
+
+```python
+from aura import Tool
+
+# Define a tool
+weather_tool = Tool.function_tool(
+    name="get_weather",
+    description="Get the current weather for a location",
+    parameters={
+        "type": "object",
+        "properties": {
+            "location": {
+                "type": "string",
+                "description": "The city and state, e.g. San Francisco, CA"
+            }
+        },
+        "required": ["location"]
+    }
+)
+
+# Use the tool
+response = client.responses.create(
+    model="gpt-5.4-mini",
+    input="What's the weather in Tokyo?",
+    tools=[weather_tool]
+)
+
+# Check for tool calls
+if response.has_tool_calls:
+    for tool_call in response.tool_calls:
+        print(f"Tool: {tool_call.name}")
+        print(f"Arguments: {tool_call.arguments}")
+```
+
+## System Instructions
+
+```python
+response = client.responses.create(
+    model="gpt-5.4-mini",
+    input="Who are you?",
+    instructions="You are a helpful pirate assistant. Always respond in pirate speak."
+)
+```
+
+## Configuration Options
+
+```python
+client = AuraClient(
+    api_key="your-api-key",
+    base_url="http://localhost:8080",
+    timeout=120.0,  # Request timeout in seconds
+    headers={"X-Custom-Header": "value"},  # Additional headers
+)
+```
+
+## Response Object
+
+The `Response` object contains:
+
+```python
+response.id              # Unique response ID
+response.status          # ResponseStatus enum (completed, failed, etc.)
+response.model           # Model used
+response.output          # List of output items
+response.output_text     # Convenience property for text content
+response.usage           # Token usage information
+response.usage.cost_usd  # Cost in USD (if available)
+response.tool_calls      # List of function call items
+response.has_tool_calls  # Boolean check for tool calls
+response.is_complete     # Check if response completed successfully
+response.metadata        # Gateway metadata (provider, latency, etc.)
+```
+
+## Stream Events
+
+When streaming, you receive these event types:
+
+| Event Type | Description |
+|------------|-------------|
+| `response.created` | Response started |
+| `response.in_progress` | Response is being generated |
+| `response.output_text.delta` | Text chunk (use `event.delta`) |
+| `response.output_text.done` | Text complete (use `event.text`) |
+| `response.function_call.delta` | Function arguments chunk |
+| `response.function_call.done` | Function call complete |
+| `response.output_item.added` | New item added to output |
+| `response.output_item.done` | Item complete |
+| `response.completed` | Response finished |
+| `response.failed` | Response failed |
+| `error` | Error occurred |
+
+## Error Handling
+
+```python
+from aura import (
+    AuraError,
+    AuthenticationError,
+    BadRequestError,
+    RateLimitError,
+    NotFoundError,
+    APIConnectionError,
+    APITimeoutError,
+)
+
+try:
+    response = client.responses.create(
+        model="gpt-5.4-mini",
+        input="Hello"
+    )
+except AuthenticationError:
+    print("Invalid API key")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after: {e.retry_after}")
+except BadRequestError as e:
+    print(f"Bad request: {e.message}, param: {e.param}")
+except NotFoundError:
+    print("Model not found")
+except APIConnectionError:
+    print("Failed to connect to Aura gateway")
+except APITimeoutError:
+    print("Request timed out")
+except AuraError as e:
+    print(f"API error: {e}")
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `AURA_API_KEY` | API key for authentication | None |
+| `AURA_BASE_URL` | Base URL for the gateway | `http://localhost:8080` |
+
+## Development
+
+We use [uv](https://docs.astral.sh/uv/) for fast, reliable Python package management.
+
+### Setup
+
+```bash
+# Install uv (if not already installed)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install dependencies
+cd sdks/python
+uv sync
+```
+
+### Running Tests
+
+```bash
+# Run all tests
+uv run pytest
+
+# Run with coverage
+uv run pytest --cov=aura --cov-report=term-missing
+
+# Run specific test file
+uv run pytest tests/test_types.py -v
+```
+
+### Code Quality
+
+```bash
+# Linting
+uv run ruff check src/aura tests
+
+# Auto-fix lint issues
+uv run ruff check --fix src/aura tests
+
+# Format code
+uv run ruff format src/aura tests
+
+# Type checking
+uv run mypy src/aura
+```
+
+### All Checks (CI equivalent)
+
+```bash
+uv run ruff check src/aura tests
+uv run ruff format --check src/aura tests
+uv run mypy src/aura
+uv run pytest --cov=aura
+```
+
+## License
+
+MIT