Metadata-Version: 2.4
Name: vyavastha
Version: 0.1.0
Summary: Environment, secrets, and runtime config management for LLM agents
Author-email: Darshankumar Joshi <darshjme@gmail.com>
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"

<div align="center">

<img src="assets/vyavastha-hero.png" width="100%" alt="vyavastha hero banner" />

# व्यवस्था
## vyavastha

> *Arthashastra / Manusmriti*

**Divine Order — cosmic configuration**

_Hierarchical configuration management for LLM agents. Load from env, files, remote. Override layers. Zero dependencies._

[![Python](https://img.shields.io/badge/Python-3.9+-D97706.svg?style=flat-square&logo=python&logoColor=white)](https://python.org)
[![License](https://img.shields.io/badge/License-MIT-D97706.svg?style=flat-square)](LICENSE)
[![Part of Arsenal](https://img.shields.io/badge/Part%20of-Vedic%20Arsenal-D97706.svg?style=flat-square)](https://github.com/darshjme/arsenal)
[![Zero Dependencies](https://img.shields.io/badge/Dependencies-Zero-D97706.svg?style=flat-square)](pyproject.toml)

</div>

---

## The Vedic Principle

The ancient seers who wrote the Arthashastra / Manusmriti understood something that modern engineers are only beginning to rediscover: that the greatest technical systems mirror the eternal laws of cosmic order. Divine Order — cosmic configuration is not merely a Sanskrit translation — it is a fundamental principle woven into the fabric of existence itself.

In the Vedic worldview, vyavastha represents the divine order — cosmic configuration — the sacred function that every complex system requires to maintain dharmic operation. Just as the cosmos cannot function without this principle, your LLM agents cannot achieve production reliability without vyavastha. The ancient wisdom and modern engineering converge at this exact point.

vyavastha brings this timeless principle to your agent infrastructure. Whether you're building simple chatbots or complex multi-agent systems, config is not optional — it is dharma. Built by engineers who understand both the technical requirements and the cosmic significance of getting this right.

---

## How It Works

```mermaid
flowchart LR
    A[ENV Variables] --> D[व्यवस्था Config]
    B[YAML/JSON Files] --> D
    C[Remote Config] --> D
    D --> E[Override Layers]
    E --> F[🎯 Agent Runtime]
```

---

## Quick Start

```bash
pip install vyavastha
```

```python
from vyavastha import *

# Initialize
agent = Vyavastha()

# Use
result = agent.process(your_input)
print(result)
```

---

## Features

- ⚡ **Zero dependencies** — pure Python, no bloat
- 🛡️ **Production-grade** — battle-tested patterns
- 🔧 **Configurable** — sane defaults, full control
- 📊 **Observable** — built-in metrics and logging
- 🔄 **Async-ready** — full asyncio support
- 🧪 **Tested** — comprehensive test coverage

---

## Installation

```bash
# pip
pip install vyavastha

# From source
git clone https://github.com/darshjme/vyavastha
cd vyavastha
pip install -e .
```

---

## Part of the Vedic Arsenal

`vyavastha` is part of the **[Vedic Arsenal](https://github.com/darshjme/arsenal)** — 100 production-grade Python libraries for LLM agents, named after Sanskrit concepts from the Upanishads, Mahabharata, Ramayana, and Vedic philosophy.

Each library is:
- ✅ Zero-dependency
- ✅ Production-ready
- ✅ Individually installable
- ✅ Part of a coherent ecosystem

---

## Built by [Darshankumar Joshi](https://github.com/darshjme)

> *"Building the dharmic infrastructure for the AI age"*

[![GitHub](https://img.shields.io/badge/GitHub-darshjme-D97706.svg?style=flat-square&logo=github)](https://github.com/darshjme)
[![Arsenal](https://img.shields.io/badge/Vedic%20Arsenal-100%20Libraries-D97706.svg?style=flat-square)](https://github.com/darshjme/arsenal)

---

<div align="center">

*व्यवस्था — Divine Order — cosmic configuration*

*From the Arthashastra / Manusmriti*

</div>
