⚡ क्षेत्र

kshetra

Mahabharata / Bhagavad Gita 1.1

The Sacred Field — Kurukshetra itself

Sandbox execution environment for LLM agent tools. Isolated execution, resource limits.

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

The Bhagavad Gita opens with these words: "Dhritarashtra said: O Sanjaya, what did my sons and the sons of Pandu do when they assembled in the holy field of Kurukshetra, eager for battle?"

The Kshetra — the sacred field — is where karma plays out. Contained. Bounded. Yet infinite in its consequences.

kshetra provides the sacred sandbox for your LLM agent. A contained execution environment where experiments can run, code can execute, tools can be tested — without touching the sacred ground of production. Like Kurukshetra itself: the battle happens here, but the consequences are isolated by the dharmic boundary.

flowchart LR
    A[Agent Code] --> B[kshetra sandbox]
    B --> C{Execute}
    C -- Safe --> D[Result]
    C -- Dangerous --> E[Block + Log]
    B --> F[Isolated Environment]
    style B fill:#f59e0b,color:#000

pip install kshetra

Or from source:

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

from kshetra import *

# See examples/ for full usage

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

Each library solves one problem. Zero external dependencies. Pure Python 3.8+.

1. Fork the repo
2. Create feature branch (git checkout -b fix/your-fix)
3. Add tests — zero dependencies only
4. Open a PR