{"id":50881664,"url":"https://github.com/zd87pl/powerhouse","last_synced_at":"2026-06-15T13:30:30.365Z","repository":{"id":354067987,"uuid":"1221965641","full_name":"zd87pl/powerhouse","owner":"zd87pl","description":"10x Powerhouse — Ziggy's autonomous AI engineering organization. Self-improving infra for scaffolding, deploying, monitoring and autonomously fixing projects.","archived":false,"fork":false,"pushed_at":"2026-05-10T03:17:33.000Z","size":5993,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-10T03:33:09.061Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zd87pl.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-26T22:46:32.000Z","updated_at":"2026-05-10T03:17:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zd87pl/powerhouse","commit_stats":null,"previous_names":["zd87pl/powerhouse"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zd87pl/powerhouse","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zd87pl%2Fpowerhouse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zd87pl%2Fpowerhouse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zd87pl%2Fpowerhouse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zd87pl%2Fpowerhouse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zd87pl","download_url":"https://codeload.github.com/zd87pl/powerhouse/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zd87pl%2Fpowerhouse/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34365596,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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-06-15T13:30:28.788Z","updated_at":"2026-06-15T13:30:30.350Z","avatar_url":"https://github.com/zd87pl.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# ⚡ POWERHOUSE\n\n### **Declare the business. Reconcile the infrastructure. Automate the fixes.**\n\n\u003e *\"Build me a plus-size fashion store for the Polish market.\"*\n\u003e *Powerhouse turns that intent into projects, infrastructure checks, and agent workflows.*\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python](https://img.shields.io/badge/Python-3.11+-blue.svg)](https://python.org)\n\n[📖 Docs](#-quick-start) · [🚀 Try It](#-quick-start) · [🤖 How Autonomy Works](#-how-it-works) · [⭐ Star](https://github.com/zd87pl/powerhouse)\n\n\u003c/div\u003e\n\n---\n\n## 🤯 What Is This?\n\n**Powerhouse is an early-stage autonomous engineering harness.** You give it a business idea or `.powerhouse.yml` intent file. The current codebase provides:\n\n1. **Intent parsing** from natural language into a structured app spec\n2. **Project tracking** through a FastAPI control plane and Next.js dashboard\n3. **Infrastructure reconciliation** with explicit synced, drifted, skipped, and error states\n4. **Credential management** with encrypted-at-rest API keys\n5. **Agent/runtime scaffolding** for future autofix, swarm, and business-agent loops\n\nThe product goal is larger: live scaffolding, deploys, monitoring, and self-healing PRs. Those paths are being hardened behind explicit auth, credentials, and quota gates before they are treated as production-ready.\n\n### See it in action:\n\n```bash\n# One file. That's all you need.\ncat \u003e .powerhouse.yml \u003c\u003c EOF\nproject: bez-spinki\ndescription: \"Polish plus-size fashion store\"\nstack: nextjs\nfeatures: [shopify-checkout, size-guide, BLIK-payments, inventory-sync]\nmarket: PL\nEOF\n\n# Then run the API/dashboard and reconcile the declared resources.\npython3 run_api.py\n# → http://localhost:8080/api/health\n```\n\n---\n\n## 🔥 The Difference\n\nMost AI coding tools stop at **code generation**. Powerhouse is aimed at the next layer: declared resources, deploy state, observability, and repair workflows.\n\nThe current repo is a foundation for that loop. Evaluate it as a prototype control plane, not as a finished production autonomous operator.\n\n```\nYOU: \"Build me a store\"\n     │\n     ▼\n┌────────────────────────────────────────────────────────────┐\n│  POWERHOUSE AGENT SWARM                                     │\n│                                                             │\n│  🏛️ Architect    → Designs schema, plans files               │\n│  👨‍💻 Coder        → Implements clean, typed, tested code      │\n│  🔍 Reviewer     → Validates everything — PASS or REVISE     │\n│  🚀 DevOps       → Deploys to Vercel, configures Shopify    │\n│  🧪 Tester       → Fuzzes inputs, runs edge cases           │\n│                                                             │\n│  Target: loop until Reviewer says PASS, then open a PR.     │\n└────────────────────────────────────────────────────────────┘\n     │\n     ▼  LIVE at https://your-store.com\n     │\n     ▼  3AM: Bug detected\n┌────────────────────────────────────────────────────────────┐\n│  🤖 AUTOFIX DAEMON                                          │\n│  → Reads stack trace                                        │\n│  → Diagnoses root cause                                     │\n│  → Target: generate patch, open PR, verify CI               │\n└────────────────────────────────────────────────────────────┘\n```\n\n\u003e **Current status:** the control plane, dashboard, intent engine, and agent primitives exist. End-to-end autonomous repair is not production-ready yet.\n\n---\n\n## 🎯 What You Can Build\n\n| Business Type | What Powerhouse Handles | Time to Live |\n|---|---|---|\n| 🛍️ **Ecommerce store** | Intent parsing and scaffold target; payments/inventory integrations planned | Prototype |\n| 📊 **SaaS dashboard** | FastAPI + Next.js dashboard exists; auth/billing hardening planned | In progress |\n| 🤖 **API service** | FastAPI control plane, project tracking, key storage, reconciliation | In progress |\n| 🧪 **ML pipeline** | RunPod/training workflow is roadmap only | Planned |\n\n---\n\n## 🧬 How It Works\n\n### 1. The Intent Engine\nYou declare **what** you want. Not how to build it.\n\n```yaml\n# .powerhouse.yml — that's the whole spec\nproject: my-saas\ndescription: \"Analytics dashboard for ecommerce\"\nstack: nextjs\nauth: clerk\ndatabase: supabase\nbilling: stripe\nmonitoring: sentry+phoenix\n```\n\nThe engine reads this and compares declared resources with reality:\n- GitHub repo exists? If credentials are configured, verify or create it\n- Deploy target present? Verify supported provider state or report skipped\n- CI/CD running? Check what can be verified and report drift\n- **Every resource declared = synced, drifted, skipped, or errored.** Skipped work is not reported as healthy.\n\n### 2. The Autonomy Core\nWhat makes Powerhouse actually autonomous — not just a fancy scaffold script:\n\n- **Event Bus** — agents communicate through typed in-process events.\n- **Episodic Memory** — in-memory fallback exists; ChromaDB/Supabase persistence is being integrated.\n- **Model Router** — routing primitives exist; LiteLLM/OpenRouter hardening is still planned.\n- **Deliberation Council** — a heuristic council exists; production agent deliberation is planned.\n\n### 3. Business Agents\nDomain-specific agents that run your business:\n\n```python\n# Margin monitoring — fires automatically\nmerch = MerchAgent()\nalerts = await merch.check_margins(products)\n# → \"Sukienki XL: 25% margin (threshold 40%). Raise price $80→$100\"\n\n# Traffic anomaly detection\ngrowth = GrowthAgent()\nalert = await growth.detect_traffic_anomaly(\"/sukienki\", 5000, 1000)\n# → \"🚨 +400% traffic spike on /sukienki. Check referrer.\"\n\n# A/B test lifecycle\ntest = await growth.propose_ab_test(\n    name=\"Hero CTA copy test\",\n    hypothesis=\"If we change CTA to 'Shop the Look', conversion will improve\",\n    variant_a=\"Shop Now\", variant_b=\"Shop the Look\"\n)\n```\n\n---\n\n## 🚀 Quick Start\n\n```bash\n# 1. Clone\ngit clone https://github.com/zd87pl/powerhouse.git \u0026\u0026 cd powerhouse\n\n# 2. Install\npip install -r requirements.txt\n\n# 3. Run the API\npython3 run_api.py\n# → http://localhost:8080/api/health\n\n# 4. Optional: run the dashboard\ncd dashboard \u0026\u0026 npm install \u0026\u0026 npm run dev\n# → http://localhost:3000/dashboard/setup\n\n# 5. Create your first project\ncurl -X POST http://localhost:8080/api/projects \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"my-store\", \"stack\": \"nextjs\", \"intent_yaml\": \"project: my-store\\nstack: nextjs\\ndeploy:\\n  provider: vercel\"}'\n\n# 6. Trigger reconciliation\ncurl -X POST http://localhost:8080/api/projects/\u003cid\u003e/reconcile\n# → Infrastructure checks are reported as synced, drifted, skipped, or error\n```\n\n`run_api.py` sets local-only development auth and dev secret encryption defaults. In production, configure Clerk, `POWERHOUSE_SECRET_KEY`, explicit `POWERHOUSE_CORS_ORIGINS`, and leave `POWERHOUSE_ALLOW_DEV_AUTH` disabled.\n\nThe setup dashboard reports each provider as connected from environment variables, configured from encrypted user-supplied keys, or missing. Required providers currently start with GitHub and Vercel so OSS users can bring their own tokens while the control plane keeps project progress visible. GitHub and Vercel can also be validated from the dashboard with read-only API checks before automated work is enabled.\n\n---\n\n## 🛡️ vs. Everyone Else\n\n| | Bolt | Lovable | v0 | Replit | **Powerhouse** |\n|---|---|---|---|---|---|\n| Builds an app | ✅ | ✅ | ✅ | ✅ | 🏗️ |\n| Deploys it | ✅ | ✅ | ✅ | ✅ | gated prototype |\n| CI/CD + monitoring | ❌ | ❌ | ❌ | ❌ | 🏗️ |\n| **Self-healing** | ❌ | ❌ | ❌ | ❌ | planned |\n| **Remembers decisions** | ❌ | ❌ | ❌ | ❌ | prototype |\n| **Agent swarms** | ❌ | ❌ | ⚠️ | ❌ | scaffolded |\n| **Business agents** | ❌ | ❌ | ❌ | ❌ | prototype |\n| Open source | ❌ | ❌ | ❌ | ❌ | **✅ MIT** |\n\n\u003e **Moat target:** closed-loop repair from production error to verified PR.\n\n---\n\n## 📋 Roadmap\n\n| Phase | Status |\n|---|---|\n| **Foundation** — Vector memory, model routing, event bus | 🏗️ In progress |\n| **Autonomy** — Agent swarms, deliberation council, autofix daemon | 🏗️ In progress |\n| **SaaS** — Multi-tenant, Clerk auth, Stripe billing | 🏗️ In progress |\n| **Scale** — RunPod training, enterprise SSO, SOC-2 | 📅 Q3 2026 |\n\n---\n\n## 🤝 Who's This For?\n\n- **Solo founders** — prototype app and infrastructure intent quickly\n- **Agencies** — manage declared resources and project status from one control plane\n- **Ecommerce operators** — experiment with merchandising and growth-agent primitives\n- **AI researchers** — RunPod integration for training + evaluation pipelines\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built with ⚡ by Ziggy**\n\n[⭐ Star this repo](https://github.com/zd87pl/powerhouse) · [📖 Full docs](docs/) · [💬 Discussions](https://github.com/zd87pl/powerhouse/discussions)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzd87pl%2Fpowerhouse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzd87pl%2Fpowerhouse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzd87pl%2Fpowerhouse/lists"}