nexttoken 0.1.0__tar.gz

nexttoken-0.1.0/.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.pytest_cache/
+.coverage
+htmlcov/
+.venv/
+venv/
+
+# Node
+node_modules/
+npm-debug.log
+yarn-error.log
+
+# IDE/Editor
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Build artifacts
+*.log
+*.tmp

nexttoken-0.1.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: nexttoken
+Version: 0.1.0
+Summary: NextToken SDK - Simple client for the NextToken APIs and Gateway
+Project-URL: Homepage, https://nexttoken.co
+Project-URL: Documentation, https://docs.nexttoken.co
+Project-URL: Repository, https://github.com/NextTokenAI/nexttoken
+Author-email: NextToken <contact@nexttoken.co>
+License-Expression: MIT
+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
+Requires-Python: >=3.8
+Requires-Dist: openai>=1.0.0
+Description-Content-Type: text/markdown
+
+# NextToken Python SDK
+
+Simple Python client for the NextToken Gateway - an OpenAI-compatible LLM proxy.
+
+## Installation
+
+```bash
+pip install nexttoken
+```
+
+## Quick Start
+
+```python
+from nexttoken import NextToken
+
+# Initialize with your API key
+client = NextToken(api_key="your-api-key")
+
+# Use like the OpenAI SDK
+response = client.chat.completions.create(
+    model="gpt-4o",  # or "claude-3-5-sonnet", "gemini-2.5-flash"
+    messages=[
+        {"role": "user", "content": "Hello!"}
+    ]
+)
+
+print(response.choices[0].message.content)
+```
+
+## Using with OpenAI SDK Directly
+
+Since the Gateway is OpenAI-compatible, you can also use the OpenAI SDK:
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    api_key="your-nexttoken-api-key",
+    base_url="https://gateway.nexttoken.co/v1"
+)
+
+response = client.chat.completions.create(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+## Available Models
+
+- OpenAI models
+- Anthropic models
+- Gemini models
+- Openrouter models
+
+## Embeddings
+
+```python
+from nexttoken import NextToken
+
+client = NextToken(api_key="your-api-key")
+
+response = client.embeddings.create(
+    model="text-embedding-3-small",
+    input="Your text to embed"
+)
+
+print(response.data[0].embedding)
+```
+
+## Get Your API Key
+
+Sign up at [nexttoken.co](https://nexttoken.co) and get your API key from Settings.
+
+## License
+
+MIT

nexttoken-0.1.0/README.md

@@ -0,0 +1,76 @@
+# NextToken Python SDK
+
+Simple Python client for the NextToken Gateway - an OpenAI-compatible LLM proxy.
+
+## Installation
+
+```bash
+pip install nexttoken
+```
+
+## Quick Start
+
+```python
+from nexttoken import NextToken
+
+# Initialize with your API key
+client = NextToken(api_key="your-api-key")
+
+# Use like the OpenAI SDK
+response = client.chat.completions.create(
+    model="gpt-4o",  # or "claude-3-5-sonnet", "gemini-2.5-flash"
+    messages=[
+        {"role": "user", "content": "Hello!"}
+    ]
+)
+
+print(response.choices[0].message.content)
+```
+
+## Using with OpenAI SDK Directly
+
+Since the Gateway is OpenAI-compatible, you can also use the OpenAI SDK:
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    api_key="your-nexttoken-api-key",
+    base_url="https://gateway.nexttoken.co/v1"
+)
+
+response = client.chat.completions.create(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+## Available Models
+
+- OpenAI models
+- Anthropic models
+- Gemini models
+- Openrouter models
+
+## Embeddings
+
+```python
+from nexttoken import NextToken
+
+client = NextToken(api_key="your-api-key")
+
+response = client.embeddings.create(
+    model="text-embedding-3-small",
+    input="Your text to embed"
+)
+
+print(response.data[0].embedding)
+```
+
+## Get Your API Key
+
+Sign up at [nexttoken.co](https://nexttoken.co) and get your API key from Settings.
+
+## License
+
+MIT

nexttoken-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "nexttoken"
+version = "0.1.0"
+description = "NextToken SDK - Simple client for the NextToken APIs and Gateway"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    { name = "NextToken", email = "contact@nexttoken.co" }
+]
+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",
+]
+dependencies = [
+    "openai>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://nexttoken.co"
+Documentation = "https://docs.nexttoken.co"
+Repository = "https://github.com/NextTokenAI/nexttoken"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/nexttoken"]

nexttoken-0.1.0/src/nexttoken/__init__.py

@@ -0,0 +1,6 @@
+"""NextToken SDK - Simple client for the NextToken Gateway."""
+
+from .client import NextToken
+
+__version__ = "0.1.0"
+__all__ = ["NextToken", "__version__"]

nexttoken-0.1.0/src/nexttoken/client.py

@@ -0,0 +1,57 @@
+"""NextToken client for the OpenAI-compatible Gateway."""
+
+from __future__ import annotations
+
+from openai import OpenAI
+
+
+class NextToken:
+    """Simple client for the NextToken Gateway.
+
+    The Gateway is an OpenAI-compatible LLM proxy that provides:
+    - Access to multiple models (GPT-4, Claude, Gemini)
+    - Usage tracking and cost management
+    - Simple Bearer token authentication
+
+    Example:
+        >>> from nexttoken import NextToken
+        >>> client = NextToken(api_key="your-api-key")
+        >>> response = client.chat.completions.create(
+        ...     model="gpt-4o",
+        ...     messages=[{"role": "user", "content": "Hello!"}]
+        ... )
+        >>> print(response.choices[0].message.content)
+    """
+
+    DEFAULT_BASE_URL = "https://gateway.nexttoken.co/v1"
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str | None = None,
+    ):
+        """Initialize the NextToken client.
+
+        Args:
+            api_key: Your NextToken API key (from https://nexttoken.co/settings)
+            base_url: Optional custom gateway URL (defaults to production)
+        """
+        self._client = OpenAI(
+            api_key=api_key,
+            base_url=base_url or self.DEFAULT_BASE_URL,
+        )
+
+    @property
+    def chat(self):
+        """Access chat completions."""
+        return self._client.chat
+
+    @property
+    def embeddings(self):
+        """Access embeddings."""
+        return self._client.embeddings
+
+    @property
+    def models(self):
+        """Access models list."""
+        return self._client.models