indoxrouter 0.1.2__tar.gz → 0.1.4__tar.gz

indoxrouter-0.1.4/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+recursive-include cookbook *.md *.ipynb
+recursive-include examples *.py 

indoxrouter-0.1.4/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.2
+Name: indoxrouter
+Version: 0.1.4
+Summary: A unified client for various AI providers
+Home-page: https://github.com/indoxrouter/indoxrouter
+Author: indoxRouter Team
+Author-email: ashkan.eskandari.dev@gmail.com
+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
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# IndoxRouter Client
+
+A unified client for various AI providers, including OpenAI, Anthropic, Google, and Mistral.
+
+## Features
+
+- **Unified API**: Access multiple AI providers through a single API
+- **Simple Interface**: Easy-to-use methods for chat, completion, embeddings, and image generation
+- **Error Handling**: Standardized error handling across providers
+- **Authentication**: Automatic token management
+
+## Installation
+
+```bash
+pip install indoxrouter
+```
+
+## Usage
+
+### Initialization
+
+```python
+from indoxrouter import Client
+
+# Initialize with API key (default connects to localhost:8000)
+client = Client(api_key="your_api_key")
+
+# Or specify a custom server URL
+client = Client(
+    api_key="your_api_key",
+    base_url="http://your-server-url:8000"
+)
+
+# Connect to Docker container inside the Docker network
+client = Client(
+    api_key="your_api_key",
+    base_url="http://indoxrouter-server:8000"
+)
+
+# Using environment variables
+# Set INDOX_ROUTER_API_KEY environment variable
+import os
+os.environ["INDOX_ROUTER_API_KEY"] = "your_api_key"
+client = Client()
+```
+
+### Chat Completions
+
+```python
+response = client.chat(
+    messages=[
+        {"role": "system", "content": "You are a helpful assistant."},
+        {"role": "user", "content": "Tell me a joke."}
+    ],
+    model="openai/gpt-4o-mini",  # Provider/model format
+    temperature=0.7
+)
+
+print(response["choices"][0]["message"]["content"])
+```
+
+### Text Completions
+
+```python
+response = client.completion(
+    prompt="Once upon a time,",
+    model="openai/gpt-4o-mini",
+    max_tokens=100
+)
+
+print(response["choices"][0]["text"])
+```
+
+### Embeddings
+
+```python
+response = client.embeddings(
+    text=["Hello world", "AI is amazing"],
+    model="openai/text-embedding-3-small"
+)
+
+print(f"Dimensions: {len(response['data'][0]['embedding'])}")
+print(f"First embedding: {response['data'][0]['embedding'][:5]}...")
+```
+
+### Image Generation
+
+```python
+response = client.images(
+    prompt="A serene landscape with mountains and a lake",
+    model="openai/dall-e-3",
+    size="1024x1024"
+)
+
+print(f"Image URL: {response['data'][0]['url']}")
+```
+
+### Streaming Responses
+
+```python
+for chunk in client.chat(
+    messages=[{"role": "user", "content": "Write a short story."}],
+    model="openai/gpt-4o-mini",
+    stream=True
+):
+    if chunk.get("choices") and len(chunk["choices"]) > 0:
+        content = chunk["choices"][0].get("delta", {}).get("content", "")
+        print(content, end="", flush=True)
+```
+
+### Getting Available Models
+
+```python
+# Get all providers and models
+providers = client.models()
+for provider in providers:
+    print(f"Provider: {provider['name']}")
+    for model in provider["models"]:
+        print(f"  - {model['id']}: {model['description'] or ''}")
+
+# Get models for a specific provider
+openai_provider = client.models("openai")
+print(f"OpenAI models: {[m['id'] for m in openai_provider['models']]}")
+```
+
+## Error Handling
+
+```python
+from indoxrouter import Client, ModelNotFoundError, ProviderError
+
+try:
+    client = Client(api_key="your_api_key")
+    response = client.chat(
+        messages=[{"role": "user", "content": "Hello"}],
+        model="nonexistent-provider/nonexistent-model"
+    )
+except ModelNotFoundError as e:
+    print(f"Model not found: {e}")
+except ProviderError as e:
+    print(f"Provider error: {e}")
+```
+
+## Context Manager
+
+```python
+with Client(api_key="your_api_key") as client:
+    response = client.chat(
+        messages=[{"role": "user", "content": "Hello!"}],
+        model="openai/gpt-4o-mini"
+    )
+    print(response["choices"][0]["message"]["content"])
+# Client is automatically closed when exiting the block
+```
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

indoxrouter-0.1.4/README.md

@@ -0,0 +1,157 @@
+# IndoxRouter Client
+
+A unified client for various AI providers, including OpenAI, Anthropic, Google, and Mistral.
+
+## Features
+
+- **Unified API**: Access multiple AI providers through a single API
+- **Simple Interface**: Easy-to-use methods for chat, completion, embeddings, and image generation
+- **Error Handling**: Standardized error handling across providers
+- **Authentication**: Automatic token management
+
+## Installation
+
+```bash
+pip install indoxrouter
+```
+
+## Usage
+
+### Initialization
+
+```python
+from indoxrouter import Client
+
+# Initialize with API key (default connects to localhost:8000)
+client = Client(api_key="your_api_key")
+
+# Or specify a custom server URL
+client = Client(
+    api_key="your_api_key",
+    base_url="http://your-server-url:8000"
+)
+
+# Connect to Docker container inside the Docker network
+client = Client(
+    api_key="your_api_key",
+    base_url="http://indoxrouter-server:8000"
+)
+
+# Using environment variables
+# Set INDOX_ROUTER_API_KEY environment variable
+import os
+os.environ["INDOX_ROUTER_API_KEY"] = "your_api_key"
+client = Client()
+```
+
+### Chat Completions
+
+```python
+response = client.chat(
+    messages=[
+        {"role": "system", "content": "You are a helpful assistant."},
+        {"role": "user", "content": "Tell me a joke."}
+    ],
+    model="openai/gpt-4o-mini",  # Provider/model format
+    temperature=0.7
+)
+
+print(response["choices"][0]["message"]["content"])
+```
+
+### Text Completions
+
+```python
+response = client.completion(
+    prompt="Once upon a time,",
+    model="openai/gpt-4o-mini",
+    max_tokens=100
+)
+
+print(response["choices"][0]["text"])
+```
+
+### Embeddings
+
+```python
+response = client.embeddings(
+    text=["Hello world", "AI is amazing"],
+    model="openai/text-embedding-3-small"
+)
+
+print(f"Dimensions: {len(response['data'][0]['embedding'])}")
+print(f"First embedding: {response['data'][0]['embedding'][:5]}...")
+```
+
+### Image Generation
+
+```python
+response = client.images(
+    prompt="A serene landscape with mountains and a lake",
+    model="openai/dall-e-3",
+    size="1024x1024"
+)
+
+print(f"Image URL: {response['data'][0]['url']}")
+```
+
+### Streaming Responses
+
+```python
+for chunk in client.chat(
+    messages=[{"role": "user", "content": "Write a short story."}],
+    model="openai/gpt-4o-mini",
+    stream=True
+):
+    if chunk.get("choices") and len(chunk["choices"]) > 0:
+        content = chunk["choices"][0].get("delta", {}).get("content", "")
+        print(content, end="", flush=True)
+```
+
+### Getting Available Models
+
+```python
+# Get all providers and models
+providers = client.models()
+for provider in providers:
+    print(f"Provider: {provider['name']}")
+    for model in provider["models"]:
+        print(f"  - {model['id']}: {model['description'] or ''}")
+
+# Get models for a specific provider
+openai_provider = client.models("openai")
+print(f"OpenAI models: {[m['id'] for m in openai_provider['models']]}")
+```
+
+## Error Handling
+
+```python
+from indoxrouter import Client, ModelNotFoundError, ProviderError
+
+try:
+    client = Client(api_key="your_api_key")
+    response = client.chat(
+        messages=[{"role": "user", "content": "Hello"}],
+        model="nonexistent-provider/nonexistent-model"
+    )
+except ModelNotFoundError as e:
+    print(f"Model not found: {e}")
+except ProviderError as e:
+    print(f"Provider error: {e}")
+```
+
+## Context Manager
+
+```python
+with Client(api_key="your_api_key") as client:
+    response = client.chat(
+        messages=[{"role": "user", "content": "Hello!"}],
+        model="openai/gpt-4o-mini"
+    )
+    print(response["choices"][0]["message"]["content"])
+# Client is automatically closed when exiting the block
+```
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

indoxrouter-0.1.4/cookbook/README.md

@@ -0,0 +1,44 @@
+# IndoxRouter Cookbook
+
+This directory contains examples and recipes for using the IndoxRouter client to interact with various AI providers.
+
+## Examples
+
+- [Chat Completion](chat_completion.md): Examples of generating chat completions
+- [Embeddings](embeddings.md): Examples of generating embeddings
+- [Image Generation](image_generation.md): Examples of generating images
+
+## Jupyter Notebook
+
+- [IndoxRouter Cookbook](indoxRouter_cookbook.ipynb): A comprehensive Jupyter notebook with examples of using the IndoxRouter client
+
+## Getting Started
+
+To run these examples, you'll need to:
+
+1. Install the IndoxRouter client:
+
+```bash
+pip install indoxrouter
+```
+
+2. Set your API key:
+
+```bash
+# Set environment variable
+export INDOXROUTER_API_KEY=your-api-key
+
+# Or provide it directly in your code
+from indoxrouter import Client
+client = Client(api_key="your-api-key")
+```
+
+3. Run the examples:
+
+```bash
+python -c "from indoxrouter import Client; client = Client(api_key='your_api_key'); print(client.chat([{'role': 'user', 'content': 'Hello!'}]))"
+```
+
+## Note on API Keys
+
+The IndoxRouter API key is used to authenticate with the IndoxRouter server. You don't need to provide individual API keys for each provider (like OpenAI, Anthropic, etc.) as the IndoxRouter server handles that for you.