Ouro Loop

Ouro Loop


**"To grant an entity absolute autonomy, you must first bind it with absolute constraints."**

[](https://opensource.org/licenses/MIT) [](https://pypi.org/project/ouro-loop/) [](https://www.python.org/downloads/) [](https://github.com/VictorVVedtion/ouro-loop/actions/workflows/test.yml) []() []()

What is Ouro Loop?

**Ouro Loop** is an open-source framework that gives AI coding agents (Claude Code, Cursor, Aider, Codex) a structured autonomous loop with runtime-enforced guardrails. It implements **bounded autonomy** — the developer defines absolute constraints (DANGER ZONES, NEVER DO rules, IRON LAWS) using the BOUND system, then the agent loops autonomously through Build → Verify → Self-Fix cycles. When verification fails, the agent doesn't ask for help — it consults its remediation playbook, reverts, tries a different approach, and reports what it did. Constraints are enforced at the runtime level through Claude Code Hooks (exit 2 hard-block), not by relying on the agent's "good behavior." Inspired by Karpathy's [autoresearch](https://github.com/karpathy/autoresearch), extended from ML to general software engineering. Zero dependencies, pure Python 3.10+.