xmode-ai-sdk 1.0.0__tar.gz

xmode_ai_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: xmode-ai-sdk
+Version: 1.0.0
+Summary: Python client for XMode AI – access multiple AI models with one API key
+Home-page: https://xmode.space
+Author: XMode Team
+Author-email: support@xmode.space
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+XMode AI Python client for accessing multiple AI models via one API key.

xmode_ai_sdk-1.0.0/README.md

@@ -0,0 +1,90 @@
+# 🚀 XMode AI Python Client
+
+**XMode AI** is a unified Python client for advanced AI models from **Anthropic**, **OpenAI**, and **Google Gemini**.  
+One API key – access to all leading models.
+
+---
+
+## 📦 Installation
+
+```bash
+# From source (recommended for development)
+pip install -e .
+
+# After publishing to PyPI
+pip install xmode-ai
+```
+
+---
+
+## 🚀 Quick Start
+
+```python
+from xmode_ai import XModeAI
+
+# Your personal API key from xmode.space dashboard
+ai = XModeAI(api_key="your-api-key")
+
+# Simple chat
+reply = ai.simple_chat("What is the capital of France?")
+print(reply)
+```
+
+---
+
+## 🧠 Available Models
+
+```python
+from xmode_ai import list_models
+
+for model in list_models():
+    print(f"{model['id']} – {model['name']} ({model['context']} ctx)")
+```
+
+### Model List (sample)
+
+| Provider  | Model              | Context | Price (input/output per 1M tokens) |
+|-----------|--------------------|---------|-----------------------------------|
+| Anthropic | Claude Opus 5      | 200K    | $2.50 / $12.50                    |
+| Anthropic | Claude Sonnet 5    | 200K    | $1.00 / $5.00                     |
+| OpenAI    | GPT-5.6 Sol        | 400K    | $2.50 / $15.00                    |
+| OpenAI    | GPT-5.5            | 400K    | $2.50 / $15.00                    |
+| Google    | Gemini 3.1 Pro     | 2M      | $1.00 / $6.00                     |
+| Google    | Gemini 3.6 Flash   | 1M      | $0.75 / $3.75                     |
+
+Full model list with all parameters is available in `xmode_ai.models`.
+
+---
+
+## ⚙️ Advanced Usage
+
+```python
+from xmode_ai import XModeAI
+
+ai = XModeAI(api_key="your-api-key")
+
+response = ai.chat_completion(
+    messages=[
+        {"role": "system", "content": "You are a helpful assistant."},
+        {"role": "user", "content": "Explain quantum computing in simple terms."}
+    ],
+    model="claude-sonnet-5",
+    temperature=0.5,
+    max_tokens=500
+)
+
+print(response["choices"][0]["message"]["content"])
+```
+
+---
+
+## 📚 Documentation
+
+- Official website: [xmode.space](https://xmode.space)
+- Support: [support@xmode.space](mailto:support@xmode.space)
+
+---
+
+## 📄 License
+
+MIT License © 2026 XMode Team

xmode_ai_sdk-1.0.0/setup.cfg

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

xmode_ai_sdk-1.0.0/setup.py

@@ -0,0 +1,20 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="xmode-ai-sdk",
+    version="1.0.0",
+    description="Python client for XMode AI – access multiple AI models with one API key",
+    long_description="XMode AI Python client for accessing multiple AI models via one API key.",
+    long_description_content_type="text/markdown",
+    author="XMode Team",
+    author_email="support@xmode.space",
+    url="https://xmode.space",
+    packages=find_packages(),
+    install_requires=["requests>=2.25.0"],
+    python_requires=">=3.7",
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+)

xmode_ai_sdk-1.0.0/xmode_ai/__init__.py

@@ -0,0 +1,18 @@
+"""
+XMode AI — Python клиент для работы с AI моделями.
+Используйте свой API-ключ, полученный в личном кабинете xmode.space.
+"""
+from .core import XModeAI
+from .models import MODELS, list_models, get_model_info
+from .exceptions import XModeError, APIError, AuthenticationError
+
+__all__ = [
+    "XModeAI",
+    "MODELS",
+    "list_models",
+    "get_model_info",
+    "XModeError",
+    "APIError",
+    "AuthenticationError",
+]
+__version__ = "1.0.0"

xmode_ai_sdk-1.0.0/xmode_ai/core.py

@@ -0,0 +1,66 @@
+"""
+Основной клиент для взаимодействия с XMode AI API.
+"""
+import requests
+from typing import List, Dict, Any, Optional
+from .exceptions import AuthenticationError, APIError
+from .models import get_model_info
+
+class XModeAI:
+    """
+    Клиент для XMode AI.
+    Использует единый API-ключ, полученный в личном кабинете xmode.space.
+    По умолчанию отправляет запросы на https://api.xmode.space/v1.
+    """
+    def __init__(self, api_key: str, base_url: str = "https://api.xmode.space/v1"):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip('/')
+        self.headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json"
+        }
+
+    def _request(self, method: str, endpoint: str, data: Dict = None) -> Dict:
+        url = f"{self.base_url}/{endpoint.lstrip('/')}"
+        try:
+            response = requests.request(
+                method=method,
+                url=url,
+                headers=self.headers,
+                json=data,
+                timeout=60
+            )
+            if response.status_code == 401:
+                raise AuthenticationError("Invalid API key.")
+            if response.status_code >= 400:
+                raise APIError(f"API error {response.status_code}: {response.text}")
+            return response.json()
+        except requests.exceptions.RequestException as e:
+            raise APIError(f"Network error: {e}")
+
+    def chat_completion(
+        self,
+        messages: List[Dict[str, str]],
+        model: str = "gpt-3.5-turbo",
+        temperature: float = 0.7,
+        max_tokens: int = 1000,
+        **kwargs
+    ) -> Dict[str, Any]:
+        """Отправить запрос на завершение чата."""
+        payload = {
+            "model": model,
+            "messages": messages,
+            "temperature": temperature,
+            "max_tokens": max_tokens,
+            **kwargs
+        }
+        return self._request("POST", "/chat/completions", payload)
+
+    def simple_chat(self, prompt: str, model: str = "gpt-3.5-turbo", **kwargs) -> str:
+        """Упрощённый метод: отправляет один промпт, возвращает текст ответа."""
+        messages = [{"role": "user", "content": prompt}]
+        result = self.chat_completion(messages, model=model, **kwargs)
+        try:
+            return result["choices"][0]["message"]["content"]
+        except (KeyError, IndexError):
+            raise APIError("Unexpected response format.")

xmode_ai_sdk-1.0.0/xmode_ai/exceptions.py

@@ -0,0 +1,13 @@
+"""Кастомные исключения для библиотеки."""
+
+class XModeError(Exception):
+    """Базовое исключение XMode AI."""
+    pass
+
+class AuthenticationError(XModeError):
+    """Ошибка аутентификации (неверный API-ключ)."""
+    pass
+
+class APIError(XModeError):
+    """Ошибка при вызове API (сетевая или серверная)."""
+    pass

xmode_ai_sdk-1.0.0/xmode_ai/models.py

@@ -0,0 +1,80 @@
+"""
+Список доступных моделей, сгруппированных по провайдерам.
+Актуально на август 2026.
+"""
+MODELS = {
+    "anthropic": [
+        {"id": "claude-opus-5", "name": "Claude Opus 5", "context": 200000,
+         "description": "Flagship model for demanding reasoning, coding, and long-horizon agentic work",
+         "input_price": 2.5, "output_price": 12.5},
+        {"id": "claude-sonnet-5", "name": "Claude Sonnet 5", "context": 200000,
+         "description": "The most powerful Sonnet model, excelling at coding, agentic, and professional tasks",
+         "input_price": 1.0, "output_price": 5.0},
+        {"id": "claude-opus-4.8", "name": "Claude Opus 4.8", "context": 200000,
+         "description": "Newest Opus — top-tier coding, analysis, and long-horizon tasks",
+         "input_price": 2.5, "output_price": 12.5},
+        {"id": "claude-opus-4.7", "name": "Claude Opus 4.7", "context": 200000,
+         "description": "Most capable Claude for deep reasoning and agentic work",
+         "input_price": 2.5, "output_price": 12.5},
+        {"id": "claude-sonnet-4.6", "name": "Claude Sonnet 4.6", "context": 200000,
+         "description": "Balanced Claude with strong quality at a moderate price",
+         "input_price": 1.5, "output_price": 7.5},
+        {"id": "claude-haiku-4.5", "name": "Claude Haiku 4.5", "context": 200000,
+         "description": "Fastest, most affordable Claude for everyday tasks",
+         "input_price": 0.5, "output_price": 2.5},
+    ],
+    "openai": [
+        {"id": "gpt-5.6-sol", "name": "GPT-5.6 Sol", "context": 400000,
+         "description": "Flagship model in the GPT-5.6 series",
+         "input_price": 2.5, "output_price": 15.0},
+        {"id": "gpt-5.5", "name": "GPT-5.5", "context": 400000,
+         "description": "Latest frontier model with the strongest general capabilities",
+         "input_price": 2.5, "output_price": 15.0},
+        {"id": "gpt-5.6-terra", "name": "GPT-5.6 Terra", "context": 400000,
+         "description": "Balanced capability and cost for coding, reasoning, and agentic tasks",
+         "input_price": 1.25, "output_price": 7.5},
+        {"id": "gpt-5.6-luna", "name": "GPT-5.6 Luna", "context": 400000,
+         "description": "High-volume and latency‑sensitive tasks (chat, classification)",
+         "input_price": 0.5, "output_price": 3.0},
+        {"id": "gpt-5.4", "name": "GPT-5.4", "context": 400000,
+         "description": "Higher‑quality reasoning for complex, multi‑step tasks",
+         "input_price": 1.25, "output_price": 7.5},
+        {"id": "gpt-5.4-mini", "name": "GPT-5.4 Mini", "context": 400000,
+         "description": "Fast and cheap for high‑volume, latency‑sensitive workloads",
+         "input_price": 0.38, "output_price": 2.25},
+    ],
+    "google": [
+        {"id": "gemini-3.1-pro", "name": "Gemini 3.1 Pro", "context": 2000000,
+         "description": "Refined Gemini 3 Pro with 2M‑token context",
+         "input_price": 1.0, "output_price": 6.0},
+        {"id": "gemini-3.6-flash", "name": "Gemini 3.6 Flash", "context": 1000000,
+         "description": "High‑quality results with reduced token usage and fewer edits",
+         "input_price": 0.75, "output_price": 3.75},
+        {"id": "gemini-3.5-flash", "name": "Gemini 3.5 Flash", "context": 1000000,
+         "description": "Latest Flash generation, optimised for speed and scale",
+         "input_price": 0.75, "output_price": 4.5},
+        {"id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash", "context": 1000000,
+         "description": "Fast, low‑cost multimodal model with huge context window",
+         "input_price": 0.15, "output_price": 1.25},
+        {"id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro", "context": 1000000,
+         "description": "High‑quality reasoning across text, images, and code",
+         "input_price": 0.63, "output_price": 5.0},
+    ],
+}
+
+def list_models(provider=None):
+    """Возвращает список моделей. Если provider указан, фильтрует по провайдеру."""
+    if provider:
+        return MODELS.get(provider.lower(), [])
+    all_models = []
+    for group in MODELS.values():
+        all_models.extend(group)
+    return all_models
+
+def get_model_info(model_id):
+    """Возвращает информацию о модели по её ID или None."""
+    for group in MODELS.values():
+        for model in group:
+            if model["id"] == model_id:
+                return model
+    return None

xmode_ai_sdk-1.0.0/xmode_ai_sdk.egg-info/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: xmode-ai-sdk
+Version: 1.0.0
+Summary: Python client for XMode AI – access multiple AI models with one API key
+Home-page: https://xmode.space
+Author: XMode Team
+Author-email: support@xmode.space
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+XMode AI Python client for accessing multiple AI models via one API key.

xmode_ai_sdk-1.0.0/xmode_ai_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+setup.py
+xmode_ai/__init__.py
+xmode_ai/core.py
+xmode_ai/exceptions.py
+xmode_ai/models.py
+xmode_ai_sdk.egg-info/PKG-INFO
+xmode_ai_sdk.egg-info/SOURCES.txt
+xmode_ai_sdk.egg-info/dependency_links.txt
+xmode_ai_sdk.egg-info/requires.txt
+xmode_ai_sdk.egg-info/top_level.txt

xmode_ai_sdk-1.0.0/xmode_ai_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

xmode_ai_sdk-1.0.0/xmode_ai_sdk.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.0

xmode_ai_sdk-1.0.0/xmode_ai_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+xmode_ai