Metadata-Version: 2.4
Name: avastha
Version: 0.1.0
Summary: Persistent state management for LLM agents across sessions
Author-email: Darshankumar Joshi <darshjme@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/darshjme-codes/agent-state
Project-URL: Repository, https://github.com/darshjme-codes/agent-state
Keywords: llm,agents,state,persistence,checkpoint,session
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.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
Requires-Python: >=3.10
Description-Content-Type: text/markdown

<div align="center">

<img src="assets/avastha-hero.png" alt="अवस्था — avastha by Darshankumar Joshi" width="100%" />

# 🌊 अवस्था
## `avastha`

> *Mandukya Upanishad*

### States of Being — Jagrat Svapna Sushupti

**Persistent state management for LLM agents. Snapshots, rollback, multi-backend storage. Zero dependencies.**

[![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/avastha)
[![Vedic Arsenal](https://img.shields.io/badge/Vedic%20Arsenal-100%20libs-blue?style=flat-square)](https://github.com/darshjme/arsenal)
[![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)

*Formerly `agent-state` — 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 *Avastha* principle from Mandukya Upanishad 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 — `avastha` applies this wisdom to LLM agent engineering.

The concept of *अवस्था* (States of Being — Jagrat Svapna Sushupti) speaks directly to the technical problem this library solves. When the sages codified this principle in Mandukya Upanishad, 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[avastha]
    B --> C{Process}
    C -- Success --> D[Output]
    C -- Error --> E[Handle]
    E --> B
    style B fill:#6b21a8,color:#fff
```

---

## Installation

```bash
pip install avastha
```

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

## Quick Start

```python
from avastha import *

# See examples/ for full usage
```

---

## The Vedic Arsenal

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

| Sanskrit Name | Source | Technical Function |
|---|---|---|
| `avastha` | Mandukya Upanishad | States of Being — Jagrat Svapna Sushupti |

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>
