Evo-OS

<div align="center">

🧬 Evo OS

The Agent-First Development Orchestrator
<img width="1912" height="948" alt="image" src="https://github.com/user-attachments/assets/ffec4744-eb0e-4036-a2e1-6f172adbef3e" />


</div>

<a name="english"></a>

🧬 English

"Build software, don't just generate code."

Evo OS is a robust, cost-aware, and self-healing autonomous AI development framework designed to run locally with Docker sandboxing.

🧐 What is Evo OS?

Evo OS is an "Agent-First" development environment. Unlike simple coding assistants, Evo acts as a full engineering team. It plans the architecture, writes the code, verifies it using static analysis (AST), executes it in a sandbox to check for runtime errors, and fixes its own mistakes—all autonomously.

It addresses the critical flaws of current AI agents: Infinite Loops, Hidden Costs, and Environment Pollution.

✨ Key Features

🥇 BudgetGuard™ (Real-time Cost Control)

Evo tracks token usage in real-time and converts it to actual currency (JPY/USD). It strictly enforces budget limits per run (e.g., stops immediately if it exceeds 50 JPY), preventing unexpected API bills.

🛡️ Smart Healing & Loop Detection

Uses a multi-stage healing process (Patching -> Rewriting). Crucially, it includes logic to detect healing loops. If Evo gets stuck trying to fix the same error twice, it intelligently adapts its strategy or moves forward to prevent stalled processes.

🐳 Docker Sandboxing

All code execution happens inside a secure evo-sandbox Docker container. This ensures:

Security: No risk of malicious code running on your host (e.g., rm -rf / protection).

Consistency: Pre-installed heavy libraries (numpy, pandas, qiskit, scikit-learn, etc.) ensure fast and reproducible execution.

🧩 Kit System (Self-Expansion)

Evo selects specialized "Kits" (YAML-based domain knowledge) based on your prompt (e.g., "Make a Chrome Extension", "Create a Mahjong Game"). It can even generate new Kits for itself to learn new technologies on the fly