aetherroute 0.1.0__tar.gz

aetherroute-0.1.0/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to **AetherRoute** are documented here.
+This project follows [Semantic Versioning](https://semver.org/).
+
+---
+
+## [0.1.0] — 2025-06-14
+
+### Added
+- **Multi-provider orchestration** — OpenAI, Anthropic Claude, Mistral, and Ollama support with a unified async interface.
+- **Intelligent task routing** — TF-IDF + scoring engine routes queries to the best-fit provider based on task category, latency, cost, and health history.
+- **Hot failover** — Automatic provider failover on error or health registry `down` status.
+- **Output validation & repair loops** — Pydantic schema validation with automatic re-prompt on failure (up to 3 retries).
+- **Self-consistency checker** — High-stakes queries run against two providers; divergent responses are flagged.
+- **Cost governor** — Per-request and per-session hard cost ceilings enforced from config.
+- **Security sanitizer** — Prompt injection detection + RBAC permission guard.
+- **Fuzzy semantic cache** — Redis-backed (in-memory fallback) cache with cosine similarity matching.
+- **Context curation** — TF-IDF relevance ranking + async summarization to prevent context window overflow.
+- **CLI observability report** — `aetherroute-report` command (powered by `rich`) renders routing analytics, cost tables, and request traces directly in the terminal.
+- **Mock mode** — Full offline demo with schema-aware mock responses for all providers.
+- **PyPI packaging** — Installable via `pip install aetherroute` with provider SDKs as optional extras.
+
+### Changed
+- Replaced Streamlit web dashboard with a zero-browser CLI report (`aetherroute-report`).
+- Made provider SDK dependencies (`openai`, `anthropic`, `mistralai`) optional extras.
+
+### Fixed
+- Mock providers now synthesize schema-aware JSON responses instead of returning a hardcoded generic object, preventing false validation failures in offline mode.

aetherroute-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mithun Barath M R
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aetherroute-0.1.0/MANIFEST.in

@@ -0,0 +1,8 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+include config.yaml
+include requirements.txt
+recursive-include aetherroute *.py
+recursive-include aetherroute *.yaml
+recursive-include aetherroute *.typed

aetherroute-0.1.0/PKG-INFO

@@ -0,0 +1,324 @@
+Metadata-Version: 2.4
+Name: aetherroute
+Version: 0.1.0
+Summary: Production-grade multi-provider LLM orchestration, routing, and validation framework
+Author-email: Mithun Barath M R <barathmithun1548@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Mithun Barath M R
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/mithunbarath/aetherroute
+Project-URL: Source, https://github.com/mithunbarath/aetherroute
+Project-URL: Bug Tracker, https://github.com/mithunbarath/aetherroute/issues
+Project-URL: Changelog, https://github.com/mithunbarath/aetherroute/blob/main/CHANGELOG.md
+Keywords: llm,ai,openai,anthropic,mistral,routing,orchestration,validation,pydantic,async,failover
+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.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: redis>=5.0.0
+Requires-Dist: tiktoken>=0.5.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.18.0; extra == "anthropic"
+Provides-Extra: mistral
+Requires-Dist: mistralai>=0.1.0; extra == "mistral"
+Provides-Extra: all
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: anthropic>=0.18.0; extra == "all"
+Requires-Dist: mistralai>=0.1.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+# AetherRoute ⚡
+
+[![PyPI version](https://img.shields.io/pypi/v/aetherroute.svg)](https://pypi.org/project/aetherroute/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![GitHub](https://img.shields.io/badge/GitHub-mithunbarath%2Faetherroute-lightgrey?logo=github)](https://github.com/mithunbarath/aetherroute)
+
+**AetherRoute** is a production-grade multi-provider LLM orchestration, validation, and routing framework. It is designed to mitigate critical LLM failure modes — provider outages, cost spikes, prompt injection attacks, structured formatting errors, and token window overflows — in professional environments.
+
+```
+Request ──► Input Sanitizer ──► Cache Lookup (Exact/Semantic)
+                                       │
+  ┌────────────────────────────────────┘ (Cache Miss)
+  ▼
+Context Curation (Sliding Window & Summarization)
+  │
+  ▼
+Scoring & Decision Router (Task Fit, Cost, Latency, SQLite History)
+  │
+  ▼
+Provider Pool (OpenAI, Anthropic Claude, Mistral, Ollama)
+  │
+  ├──► Success ──► Pydantic Validator ──► DB Logging ──► Response
+  │                    │ (Validation Error)
+  │                    ▼ (Up to 3 Retries)
+  │             Repair Re-prompt Loop
+  │
+  └──► Failure ──► Hot Failover (Try next-best provider)
+```
+
+---
+
+## 🚀 Key Features & Solved Production Failure Modes
+
+### 1. Resilient Failover & Registry
+- **Problem**: OpenAI/Anthropic downtime or rate limiting crashes your application.
+- **Solution**: A live health registry (`healthy`, `degraded`, `down`) updates via periodic pings. On failure, AetherRoute performs a **hot-failover** to the next-best provider seamlessly.
+
+### 2. Prompt Normalization
+- **Problem**: Providers expect different message structures (Anthropic alternating roles, OpenAI permissive).
+- **Solution**: Unified prompt format dynamically mapped to each provider's API requirements.
+
+### 3. Real-Time Cost Governor
+- **Problem**: Recursive loops and heavy context cause runaway API bills.
+- **Solution**: Hard per-request and per-session cost ceilings enforced against live token counts. Blocked calls raise `CostLimitExceeded`.
+
+### 4. Sliding Context Curation
+- **Problem**: Full chat history causes token overflows and irrelevant retrieval.
+- **Solution**: TF-IDF cosine relevance ranking prunes old messages, and cheap models asynchronously summarize older context.
+
+### 5. Output Validation & Repair Loops
+- **Problem**: LLMs return invalid JSON or miss required fields.
+- **Solution**: Pydantic schema validation with automatic re-prompting on failure (up to 3 retries with error detail injected into the repair prompt).
+
+### 6. Security Input Sanitization
+- **Problem**: Prompt injection scripts bypass rules and leak system prompts.
+- **Solution**: Regex-based injection detection + RBAC permission guards raise `SecurityBlockError`/`PermissionDeniedError`.
+
+### 7. Fuzzy Semantic Cache
+- **Problem**: Semantically identical repeated queries waste money and increase latency.
+- **Solution**: Async Redis cache (in-memory fallback) returns hits for both exact and semantically similar queries using cosine similarity.
+
+### 8. CLI Observability Report
+- **Problem**: Black-box execution blocks debugging.
+- **Solution**: Every routing decision, latency, cost, and validation retry is persisted in SQLite and rendered as a beautiful terminal report via `aetherroute-report`.
+
+---
+
+## 📦 Installation
+
+### Core (no provider SDK)
+```bash
+pip install aetherroute
+```
+
+### With specific providers
+```bash
+pip install aetherroute[openai]        # OpenAI only
+pip install aetherroute[anthropic]     # Anthropic Claude only
+pip install aetherroute[mistral]       # Mistral AI only
+pip install aetherroute[all]           # All providers
+```
+
+### From source
+```bash
+git clone https://github.com/mithunbarath/aetherroute.git
+cd aetherroute
+pip install -e ".[all,dev]"
+```
+
+---
+
+## ⚙️ Configuration
+
+Set API keys as environment variables (all optional — AetherRoute runs in mock mode without them):
+
+```bash
+# Windows CMD
+set OPENAI_API_KEY=your-openai-key
+set ANTHROPIC_API_KEY=your-anthropic-key
+set MISTRAL_API_KEY=your-mistral-key
+
+# Linux / macOS
+export OPENAI_API_KEY=your-openai-key
+export ANTHROPIC_API_KEY=your-anthropic-key
+export MISTRAL_API_KEY=your-mistral-key
+```
+
+Or edit `config.yaml` directly in your project directory.
+
+---
+
+## ⚡ Quick Start
+
+```python
+import asyncio
+from aetherroute.orchestrator import AetherRouteOrchestrator
+
+async def main():
+    orchestrator = AetherRouteOrchestrator()
+    await orchestrator.start()
+
+    response = await orchestrator.query(
+        messages=[{"role": "user", "content": "Summarise the history of the Roman Empire."}],
+        query="Summarise the history of the Roman Empire.",
+        session_id="my-session"
+    )
+    print(response["text"])
+    await orchestrator.close()
+
+asyncio.run(main())
+```
+
+### Structured Output (with Pydantic)
+
+```python
+from pydantic import BaseModel, Field
+
+class Ticket(BaseModel):
+    ticket_id: int
+    sentiment: str = Field(description="positive, neutral, or negative")
+    urgency: str   = Field(description="high, medium, or low")
+    summary: str
+
+ticket, raw = await orchestrator.query_structured(
+    messages=[{"role": "user", "content": "Ticket #42: customer is very angry, system is down."}],
+    query="Extract ticket info.",
+    response_model=Ticket,
+    session_id="my-session"
+)
+print(ticket.urgency)   # "high"
+```
+
+---
+
+## 🎬 Running the Demo
+
+The included `demo.py` showcases **all 6 scenarios** using mock providers (runs fully offline):
+
+```bash
+python demo.py
+```
+
+Demonstrates:
+- Routing decisions based on query classification
+- Provider outage hot-failover
+- Output validator repair loops
+- Security injection blocking
+- Session cost governor enforcement
+- Fuzzy semantic cache hits
+
+---
+
+## 📊 CLI Observability Report
+
+View routing analytics, cost breakdowns, and request traces directly in your terminal:
+
+```bash
+python -m aetherroute.observability.report
+
+# Or if installed via pip:
+aetherroute-report
+
+# Options:
+#   --db PATH     SQLite database path (default: aetherroute.db)
+#   --traces N    Number of recent traces to display (default: 15)
+aetherroute-report --db aetherroute.db --traces 25
+```
+
+The report shows:
+- **Summary panel** — total requests, cost, average latency, success rate
+- **Provider routing table** — request count, total cost, avg latency per provider
+- **Task category breakdown** — coding, summarization, reasoning, creative, extraction
+- **Session cost totals** — cost aggregated per session ID
+- **Request trace table** — last N requests with colour-coded success/fail indicators
+
+---
+
+## 🧪 Running Tests
+
+```bash
+pip install aetherroute[dev]
+pytest tests/ -v
+```
+
+---
+
+## 📁 Project Structure
+
+```
+aetherroute/
+├── adapters/          # Prompt normalization for each provider
+├── cache/             # Semantic + exact caching (Redis/in-memory)
+├── config.py          # YAML config loader (AetherRouteConfig)
+├── context/           # Context curation (TF-IDF, summarization)
+├── cost/              # Cost governor & SQLite transaction logging
+├── observability/
+│   ├── logger.py      # SQLite request logger
+│   └── report.py      # Rich CLI observability report
+├── orchestrator.py    # Main entry-point: AetherRouteOrchestrator
+├── providers/         # OpenAI, Anthropic, Mistral, Ollama wrappers
+├── router/            # Task classifier & routing engine
+├── security/          # Input sanitizer & RBAC permission guard
+└── validation/        # Pydantic validator & self-consistency checker
+```
+
+---
+
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome!
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/my-feature`
+3. Commit your changes: `git commit -m "Add my feature"`
+4. Push to the branch: `git push origin feature/my-feature`
+5. Open a Pull Request
+
+Please ensure all tests pass (`pytest tests/`) and update the `CHANGELOG.md`.
+
+---
+
+## 👤 Author
+
+**Mithun Barath M R**
+- 📧 [barathmithun1548@gmail.com](mailto:barathmithun1548@gmail.com)
+- 💼 [LinkedIn](https://www.linkedin.com/in/mithunbarathmr13/)
+- 🐙 [GitHub](https://github.com/mithunbarath)
+- 🏥 Co-founder, MedClara — Healthcare AI Automation
+
+---
+
+## 📄 License
+
+This project is licensed under the **MIT License** — see [LICENSE](LICENSE) for details.

aetherroute-0.1.0/README.md

@@ -0,0 +1,255 @@
+# AetherRoute ⚡
+
+[![PyPI version](https://img.shields.io/pypi/v/aetherroute.svg)](https://pypi.org/project/aetherroute/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![GitHub](https://img.shields.io/badge/GitHub-mithunbarath%2Faetherroute-lightgrey?logo=github)](https://github.com/mithunbarath/aetherroute)
+
+**AetherRoute** is a production-grade multi-provider LLM orchestration, validation, and routing framework. It is designed to mitigate critical LLM failure modes — provider outages, cost spikes, prompt injection attacks, structured formatting errors, and token window overflows — in professional environments.
+
+```
+Request ──► Input Sanitizer ──► Cache Lookup (Exact/Semantic)
+                                       │
+  ┌────────────────────────────────────┘ (Cache Miss)
+  ▼
+Context Curation (Sliding Window & Summarization)
+  │
+  ▼
+Scoring & Decision Router (Task Fit, Cost, Latency, SQLite History)
+  │
+  ▼
+Provider Pool (OpenAI, Anthropic Claude, Mistral, Ollama)
+  │
+  ├──► Success ──► Pydantic Validator ──► DB Logging ──► Response
+  │                    │ (Validation Error)
+  │                    ▼ (Up to 3 Retries)
+  │             Repair Re-prompt Loop
+  │
+  └──► Failure ──► Hot Failover (Try next-best provider)
+```
+
+---
+
+## 🚀 Key Features & Solved Production Failure Modes
+
+### 1. Resilient Failover & Registry
+- **Problem**: OpenAI/Anthropic downtime or rate limiting crashes your application.
+- **Solution**: A live health registry (`healthy`, `degraded`, `down`) updates via periodic pings. On failure, AetherRoute performs a **hot-failover** to the next-best provider seamlessly.
+
+### 2. Prompt Normalization
+- **Problem**: Providers expect different message structures (Anthropic alternating roles, OpenAI permissive).
+- **Solution**: Unified prompt format dynamically mapped to each provider's API requirements.
+
+### 3. Real-Time Cost Governor
+- **Problem**: Recursive loops and heavy context cause runaway API bills.
+- **Solution**: Hard per-request and per-session cost ceilings enforced against live token counts. Blocked calls raise `CostLimitExceeded`.
+
+### 4. Sliding Context Curation
+- **Problem**: Full chat history causes token overflows and irrelevant retrieval.
+- **Solution**: TF-IDF cosine relevance ranking prunes old messages, and cheap models asynchronously summarize older context.
+
+### 5. Output Validation & Repair Loops
+- **Problem**: LLMs return invalid JSON or miss required fields.
+- **Solution**: Pydantic schema validation with automatic re-prompting on failure (up to 3 retries with error detail injected into the repair prompt).
+
+### 6. Security Input Sanitization
+- **Problem**: Prompt injection scripts bypass rules and leak system prompts.
+- **Solution**: Regex-based injection detection + RBAC permission guards raise `SecurityBlockError`/`PermissionDeniedError`.
+
+### 7. Fuzzy Semantic Cache
+- **Problem**: Semantically identical repeated queries waste money and increase latency.
+- **Solution**: Async Redis cache (in-memory fallback) returns hits for both exact and semantically similar queries using cosine similarity.
+
+### 8. CLI Observability Report
+- **Problem**: Black-box execution blocks debugging.
+- **Solution**: Every routing decision, latency, cost, and validation retry is persisted in SQLite and rendered as a beautiful terminal report via `aetherroute-report`.
+
+---
+
+## 📦 Installation
+
+### Core (no provider SDK)
+```bash
+pip install aetherroute
+```
+
+### With specific providers
+```bash
+pip install aetherroute[openai]        # OpenAI only
+pip install aetherroute[anthropic]     # Anthropic Claude only
+pip install aetherroute[mistral]       # Mistral AI only
+pip install aetherroute[all]           # All providers
+```
+
+### From source
+```bash
+git clone https://github.com/mithunbarath/aetherroute.git
+cd aetherroute
+pip install -e ".[all,dev]"
+```
+
+---
+
+## ⚙️ Configuration
+
+Set API keys as environment variables (all optional — AetherRoute runs in mock mode without them):
+
+```bash
+# Windows CMD
+set OPENAI_API_KEY=your-openai-key
+set ANTHROPIC_API_KEY=your-anthropic-key
+set MISTRAL_API_KEY=your-mistral-key
+
+# Linux / macOS
+export OPENAI_API_KEY=your-openai-key
+export ANTHROPIC_API_KEY=your-anthropic-key
+export MISTRAL_API_KEY=your-mistral-key
+```
+
+Or edit `config.yaml` directly in your project directory.
+
+---
+
+## ⚡ Quick Start
+
+```python
+import asyncio
+from aetherroute.orchestrator import AetherRouteOrchestrator
+
+async def main():
+    orchestrator = AetherRouteOrchestrator()
+    await orchestrator.start()
+
+    response = await orchestrator.query(
+        messages=[{"role": "user", "content": "Summarise the history of the Roman Empire."}],
+        query="Summarise the history of the Roman Empire.",
+        session_id="my-session"
+    )
+    print(response["text"])
+    await orchestrator.close()
+
+asyncio.run(main())
+```
+
+### Structured Output (with Pydantic)
+
+```python
+from pydantic import BaseModel, Field
+
+class Ticket(BaseModel):
+    ticket_id: int
+    sentiment: str = Field(description="positive, neutral, or negative")
+    urgency: str   = Field(description="high, medium, or low")
+    summary: str
+
+ticket, raw = await orchestrator.query_structured(
+    messages=[{"role": "user", "content": "Ticket #42: customer is very angry, system is down."}],
+    query="Extract ticket info.",
+    response_model=Ticket,
+    session_id="my-session"
+)
+print(ticket.urgency)   # "high"
+```
+
+---
+
+## 🎬 Running the Demo
+
+The included `demo.py` showcases **all 6 scenarios** using mock providers (runs fully offline):
+
+```bash
+python demo.py
+```
+
+Demonstrates:
+- Routing decisions based on query classification
+- Provider outage hot-failover
+- Output validator repair loops
+- Security injection blocking
+- Session cost governor enforcement
+- Fuzzy semantic cache hits
+
+---
+
+## 📊 CLI Observability Report
+
+View routing analytics, cost breakdowns, and request traces directly in your terminal:
+
+```bash
+python -m aetherroute.observability.report
+
+# Or if installed via pip:
+aetherroute-report
+
+# Options:
+#   --db PATH     SQLite database path (default: aetherroute.db)
+#   --traces N    Number of recent traces to display (default: 15)
+aetherroute-report --db aetherroute.db --traces 25
+```
+
+The report shows:
+- **Summary panel** — total requests, cost, average latency, success rate
+- **Provider routing table** — request count, total cost, avg latency per provider
+- **Task category breakdown** — coding, summarization, reasoning, creative, extraction
+- **Session cost totals** — cost aggregated per session ID
+- **Request trace table** — last N requests with colour-coded success/fail indicators
+
+---
+
+## 🧪 Running Tests
+
+```bash
+pip install aetherroute[dev]
+pytest tests/ -v
+```
+
+---
+
+## 📁 Project Structure
+
+```
+aetherroute/
+├── adapters/          # Prompt normalization for each provider
+├── cache/             # Semantic + exact caching (Redis/in-memory)
+├── config.py          # YAML config loader (AetherRouteConfig)
+├── context/           # Context curation (TF-IDF, summarization)
+├── cost/              # Cost governor & SQLite transaction logging
+├── observability/
+│   ├── logger.py      # SQLite request logger
+│   └── report.py      # Rich CLI observability report
+├── orchestrator.py    # Main entry-point: AetherRouteOrchestrator
+├── providers/         # OpenAI, Anthropic, Mistral, Ollama wrappers
+├── router/            # Task classifier & routing engine
+├── security/          # Input sanitizer & RBAC permission guard
+└── validation/        # Pydantic validator & self-consistency checker
+```
+
+---
+
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome!
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/my-feature`
+3. Commit your changes: `git commit -m "Add my feature"`
+4. Push to the branch: `git push origin feature/my-feature`
+5. Open a Pull Request
+
+Please ensure all tests pass (`pytest tests/`) and update the `CHANGELOG.md`.
+
+---
+
+## 👤 Author
+
+**Mithun Barath M R**
+- 📧 [barathmithun1548@gmail.com](mailto:barathmithun1548@gmail.com)
+- 💼 [LinkedIn](https://www.linkedin.com/in/mithunbarathmr13/)
+- 🐙 [GitHub](https://github.com/mithunbarath)
+- 🏥 Co-founder, MedClara — Healthcare AI Automation
+
+---
+
+## 📄 License
+
+This project is licensed under the **MIT License** — see [LICENSE](LICENSE) for details.

aetherroute-0.1.0/aetherroute/__init__.py

@@ -0,0 +1,8 @@
+"""
+AetherRoute - Multi-provider LLM orchestration and routing framework.
+"""
+
+from aetherroute.config import load_config, AetherRouteConfig
+
+__version__ = "0.1.0"
+__all__ = ["load_config", "AetherRouteConfig"]

aetherroute-0.1.0/aetherroute/adapters/__init__.py

@@ -0,0 +1,8 @@
+from aetherroute.adapters.prompt import PromptAdapter
+from aetherroute.adapters.token_counter import count_tokens, count_messages_tokens
+
+__all__ = [
+    "PromptAdapter",
+    "count_tokens",
+    "count_messages_tokens"
+]