⚡ मार्गदर्शक

margadarshak

Bhagavad Gita — Krishna as guide

The Divine Guide — showing the path

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

Formerly agent-router — Part of the Vedic Arsenal: 100 production-grade Python libraries for LLM agents, each named from the Vedas, Puranas, and Mahakavyas.

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

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

pip install margadarshak

Or from source:

git clone https://github.com/darshjme/margadarshak.git
cd margadarshak && pip install -e .

Quick Start

from margadarshak import *

# See examples/ for full usage

The Vedic Arsenal

margadarshak is one of 100 libraries in darshjme/arsenal — each named from sacred Indian literature:

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