rodiumai 0.1.0__tar.gz

rodiumai-0.1.0/.env.example

@@ -0,0 +1,9 @@
+# RodiumAI — SDK Configuration
+# Copy this file to .env and fill in your values
+
+# Required: Your RodiumAI API key (starts with "rdk-")
+RODIUMAI_API_KEY=rdk-your-api-key-here
+
+# Optional: Log level (DEBUG, INFO, WARNING, ERROR)
+# Default: WARNING
+RODIUMAI_LOG_LEVEL=WARNING

rodiumai-0.1.0/.github/workflows/python-sdk.yml

@@ -0,0 +1,122 @@
+name: Python SDK
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run unit tests
+        run: pytest tests/unit --cov=rodiumai --cov-report=xml
+
+      - name: Run integration tests
+        run: pytest tests/integration --cov=rodiumai --cov-report=xml --cov-append
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: true
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: flake8
+        run: flake8 rodiumai/ tests/
+
+      - name: black
+        run: black --check --diff rodiumai/ tests/
+
+      - name: isort
+        run: isort --check-only --diff rodiumai/ tests/
+
+      - name: mypy
+        run: mypy rodiumai/
+
+  security:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: bandit
+        run: bandit -r rodiumai/
+
+      - name: pip-audit
+        run: pip-audit
+
+  publish:
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [test, lint, security]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build dependencies
+        run: |
+          pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          body_path: CHANGELOG.md
+          files: dist/*

rodiumai-0.1.0/.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Virtual environments
+venv/
+.venv/
+.env
+
+# IDE
+.vscode/
+.idea/
+
+# Coverage
+.coverage
+htmlcov/
+coverage.xml
+
+# Mypy
+.mypy_cache/
+
+# Pytest
+.pytest_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Tests
+tests/
+test_reel.py
+
+# Pip
+pip-log.txt
+pip-delete-failed-directory

rodiumai-0.1.0/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+## 0.1.0 (2026-06-01)
+
+### Initial Release
+
+- Chat Completions (standard + streaming SSE)
+- Embeddings (single + batch)
+- Image Generation (text-to-image)
+- Audio (speech-to-text + text-to-speech)
+- Video stub (future-ready, NotImplementedError)
+- Full error hierarchy (8 custom errors)
+- Structured JSON logging with alerts
+- Usage statistics per session
+- Automatic retry with exponential backoff
+- OpenAI drop-in replacement syntax
+- HTTPS enforced, API key masked everywhere
+- 98.5%+ test coverage enforced in CI
+- Multi-architecture Docker support

rodiumai-0.1.0/Dockerfile

@@ -0,0 +1,27 @@
+FROM python:3.12-slim-bookworm AS builder
+
+WORKDIR /build
+
+COPY pyproject.toml README.md ./
+COPY rodiumai/ rodiumai/
+
+RUN pip install --no-cache-dir build && \
+    python -m build --wheel
+
+
+FROM python:3.12-slim-bookworm AS runner
+
+RUN groupadd -r rodiumai && \
+    useradd -r -g rodiumai -d /app -s /sbin/nologin rodiumai
+
+WORKDIR /app
+
+COPY --from=builder /build/dist/*.whl /tmp/
+
+RUN pip install --no-cache-dir /tmp/*.whl && \
+    rm /tmp/*.whl && \
+    rm -rf /root/.cache
+
+USER rodiumai
+
+ENTRYPOINT ["python", "-c", "import rodiumai; print(f'RodiumAI SDK v{rodiumai.VERSION}')"]

rodiumai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RodiumAI
+
+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.

rodiumai-0.1.0/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: rodiumai
+Version: 0.1.0
+Summary: RodiumAI SDK — Unified AI API for Africa
+Project-URL: Homepage, https://rodiumai.io
+Project-URL: Documentation, https://docs.rodiumai.io
+Project-URL: Source, https://github.com/RodiumAI/rodiumai-python
+Project-URL: Issues, https://github.com/RodiumAI/rodiumai-python/issues
+Author-email: RodiumAI <dev@rodiumai.io>
+License: MIT
+License-File: LICENSE
+Keywords: africa,ai,api,llm,openai-compatible
+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.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 :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Requires-Dist: httpx>=0.25.0
+Provides-Extra: dev
+Requires-Dist: bandit>=1.7; extra == 'dev'
+Requires-Dist: black>=23.0; extra == 'dev'
+Requires-Dist: flake8>=6.0; extra == 'dev'
+Requires-Dist: isort>=5.0; extra == 'dev'
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pip-audit>=2.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# RodiumAI Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/rodiumai)](https://pypi.org/project/rodiumai/)
+[![Python versions](https://img.shields.io/pypi/pyversions/rodiumai)](https://pypi.org/project/rodiumai/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Unified AI API for Africa — access leading AI models through one SDK with local payment methods.
+
+> **OpenAI drop-in replacement** — migrate by changing only `api_key` and `base_url`.
+
+## Installation
+
+```bash
+pip install rodiumai
+```
+
+## Quick Start
+
+```python
+from rodiumai import RodiumAI
+import os
+
+client = RodiumAI(api_key=os.getenv("RODIUMAI_API_KEY"))
+
+# Chat completion
+response = client.chat.completions.create(
+    model="auto",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+print(response.choices[0].message.content)
+
+# Streaming
+for chunk in client.chat.completions.create(
+    model="auto",
+    messages=[{"role": "user", "content": "Hello!"}],
+    stream=True,
+):
+    print(chunk.choices[0].delta.content or "", end="")
+```
+
+## Migration from OpenAI
+
+```python
+# Before (OpenAI)
+from openai import OpenAI
+client = OpenAI(api_key="sk-...")
+
+# After (RodiumAI)
+from rodiumai import RodiumAI
+client = RodiumAI(api_key="rdk-...")
+```
+
+That's it. Same methods, same parameters, same response types.
+
+## Features
+
+- **Chat Completions** — Standard & streaming (SSE)
+- **Embeddings** — Single & batch text input
+- **Image Generation** — Text-to-image with size/quality options
+- **Audio** — Speech-to-text & text-to-speech
+- **Video** — Future-ready stub
+- **Retry Logic** — Automatic with exponential backoff
+- **Error Hierarchy** — 8 typed errors with fix suggestions
+- **Observability** — Structured JSON logging, usage stats, alerts
+- **Security** — API key masked everywhere, HTTPS enforced
+
+## Documentation
+
+Full documentation at [docs.rodiumai.io](https://docs.rodiumai.io).
+
+## Development
+
+```bash
+git clone https://github.com/RodiumAI/rodiumai-python.git
+cd rodiumai-python
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

rodiumai-0.1.0/README.md

@@ -0,0 +1,82 @@
+# RodiumAI Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/rodiumai)](https://pypi.org/project/rodiumai/)
+[![Python versions](https://img.shields.io/pypi/pyversions/rodiumai)](https://pypi.org/project/rodiumai/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Unified AI API for Africa — access leading AI models through one SDK with local payment methods.
+
+> **OpenAI drop-in replacement** — migrate by changing only `api_key` and `base_url`.
+
+## Installation
+
+```bash
+pip install rodiumai
+```
+
+## Quick Start
+
+```python
+from rodiumai import RodiumAI
+import os
+
+client = RodiumAI(api_key=os.getenv("RODIUMAI_API_KEY"))
+
+# Chat completion
+response = client.chat.completions.create(
+    model="auto",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+print(response.choices[0].message.content)
+
+# Streaming
+for chunk in client.chat.completions.create(
+    model="auto",
+    messages=[{"role": "user", "content": "Hello!"}],
+    stream=True,
+):
+    print(chunk.choices[0].delta.content or "", end="")
+```
+
+## Migration from OpenAI
+
+```python
+# Before (OpenAI)
+from openai import OpenAI
+client = OpenAI(api_key="sk-...")
+
+# After (RodiumAI)
+from rodiumai import RodiumAI
+client = RodiumAI(api_key="rdk-...")
+```
+
+That's it. Same methods, same parameters, same response types.
+
+## Features
+
+- **Chat Completions** — Standard & streaming (SSE)
+- **Embeddings** — Single & batch text input
+- **Image Generation** — Text-to-image with size/quality options
+- **Audio** — Speech-to-text & text-to-speech
+- **Video** — Future-ready stub
+- **Retry Logic** — Automatic with exponential backoff
+- **Error Hierarchy** — 8 typed errors with fix suggestions
+- **Observability** — Structured JSON logging, usage stats, alerts
+- **Security** — API key masked everywhere, HTTPS enforced
+
+## Documentation
+
+Full documentation at [docs.rodiumai.io](https://docs.rodiumai.io).
+
+## Development
+
+```bash
+git clone https://github.com/RodiumAI/rodiumai-python.git
+cd rodiumai-python
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

rodiumai-0.1.0/pyproject.toml

@@ -0,0 +1,80 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "rodiumai"
+version = "0.1.0"
+description = "RodiumAI SDK — Unified AI API for Africa"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+    { name = "RodiumAI", email = "dev@rodiumai.io" },
+]
+keywords = ["ai", "api", "africa", "llm", "openai-compatible"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+dependencies = [
+    "httpx>=0.25.0",
+]
+
+[project.urls]
+Homepage = "https://rodiumai.io"
+Documentation = "https://docs.rodiumai.io"
+Source = "https://github.com/RodiumAI/rodiumai-python"
+Issues = "https://github.com/RodiumAI/rodiumai-python/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-httpx>=0.30.0",
+    "pytest-cov>=4.0",
+    "flake8>=6.0",
+    "black>=23.0",
+    "mypy>=1.0",
+    "isort>=5.0",
+    "bandit>=1.7",
+    "pip-audit>=2.0",
+]
+
+[tool.coverage.run]
+branch = true
+source = ["rodiumai"]
+
+[tool.coverage.report]
+fail_under = 98.5
+skip_covered = true
+show_missing = true
+
+[tool.black]
+line-length = 100
+target-version = ["py38", "py39", "py310", "py311", "py312"]
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+[tool.mypy]
+python_version = "3.8"
+strict = true
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.bandit]
+exclude_dirs = ["tests"]

rodiumai-0.1.0/rodiumai/__init__.py

@@ -0,0 +1,29 @@
+from .client import RodiumAI
+from .errors import (
+    InsufficientRODIError,
+    InternalServerError,
+    InvalidAPIKeyError,
+    ModelNotFoundError,
+    NetworkError,
+    PermissionDeniedError,
+    RateLimitError,
+    RodiumAIError,
+    ServiceUnavailableError,
+    TimeoutError_ as TimeoutError,
+)
+from ._version import VERSION
+
+__all__ = [
+    "RodiumAI",
+    "RodiumAIError",
+    "InvalidAPIKeyError",
+    "InsufficientRODIError",
+    "PermissionDeniedError",
+    "ModelNotFoundError",
+    "RateLimitError",
+    "InternalServerError",
+    "ServiceUnavailableError",
+    "TimeoutError",
+    "NetworkError",
+    "VERSION",
+]