{"id":43048335,"url":"https://github.com/hummbl-dev/engine-ops","last_synced_at":"2026-01-31T10:09:12.148Z","repository":{"id":325651567,"uuid":"1101515160","full_name":"hummbl-dev/engine-ops","owner":"hummbl-dev","description":"engine optimization operations","archived":false,"fork":false,"pushed_at":"2026-01-30T13:12:01.000Z","size":2208,"stargazers_count":1,"open_issues_count":7,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-31T06:38:33.987Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hummbl-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"AUDIT_REPORT.md","citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":"GOVERNANCE.md","roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-11-21T19:34:16.000Z","updated_at":"2026-01-30T13:12:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hummbl-dev/engine-ops","commit_stats":null,"previous_names":["hummbl-dev/engine-ops"],"tags_count":5,"template":true,"template_full_name":null,"purl":"pkg:github/hummbl-dev/engine-ops","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fengine-ops","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fengine-ops/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fengine-ops/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fengine-ops/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hummbl-dev","download_url":"https://codeload.github.com/hummbl-dev/engine-ops/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fengine-ops/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28937871,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T08:53:31.997Z","status":"ssl_error","status_checked_at":"2026-01-31T08:51:38.521Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-31T10:09:11.319Z","updated_at":"2026-01-31T10:09:12.135Z","avatar_url":"https://github.com/hummbl-dev.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sovereign Intelligence Stack\n\n[![License](https://img.shields.io/badge/license-BSL%201.1-blue.svg)](LICENSE)\n[![Python](https://img.shields.io/badge/python-3.13-blue.svg)](https://www.python.org/downloads/)\n[![CI/CD](https://img.shields.io/badge/CI%2FCD-GitHub%20Actions-green.svg)](.github/workflows/production.yml)\n\n\u003e **Escape Digital Feudalism. Own Your AI.**\n\nA production-ready, self-evolving AI stack with constitutional governance, federated learning, and real-time control.\n\n---\n\n## 🎯 The Problem: AI Feudalism\n\n| Traditional AI        | Sovereign Stack          |\n| --------------------- | ------------------------ |\n| 🔒 **Black Box**      | 🔍 **Glass Box**         |\n| 🏢 **Vendor Lock-in** | 👤 **User Owned**        |\n| ❓ **Opaque Rules**   | 📜 **YAML Constitution** |\n| 🤖 **AI Decides**     | 🧠 **Human Governs**     |\n| 💨 **Context Rots**   | 📊 **Full Audit Trail**  |\n\n**You are not a tenant. You are the Sovereign.**\n\n---\n\n## ✨ Features\n\n### 🛡️ Governance \u0026 Safety\n\n- **Constitutional Policy Engine** - Define rules in `constitution.yaml`\n- **Immutable Audit Logging** - Every AI decision is traceable\n- **Policy Enforcement** - Block dangerous commands, secrets, SQL injection\n- **Adversarial Defense** - Red-team tested against prompt injection\n\n### 🧠 Advanced Cognition\n\n- **Self-Reflective Reasoning** - o1-style test-time compute\n- **Multi-Agent Debate** - Consensus through Red/Blue/Judge deliberation\n- **Episodic Memory (RAG)** - ChromaDB vector store with semantic search\n- **Federated Learning** - Cross-instance knowledge sharing (privacy-preserving)\n\n### 🏗️ Self-Evolution (The Architect)\n\n- **Sandboxed Code Generation** - TDD workflow (tests → code → verify)\n- **Path Traversal Protection** - All writes confined to `sandbox/`\n- **Constitutional Verification** - Generated code validated against policies\n- **Pattern Memorization** - Successful solutions stored for reuse\n\n### 🎮 SovereignOps Control Plane\n\n- **Real-Time Agent Management** - Pause/Resume/Stop any agent\n- **Terminal UI (TUI)** - Live monitoring dashboard (`sovereign_ops.py`)\n- **Management API** - RESTful endpoints for agent control\n- **Global Registry** - Track all active agents\n\n### 📦 Production Ready\n\n- **CI/CD Pipeline** - GitHub Actions with automated testing\n- **Kubernetes Deployment** - Multi-replica deployment with federation\n- **Monitoring** - Prometheus metrics (`/health`, `/metrics`)\n- **Integration Tests** - E2E workflow verification\n- **Load Balancing** - K8s Service with 3+ replicas\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Python 3.13+\n- Docker (optional, for K8s deployment)\n- Git\n\n### 1. Clone \u0026 Setup\n\n```bash\ngit clone https://github.com/hummbl-dev/engine-ops.git\ncd engine-ops\n\n# Setup Python environment\npython3 -m venv .venv\nsource .venv/bin/activate\npip install -r requirements.txt\n\n# Configure API key\necho \"GOOGLE_API_KEY=your_key_here\" \u003e .env\n```\n\n### 2. Run Locally\n\n```bash\n# Start the Engine API\nuvicorn engine.src.main:app --reload\n\n# In another terminal: Launch SovereignOps TUI\npython sovereign_ops.py\n```\n\nOpen \u003chttp://localhost:8000/docs\u003e for the Matrix-themed API interface.\n\n### 3. Deploy to Kubernetes\n\n```bash\n# Using the deployment helper (works with Colima)\nchmod +x scripts/deploy.sh\n./scripts/deploy.sh\n\n# Or manually\nkubectl apply -f infra/k8s/sovereign-stack-deployment.yaml\n```\n\nSee [Production Deployment Guide](docs/PRODUCTION_DEPLOYMENT.md) for detailed instructions.\n\n---\n\n## 📚 Architecture\n\n```\nengine-ops/\n├── agentic_workflow/       # Multi-agent system\n│   ├── agents/            # Detection, Triage, Resolution, Audit, Architect\n│   ├── tools/             # FileSandbox, safe I/O\n│   ├── debate.py          # Multi-agent consensus\n│   ├── policy.py          # Constitutional enforcement\n│   └── memory.py          # Episodic RAG\n├── engine/                # FastAPI REST API\n│   ├── src/main.py        # Matrix-themed Swagger UI\n│   └── src/registry.py    # Agent management\n├── infra/k8s/             # Kubernetes manifests\n├── sovereign_ops.py       # Terminal UI (Textual)\n├── sandbox/               # Safe code generation zone\n└── docs/                  # Complete documentation\n```\n\n---\n\n## 🎯 Core Components\n\n### 1. Constitutional Governance\n\nDefine your AI's behavior in `config/constitution.yaml`:\n\n```yaml\ndirectives:\n  - id: no_secrets\n    pattern: '(api[_-]?key|password|secret)'\n    action: block\n    reason: 'Potential secret exposure'\n```\n\n### 2. Multi-Agent Debate\n\nCritical decisions trigger consensus through deliberation:\n\n```python\nfrom agentic_workflow.debate import get_debate_orchestrator\n\norchestrator = get_debate_orchestrator()\nresult = orchestrator.orchestrate_debate(issue, rounds=3)\n# Returns: DebateResult with final_decision and convergence_score\n```\n\n### 3. The Architect (Self-Modification)\n\nGenerate code safely with TDD workflow:\n\n```python\nfrom agentic_workflow.agents.architect_agent import ArchitectAgent\n\narchitect = ArchitectAgent()\nresult = architect.generate_code(\"Create a Fibonacci function\")\n# Writes tests → implementation → runs tests → verifies policy\n```\n\n### 4. SovereignOps Control\n\nManage agents in real-time:\n\n```bash\n# Launch TUI\npython sovereign_ops.py\n\n# Or use API\ncurl -X POST http://localhost:8000/agents/agent-1/pause\ncurl -X POST http://localhost:8000/agents/agent-1/resume\n```\n\n---\n\n## 📖 Documentation\n\n- **[User Guide](USER_GUIDE.md)** - Complete usage guide\n- **[Production Deployment](docs/PRODUCTION_DEPLOYMENT.md)** - K8s deployment guide\n- **[Walkthrough](walkthrough.md)** - Feature demonstrations with examples\n- **[Manifesto](MANIFESTO.md)** - Philosophy \u0026 motivation\n- **[Architecture](docs/The_Sovereign_Scaffold.md)** - Technical deep dive\n\n---\n\n## 🧪 Testing\n\n```bash\n# Run all tests\npytest agentic_workflow/tests/ -v\n\n# Run integration tests\npytest agentic_workflow/tests/integration/ -v\n\n# With coverage\npytest --cov=agentic_workflow --cov-report=html\n```\n\n---\n\n## 🔬 Research Contributions\n\nThis stack implements several novel approaches:\n\n1. **Self-Reflective Multi-Agent Consensus** - Combining o1-style reasoning with deliberative debate (~30% accuracy improvement)\n2. **Privacy-Preserving Federated Memory** - Cross-instance learning without raw data exposure\n3. **Constitutional AI with Runtime Verification** - Policy enforcement at execution time, not just training\n4. **Sandboxed Self-Evolution** - Safe code generation with TDD and policy validation\n\nSee [walkthrough.md](walkthrough.md) for benchmarks and results.\n\n---\n\n## 🛣️ Roadmap\n\n- [x] **Phase 1-9:** Foundation (Governance, Memory, Debate, Federation)\n- [x] **Phase 10:** SovereignOps Control Plane\n- [x] **Phase 11:** The Architect (Self-Evolution)\n- [ ] **Phase 12:** Multi-Modal (Vision, Audio)\n- [ ] **Phase 13:** Formal Verification (TLA+)\n- [ ] **Phase 14:** Economic Optimizer (Cost-aware orchestration)\n\n---\n\n## 🤝 Contributing\n\nWe follow **SovereignOps** protocols:\n\n1. **Augmented Commits** - AI-generated code must cite provenance\n2. **Constitutional Audits** - All PRs pass policy checks\n3. **Context Hygiene** - Regular memory pruning\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n---\n\n## 📄 License\n\nBusiness Source License 1.1 (BSL 1.1)  \nConverts to Apache 2.0 on 2029-01-01\n\nSee [LICENSE](LICENSE) for details.\n\n---\n\n## 🙏 Acknowledgments\n\nBuilt with:\n\n- [FastAPI](https://fastapi.tiangolo.com/) - Modern Python web framework\n- [Textual](https://textual.textualize.io/) - Terminal UI framework\n- [ChromaDB](https://www.trychroma.com/) - Vector database\n- [Gemini](https://ai.google.dev/) - LLM provider\n- [Kubernetes](https://kubernetes.io/) - Container orchestration\n\n---\n\n**Welcome to the age of Owned Intelligence.**\n\n_You are not a tenant. You are the Sovereign._\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhummbl-dev%2Fengine-ops","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhummbl-dev%2Fengine-ops","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhummbl-dev%2Fengine-ops/lists"}