Prometheus
⚡ AI-Powered Software 3.0 Platform ⚡

Redefining Software Productivity Beyond Vibe Coding — There’s More Beyond Lovable and Replit.
Moving beyond unreliable prototype generation, Prometheus turns your ideas into verifiable, affordable software through autonomous code agents.

Website • X/Twitter • LinkedIn • Discord • Reddit • GitHub

## 📣 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
– No cross-file or cross-repo understanding
– 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
– No persistent knowledge graph or long-term memory
– 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
– 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
– No repository-level semantic linking
– 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!

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 [![Star History Chart](https://api.star-history.com/svg?repos=EuniAI/Prometheus&type=Date)](https://www.star-history.com/#EuniAI/Prometheus&Date) --- ## 🙏 Acknowledgments

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. ---

Made with ❤️ by the EuniAI Team

Prometheus ⚡ AI-Powered Software 3.0 Platform ⚡

Prometheus
⚡ AI-Powered Software 3.0 Platform ⚡