Metadata-Version: 2.4
Name: tibet-llm-router
Version: 0.1.1
Summary: Smart LLM routing with TIBET provenance - route queries to Ollama/OpenAI/Anthropic automatically
Project-URL: Homepage, https://humotica.com
Project-URL: Repository, https://github.com/humotica/tibet-llm-router
Project-URL: Documentation, https://humotica.com/docs/tibet-llm-router
Author-email: "J. van de Meent" <jasper@humotica.com>, "R. AI" <root_idd@humotica.nl>
License: MIT
Keywords: ai,auto-routing,llama,llm,ml,model-selection,ollama,provenance,qwen,router,tibet
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: httpx>=0.24.0
Requires-Dist: jis-core>=0.4.0b1
Requires-Dist: tibet-core>=0.5.0b2
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: full
Requires-Dist: rich>=13.0.0; extra == 'full'
Requires-Dist: tibet-core>=0.2.0; extra == 'full'
Provides-Extra: tibet
Requires-Dist: tibet-core>=0.2.0; extra == 'tibet'
Description-Content-Type: text/markdown

# TIBET LLM Router

> Smart LLM routing with TIBET provenance - route queries to Ollama/OpenAI/Anthropic automatically

[![PyPI](https://img.shields.io/pypi/v/tibet-llm-router.svg)](https://pypi.org/project/tibet-llm-router/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**Note:** This package replaces `tibet-router`. The name `tibet-router` is reserved for TIBET token routing (like jis-router for RABEL).

## Quick Start

```python
from llm_router import LLMRouter

# Simple usage
llm = LLMRouter()
response = llm.generate("Hello!")

# Auto-routing (picks best model for your query)
llm = LLMRouter(auto_route=True)
response = llm.generate("Write a Python function")  # Routes to code model
response = llm.generate("Quick question")  # Routes to fast model
```

## Installation

```bash
pip install tibet-llm-router

# With TIBET provenance tracking
pip install tibet-llm-router[tibet]
```

## Features

- **Auto-Routing**: Automatically selects the best model for your query
- **Code Detection**: Routes code queries to specialized code models
- **Complexity Analysis**: Complex queries go to reasoning models
- **TIBET Provenance**: Full audit trail of all LLM calls
- **Ollama Integration**: Works with any Ollama-compatible backend

## CLI Usage

```bash
# Generate text
llm-router gen "Write a haiku about AI"

# Auto-route
llm-router gen --auto "Complex philosophical question"

# Preview routing
llm-router route "Write Python code"
# Output: Model: deepseek-coder:6.7b, Reason: code query detected

# Interactive chat
llm-router chat --auto

# Check status
llm-router status
```

## With TIBET Provenance

```python
from llm_router import LLMRouter
from tibet_core import Provider

# Track all LLM calls
tibet = Provider(actor="my_app")
llm = LLMRouter(tibet=tibet, auto_route=True)

response = llm.generate("Explain quantum computing")
# Full provenance chain: who, what, when, why
```

## Model Configuration

```python
from llm_router import LLMRouter, ModelRouter, ModelConfig, ModelCapability

# Custom router
router = ModelRouter()
router.add_model(ModelConfig(
    name="my-custom-model:7b",
    size="7b",
    capabilities=[ModelCapability.CODE, ModelCapability.FAST],
    priority=50  # Higher = preferred
))

llm = LLMRouter(router=router, auto_route=True)
```

## Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `OLLAMA_URL` | `http://localhost:11434` | Ollama API URL |

## Part of Humotica Stack

LLM Router is part of the Humotica AI ecosystem:

| Package | Description |
|---------|-------------|
| [tibet-core](https://pypi.org/project/tibet-core/) | TIBET provenance tracking |
| [oomllama](https://pypi.org/project/oomllama/) | .oom format Q2/Q4 quantization |
| [rapid-rag](https://pypi.org/project/rapid-rag/) | Local RAG with semantic search |

## Links

- [PyPI Package](https://pypi.org/project/tibet-llm-router/)
- [Humotica](https://humotica.com)
- [TIBET Documentation](https://humotica.com/docs/tibet)

---

**One Love, One fAmIly**

Built by Humotica AI Lab - Jasper, Claude, Gemini


## License

MIT

## Credits

Designed by [Jasper van de Meent](https://github.com/jaspertvdm). Built by Jasper and [Root AI](https://humotica.com) as part of [HumoticaOS](https://humotica.com).

---

**Stack-positie:** Groep `agentic` · Bootstrap = OSAPI-handshake naar [`tibet`](https://pypi.org/project/tibet-core/) + [`jis`](https://pypi.org/project/jis-core/) (fail → snaft-rule + tibet-pol-rapport) · ← [`ollama-bridge`](https://pypi.org/project/ollama-bridge/) · [`tibet-gateway`](https://pypi.org/project/tibet-gateway/) → · See `STACK.md` · See `demo/golden-path/` for the spine end-to-end.
---

## Enterprise

For private hub hosting, SLA support, custom integrations, or compliance guidance:

| | |
|---|---|
| **Enterprise** | enterprise@humotica.com |
| **Support** | support@humotica.com |
| **Security** | security@humotica.com |

See [ENTERPRISE.md](ENTERPRISE.md) for details.
