One README. Four pillars. Zero ambiguity. From bare metal to autonomous operation.
“Yantra” — Sanskrit (यन्त्र)
A geometric instrument of divine computation. Used in Vedic cosmology to represent structured pathways through which consciousness operates on matter.
YantraOS is not a Linux distro with AI bolted on. It is an inversion of the computing paradigm. The OS senses context, reasons over it, and acts — without waiting to be commanded. You are a principal. The OS is your agent.
# daemon starts on boot, thinks forever
systemctl status yantra.service
# → Active: active (running) since ...
# → Main PID: 1337 (yantra-daemon)SENSE → REMEMBER → REASON → ACT → LEARN. The Kriya Loop is the heartbeat of YantraOS. It runs perpetually inside yantra.service. It never pauses. Every cycle is a cognitive event: telemetry in, ChromaDB retrieval, LiteLLM inference, Docker execution, vector embedding out.
# Watch the loop in real time
python3 -m core.tui_shell
# ┌─ TELEMETRY ─┬─ THOUGHTSTREAM ──────┬─ COMMAND ─┐
# │ CPU: 12% │ [SENSE] reading... │ │
# │ RAM: 4.1GB │ [REASON] planning... │ > _ │
# └─────────────┴──────────────────────┴───────────┘Every autonomous action executes inside a locked-down Alpine Docker container. No host mount. No network. No privilege. LLM output is never executed on the host directly — it passes through JSON schema validation, then into the sandbox, then through a whitelisted SSH gateway.
# Execution chain (simplified)
LLM_OUTPUT
→ JSON Schema Validation
→ Docker Alpine Container
→ Restricted Shell
→ SSH (whitelisted key)
→ Host Command ExecutorHardware is not a barrier. YantraOS detects your hardware and routes inference to the optimal backend: Ollama for local GPUs with ≥8GB VRAM (ALPHA MODE), Gemini/Claude/GPT-4o via LiteLLM for edge hardware (EDGE MODE), or minimal offline models when network is unavailable (DARK MODE).
# In config.yaml — one setting, three modes
inference:
local_model: llama3:70b # ALPHA
cloud_model: gemini-2.0-flash # EDGE
fallback_model: phi3:mini # DARK
router: litellm # always