चेतना

chetana

Samkhya philosophy

Consciousness — the aware window

Context window management for LLM agents. Token counting, truncation strategies, sliding window. Zero dependencies.

---

The Vedic Principle

The ancient seers who wrote the Samkhya philosophy understood something that modern engineers are only beginning to rediscover: that the greatest technical systems mirror the eternal laws of cosmic order. Consciousness — the aware window is not merely a Sanskrit translation — it is a fundamental principle woven into the fabric of existence itself.

In the Vedic worldview, chetana represents the consciousness — the aware window — 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 chetana. The ancient wisdom and modern engineering converge at this exact point.

chetana brings this timeless principle to your agent infrastructure. Whether you're building simple chatbots or complex multi-agent systems, context 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

flowchart TD
    A[Raw Conversation] --> B[चेतना Token Count]
    B --> C{Within Window?}
    C -->|Yes| D[Pass to LLM]
    C -->|No| E[Truncation Strategy]
    E --> F[Sliding Window / Summary]
    F --> D

Loading

---

Quick Start

pip install chetana

from chetana import *

# Initialize
agent = Chetana()

# 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

# pip
pip install chetana

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

---

Part of the Vedic Arsenal

chetana is part of the Vedic 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

"Building the dharmic infrastructure for the AI age"

---

चेतना — Consciousness — the aware window

From the Samkhya philosophy