indoxrouter 0.1.15__tar.gz → 0.1.16__tar.gz

{indoxrouter-0.1.15/indoxrouter.egg-info → indoxrouter-0.1.16}/PKG-INFO

@@ -1,11 +1,16 @@
 Metadata-Version: 2.4
 Name: indoxrouter
-Version: 0.1.15
+Version: 0.1.16
 Summary: A unified client for various AI providers
 Author-email: indoxRouter Team <ashkan.eskandari.dev@gmail.com>
+License: MIT
 Project-URL: Homepage, https://github.com/indoxrouter/indoxrouter
+Project-URL: Repository, https://github.com/indoxrouter/indoxrouter
+Project-URL: Issues, https://github.com/indoxrouter/indoxrouter/issues
+Keywords: ai,api,client,openai,anthropic,google,mistral
 Classifier: Development Status :: 3 - Alpha
 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

{indoxrouter-0.1.15 → indoxrouter-0.1.16}/cookbook/indoxRouter_cookbook.ipynb

@@ -14,52 +14,6 @@
         "\n"
       ]
     },
-    {
-      "cell_type": "code",
-      "execution_count": 2,
-      "id": "479b6ce6",
-      "metadata": {},
-      "outputs": [
-        {
-          "name": "stdout",
-          "output_type": "stream",
-          "text": [
-            "Collecting passlib\n",
-            "  Using cached passlib-1.7.4-py2.py3-none-any.whl.metadata (1.7 kB)\n",
-            "Using cached passlib-1.7.4-py2.py3-none-any.whl (525 kB)\n",
-            "Installing collected packages: passlib\n",
-            "Successfully installed passlib-1.7.4\n",
-            "Note: you may need to restart the kernel to use updated packages.\n"
-          ]
-        },
-        {
-          "name": "stderr",
-          "output_type": "stream",
-          "text": [
-            "\n",
-            "[notice] A new release of pip is available: 24.3.1 -> 25.0.1\n",
-            "[notice] To update, run: python.exe -m pip install --upgrade pip\n"
-          ]
-        }
-      ],
-      "source": [
-        "pip install passlib"
-      ]
-    },
-    {
-      "cell_type": "code",
-      "execution_count": 1,
-      "id": "e03bc1cc",
-      "metadata": {},
-      "outputs": [],
-      "source": [
-        "import sys\n",
-        "import os\n",
-        "module_path = os.path.abspath('E:/Codes/indoxRouter/')\n",
-        "if module_path not in sys.path:\n",
-        "    sys.path.append(module_path)"
-      ]
-    },
     {
       "cell_type": "code",
       "execution_count": null,
@@ -1358,6 +1312,207 @@
         "\n",
         "For more information, refer to the [IndoxRouter documentation](https://docs.indoxrouter.com).\n"
       ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 1,
+      "id": "60ca0fd8",
+      "metadata": {},
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "Requirement already satisfied: openai in e:\\anaconda\\lib\\site-packages (1.52.2)\n",
+            "Requirement already satisfied: anyio<5,>=3.5.0 in e:\\anaconda\\lib\\site-packages (from openai) (4.2.0)\n",
+            "Requirement already satisfied: distro<2,>=1.7.0 in e:\\anaconda\\lib\\site-packages (from openai) (1.9.0)\n",
+            "Requirement already satisfied: httpx<1,>=0.23.0 in e:\\anaconda\\lib\\site-packages (from openai) (0.27.0)\n",
+            "Requirement already satisfied: jiter<1,>=0.4.0 in e:\\anaconda\\lib\\site-packages (from openai) (0.6.1)\n",
+            "Requirement already satisfied: pydantic<3,>=1.9.0 in c:\\users\\ashkan\\appdata\\roaming\\python\\python312\\site-packages (from openai) (2.9.2)\n",
+            "Requirement already satisfied: sniffio in e:\\anaconda\\lib\\site-packages (from openai) (1.3.0)\n",
+            "Requirement already satisfied: tqdm>4 in e:\\anaconda\\lib\\site-packages (from openai) (4.66.4)\n",
+            "Requirement already satisfied: typing-extensions<5,>=4.11 in e:\\anaconda\\lib\\site-packages (from openai) (4.11.0)\n",
+            "Requirement already satisfied: idna>=2.8 in e:\\anaconda\\lib\\site-packages (from anyio<5,>=3.5.0->openai) (3.7)\n",
+            "Requirement already satisfied: certifi in e:\\anaconda\\lib\\site-packages (from httpx<1,>=0.23.0->openai) (2024.6.2)\n",
+            "Requirement already satisfied: httpcore==1.* in e:\\anaconda\\lib\\site-packages (from httpx<1,>=0.23.0->openai) (1.0.5)\n",
+            "Requirement already satisfied: h11<0.15,>=0.13 in e:\\anaconda\\lib\\site-packages (from httpcore==1.*->httpx<1,>=0.23.0->openai) (0.14.0)\n",
+            "Requirement already satisfied: annotated-types>=0.6.0 in e:\\anaconda\\lib\\site-packages (from pydantic<3,>=1.9.0->openai) (0.6.0)\n",
+            "Requirement already satisfied: pydantic-core==2.23.4 in e:\\anaconda\\lib\\site-packages (from pydantic<3,>=1.9.0->openai) (2.23.4)\n",
+            "Requirement already satisfied: colorama in e:\\anaconda\\lib\\site-packages (from tqdm>4->openai) (0.4.6)\n"
+          ]
+        },
+        {
+          "name": "stderr",
+          "output_type": "stream",
+          "text": [
+            "\n",
+            "[notice] A new release of pip is available: 24.3.1 -> 25.1.1\n",
+            "[notice] To update, run: python.exe -m pip install --upgrade pip\n"
+          ]
+        }
+      ],
+      "source": [
+        "!pip install openai"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 2,
+      "id": "4da1a40d",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from openai import OpenAI\n",
+        "client = OpenAI(\n",
+        "  base_url=\"https://api.indoxrouter.com\",\n",
+        "  api_key=\"indox-vgfI5PEfUoZ6qufR2z6QqXFV4BHgxrez\",\n",
+        ")\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 5,
+      "id": "648eff2d",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from openai import OpenAI\n",
+        "client = OpenAI(\n",
+        "  base_url=\"https://api.indoxrouter.com\",\n",
+        "  api_key=\"indox-vgfI5PEfUoZ6qufR2z6QqXFV4BHgxrez\",\n",
+        ")\n",
+        "\n",
+        "completion = client.chat.completions.create(\n",
+        "  model=\"deepseek/deepseek-chat\",\n",
+        "  messages=[\n",
+        "    {\n",
+        "      \"role\": \"user\",\n",
+        "      \"content\": \"What is the meaning of life?\"\n",
+        "    }\n",
+        "  ]\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 6,
+      "id": "becbf4fa",
+      "metadata": {},
+      "outputs": [
+        {
+          "data": {
+            "text/plain": [
+              "ChatCompletion(id=None, choices=None, created=None, model='deepseek-chat', object=None, service_tier=None, system_fingerprint=None, usage=CompletionUsage(completion_tokens=None, prompt_tokens=None, total_tokens=None, completion_tokens_details=None, prompt_tokens_details=None, tokens_prompt=10, tokens_completion=348, tokens_total=358, cost=0.000706, latency=19.672869205474854, timestamp='2025-05-19T06:05:02.416455'), request_id='5ce677cf-0e30-49e3-a9d9-bf99f91edbb6', created_at='2025-05-19T06:05:02.434101', duration_ms=21821.611166000366, provider='deepseek', success=True, message='', raw_response=None, data='The meaning of life is one of the most profound and debated questions in philosophy, religion, and science. Different perspectives offer various answers:\\n\\n1. **Philosophical Perspectives:**  \\n   - **Existentialism (e.g., Sartre, Camus):** Life has no inherent meaning—we must create our own purpose through choices and actions.  \\n   - **Absurdism (Camus):** The search for meaning in a meaningless universe is absurd, but we must embrace life anyway.  \\n   - **Stoicism:** Meaning comes from virtue, wisdom, and living in harmony with nature.  \\n\\n2. **Religious/Spiritual Views:**  \\n   - **Theistic (Christianity, Islam, etc.):** Life’s purpose is to serve, love, or unite with God (or the divine).  \\n   - **Eastern Traditions (Buddhism, Hinduism):** Meaning may involve enlightenment (breaking the cycle of suffering) or fulfilling dharma (duty).  \\n\\n3. **Scientific Perspectives:**  \\n   - **Biological:** Life’s \"purpose\" is survival, reproduction, and passing on genes (evolutionary biology).  \\n   - **Cosmic:** From a physics standpoint, life may be a rare, fleeting phenomenon in an indifferent universe.  \\n\\n4. **Personal/Subjective Meaning:**  \\n   Many find purpose in relationships, creativity, helping others, or personal growth. Viktor Frankl (Holocaust survivor) argued that meaning arises from suffering, love, and work.  \\n\\n**Short answer?** There’s no universal meaning—it’s up to you to define it. What gives *your* life purpose?  \\n\\nWould you like to explore a specific perspective?', finish_reason=None)"
+            ]
+          },
+          "execution_count": 6,
+          "metadata": {},
+          "output_type": "execute_result"
+        }
+      ],
+      "source": [
+        "completion"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 7,
+      "id": "410449d5",
+      "metadata": {},
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "ChatCompletion(id=None, choices=None, created=None, model='deepseek-chat', object=None, service_tier=None, system_fingerprint=None, usage=CompletionUsage(completion_tokens=None, prompt_tokens=None, total_tokens=None, completion_tokens_details=None, prompt_tokens_details=None, tokens_prompt=10, tokens_completion=348, tokens_total=358, cost=0.000706, latency=19.672869205474854, timestamp='2025-05-19T06:05:02.416455'), request_id='5ce677cf-0e30-49e3-a9d9-bf99f91edbb6', created_at='2025-05-19T06:05:02.434101', duration_ms=21821.611166000366, provider='deepseek', success=True, message='', raw_response=None, data='The meaning of life is one of the most profound and debated questions in philosophy, religion, and science. Different perspectives offer various answers:\\n\\n1. **Philosophical Perspectives:**  \\n   - **Existentialism (e.g., Sartre, Camus):** Life has no inherent meaning—we must create our own purpose through choices and actions.  \\n   - **Absurdism (Camus):** The search for meaning in a meaningless universe is absurd, but we must embrace life anyway.  \\n   - **Stoicism:** Meaning comes from virtue, wisdom, and living in harmony with nature.  \\n\\n2. **Religious/Spiritual Views:**  \\n   - **Theistic (Christianity, Islam, etc.):** Life’s purpose is to serve, love, or unite with God (or the divine).  \\n   - **Eastern Traditions (Buddhism, Hinduism):** Meaning may involve enlightenment (breaking the cycle of suffering) or fulfilling dharma (duty).  \\n\\n3. **Scientific Perspectives:**  \\n   - **Biological:** Life’s \"purpose\" is survival, reproduction, and passing on genes (evolutionary biology).  \\n   - **Cosmic:** From a physics standpoint, life may be a rare, fleeting phenomenon in an indifferent universe.  \\n\\n4. **Personal/Subjective Meaning:**  \\n   Many find purpose in relationships, creativity, helping others, or personal growth. Viktor Frankl (Holocaust survivor) argued that meaning arises from suffering, love, and work.  \\n\\n**Short answer?** There’s no universal meaning—it’s up to you to define it. What gives *your* life purpose?  \\n\\nWould you like to explore a specific perspective?', finish_reason=None)\n"
+          ]
+        }
+      ],
+      "source": [
+        "from pprint import pprint\n",
+        "pprint(completion)"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 8,
+      "id": "ff185a0a",
+      "metadata": {},
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "Note: you may need to restart the kernel to use updated packages.Collecting indoxrouter\n",
+            "  Using cached indoxrouter-0.1.15-py3-none-any.whl.metadata (5.4 kB)\n",
+            "Requirement already satisfied: requests>=2.25.0 in e:\\anaconda\\lib\\site-packages (from indoxrouter) (2.32.3)\n",
+            "Requirement already satisfied: python-dotenv>=1.0.0 in e:\\anaconda\\lib\\site-packages (from indoxrouter) (1.0.1)\n",
+            "Requirement already satisfied: charset-normalizer<4,>=2 in e:\\anaconda\\lib\\site-packages (from requests>=2.25.0->indoxrouter) (3.3.2)\n",
+            "Requirement already satisfied: idna<4,>=2.5 in e:\\anaconda\\lib\\site-packages (from requests>=2.25.0->indoxrouter) (3.7)\n",
+            "Requirement already satisfied: urllib3<3,>=1.21.1 in e:\\anaconda\\lib\\site-packages (from requests>=2.25.0->indoxrouter) (2.2.2)\n",
+            "Requirement already satisfied: certifi>=2017.4.17 in e:\\anaconda\\lib\\site-packages (from requests>=2.25.0->indoxrouter) (2024.6.2)\n",
+            "Using cached indoxrouter-0.1.15-py3-none-any.whl (11 kB)\n",
+            "Installing collected packages: indoxrouter\n",
+            "Successfully installed indoxrouter-0.1.15\n",
+            "\n"
+          ]
+        },
+        {
+          "name": "stderr",
+          "output_type": "stream",
+          "text": [
+            "\n",
+            "[notice] A new release of pip is available: 24.3.1 -> 25.1.1\n",
+            "[notice] To update, run: python.exe -m pip install --upgrade pip\n"
+          ]
+        }
+      ],
+      "source": [
+        "pip install indoxrouter"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 9,
+      "id": "b584d7c4",
+      "metadata": {},
+      "outputs": [
+        {
+          "data": {
+            "text/plain": [
+              "{'request_id': 'c08cc108-6b0d-48bd-a660-546143f1b9fa',\n",
+              " 'created_at': '2025-05-19T06:07:38.077269',\n",
+              " 'duration_ms': 9664.651870727539,\n",
+              " 'provider': 'deepseek',\n",
+              " 'model': 'deepseek-chat',\n",
+              " 'success': True,\n",
+              " 'message': '',\n",
+              " 'usage': {'tokens_prompt': 15,\n",
+              "  'tokens_completion': 107,\n",
+              "  'tokens_total': 122,\n",
+              "  'cost': 0.000229,\n",
+              "  'latency': 9.487398862838745,\n",
+              "  'timestamp': '2025-05-19T06:07:38.065330'},\n",
+              " 'raw_response': None,\n",
+              " 'data': 'In a bustling city, a small cleaning robot named Pip discovered a lost kitten in an alley. Despite its simple programming, Pip felt a strange urge to protect the tiny creature. It carried the kitten through busy streets, dodging humans and traffic, until it found a kind woman who gasped in delight. The woman took the kitten home, and Pip watched from the sidewalk, its circuits humming with something like happiness. That night, as it returned to its charging station, Pip replayed the memory—its first act of kindness beyond code.',\n",
+              " 'finish_reason': None}"
+            ]
+          },
+          "execution_count": 9,
+          "metadata": {},
+          "output_type": "execute_result"
+        }
+      ],
+      "source": [
+        "from indoxrouter import Client\n",
+        "client= Client(api_key=\"indox-vgfI5PEfUoZ6qufR2z6QqXFV4BHgxrez\")\n",
+        "client.chat(\n",
+        "    messages=[\n",
+        "        {\"role\": \"user\", \"content\": \"Tell me a story about a robot in 5 sentences.\"}\n",
+        "    ],\n",
+        "    model=\"deepseek/deepseek-chat\",\n",
+        ")"
+      ]
     }
   ],
   "metadata": {

{indoxrouter-0.1.15 → indoxrouter-0.1.16}/indoxrouter/__init__.py

@@ -30,7 +30,7 @@ For custom server URLs:
     ```
 """
 
-from .client import Client
+from .client import Client, IndoxRouter
 from .exceptions import (
     IndoxRouterError,
     AuthenticationError,
@@ -39,13 +39,18 @@ from .exceptions import (
     ProviderError,
     ModelNotFoundError,
     ProviderNotFoundError,
+    ModelNotAvailableError,
     InvalidParametersError,
+    RequestError,
     InsufficientCreditsError,
+    ValidationError,
+    APIError,
 )
 
 __version__ = "0.2.1"
 __all__ = [
     "Client",
+    "IndoxRouter",
     "IndoxRouterError",
     "AuthenticationError",
     "NetworkError",
@@ -53,6 +58,10 @@ __all__ = [
     "ProviderError",
     "ModelNotFoundError",
     "ProviderNotFoundError",
+    "ModelNotAvailableError",
     "InvalidParametersError",
+    "RequestError",
     "InsufficientCreditsError",
+    "ValidationError",
+    "APIError",
 ]

{indoxrouter-0.1.15 → indoxrouter-0.1.16}/indoxrouter/client.py

@@ -57,10 +57,14 @@ from .exceptions import (
     NetworkError,
     ProviderNotFoundError,
     ModelNotFoundError,
+    ModelNotAvailableError,
     InvalidParametersError,
     RateLimitError,
     ProviderError,
+    RequestError,
     InsufficientCreditsError,
+    ValidationError,
+    APIError,
 )
 from .constants import (
     DEFAULT_BASE_URL,
@@ -316,29 +320,57 @@ class Client:
                 if "provider" in error_message.lower():
                     raise ProviderNotFoundError(error_message)
                 elif "model" in error_message.lower():
-                    raise ModelNotFoundError(error_message)
+                    # Check if it's a model not found vs model not available
+                    if (
+                        "not supported" in error_message.lower()
+                        or "disabled" in error_message.lower()
+                        or "unavailable" in error_message.lower()
+                    ):
+                        raise ModelNotAvailableError(error_message)
+                    else:
+                        raise ModelNotFoundError(error_message)
                 else:
-                    raise NetworkError(
-                        f"Resource not found: {error_message} (URL: {url})"
-                    )
+                    raise APIError(f"Resource not found: {error_message} (URL: {url})")
             elif status_code == 429:
                 raise RateLimitError(f"Rate limit exceeded: {error_message}")
             elif status_code == 400:
-                raise InvalidParametersError(f"Invalid parameters: {error_message}")
+                # Check if it's a validation error or invalid parameters
+                if (
+                    "validation" in error_message.lower()
+                    or "invalid format" in error_message.lower()
+                ):
+                    raise ValidationError(f"Request validation failed: {error_message}")
+                else:
+                    raise InvalidParametersError(f"Invalid parameters: {error_message}")
             elif status_code == 402:
                 raise InsufficientCreditsError(f"Insufficient credits: {error_message}")
+            elif status_code == 422:
+                # Unprocessable Entity - typically validation errors
+                raise ValidationError(f"Request validation failed: {error_message}")
+            elif status_code == 503:
+                # Service Unavailable - model might be temporarily unavailable
+                if "model" in error_message.lower():
+                    raise ModelNotAvailableError(
+                        f"Model temporarily unavailable: {error_message}"
+                    )
+                else:
+                    raise APIError(f"Service unavailable: {error_message}")
             elif status_code == 500:
                 # Provide more detailed information for server errors
                 error_detail = error_data.get("detail", "No details provided")
                 # Include the request data in the error message for better debugging
                 request_data_str = json.dumps(data, indent=2) if data else "None"
-                raise ProviderError(
+                raise RequestError(
                     f"Server error (500): {error_detail}. URL: {url}.\n"
                     f"Request data: {request_data_str}\n"
                     f"This may indicate an issue with the server configuration or a problem with the provider service."
                 )
+            elif status_code >= 400 and status_code < 500:
+                # Client errors
+                raise APIError(f"Client error ({status_code}): {error_message}")
             else:
-                raise ProviderError(f"Provider error ({status_code}): {error_message}")
+                # Server errors
+                raise RequestError(f"Server error ({status_code}): {error_message}")
         except requests.RequestException as e:
             logger.error(f"Request exception: {str(e)}")
             raise NetworkError(f"Network error: {str(e)}")

{indoxrouter-0.1.15 → indoxrouter-0.1.16}/indoxrouter/exceptions.py

@@ -38,14 +38,20 @@ class ProviderError(IndoxRouterError):
     pass
 
 
+class ProviderNotFoundError(ProviderError):
+    """Raised when a requested provider is not found."""
+
+    pass
+
+
 class ModelNotFoundError(ProviderError):
     """Raised when a requested model is not found."""
 
     pass
 
 
-class ProviderNotFoundError(ProviderError):
-    """Raised when a requested provider is not found."""
+class ModelNotAvailableError(ProviderError):
+    """Raised when a model is disabled or not supported by the provider."""
 
     pass
 
@@ -56,7 +62,25 @@ class InvalidParametersError(IndoxRouterError):
     pass
 
 
+class RequestError(IndoxRouterError):
+    """Raised when a request to a provider fails."""
+
+    pass
+
+
 class InsufficientCreditsError(IndoxRouterError):
     """Raised when the user doesn't have enough credits."""
 
     pass
+
+
+class ValidationError(IndoxRouterError):
+    """Raised when request validation fails."""
+
+    pass
+
+
+class APIError(IndoxRouterError):
+    """Raised when the API returns an error."""
+
+    pass

{indoxrouter-0.1.15 → indoxrouter-0.1.16/indoxrouter.egg-info}/PKG-INFO

@@ -1,11 +1,16 @@
 Metadata-Version: 2.4
 Name: indoxrouter
-Version: 0.1.15
+Version: 0.1.16
 Summary: A unified client for various AI providers
 Author-email: indoxRouter Team <ashkan.eskandari.dev@gmail.com>
+License: MIT
 Project-URL: Homepage, https://github.com/indoxrouter/indoxrouter
+Project-URL: Repository, https://github.com/indoxrouter/indoxrouter
+Project-URL: Issues, https://github.com/indoxrouter/indoxrouter/issues
+Keywords: ai,api,client,openai,anthropic,google,mistral
 Classifier: Development Status :: 3 - Alpha
 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

{indoxrouter-0.1.15 → indoxrouter-0.1.16}/pyproject.toml

@@ -1,19 +1,22 @@
 [build-system]
-requires = ["setuptools>=42", "wheel"]
+requires = ["setuptools>=61.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "indoxrouter"
-version = "0.1.15"
+version = "0.1.16"
 authors = [
     {name = "indoxRouter Team", email = "ashkan.eskandari.dev@gmail.com"},
 ]
 description = "A unified client for various AI providers"
 readme = "README.md"
 requires-python = ">=3.8"
+license = {text = "MIT"}
+keywords = ["ai", "api", "client", "openai", "anthropic", "google", "mistral"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
@@ -28,7 +31,11 @@ dependencies = [
 
 [project.urls]
 Homepage = "https://github.com/indoxrouter/indoxrouter"
+Repository = "https://github.com/indoxrouter/indoxrouter"
+Issues = "https://github.com/indoxrouter/indoxrouter/issues"
 
-[tool.setuptools]
-packages = ["indoxrouter"]
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["indoxrouter*"]
+exclude = ["tests*"]