Metadata-Version: 2.4
Name: margadarshak
Version: 1.0.0
Summary: Production request routing for multi-agent systems
Author-email: Darshankumar Joshi <darshjme@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/darshjme-codes/agent-router
Project-URL: Repository, https://github.com/darshjme-codes/agent-router
Keywords: agents,routing,llm,multi-agent,dispatcher
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

<div align="center">

<img src="assets/margadarshak-hero.png" alt="मार्गदर्शक — margadarshak by Darshankumar Joshi" width="100%" />

# ⚡ मार्गदर्शक
## `margadarshak`

> *Bhagavad Gita — Krishna as guide*

### The Divine Guide — showing the path

**Semantic task router for multi-agent systems. Dispatch to specialists, not generalists.**

[![Python](https://img.shields.io/badge/Python-3.8%2B-blue?style=flat-square&logo=python)](https://python.org)
[![Zero Dependencies](https://img.shields.io/badge/Dependencies-Zero-brightgreen?style=flat-square)](https://github.com/darshjme/margadarshak)
[![Vedic Arsenal](https://img.shields.io/badge/Vedic%20Arsenal-100%20libs-yellow?style=flat-square)](https://github.com/darshjme/arsenal)
[![License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](LICENSE)

*Formerly `agent-router` — Part of the [**Vedic Arsenal**](https://github.com/darshjme/arsenal): 100 production-grade Python libraries for LLM agents, each named from the Vedas, Puranas, and Mahakavyas.*

</div>

---

## The Vedic Principle

The ancient *Margadarshak* principle from Bhagavad Gita — Krishna as guide finds its modern expression in this library.

Just as the Vedic sages understood that every phenomenon in the universe follows deep patterns — patterns of creation, maintenance, and dissolution — `margadarshak` applies this wisdom to LLM agent engineering.

The concept of *मार्गदर्शक* (The Divine Guide — showing the path) speaks directly to the technical problem this library solves. When the sages codified this principle in Bhagavad Gita — Krishna as guide, they were describing not just a spiritual truth but a computational truth that would take humanity millennia to rediscover in silicon.

This is not coincidence. The universe has one nature. The Vedas described it first.

---

## How It Works

```mermaid
flowchart LR
    A[Input] --> B[margadarshak]
    B --> C{Process}
    C -- Success --> D[Output]
    C -- Error --> E[Handle]
    E --> B
    style B fill:#6b21a8,color:#fff
```

---

## Installation

```bash
pip install margadarshak
```

Or from source:
```bash
git clone https://github.com/darshjme/margadarshak.git
cd margadarshak && pip install -e .
```

## Quick Start

```python
from margadarshak import *

# See examples/ for full usage
```

---

## The Vedic Arsenal

`margadarshak` is one of 100 libraries in **[darshjme/arsenal](https://github.com/darshjme/arsenal)** — each named from sacred Indian literature:

| Sanskrit Name | Source | Technical Function |
|---|---|---|
| `margadarshak` | Bhagavad Gita — Krishna as guide | The Divine Guide — showing the path |

Each library solves one problem. Zero external dependencies. Pure Python 3.8+.

---

## Contributing

1. Fork the repo
2. Create feature branch (`git checkout -b fix/your-fix`)  
3. Add tests — zero dependencies only
4. Open a PR

---

<div align="center">

**⚡ Built by [Darshankumar Joshi](https://github.com/darshjme)** · [@thedarshanjoshi](https://twitter.com/thedarshanjoshi)

*"कर्मण्येवाधिकारस्ते मा फलेषु कदाचन"*
*Your right is to action alone, never to its fruits. — Bhagavad Gita 2.47*

[Vedic Arsenal](https://github.com/darshjme/arsenal) · [GitHub](https://github.com/darshjme) · [Twitter](https://twitter.com/thedarshanjoshi)

</div>
