onlist 0.1.0__tar.gz

onlist-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

onlist-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,41 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e . && pip install pytest pytest-asyncio respx
+      - run: pytest -v
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - run: pip install -e . && pip install mypy
+      - run: mypy src/onlist/
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - run: pip install ruff
+      - run: ruff check src/ tests/
+      - run: ruff format --check src/ tests/

onlist-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.venv/
+venv/
+*.so
+.env
+.env.local

onlist-0.1.0/LICENSE

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

onlist-0.1.0/PKG-INFO

@@ -0,0 +1,303 @@
+Metadata-Version: 2.4
+Name: onlist
+Version: 0.1.0
+Summary: Official Python SDK for Onlist, the AI API marketplace. Access GPT, Claude, Gemini, DeepSeek and 40+ models through one OpenAI-compatible API.
+Project-URL: Homepage, https://onlist.io
+Project-URL: Documentation, https://onlist.io/docs
+Project-URL: Repository, https://github.com/OnlistTeam/onlist-python
+Project-URL: API Reference, https://onlist.io/docs/api
+Project-URL: Model Catalog, https://onlist.io/models
+Project-URL: Provider Directory, https://onlist.io/providers
+Project-URL: Changelog, https://github.com/OnlistTeam/onlist-python/releases
+Project-URL: Issues, https://github.com/OnlistTeam/onlist-python/issues
+Author-email: Onlist <dev@onlist.io>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,ai-api,ai-gateway,anthropic,api,chat-completion,claude,deepseek,gemini,gpt,llm,llm-proxy,marketplace,model-router,onlist,openai,openrouter,sdk
+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.9
+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: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Description-Content-Type: text/markdown
+
+# Onlist Python SDK
+
+The official Python client for [Onlist](https://onlist.io), the AI API marketplace.
+
+Onlist aggregates 40+ AI model providers behind a single OpenAI-compatible API.
+This SDK is a drop-in replacement for the OpenAI Python client, so you can switch
+with one line of code.
+
+[![PyPI version](https://img.shields.io/pypi/v/onlist.svg)](https://pypi.org/project/onlist/)
+[![Python versions](https://img.shields.io/pypi/pyversions/onlist.svg)](https://pypi.org/project/onlist/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/OnlistTeam/onlist-python/blob/main/LICENSE)
+
+## Installation
+
+```bash
+pip install onlist
+```
+
+## Quick Start
+
+```python
+from onlist import Onlist
+
+client = Onlist(api_key="sk-...")  # or set ONLIST_API_KEY env var
+
+response = client.chat.completions.create(
+    model="anthropic/claude-sonnet-4",
+    messages=[{"role": "user", "content": "What is Onlist?"}],
+)
+print(response.choices[0].message.content)
+```
+
+Get your API key at [onlist.io](https://onlist.io).
+
+## Authentication
+
+The client reads your API key from:
+1. The `api_key` parameter
+2. The `ONLIST_API_KEY` environment variable
+3. The `OPENAI_API_KEY` environment variable (fallback, for easy migration)
+
+```bash
+export ONLIST_API_KEY="sk-..."
+```
+
+## Provider Routing
+
+Onlist's marketplace lets you choose which provider serves your request.
+Use the `provider` field via `extra_body`:
+
+```python
+# Pin to a specific provider
+response = client.chat.completions.create(
+    model="anthropic/claude-sonnet-4",
+    messages=[{"role": "user", "content": "Hello"}],
+    extra_body={"provider": "alice-shop"},
+)
+
+# Route to the cheapest provider
+response = client.chat.completions.create(
+    model="openai/gpt-4o",
+    messages=[{"role": "user", "content": "Hello"}],
+    extra_body={"provider": {"sort": "price"}},
+)
+
+# Full routing control
+response = client.chat.completions.create(
+    model="openai/gpt-4o",
+    messages=[{"role": "user", "content": "Hello"}],
+    extra_body={
+        "provider": {
+            "allow": ["alice-shop", "bob-relay"],
+            "sort": "price",
+            "allow_fallbacks": True,
+            "max_price": {"prompt": 0.000003, "completion": 0.000015},
+        }
+    },
+)
+```
+
+You can also use the typed helper:
+
+```python
+from onlist import ProviderRouting
+
+routing = ProviderRouting(
+    allow=["alice-shop", "bob-relay"],
+    sort="price",
+)
+
+response = client.chat.completions.create(
+    model="openai/gpt-4o",
+    messages=[{"role": "user", "content": "Hello"}],
+    extra_body={"provider": routing.model_dump(exclude_none=True)},
+)
+```
+
+## Streaming
+
+```python
+stream = client.chat.completions.create(
+    model="anthropic/claude-sonnet-4",
+    messages=[{"role": "user", "content": "Write a haiku about APIs"}],
+    stream=True,
+)
+
+for chunk in stream:
+    content = chunk.choices[0].delta.content
+    if content:
+        print(content, end="", flush=True)
+```
+
+## Async Usage
+
+```python
+import asyncio
+from onlist import AsyncOnlist
+
+async def main():
+    client = AsyncOnlist(api_key="sk-...")
+
+    response = await client.chat.completions.create(
+        model="openai/gpt-4o",
+        messages=[{"role": "user", "content": "Hello!"}],
+    )
+    print(response.choices[0].message.content)
+
+asyncio.run(main())
+```
+
+## Marketplace API
+
+Query the Onlist marketplace for models and providers:
+
+```python
+from onlist import Onlist
+
+client = Onlist(api_key="sk-...")
+
+# List available models with pricing
+models = client.marketplace.models.list(limit=10)
+for m in models.data:
+    print(f"{m['id']} - input: {m.get('pricing', {}).get('prompt', 'N/A')}")
+
+# Get detailed model info with all provider offers
+detail = client.marketplace.models.get("anthropic/claude-sonnet-4")
+print(f"{detail.id} - {len(detail.providers)} providers")
+
+# Browse providers
+providers = client.marketplace.providers.list()
+for p in providers.data:
+    print(f"{p.slug} - score: {p.score}")
+
+# Get a specific provider's profile
+provider = client.marketplace.providers.get("alice-shop")
+print(f"{provider.display_name} - {provider.model_count} models")
+```
+
+## Other APIs
+
+Since Onlist is fully OpenAI-compatible, all standard endpoints work:
+
+```python
+# Embeddings
+embedding = client.embeddings.create(
+    model="openai/text-embedding-3-small",
+    input="Hello world",
+)
+
+# Image generation
+image = client.images.generate(
+    model="openai/gpt-image-2",
+    prompt="A sunset over Tokyo",
+)
+
+# Text-to-speech
+audio = client.audio.speech.create(
+    model="openai/tts-1",
+    voice="alloy",
+    input="Welcome to Onlist.",
+)
+```
+
+## Error Handling
+
+For OpenAI-compatible API calls (`chat.completions`, `embeddings`, etc.), the
+standard `openai` exceptions are raised:
+
+```python
+import openai
+from onlist import Onlist
+
+client = Onlist(api_key="sk-...")
+
+try:
+    response = client.chat.completions.create(
+        model="openai/gpt-4o",
+        messages=[{"role": "user", "content": "Hello"}],
+    )
+except openai.AuthenticationError:
+    print("Invalid API key")
+except openai.RateLimitError as e:
+    print(f"Rate limited: {e.message}")
+```
+
+For marketplace API calls (`client.marketplace.*`), Onlist-specific exceptions
+are raised:
+
+```python
+from onlist import Onlist, AuthenticationError, APIError
+
+client = Onlist(api_key="sk-...")
+
+try:
+    providers = client.marketplace.providers.list()
+except AuthenticationError:
+    print("Invalid API key for marketplace")
+except APIError as e:
+    print(f"API error {e.status_code}: {e.message}")
+```
+
+## Migrate from OpenAI or OpenRouter
+
+Already using the OpenAI SDK? Change one line:
+
+```diff
+- from openai import OpenAI
+- client = OpenAI(api_key="sk-...")
++ from onlist import Onlist
++ client = Onlist(api_key="sk-...")
+```
+
+Or, if you prefer to keep using `openai` directly:
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    api_key="your-onlist-key",
+    base_url="https://onlist.io/v1",
+)
+```
+
+## Routing Metadata
+
+Onlist returns routing information in response headers. Access them to see
+which provider actually served your request:
+
+```python
+# Use the with_raw_response pattern from the openai SDK:
+raw_response = client.chat.completions.with_raw_response.create(
+    model="openai/gpt-4o",
+    messages=[{"role": "user", "content": "Hello"}],
+)
+print(raw_response.headers.get("x-onlist-route-id"))
+print(raw_response.headers.get("x-onlist-provider"))
+
+# Parse the completion as usual:
+response = raw_response.parse()
+print(response.choices[0].message.content)
+```
+
+## Links
+
+- [Onlist Website](https://onlist.io)
+- [API Documentation](https://onlist.io/docs)
+- [Model Catalog](https://onlist.io/models)
+- [Provider Directory](https://onlist.io/providers)
+- [GitHub](https://github.com/OnlistTeam/onlist-python)

onlist-0.1.0/README.md

@@ -0,0 +1,269 @@
+# Onlist Python SDK
+
+The official Python client for [Onlist](https://onlist.io), the AI API marketplace.
+
+Onlist aggregates 40+ AI model providers behind a single OpenAI-compatible API.
+This SDK is a drop-in replacement for the OpenAI Python client, so you can switch
+with one line of code.
+
+[![PyPI version](https://img.shields.io/pypi/v/onlist.svg)](https://pypi.org/project/onlist/)
+[![Python versions](https://img.shields.io/pypi/pyversions/onlist.svg)](https://pypi.org/project/onlist/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/OnlistTeam/onlist-python/blob/main/LICENSE)
+
+## Installation
+
+```bash
+pip install onlist
+```
+
+## Quick Start
+
+```python
+from onlist import Onlist
+
+client = Onlist(api_key="sk-...")  # or set ONLIST_API_KEY env var
+
+response = client.chat.completions.create(
+    model="anthropic/claude-sonnet-4",
+    messages=[{"role": "user", "content": "What is Onlist?"}],
+)
+print(response.choices[0].message.content)
+```
+
+Get your API key at [onlist.io](https://onlist.io).
+
+## Authentication
+
+The client reads your API key from:
+1. The `api_key` parameter
+2. The `ONLIST_API_KEY` environment variable
+3. The `OPENAI_API_KEY` environment variable (fallback, for easy migration)
+
+```bash
+export ONLIST_API_KEY="sk-..."
+```
+
+## Provider Routing
+
+Onlist's marketplace lets you choose which provider serves your request.
+Use the `provider` field via `extra_body`:
+
+```python
+# Pin to a specific provider
+response = client.chat.completions.create(
+    model="anthropic/claude-sonnet-4",
+    messages=[{"role": "user", "content": "Hello"}],
+    extra_body={"provider": "alice-shop"},
+)
+
+# Route to the cheapest provider
+response = client.chat.completions.create(
+    model="openai/gpt-4o",
+    messages=[{"role": "user", "content": "Hello"}],
+    extra_body={"provider": {"sort": "price"}},
+)
+
+# Full routing control
+response = client.chat.completions.create(
+    model="openai/gpt-4o",
+    messages=[{"role": "user", "content": "Hello"}],
+    extra_body={
+        "provider": {
+            "allow": ["alice-shop", "bob-relay"],
+            "sort": "price",
+            "allow_fallbacks": True,
+            "max_price": {"prompt": 0.000003, "completion": 0.000015},
+        }
+    },
+)
+```
+
+You can also use the typed helper:
+
+```python
+from onlist import ProviderRouting
+
+routing = ProviderRouting(
+    allow=["alice-shop", "bob-relay"],
+    sort="price",
+)
+
+response = client.chat.completions.create(
+    model="openai/gpt-4o",
+    messages=[{"role": "user", "content": "Hello"}],
+    extra_body={"provider": routing.model_dump(exclude_none=True)},
+)
+```
+
+## Streaming
+
+```python
+stream = client.chat.completions.create(
+    model="anthropic/claude-sonnet-4",
+    messages=[{"role": "user", "content": "Write a haiku about APIs"}],
+    stream=True,
+)
+
+for chunk in stream:
+    content = chunk.choices[0].delta.content
+    if content:
+        print(content, end="", flush=True)
+```
+
+## Async Usage
+
+```python
+import asyncio
+from onlist import AsyncOnlist
+
+async def main():
+    client = AsyncOnlist(api_key="sk-...")
+
+    response = await client.chat.completions.create(
+        model="openai/gpt-4o",
+        messages=[{"role": "user", "content": "Hello!"}],
+    )
+    print(response.choices[0].message.content)
+
+asyncio.run(main())
+```
+
+## Marketplace API
+
+Query the Onlist marketplace for models and providers:
+
+```python
+from onlist import Onlist
+
+client = Onlist(api_key="sk-...")
+
+# List available models with pricing
+models = client.marketplace.models.list(limit=10)
+for m in models.data:
+    print(f"{m['id']} - input: {m.get('pricing', {}).get('prompt', 'N/A')}")
+
+# Get detailed model info with all provider offers
+detail = client.marketplace.models.get("anthropic/claude-sonnet-4")
+print(f"{detail.id} - {len(detail.providers)} providers")
+
+# Browse providers
+providers = client.marketplace.providers.list()
+for p in providers.data:
+    print(f"{p.slug} - score: {p.score}")
+
+# Get a specific provider's profile
+provider = client.marketplace.providers.get("alice-shop")
+print(f"{provider.display_name} - {provider.model_count} models")
+```
+
+## Other APIs
+
+Since Onlist is fully OpenAI-compatible, all standard endpoints work:
+
+```python
+# Embeddings
+embedding = client.embeddings.create(
+    model="openai/text-embedding-3-small",
+    input="Hello world",
+)
+
+# Image generation
+image = client.images.generate(
+    model="openai/gpt-image-2",
+    prompt="A sunset over Tokyo",
+)
+
+# Text-to-speech
+audio = client.audio.speech.create(
+    model="openai/tts-1",
+    voice="alloy",
+    input="Welcome to Onlist.",
+)
+```
+
+## Error Handling
+
+For OpenAI-compatible API calls (`chat.completions`, `embeddings`, etc.), the
+standard `openai` exceptions are raised:
+
+```python
+import openai
+from onlist import Onlist
+
+client = Onlist(api_key="sk-...")
+
+try:
+    response = client.chat.completions.create(
+        model="openai/gpt-4o",
+        messages=[{"role": "user", "content": "Hello"}],
+    )
+except openai.AuthenticationError:
+    print("Invalid API key")
+except openai.RateLimitError as e:
+    print(f"Rate limited: {e.message}")
+```
+
+For marketplace API calls (`client.marketplace.*`), Onlist-specific exceptions
+are raised:
+
+```python
+from onlist import Onlist, AuthenticationError, APIError
+
+client = Onlist(api_key="sk-...")
+
+try:
+    providers = client.marketplace.providers.list()
+except AuthenticationError:
+    print("Invalid API key for marketplace")
+except APIError as e:
+    print(f"API error {e.status_code}: {e.message}")
+```
+
+## Migrate from OpenAI or OpenRouter
+
+Already using the OpenAI SDK? Change one line:
+
+```diff
+- from openai import OpenAI
+- client = OpenAI(api_key="sk-...")
++ from onlist import Onlist
++ client = Onlist(api_key="sk-...")
+```
+
+Or, if you prefer to keep using `openai` directly:
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    api_key="your-onlist-key",
+    base_url="https://onlist.io/v1",
+)
+```
+
+## Routing Metadata
+
+Onlist returns routing information in response headers. Access them to see
+which provider actually served your request:
+
+```python
+# Use the with_raw_response pattern from the openai SDK:
+raw_response = client.chat.completions.with_raw_response.create(
+    model="openai/gpt-4o",
+    messages=[{"role": "user", "content": "Hello"}],
+)
+print(raw_response.headers.get("x-onlist-route-id"))
+print(raw_response.headers.get("x-onlist-provider"))
+
+# Parse the completion as usual:
+response = raw_response.parse()
+print(response.choices[0].message.content)
+```
+
+## Links
+
+- [Onlist Website](https://onlist.io)
+- [API Documentation](https://onlist.io/docs)
+- [Model Catalog](https://onlist.io/models)
+- [Provider Directory](https://onlist.io/providers)
+- [GitHub](https://github.com/OnlistTeam/onlist-python)