avastha 0.1.0

Persistent state management for LLM agents across sessions

🌊 अवस्था

avastha

Mandukya Upanishad

States of Being — Jagrat Svapna Sushupti

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

Formerly agent-state — 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 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

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

pip install avastha

Or from source:

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

Quick Start

from avastha import *

# See examples/ for full usage

---

The Vedic Arsenal

avastha is one of 100 libraries in 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

---

🌊 Built by Darshankumar Joshi · @thedarshanjoshi

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

Vedic Arsenal · GitHub · Twitter