agent-retry 0.1.0

Zero-dependency Python library for resilient LLM agent calls — exponential backoff, jitter, fallback chains, and dead letter queues.

🔮 पुनर्जन्म

punarjanma

Upanishads / Bhagavad Gita 2.20

Rebirth — the eternal cycle

Resilient retry strategies for LLM agents: exponential backoff, jitter, circuit-breaker patterns. Zero dependencies.

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

---

The Vedic Principle

In the Bhagavad Gita, Lord Krishna reveals to Arjuna: "na jāyate mriyate vā kadācin" — the soul is never born, never dies. It returns, again and again, until liberation.

punarjanma brings this eternal principle to LLM agent engineering. When your API call fails, when the model returns garbage, when the network drops — the agent returns. Exponential backoff is not failure. It is the dharmic cycle of persistence, each attempt purified by the lessons of the last.

Just as the soul accumulates wisdom across lifetimes to finally achieve moksha, your agent accumulates context across retries to finally achieve its goal. The dead letter queue is not defeat — it is the end of a cycle, the completion of karma.

---

How It Works

flowchart LR
    A[LLM Call] --> B{Success?}
    B -- Yes --> C[Return Result]
    B -- No --> D[punarjanma]
    D --> E{Attempts < Max?}
    E -- Yes --> F[Exponential Backoff]
    F --> A
    E -- No --> G[Dead Letter Queue]
    style D fill:#6b21a8,color:#fff

---

Installation

pip install punarjanma

Or from source:

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

Quick Start

from punarjanma import *

# See examples/ for full usage

---

The Vedic Arsenal

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

Sanskrit Name	Source	Technical Function
punarjanma	Upanishads / Bhagavad Gita 2.20	Rebirth — the eternal cycle

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