⚡ मार्गदर्शक
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:
| 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
- Fork the repo
- Create feature branch (
git checkout -b fix/your-fix) - Add tests — zero dependencies only
- Open a PR
⚡ Built by Darshankumar Joshi · @thedarshanjoshi
"कर्मण्येवाधिकारस्ते मा फलेषु कदाचन" Your right is to action alone, never to its fruits. — Bhagavad Gita 2.47
Metadata
Release files for margadarshak 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| margadarshak-1.0.0.tar.gz | 7.0 kB | Without provenance | Details for margadarshak-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| margadarshak-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for margadarshak-1.0.0-py3-none-any.whl |
Total release size: 12.5 kB
Release files / margadarshak-1.0.0.tar.gz
| Download URL | margadarshak-1.0.0.tar.gz |
|---|---|
| Size | 7.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5d9bbb258e5fd8024f0d48b346781f52fda974c19044532b589992a788daa523
|
|
BLAKE2b-256 checksum How to use checksums |
3f02dc9b19faa295fdee61e9e3677cf072fb5c0c7d07d2609e6806b2351452b0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.11
|
Release files / margadarshak-1.0.0-py3-none-any.whl
| Download URL | margadarshak-1.0.0-py3-none-any.whl |
|---|---|
| Size | 5.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
843009e1d4236ae562ad85509c42fe31aecaa4dd4c8c97db897ac77a54e8dfa6
|
|
BLAKE2b-256 checksum How to use checksums |
26598d4916e0c447386ee964a1d8b827b5750ac2da975c91dd8b6f62789725f5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.11
|
Security for margadarshak 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.