b52318eeae
- Add intelligent-router.sh hook for automatic agent routing - Add AUTO-TRIGGER-SUMMARY.md documentation - Add FINAL-INTEGRATION-SUMMARY.md documentation - Complete Prometheus integration (6 commands + 4 tools) - Complete Dexto integration (12 commands + 5 tools) - Enhanced Ralph with access to all agents - Fix /clawd command (removed disable-model-invocation) - Update hooks.json to v5 with intelligent routing - 291 total skills now available - All 21 commands with automatic routing 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
353 lines
17 KiB
Markdown
353 lines
17 KiB
Markdown
<a name="readme-top"></a>
|
||
|
||
<div align="center">
|
||
<img src="./docs/static/images/icon.jpg" alt="Prometheus Logo" width="160">
|
||
<h1 style="border-bottom: none;">
|
||
<b><a href="https://euni.ai/" target="_blank">Prometheus</a></b><br>
|
||
⚡ AI-Powered Software 3.0 Platform ⚡
|
||
</h1>
|
||
|
||
<p align="center">
|
||
<strong>Redefining Software Productivity Beyond Vibe Coding — There’s More Beyond Lovable and Replit.</strong><br>
|
||
<em>Moving beyond unreliable prototype generation, Prometheus turns your ideas into verifiable, affordable software through autonomous code agents.</em>
|
||
</p>
|
||
|
||
<!-- 🌍 Project Links -->
|
||
<p align="center">
|
||
<a href="https://euni.ai/"><b>Website</b></a> •
|
||
<a href="https://x.com/Euni_AI"><b>X/Twitter</b></a> •
|
||
<a href="https://www.linkedin.com/company/euni-ai/"><b>LinkedIn</b></a> •
|
||
<a href="https://discord.gg/jDG4wqkKZj"><b>Discord</b></a> •
|
||
<a href="https://www.reddit.com/r/EuniAI"><b>Reddit</b></a> •
|
||
<a href="https://github.com/EuniAI/Prometheus"><b>GitHub</b></a>
|
||
</p>
|
||
|
||
<!-- Badges -->
|
||
<p align="center">
|
||
<a href="https://github.com/EuniAI/Prometheus/stargazers">
|
||
<img src="https://img.shields.io/github/stars/EuniAI/Prometheus?style=for-the-badge&color=yellow" alt="Stars">
|
||
</a>
|
||
<a href="https://github.com/EuniAI/Prometheus/forks">
|
||
<img src="https://img.shields.io/github/forks/EuniAI/Prometheus?style=for-the-badge&color=blue" alt="Forks">
|
||
</a>
|
||
<a href="https://opensource.org/licenses/Apache-2.0">
|
||
<img src="https://img.shields.io/badge/license-Apache--2.0-green?style=for-the-badge" alt="License: Apache 2.0">
|
||
</a>
|
||
<a href="https://www.arxiv.org/abs/2507.19942">
|
||
<img src="https://img.shields.io/badge/Paper-arXiv-red?style=for-the-badge&logo=arxiv&logoColor=white" alt="arXiv Paper">
|
||
</a>
|
||
<a href="https://github.com/EuniAI/Prometheus/graphs/contributors">
|
||
<img src="https://img.shields.io/github/contributors/EuniAI/Prometheus?style=for-the-badge&color=orange" alt="Contributors">
|
||
</a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/EuniAI/Prometheus" target="_blank">
|
||
<img src="https://img.shields.io/github/commit-activity/m/EuniAI/Prometheus?label=Commits&color=brightgreen&style=flat" alt="Commit Activity">
|
||
</a>
|
||
<a href="https://github.com/EuniAI/Prometheus/forks" target="_blank">
|
||
<img src="https://img.shields.io/github/forks/EuniAI/Prometheus.svg?style=flat&color=blue&label=Forks" alt="Forks">
|
||
</a>
|
||
<a href="https://github.com/EuniAI/Prometheus/issues" target="_blank">
|
||
<img alt="Issues Closed" src="https://img.shields.io/github/issues-search?query=repo%3AEuniAI%2FPrometheus%20is%3Aclosed&label=Issues%20Closed&labelColor=%237d89b0&color=%235d6b98&style=flat">
|
||
</a>
|
||
<a href="https://github.com/EuniAI/Prometheus/discussions" target="_blank">
|
||
<img alt="Discussion Posts" src="https://img.shields.io/github/discussions/EuniAI/Prometheus?label=Discussions&labelColor=%239b8afb&color=%237a5af8&style=flat">
|
||
</a>
|
||
</p>
|
||
|
||
|
||
<hr style="width:80%;border:1px solid #ddd;">
|
||
|
||
</div>
|
||
|
||
|
||
|
||
<!-- <div align="center">
|
||
<a href="https://github.com/EuniAI/Prometheus/graphs/contributors"><img src="https://img.shields.io/github/contributors/EuniAI/Prometheus?style=for-the-badge&color=blue" alt="Contributors"></a>
|
||
<a href="https://github.com/EuniAI/Prometheus/stargazers"><img src="https://img.shields.io/github/stars/EuniAI/Prometheus?style=for-the-badge&color=blue" alt="Stargazers"></a>
|
||
<a href="https://www.arxiv.org/abs/2507.19942"><img src="https://img.shields.io/badge/Paper-arXiv-red?style=for-the-badge&logo=arxiv" alt="Paper"></a>
|
||
<br/>
|
||
<a href="https://github.com/EuniAI/Prometheus/blob/main/CREDITS.md"><img src="https://img.shields.io/badge/Project-Credits-blue?style=for-the-badge&color=FFE165&logo=github&logoColor=white" alt="Credits"></a>
|
||
<a href="https://discord.gg/jDG4wqkKZj"><img src="https://img.shields.io/badge/Discord-Join%20Us-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
|
||
|
||
<br/>
|
||
<hr>
|
||
</div> -->
|
||
|
||
<br/>
|
||
|
||
## 📣 News
|
||
|
||
- **[2025-11]** Prometheus achieved TOP 5 and TOP 1 🏆 in the agents using gpt-5 in the **[swebench leaderboard](https://www.swebench.com/)** for automated software engineering using LLMs 🎉!
|
||
- **[2025-10]** We maintain a curated list of code agent projects and research: **[Awesome Code Agents](https://github.com/EuniAI/awesome-code-agents)** - explore the cutting-edge developments in autonomous code generation, bug fixing, and software engineering automation.
|
||
|
||
---
|
||
|
||
## 📖 Overview
|
||
|
||
Prometheus is a research-backed, production-ready platform that leverages **unified knowledge graphs** and **multi-agent systems** to perform intelligent operations on multilingual codebases. Built on LangGraph state machines, it orchestrates specialized AI agents to automatically classify issues, reproduce bugs, retrieve relevant context, and generate validated patches.
|
||
|
||
### Key Capabilities
|
||
|
||
- **Automated Issue Resolution**: End-to-end bug fixing with reproduction, patch generation, and multi-level validation
|
||
- **Feature Implementation Pipeline**: Context-aware feature request analysis, implementation planning, and code generation with optional regression testing
|
||
- **Intelligent Context Retrieval**: Graph-based semantic search over codebase structure, AST, and documentation
|
||
- **Multi-Agent Orchestration**: Coordinated workflow between classification, reproduction, and resolution agents
|
||
- **Knowledge Graph Integration**: Neo4j-powered unified representation of code structure and semantics
|
||
- **Containerized Execution**: Docker-isolated testing and validation environment
|
||
- **Question Answering**: Natural language queries with tool-augmented LLM agents
|
||
|
||
📖 **[Multi-Agent Architecture](docs/Multi-Agent-Architecture.md)** | 📄 **[Research Paper](https://arxiv.org/abs/2507.19942)**
|
||
---
|
||
|
||
```bibtex
|
||
@misc{chen2025prometheusKG,
|
||
title={Prometheus: Unified Knowledge Graphs for Issue Resolution in Multilingual Codebases},
|
||
author={Zimin Chen and Yue Pan and Siyu Lu and Jiayi Xu and Claire Le Goues and Martin Monperrus and He Ye},
|
||
year={2025},
|
||
eprint={2507.19942},
|
||
archivePrefix={arXiv},
|
||
primaryClass={cs.SE},
|
||
url={https://arxiv.org/abs/2507.19942},
|
||
}
|
||
```
|
||
|
||
---
|
||
## 🤖 Why Prometheus?
|
||
|
||
| System | Core Description | Limitations | Why **Prometheus** is Superior |
|
||
|---------------------------------------------------------|----------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||
| **[SWE-Agent](https://github.com/SWE-agent/SWE-agent)** | Research baseline for automatic bug fixing using a single LLM-computer interface | – Static, single-turn reasoning<br>– No cross-file or cross-repo understanding<br>– Lacks full detect–reproduce–repair–verify (DRRV) automation | ✅ Prometheus performs **multi-agent collaborative reasoning** across files and commits, enabling full-cycle issue understanding and repair |
|
||
| **[Lingxi](https://github.com/lingxi-agent/Lingxi)** | Multi-agent system for automated bug fixing and code reasoning | – Limited context retrieval<br>– No persistent knowledge graph or long-term memory<br>– Requires human validation for many patches | ✅ Prometheus integrates a **Unified Codebase Knowledge Graph** and **long-term memory (Athena)** for deeper semantic reasoning and repository-wide understanding |
|
||
| **[TRAE](https://github.com/bytedance/trae-agent)** | Multi-agent reasoning and tool execution framework | – Focused on task orchestration rather than reasoning depth<br>– No unified memory or structured code representation | ✅ Prometheus emphasizes **deep reasoning and knowledge unification**, allowing consistent understanding across large and complex repositories |
|
||
| **[OpenHands](https://github.com/OpenHands/OpenHands)** | General-purpose open-source AI developer using sandbox execution | – Strong executor but weak contextual reasoning<br>– No repository-level semantic linking<br>– Task-by-task operation only | ✅ Prometheus combines **contextual understanding and code reasoning**, achieving coherent, reproducible debugging and intelligent code repair |
|
||
|
||
---
|
||
|
||
## 🏗️ Architecture
|
||
|
||
Prometheus implements a hierarchical multi-agent system:
|
||
|
||
```
|
||
User Issue
|
||
|
|
||
v
|
||
┌─────────────────────────────────┐
|
||
│ Issue Classification Agent │
|
||
│ (bug/question/feature/doc) │
|
||
└─────────────┬───────────────────┘
|
||
|
|
||
┌───────────────┼───────────────┐
|
||
| | |
|
||
v v v
|
||
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
||
│Bug Pipeline │ │Feature │ │Question │
|
||
│ │ │Pipeline │ │Pipeline │
|
||
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘
|
||
| | |
|
||
v v v
|
||
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
||
│Bug │ │Feature │ │Context │
|
||
│Reproduction │ │Analysis │ │Retrieval │
|
||
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘
|
||
| | |
|
||
v v v
|
||
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
||
│Issue │ │Patch │ │Question │
|
||
│Resolution │ │Generation │ │Analysis │
|
||
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘
|
||
| | |
|
||
└─────────────────┼─────────────────┘
|
||
v
|
||
Response Generation
|
||
```
|
||
|
||
**Core Components**:
|
||
- **Knowledge Graph**: Tree-sitter-based AST and semantic code representation in Neo4j
|
||
- **LangGraph State Machines**: Coordinated multi-agent workflows with checkpointing
|
||
- **Docker Containers**: Isolated build and test execution environments
|
||
- **LLM Integration**: Multi-tier model strategy (GPT-4, Claude, Gemini support)
|
||
|
||
See **[Architecture Documentation](docs/Multi-Agent-Architecture.md)** for details.
|
||
|
||
---
|
||
|
||
## ⚡ Quick Start
|
||
|
||
### ✅ Prerequisites
|
||
|
||
- **Docker** and **Docker Compose**
|
||
- **Python 3.11+** (for local development)
|
||
- **API Keys**: OpenAI, Anthropic, or Google Gemini
|
||
|
||
### 📦 Installation
|
||
|
||
1. **Clone the repository**
|
||
```bash
|
||
git clone https://github.com/EuniAI/Prometheus.git
|
||
cd Prometheus
|
||
```
|
||
|
||
2. **Configure environment**
|
||
```bash
|
||
cp example.env .env
|
||
# Edit .env with your API keys
|
||
```
|
||
|
||
3. **Generate JWT secret** (required for authentication)
|
||
```bash
|
||
python -m prometheus.script.generate_jwt_token
|
||
# Copy output to .env as PROMETHEUS_JWT_SECRET_KEY
|
||
```
|
||
|
||
4. **Create working directory**
|
||
```bash
|
||
mkdir -p working_dir
|
||
```
|
||
|
||
5. **Start services**
|
||
```bash
|
||
docker-compose up --build
|
||
```
|
||
|
||
6. **Access the platform**
|
||
- API: [http://localhost:9002/v1.2](http://localhost:9002/v1.2)
|
||
- Interactive Docs: [http://localhost:9002/docs](http://localhost:9002/docs)
|
||
|
||
---
|
||
|
||
## 💻 Development
|
||
|
||
### 🛠️ Local Setup
|
||
|
||
```bash
|
||
# Install dependencies
|
||
pip install hatchling
|
||
pip install .
|
||
pip install .[test]
|
||
|
||
# Run development server
|
||
uvicorn prometheus.app.main:app --host 0.0.0.0 --port 9002 --reload
|
||
```
|
||
|
||
### 🧪 Testing
|
||
|
||
```bash
|
||
# Run tests (excluding git-dependent tests)
|
||
coverage run --source=prometheus -m pytest -v -s -m "not git"
|
||
|
||
# Generate coverage report
|
||
coverage report -m
|
||
coverage html
|
||
open htmlcov/index.html
|
||
```
|
||
|
||
### 🗄️ Database Setup
|
||
|
||
**PostgreSQL** (required for state checkpointing):
|
||
```bash
|
||
docker run -d \
|
||
-p 5432:5432 \
|
||
-e POSTGRES_USER=postgres \
|
||
-e POSTGRES_PASSWORD=password \
|
||
-e POSTGRES_DB=postgres \
|
||
postgres
|
||
```
|
||
|
||
**Neo4j** (required for knowledge graph):
|
||
```bash
|
||
docker run -d \
|
||
-p 7474:7474 -p 7687:7687 \
|
||
-e NEO4J_AUTH=neo4j/password \
|
||
-e NEO4J_PLUGINS='["apoc"]' \
|
||
-e NEO4J_dbms_memory_heap_initial__size=4G \
|
||
-e NEO4J_dbms_memory_heap_max__size=8G \
|
||
neo4j
|
||
```
|
||
|
||
Verify at [http://localhost:7474](http://localhost:7474)
|
||
|
||
---
|
||
|
||
## 📚 Research & Citation
|
||
|
||
Prometheus is based on peer-reviewed research on unified knowledge graphs for multilingual code analysis.
|
||
|
||
```bibtex
|
||
@misc{prometheus2025,
|
||
title={Prometheus: Unified Knowledge Graphs for Issue Resolution in Multilingual Codebases},
|
||
author={Zimin Chen and Yue Pan and Siyu Lu and Jiayi Xu and Claire Le Goues and Martin Monperrus and He Ye},
|
||
year={2025},
|
||
eprint={2507.19942},
|
||
archivePrefix={arXiv},
|
||
primaryClass={cs.SE},
|
||
url={https://arxiv.org/abs/2507.19942}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 🤝 Contributing
|
||
|
||
We welcome contributions! Please see our **[Contributing Guidelines](CONTRIBUTING.md)** for details on how to get started.
|
||
|
||
**Quick Links**:
|
||
- 📖 Read the full [Contributing Guide](CONTRIBUTING.md)
|
||
- 🐞 Report bugs via [GitHub Issues](https://github.com/EuniAI/Prometheus/issues)
|
||
- ✨ Submit feature requests and improvements via Pull Requests
|
||
- 💬 Join discussions on [Discord](https://discord.gg/jDG4wqkKZj)
|
||
|
||
We're grateful to all our amazing contributors who have made this project what it is today!
|
||
|
||
<a href="https://github.com/EuniAI/Prometheus/graphs/contributors">
|
||
<img src="https://contrib.rocks/image?repo=EuniAI/Prometheus&r=" width="400px"/>
|
||
</a>
|
||
|
||
If you have any questions or encounter issues, please feel free to reach out. For quick queries, you can also check our `Issues` page for common questions and solutions.
|
||
|
||
---
|
||
|
||
## 📜 License
|
||
|
||
This project is dual-licensed:
|
||
- **Community Edition**: Licensed under the [GNU General Public License v3.0 (GPLv3)](https://www.gnu.org/licenses/gpl-3.0.html).
|
||
You are free to use, modify, and redistribute this code, provided that any derivative works are also released under the GPLv3.
|
||
This ensures the project remains open and contributions benefit the community.
|
||
|
||
- **Commercial Edition**: For organizations that wish to use this software in **proprietary, closed-source, or commercial settings**,
|
||
a separate commercial license is available. Please contact **EUNI.AI Team** to discuss licensing terms.
|
||
|
||
---
|
||
|
||
## 💬 Support
|
||
|
||
- **Documentation**: [Multi-Agent Architecture](docs/Multi-Agent-Architecture.md) | [GitHub Issue Debug Guide](docs/GitHub-Issue-Debug-Guide.md)
|
||
- **Community**: [Discord Server](https://discord.gg/jDG4wqkKZj)
|
||
- **Email**: business@euni.ai
|
||
- **Issues**: [GitHub Issues](https://github.com/EuniAI/Prometheus/issues)
|
||
|
||
---
|
||
|
||
## 🌟 Star History
|
||
[](https://www.star-history.com/#EuniAI/Prometheus&Date)
|
||
|
||
---
|
||
|
||
## 🙏 Acknowledgments
|
||
|
||
<div align="center">
|
||
<img src="./docs/static/images/delysium_logo.svg" alt="Delysium Logo" width="150">
|
||
</div>
|
||
|
||
We thank [Delysium](https://delysium.com) for their support in organizing LLM-related resources, architecture design, and optimization, which greatly strengthened our research infrastructure and capabilities.
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
<p>Made with ❤️ by the <a href="https://euni.ai/">EuniAI</a> Team</p>
|
||
<p>
|
||
<a href="#readme-top">Back to top ↑</a>
|
||
</p>
|
||
</div>
|