Metadata-Version: 2.3
Name: rsroute
Version: 0.1.0
Summary: Python Package Wrapper for RSRoute server
Author: ItzRustam
Author-email: ItzRustam <rustambhadouriya7@gmail.com>
Requires-Dist: requests
Requires-Dist: langchain-core
Requires-Dist: rich
Requires-Dist: python-dotenv
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# rsroute

### What it is
`rsroute` is a lightweight Python client for [RSRoute](https://www.github.com/ItzRustam/rsroute) — a unified gateway that routes requests across 10+ LLM providers seamlessly.

### Why it is
Instead of managing disparate SDKs, raw HTTP requests, query parameters, and custom endpoints manually for each provider, `rsroute` provides a simple, unified wrapper so you can connect to your RSRoute server with minimal code.

### Code Example - ChatModel
```python
from rsroute.chat_models import ChatGemini, ChatMistral, ChatGroq, ChatOpenRouter

# Gemini
gemini_model = ChatGemini(
    model="gemini-3.5-flash-lite",
    rsroute_url="http://0.0.0.0:8000", # your URL always default to this.
)
response = gemini_model.invoke(query="What is GitHub?")
print(response)

# Groq
groq_model = ChatGroq(
    model="openai/gpt-oss-120b",
    temperature=0.7,
)
response = groq_model.invoke(query="Hello Groq!")
print(response)

# OpenRouter
openrouter_model = ChatOpenRouter(
    model="deepseek/deepseek-v4.1-flash",
    temperature=0.7,
)
response = openrouter_model.invoke(query="Hello OpenRouter!")
print(response)
```

### Code Example - Agents
```python
from rsroute.agents import GeminiAgent, MistralAgent, GroqAgent, OpenRouterAgent

# Gemini Agent
gemini_agent = GeminiAgent(
    tools=[web_search], # your tools
    max_tool_calls=12 # Default to 10
)
response = gemini_agent.invoke(query="Latest News of GPT-6 Astra")
print(response)

# Mistral Agent
mistral_agent = MistralAgent(
    tools=[web_search],
    model="mistral-small-2603"
)
response = mistral_agent.invoke(query="What is the weather in Paris?")
print(response)

# Groq Agent
groq_agent = GroqAgent(
    tools=[web_search],
    model="openai/gpt-oss-120b"
)
response = groq_agent.invoke(query="Compute 42 * 42")
print(response)

# OpenRouter Agent
openrouter_agent = OpenRouterAgent(
    tools=[web_search],
    model="deepseek/deepseek-v4.1-flash"
)
response = openrouter_agent.invoke(query="Search latest news")
print(response)
```

### Feature
* automatic `master_key` loading from .env
* proper request handling
* Agentic power

### Valid `.env` name
Any of the following variable names can be used in your `.env` file:
* `rsroute_token` (or `RSROUTE_TOKEN`)
* `master_key` (or `MASTER_KEY`)
* `rsroute_key` (or `RSROUTE_KEY`)
* `rsroute_master_key` (or `RSROUTE_MASTER_KEY`)


### Server
RSRoute Server repository: [RSRoute GitHub](https://www.github.com/ItzRustam/rsroute)

RSRoute website: [RSRoute Web](https://www.rsroute.freedev.app)