{"id":30656150,"url":"https://github.com/pmutua/chaospilot","last_synced_at":"2026-04-15T05:31:30.116Z","repository":{"id":300859781,"uuid":"1001299395","full_name":"pmutua/ChaosPilot","owner":"pmutua","description":"ChaosPilot is an intelligent log analysis platform that uses AI agents to automatically analyze error, warning, and critical logs, detect patterns, classify incidents, and recommend fixes.","archived":false,"fork":false,"pushed_at":"2025-06-24T00:10:55.000Z","size":42993,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-24T01:25:33.870Z","etag":null,"topics":["adk-python","agentdevelop","aiagents","aiintegrations","angular","bash-scripting","batch-script","docker","docker-compose","gemini","googleai","googlecloud","googlegen","llms","makefile","mcp","mcp-server","mcp-tool-box-for-databases","python","vercel-deployment"],"latest_commit_sha":null,"homepage":"https://chaos-pilot.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pmutua.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-13T06:37:46.000Z","updated_at":"2025-06-24T00:47:47.000Z","dependencies_parsed_at":"2025-06-24T01:35:56.059Z","dependency_job_id":null,"html_url":"https://github.com/pmutua/ChaosPilot","commit_stats":null,"previous_names":["pmutua/chaospilot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pmutua/ChaosPilot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmutua%2FChaosPilot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmutua%2FChaosPilot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmutua%2FChaosPilot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmutua%2FChaosPilot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pmutua","download_url":"https://codeload.github.com/pmutua/ChaosPilot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmutua%2FChaosPilot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272965996,"owners_count":25023188,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-31T02:00:09.071Z","response_time":79,"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":["adk-python","agentdevelop","aiagents","aiintegrations","angular","bash-scripting","batch-script","docker","docker-compose","gemini","googleai","googlecloud","googlegen","llms","makefile","mcp","mcp-server","mcp-tool-box-for-databases","python","vercel-deployment"],"created_at":"2025-08-31T10:07:48.006Z","updated_at":"2026-04-15T05:31:30.070Z","avatar_url":"https://github.com/pmutua.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ChaosPilot – AI-Powered Log Analysis Platform\n\n\u003e **Modern, full-stack AI platform for automated log analysis, incident classification, and intelligent remediation.**\n\n---\n\n[🚀 Quick Start](QUICK_START.md) | [📖 Setup Guide](docs/setup-and-deployment/HOW_TO_RUN_AND_DEPLOY_THE_APPLICATION.md) | [🔧 ADK Integration](docs/setup-and-deployment/ADK_INTEGRATION_README.md) | [🧪 Test Integration](test_adk_integration.py)\n\n---\n\n## 🎯 What is ChaosPilot?\n\nChaosPilot is an intelligent log analysis platform that uses AI agents to automatically analyze error, warning, and critical logs, detect patterns, classify incidents, and recommend fixes.  \n**We manage the chaos of production errors through intelligent log analysis.**\n\n---\n\n## 🏆 Features\n\n- **🔍 AI-Powered Analysis:** LLMs analyze logs for patterns and anomalies\n- **📊 Incident Classification:** Auto-classifies by severity, impact, urgency\n- **📋 Smart Response Planning:** Generates actionable response plans\n- **🛠️ Automated Fix Recommendations:** Suggests and executes safe fixes\n- **⚡ Safe Auto-Fixing:** Automated fixes with rollback capability\n- **📢 Smart Alerting:** Intelligent notifications and escalations\n- **📈 Real-Time Dashboard:** Live metrics, workflow visualization, and insights\n\n---\n\n## 🏗️ Architecture\n\n| Layer      | Tech/Tools                                      |\n|------------|-------------------------------------------------|\n| Frontend   | Angular, TypeScript, TailwindCSS, RxJS          |\n| Backend    | Python, FastAPI, Google ADK, async/await        |\n| Auth       | Supabase (user/session management)              |\n| Data/AI    | Google ADK agents, BigQuery, LLMs               |\n| DevOps     | Docker, GCP, `uv`, `hatch`                      |\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- [Google Cloud CLI](https://cloud.google.com/sdk/docs/install-sdk)\n- [Python 3.9+](https://wiki.python.org/moin/BeginnersGuide/Download)\n- [Uv](https://pypi.org/project/uv/) - 🚀 A single tool to replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more.\n   \u003e![uv comparison](./assets/uv-comparison.PNG)\n- [Node.js 16+](https://nodejs.org/)\n- [MCP Toolbox for Databases](https://googleapis.github.io/genai-toolbox/getting-started/local_quickstart/)\n\n### Setup\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/pmutua/ChaosPilot\n   cd ChaosPilot\n   ```\n\n2. **Create and activate a Python virtual environment**\n\n   - Create virtual environment\n      ```bash\n\n      uv venv\n\n      ```\n\n   - Activate virtual  environment\n\n      ```bash\n\n      # Linux/macOS:\n\n      source .venv/bin/activate\n\n      # Windows \n\n      .venv\\Scripts\\activate\n\n\n      ```\n\n\n3. **Install dependencies**\n   ```bash\n   uv sync\n   ```\n4. **Rename  `.env.template` to  `.env` and add relevant environment variables:**\n   ```env\n   APP_NAME=\"agent_manager\"\n   VERSION=0.0.0\n   MODEL=\"\"\n\n   # If you are using Google  Gemini use this\n   GOOGLE_GENAI_USE_VERTEXAI=FALSE\n   GOOGLE_API_KEY=PASTE_YOUR_ACTUAL_API_KEY_HERE\n\n   # If you are using Azure Open AI use this\n   AZURE_API_KEY=\"add api key\"\n   AZURE_API_BASE=https://example.openai.azure.com/\n   AZURE_API_VERSION=\"2025-05-05-preview\"\n   ```\n\n5. **Set up Google Cloud, BigQuery, and MCP Toolbox**  \n   (See [Setup Guide](docs/setup-and-deployment/HOW_TO_RUN_AND_DEPLOY_THE_APPLICATION.md) for full details.)\n\n---\n\n## 🖥️ Running the Application\n\n### Start All Services\n\n```bash\n# Start MCP Toolbox\ncd mcp-toolbox\n\ntoolbox --tools-file=\"tools.yaml\"\n\n# Start ADK API Server (with CORS)\n\ncd ../agent_manager\n\nadk api_server  --allow_origins=\"*\"\n\n\n# or in root directory run: \n\nadk api_server agent_manager --allow_origins=\"*\"\n\n# Start Frontend\ncd ../web\nnpm install\nnpm start\n\n```\n\n## Debugging with Agent Development Kit  UI\n\n\nSimply run the following command:\n\n\n```bash\n\nadk web\n\n# And navigate to port 8000. Now you can interact with the Agents and debug.\n\n```\n\n\u003e **NOTE:** Make sure that you select \"agent_manager\" on \"Select Agent\" option.\n\n\n---\n\n![agent ui](./assets/adkweui-interaction.png)\n\n## 📚 Documentation\n\n- [Setup \u0026 Deployment Guide](docs/setup-and-deployment/HOW_TO_RUN_AND_DEPLOY_THE_APPLICATION.md)\n\n---\n\n## 📊 Usage Examples\n\n### Analyze Error Logs\n\n1. Go to the Log Analysis page\n2. Select the \"Log Analyzer\" agent\n3. Provide error logs or describe the issue\n4. Get AI-powered analysis with confidence scores\n\n### Get Fix Recommendations\n\n1. Use the \"Fix Recommender\" agent\n2. Share the analyzed logs and issues\n3. Get specific fix suggestions with implementation steps\n\n### Automated Incident Response\n\n1. System detects critical issues\n2. AI agents generate response plans\n3. Safe automated fixes are applied\n4. Teams are notified with detailed reports\n\n---\n\n\n## 🚀 Production Deployment\n\nSee [Setup \u0026 Deployment Guide](docs/setup-and-deployment/HOW_TO_RUN_AND_DEPLOY_THE_APPLICATION.md) for GCP/Cloud Run instructions.\n\n---\n\n## 🔧 Troubleshooting\n\n- **CORS Errors:** Use `adk api_server app --allow_origins=\"*\"`\n- **Service Account Issues:** Run the IAM role assignment scripts\n- **Billing Errors:** Ensure GCP billing is enabled\n- **Agent Not Found:** Verify you're running from the correct directory\n\n---\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests if applicable\n5. Submit a pull request\n\n---\n\n## 📄 License\n\nMIT License – see the LICENSE file for details.\n\n---\n\n## 🆘 Support\n\n- Create an issue in the repository\n- Check the [documentation](docs/setup-and-deployment/)\n- Review the [troubleshooting guide](docs/setup-and-deployment/HOW_TO_RUN_AND_DEPLOY_THE_APPLICATION.md#-troubleshooting)\n\n---\n\n**ChaosPilot** – Managing the chaos of production errors through AI-powered log analysis.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpmutua%2Fchaospilot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpmutua%2Fchaospilot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpmutua%2Fchaospilot/lists"}