Prometheus

[Prometheus](https://euni.ai/)  

⚡ 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](https://euni.ai/) •
[X/Twitter](https://x.com/Euni_AI) •
[LinkedIn](https://www.linkedin.com/company/euni-ai/) •
[Discord](https://discord.gg/jDG4wqkKZj) •
[Reddit](https://www.reddit.com/r/EuniAI) •
[GitHub](https://github.com/EuniAI/Prometheus)






[![Stars](https://img.shields.io/github/stars/EuniAI/Prometheus?style=for-the-badge&color=yellow)](https://github.com/EuniAI/Prometheus/stargazers)
[![Forks](https://img.shields.io/github/forks/EuniAI/Prometheus?style=for-the-badge&color=blue)](https://github.com/EuniAI/Prometheus/forks)
[![License: Apache 2.0](https://img.shields.io/badge/license-Apache--2.0-green?style=for-the-badge)](https://opensource.org/licenses/Apache-2.0)
[![arXiv Paper](https://img.shields.io/badge/Paper-arXiv-red?style=for-the-badge&logo=arxiv&logoColor=white)](https://www.arxiv.org/abs/2507.19942)
[![Contributors](https://img.shields.io/github/contributors/EuniAI/Prometheus?style=for-the-badge&color=orange)](https://github.com/EuniAI/Prometheus/graphs/contributors)





[![Commit Activity](https://img.shields.io/github/commit-activity/m/EuniAI/Prometheus?label=Commits&color=brightgreen&style=flat)](https://github.com/EuniAI/Prometheus)
[![Forks](https://img.shields.io/github/forks/EuniAI/Prometheus.svg?style=flat&color=blue&label=Forks)](https://github.com/EuniAI/Prometheus/forks)
[![Issues Closed](https://img.shields.io/github/issues-search?query=repo%3AEuniAI%2FPrometheus%20is%3Aclosed&label=Issues%20Closed&labelColor=%237d89b0&color=%235d6b98&style=flat)](https://github.com/EuniAI/Prometheus/issues)
[![Discussion Posts](https://img.shields.io/github/discussions/EuniAI/Prometheus?label=Discussions&labelColor=%239b8afb&color=%237a5af8&style=flat)](https://github.com/EuniAI/Prometheus/discussions)



![Prometheus Architecture](./docs/static/images/Prometheus.png) 

📣 News

• [2025-11] Prometheus achieved TOP 5 and TOP 1 🏆 in the agents using gpt-5 in the swebench leaderboard for automated software engineering using LLMs 🎉!
• [2025-10] We maintain a curated list of code agent projects and research: 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 | 📄 Research Paper

@misc{pan2025prometheus,
      title={Prometheus: Towards Long-Horizon Codebase Navigation for Repository-Level Problem Solving}, 
      author={Yue Pan and Zimin Chen and Siyu Lu and Zhaoyang Chu and Xiang Li and Han Li and Yang Feng and Claire Le Goues and Federica Sarro 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?

🏗️ 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 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

   git clone https://github.com/EuniAI/Prometheus.git
   cd Prometheus
   

2. Configure environment

   cp example.env .env
   # Edit .env with your API keys
   

3. Generate JWT secret (required for authentication)

   python -m prometheus.script.generate_jwt_token
   # Copy output to .env as PROMETHEUS_JWT_SECRET_KEY
   

4. Create working directory

   mkdir -p working_dir
   

5. Start services

   docker-compose up --build
   

6. Access the platform

   • API: http://localhost:9002/v1.2
   • Interactive Docs: http://localhost:9002/docs

💻 Development

🛠️ Local Setup

# 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

# 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):

docker run -d \
  -p 5432:5432 \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=password \
  -e POSTGRES_DB=postgres \
  postgres

Neo4j (required for knowledge graph):

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

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details on how to get started.

Quick Links:

• 📖 Read the full Contributing Guide
• 🐞 Report bugs via GitHub Issues
• ✨ Submit feature requests and improvements via Pull Requests
• 💬 Join discussions on Discord

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).
  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 | GitHub Issue Debug Guide
• Community: Discord Server
• Email: business@euni.ai
• Issues: GitHub Issues

🌟 Star History

🙏 Acknowledgments

We thank Delysium 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

[Back to top ↑](#readme-top)