impossibl 0.0.1__tar.gz

impossibl-0.0.1/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: impossibl
+Version: 0.0.1
+Summary: A minimal Python client for the Impossibl AI API.
+Project-URL: Homepage, https://impossibl.com
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: openai<3,>=2
+
+# impossibl
+
+Impossibl is an AI gateway with self-serve inference.
+
+Build with models from OpenAI, Anthropic, Google, and xAI through one
+OpenAI-compatible API. Change the model ID to try another provider, while
+keeping the same integration.
+
+[Impossibl](https://impossibl.com) brings your models together with one API key,
+unified usage and billing, and automatic provider fallbacks.
+
+## Python client
+
+This package is a small client for the hosted Impossibl API. It extends the
+OpenAI Python client with Impossibl's endpoint and the `IMPOSSIBL_API_KEY`
+environment variable.
+
+```sh
+pip install impossibl
+export IMPOSSIBL_API_KEY="your-api-key"
+```
+
+List available models:
+
+```python
+from impossibl import Impossibl
+
+with Impossibl() as client:
+    for model in client.models.list():
+        print(model.id)
+```
+
+Generate a response using a model ID from the list:
+
+```python
+import os
+from impossibl import Impossibl
+
+with Impossibl() as client:
+    response = client.chat.completions.create(
+        model=os.environ["IMPOSSIBL_MODEL"],
+        messages=[{"role": "user", "content": "Hello!"}],
+    )
+    print(response.choices[0].message.content)
+```
+
+Set `IMPOSSIBL_MODEL` to your chosen model ID before running the second example.
+Model availability, pricing, and API credentials are managed by Impossibl.
+Generation requests may consume your account balance.
+
+You can also pass `api_key` explicitly. OpenAI client options such as `timeout`,
+`max_retries`, and `base_url` are forwarded unchanged. An explicit key takes
+precedence over `IMPOSSIBL_API_KEY`; `OPENAI_API_KEY` is not used as a fallback.
+
+This initial release provides a synchronous client. It does not create accounts
+or manage billing. API compatibility is determined by the Impossibl service.

impossibl-0.0.1/PYTHON.md

@@ -0,0 +1,56 @@
+# impossibl
+
+Impossibl is an AI gateway with self-serve inference.
+
+Build with models from OpenAI, Anthropic, Google, and xAI through one
+OpenAI-compatible API. Change the model ID to try another provider, while
+keeping the same integration.
+
+[Impossibl](https://impossibl.com) brings your models together with one API key,
+unified usage and billing, and automatic provider fallbacks.
+
+## Python client
+
+This package is a small client for the hosted Impossibl API. It extends the
+OpenAI Python client with Impossibl's endpoint and the `IMPOSSIBL_API_KEY`
+environment variable.
+
+```sh
+pip install impossibl
+export IMPOSSIBL_API_KEY="your-api-key"
+```
+
+List available models:
+
+```python
+from impossibl import Impossibl
+
+with Impossibl() as client:
+    for model in client.models.list():
+        print(model.id)
+```
+
+Generate a response using a model ID from the list:
+
+```python
+import os
+from impossibl import Impossibl
+
+with Impossibl() as client:
+    response = client.chat.completions.create(
+        model=os.environ["IMPOSSIBL_MODEL"],
+        messages=[{"role": "user", "content": "Hello!"}],
+    )
+    print(response.choices[0].message.content)
+```
+
+Set `IMPOSSIBL_MODEL` to your chosen model ID before running the second example.
+Model availability, pricing, and API credentials are managed by Impossibl.
+Generation requests may consume your account balance.
+
+You can also pass `api_key` explicitly. OpenAI client options such as `timeout`,
+`max_retries`, and `base_url` are forwarded unchanged. An explicit key takes
+precedence over `IMPOSSIBL_API_KEY`; `OPENAI_API_KEY` is not used as a fallback.
+
+This initial release provides a synchronous client. It does not create accounts
+or manage billing. API compatibility is determined by the Impossibl service.

impossibl-0.0.1/README.md

@@ -0,0 +1,54 @@
+# impossibl
+
+Impossibl is an AI gateway with self-serve inference.
+
+Build with models from OpenAI, Anthropic, Google, and xAI through one
+OpenAI-compatible API. Change the model ID to try another provider, while
+keeping the same integration.
+
+[Impossibl](https://impossibl.com) brings your models together with one API key,
+unified usage and billing, and automatic provider fallbacks. Connect your existing
+OpenAI SDK to `https://api.impossibl.com/v1` to get started.
+
+Explore the API at [impossibl.com](https://impossibl.com).
+
+## Packages
+
+The Python package is a small client for the hosted API. It configures the
+OpenAI Python SDK with Impossibl's endpoint and your `IMPOSSIBL_API_KEY`.
+See [Python usage](PYTHON.md) for installation and examples.
+
+The npm package is still a placeholder with no functionality.
+
+## Publishing
+
+Both packages use version `0.0.1`. Update `package.json`, `pyproject.toml`, and
+`src/impossibl/__init__.py` together for future releases.
+
+### npm
+
+```sh
+npm login
+npm publish --access public
+```
+
+### PyPI
+
+```sh
+python3 -m venv .venv
+.venv/bin/python -m pip install build twine
+.venv/bin/python -m build
+.venv/bin/python -m twine check dist/*
+.venv/bin/python -m twine upload dist/*
+```
+
+Publishing requires an available package name and registry credentials.
+
+## Python verification
+
+```sh
+.venv/bin/python -m pip install -e .
+.venv/bin/python -m unittest discover -s tests
+```
+
+Tests use mocked HTTP requests; they do not call the live API or spend credits.

impossibl-0.0.1/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "impossibl"
+version = "0.0.1"
+description = "A minimal Python client for the Impossibl AI API."
+readme = "PYTHON.md"
+requires-python = ">=3.9"
+dependencies = ["openai>=2,<3"]
+
+[project.urls]
+Homepage = "https://impossibl.com"
+
+[tool.setuptools.packages.find]
+where = ["src"]

impossibl-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

impossibl-0.0.1/src/impossibl/__init__.py

@@ -0,0 +1,19 @@
+"""A minimal Python client for the Impossibl AI API."""
+
+import os
+from typing import Any, Optional
+
+from openai import OpenAI
+
+__version__ = "0.0.1"
+
+
+class Impossibl(OpenAI):
+    """OpenAI-compatible client using Impossibl's endpoint and API key."""
+
+    def __init__(self, *, api_key: Optional[str] = None, **kwargs: Any) -> None:
+        key = api_key if api_key is not None else os.environ.get("IMPOSSIBL_API_KEY")
+        if not key:
+            raise ValueError("Pass api_key or set the IMPOSSIBL_API_KEY environment variable.")
+        kwargs.setdefault("base_url", "https://api.impossibl.com/v1")
+        super().__init__(api_key=key, **kwargs)

impossibl-0.0.1/src/impossibl.egg-info/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: impossibl
+Version: 0.0.1
+Summary: A minimal Python client for the Impossibl AI API.
+Project-URL: Homepage, https://impossibl.com
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: openai<3,>=2
+
+# impossibl
+
+Impossibl is an AI gateway with self-serve inference.
+
+Build with models from OpenAI, Anthropic, Google, and xAI through one
+OpenAI-compatible API. Change the model ID to try another provider, while
+keeping the same integration.
+
+[Impossibl](https://impossibl.com) brings your models together with one API key,
+unified usage and billing, and automatic provider fallbacks.
+
+## Python client
+
+This package is a small client for the hosted Impossibl API. It extends the
+OpenAI Python client with Impossibl's endpoint and the `IMPOSSIBL_API_KEY`
+environment variable.
+
+```sh
+pip install impossibl
+export IMPOSSIBL_API_KEY="your-api-key"
+```
+
+List available models:
+
+```python
+from impossibl import Impossibl
+
+with Impossibl() as client:
+    for model in client.models.list():
+        print(model.id)
+```
+
+Generate a response using a model ID from the list:
+
+```python
+import os
+from impossibl import Impossibl
+
+with Impossibl() as client:
+    response = client.chat.completions.create(
+        model=os.environ["IMPOSSIBL_MODEL"],
+        messages=[{"role": "user", "content": "Hello!"}],
+    )
+    print(response.choices[0].message.content)
+```
+
+Set `IMPOSSIBL_MODEL` to your chosen model ID before running the second example.
+Model availability, pricing, and API credentials are managed by Impossibl.
+Generation requests may consume your account balance.
+
+You can also pass `api_key` explicitly. OpenAI client options such as `timeout`,
+`max_retries`, and `base_url` are forwarded unchanged. An explicit key takes
+precedence over `IMPOSSIBL_API_KEY`; `OPENAI_API_KEY` is not used as a fallback.
+
+This initial release provides a synchronous client. It does not create accounts
+or manage billing. API compatibility is determined by the Impossibl service.

impossibl-0.0.1/src/impossibl.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+PYTHON.md
+README.md
+pyproject.toml
+src/impossibl/__init__.py
+src/impossibl.egg-info/PKG-INFO
+src/impossibl.egg-info/SOURCES.txt
+src/impossibl.egg-info/dependency_links.txt
+src/impossibl.egg-info/requires.txt
+src/impossibl.egg-info/top_level.txt
+tests/test_client.py

impossibl-0.0.1/src/impossibl.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

impossibl-0.0.1/src/impossibl.egg-info/requires.txt

@@ -0,0 +1 @@
+openai<3,>=2

impossibl-0.0.1/src/impossibl.egg-info/top_level.txt

@@ -0,0 +1 @@
+impossibl

impossibl-0.0.1/tests/test_client.py

@@ -0,0 +1,61 @@
+import json
+import os
+import unittest
+from unittest.mock import patch
+
+import httpx
+
+from impossibl import Impossibl
+
+
+class ClientTests(unittest.TestCase):
+    @patch.dict(os.environ, {"IMPOSSIBL_API_KEY": "test-impossibl-key"}, clear=True)
+    def test_models_use_gateway_and_environment_key(self):
+        def handle(request):
+            self.assertEqual(request.method, "GET")
+            self.assertEqual(str(request.url), "https://api.impossibl.com/v1/models")
+            self.assertEqual(request.headers["authorization"], "Bearer test-impossibl-key")
+            return httpx.Response(200, json={
+                "object": "list",
+                "data": [{"id": "test/model", "object": "model", "created": 0,
+                          "owned_by": "test"}],
+            })
+
+        with Impossibl(http_client=httpx.Client(transport=httpx.MockTransport(handle))) as client:
+            self.assertEqual(client.models.list().data[0].id, "test/model")
+
+    @patch.dict(os.environ, {"IMPOSSIBL_API_KEY": "environment-key"}, clear=True)
+    def test_completion_and_explicit_options(self):
+        def handle(request):
+            self.assertEqual(request.method, "POST")
+            self.assertEqual(str(request.url), "https://example.test/v1/chat/completions")
+            self.assertEqual(request.headers["authorization"], "Bearer explicit-key")
+            self.assertEqual(json.loads(request.content), {
+                "model": "test/model",
+                "messages": [{"role": "user", "content": "Hello!"}],
+            })
+            return httpx.Response(200, json={
+                "id": "test-completion", "object": "chat.completion", "created": 0,
+                "model": "test/model",
+                "choices": [{"index": 0, "finish_reason": "stop",
+                             "message": {"role": "assistant", "content": "Hi!"}}],
+            })
+
+        with Impossibl(
+            api_key="explicit-key", base_url="https://example.test/v1",
+            http_client=httpx.Client(transport=httpx.MockTransport(handle)),
+        ) as client:
+            response = client.chat.completions.create(
+                model="test/model", messages=[{"role": "user", "content": "Hello!"}],
+            )
+            self.assertEqual(response.choices[0].message.content, "Hi!")
+
+    @patch.dict(os.environ, {"OPENAI_API_KEY": "unrelated-key"}, clear=True)
+    def test_missing_key_does_not_fall_back_to_openai_key(self):
+        with self.assertRaisesRegex(ValueError, "IMPOSSIBL_API_KEY"):
+            Impossibl()
+
+    @patch.dict(os.environ, {"IMPOSSIBL_API_KEY": "environment-key"}, clear=True)
+    def test_empty_explicit_key_is_rejected(self):
+        with self.assertRaisesRegex(ValueError, "IMPOSSIBL_API_KEY"):
+            Impossibl(api_key="")