Skip to content

rajveer100704/AgentForge-AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ€– AgentForge-AI

A Production-Ready Multi-Agent AI System powered by Gemini


πŸ”΄ Live Demo

πŸ‘‰ Live App: https://agentforge-ai-100704.streamlit.app


πŸ–₯️ Application Preview

[AgentForge-AI UI]Screenshot 2026-01-25 143609


πŸ“Œ Overview

AgentForge-AI is a modular, production-oriented multi-agent AI system designed to solve complex tasks through structured collaboration between specialized AI agents.

Instead of a single monolithic LLM call, the system decomposes a task into planning, research, implementation, and review, closely mirroring how real-world engineering teams operate.

This project demonstrates:

  • Multi-agent orchestration
  • Clean system design
  • LLM integration (Google Gemini)
  • Streamlit-based UI
  • Testability and extensibility
  • Deployment readiness

πŸš€ Why AgentForge-AI?

Modern AI applications often fail due to:

  • Unstructured prompts
  • Lack of reasoning separation
  • No quality verification
  • Poor scalability

AgentForge-AI solves these problems by design.


🧠 Core Ideas

  • 🧠 Planner Agent β€” breaks down tasks logically
  • πŸ” Researcher Agent β€” gathers best practices and tools
  • πŸ’» Coder Agent β€” produces implementation-level output
  • πŸ§ͺ Reviewer Agent β€” evaluates quality and readiness
  • 🧩 Orchestrator β€” manages agent execution flow
  • 🧠 Memory Layer β€” enables extensibility for future context handling

This architecture enables transparent reasoning, higher-quality outputs, and enterprise-ready extensibility.


🧠 System Architecture

User Task
    ↓
Planner Agent
    β†’ Task Decomposition
    ↓
Researcher Agent
    β†’ Concepts & Tools
    ↓
Coder Agent
    β†’ Implementation / Code
    ↓
Reviewer Agent
    β†’ Quality & Readiness Evaluation

Each agent is:

  • Independent
  • Prompt-specialized
  • Replaceable
  • Testable

πŸ“‚ Project Structure

AgentForge-AI/
β”‚
β”œβ”€β”€ app.py                 # Streamlit UI entry point
β”œβ”€β”€ main.py                # CLI / backend execution
β”œβ”€β”€ requirements.txt       # Project dependencies
β”œβ”€β”€ Dockerfile             # Containerized deployment
β”œβ”€β”€ .env                   # Environment variables (API keys)
β”œβ”€β”€ .gitignore
β”‚
β”œβ”€β”€ agents/
β”‚   β”œβ”€β”€ __init__.py
β”‚   β”œβ”€β”€ base.py             # Abstract base agent
β”‚   β”œβ”€β”€ planner.py          # Task planning agent
β”‚   β”œβ”€β”€ researcher.py       # Research & analysis agent
β”‚   β”œβ”€β”€ coder.py            # Code generation agent
β”‚   └── reviewer.py         # Evaluation & scoring agent
β”‚
β”œβ”€β”€ core/
β”‚   β”œβ”€β”€ __init__.py
β”‚   β”œβ”€β”€ gemini_client.py    # Gemini API wrapper
β”‚   β”œβ”€β”€ orchestrator.py     # Agent execution pipeline
β”‚   └── memory.py           # Memory abstraction (extensible)
β”‚
β”œβ”€β”€ tests/
β”‚   β”œβ”€β”€ test_planner.py
β”‚   β”œβ”€β”€ test_researcher.py
β”‚   β”œβ”€β”€ test_coder.py
β”‚   β”œβ”€β”€ test_reviewer.py
β”‚   └── test_orchestrator.py
β”‚
└── README.md

πŸ§ͺ Example Use Case

Input Task

Design a REST API for student course enrollment

System Output

  • Structured API design
  • Resource modeling
  • Endpoints and HTTP methods
  • Error handling strategy
  • Production-grade FastAPI implementation
  • Quality and readiness scoring

This mirrors how real backend systems are architected in industry.


πŸ› οΈ Tech Stack

  • Python 3.10+
  • Google Gemini 2.5 Flash
  • Streamlit
  • Pydantic
  • FastAPI (generated output)
  • python-dotenv
  • pytest
  • Docker

βš™οΈ Installation & Setup (Local)

1️⃣ Clone Repository

git clone https://github.com/rajveer100704/AgentForge-AI.git
cd AgentForge-AI

2️⃣ Create Virtual Environment

python -m venv venv

Activate:

Windows

venv\Scripts\activate

Linux / macOS

source venv/bin/activate

3️⃣ Install Dependencies

pip install -r requirements.txt

πŸ” Environment Variables

Create a .env file in the project root:

GEMINI_API_KEY=your_gemini_api_key_here

⚠️ Never commit .env to GitHub.


▢️ Run the Application

Streamlit UI

streamlit run app.py

Then open:

http://localhost:8501

πŸ§ͺ Running Tests

pytest

All agents and orchestration logic are independently testable.


🐳 Run with Docker (Optional)

You can run AgentForge-AI using Docker without installing Python locally.

Build the image

docker build -t agentforge-ai .

Run the container

docker run -p 8501:8501 \
  -e GEMINI_API_KEY=your_api_key_here \
  agentforge-ai

Then open:

http://localhost:8501


πŸ“ˆ Future Improvements

  • Persistent long-term memory (Vector DB)
  • Agent self-reflection loops
  • Role-based access control
  • Plug-and-play agent registry
  • Async / parallel agent execution
  • Execution analytics dashboard
  • CI/CD pipeline with GitHub Actions

πŸ‘¨β€πŸ’» Author

Rajveer Saggu
πŸ“§ Email: rajveer19255@gmail.com
🌐 GitHub: https://github.com/rajveer100704


⭐ Support the Project

If you like this project, give it a ⭐ β€”
it boosts visibility and motivates future development.

About

A multi-agent AI system that autonomously plans tasks, generates code, and reviews outputs. Specialized agents collaborate through feedback loops to transform high-level goals into reliable, production-ready solutions with minimal human intervention.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages