<div align="center">

![Agent Forge](https://img.shields.io/badge/🔨_Agent-Forge-blueviolet?style=for-the-badge&labelColor=1a1a2e)

# 🔨 Agent Forge

### _Forging Production-Ready AI Agents, One Build at a Time — No Finish Line_

<p align="center">
  <strong>🎯 The Ultimate Open-Source AI Agent Collection</strong><br/>
  <em>From Customer Support to Legal Analysis — Master AI Agent Development</em>
</p>

---

[![GitHub Stars](https://img.shields.io/github/stars/ayusingh-54/agent-forge?style=for-the-badge&logo=github&logoColor=white&color=gold)](https://github.com/ayusingh-54/agent-forge/stargazers)
[![GitHub Forks](https://img.shields.io/github/forks/ayusingh-54/agent-forge?style=for-the-badge&logo=github&logoColor=white&color=blue)](https://github.com/ayusingh-54/agent-forge/network/members)
[![GitHub Issues](https://img.shields.io/github/issues/ayusingh-54/agent-forge?style=for-the-badge&logo=github&logoColor=white&color=orange)](https://github.com/ayusingh-54/agent-forge/issues)
[![License](https://img.shields.io/badge/License-Apache%202.0-green.svg?style=for-the-badge&logo=apache&logoColor=white)](LICENSE)
[![Contributors](https://img.shields.io/github/contributors/ayusingh-54/agent-forge?style=for-the-badge&logo=github&color=purple)](https://github.com/ayusingh-54/agent-forge/graphs/contributors)
[![Last Commit](https://img.shields.io/github/last-commit/ayusingh-54/agent-forge?style=for-the-badge&logo=git&color=red)](https://github.com/ayusingh-54/agent-forge/commits/main)

---

<p align="center">
  <img src="https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python"/>
  <img src="https://img.shields.io/badge/TypeScript-5.x-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript"/>
  <img src="https://img.shields.io/badge/Node.js-18+-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node.js"/>
  <img src="https://img.shields.io/badge/OpenAI-GPT--4-412991?style=flat-square&logo=openai&logoColor=white" alt="OpenAI"/>
  <img src="https://img.shields.io/badge/Claude-Anthropic-FF6B35?style=flat-square&logo=anthropic&logoColor=white" alt="Claude"/>
  <img src="https://img.shields.io/badge/LangChain-🦜-green?style=flat-square" alt="LangChain"/>
  <img src="https://img.shields.io/badge/LangGraph-⚡-orange?style=flat-square" alt="LangGraph"/>
  <img src="https://img.shields.io/badge/AutoGen-🤖-blue?style=flat-square" alt="AutoGen"/>
  <img src="https://img.shields.io/badge/Streamlit-FF4B4B?style=flat-square&logo=streamlit&logoColor=white" alt="Streamlit"/>
  <img src="https://img.shields.io/badge/React-18-61DAFB?style=flat-square&logo=react&logoColor=black" alt="React"/>
  <img src="https://img.shields.io/badge/Docker-Ready-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Docker"/>
</p>

---

[**🚀 Quick Start**](#-quick-start) · [**📖 Documentation**](#-documentation) · [**🤝 Contributing**](#-contributing) · [**💬 Community**](#-community) · [**📺 Demo**](#-demos)

</div>

---

## 📋 Table of Contents

<details open>
<summary><strong>Click to expand / collapse</strong></summary>

- [🎯 About This Project](#-about-this-project)
- [✨ Features](#-features)
- [📊 Challenge Progress](#-challenge-progress)
- [🤖 Agent Directory](#-agent-directory)
- [🏗️ Architecture](#️-architecture)
- [🚀 Quick Start](#-quick-start)
- [📖 Documentation](#-documentation)
- [🛠️ Tech Stack](#️-tech-stack)
- [📂 Project Structure](#-project-structure)
- [🗺️ Roadmap](#️-roadmap)
- [🤝 Contributing](#-contributing)
- [💬 Community](#-community)
- [❓ FAQ](#-faq)
- [📄 License](#-license)
- [👨‍💻 Author](#-author)
- [🙏 Acknowledgments](#-acknowledgments)

</details>

---

## 🎯 About This Project

> **"The journey of mastering AI agents begins with a single commit."**

**Agent Forge** is a comprehensive open-source collection of **production-ready AI agents** covering diverse use cases. This isn't just a tutorial collection—it's a hands-on journey through the cutting edge of AI agent development.

### 🌟 What Makes This Different?

| Feature              | This Project               | Typical Tutorials   |
| -------------------- | -------------------------- | ------------------- |
| **Production Ready** | ✅ Deployable code         | ❌ Demo snippets    |
| **Full Stack**       | ✅ Frontend + Backend      | ❌ Backend only     |
| **Multi-Framework**  | ✅ LangChain, AutoGen, MCP | ❌ Single framework |
| **Real APIs**        | ✅ Live integrations       | ❌ Mock data        |
| **Documentation**    | ✅ Comprehensive guides    | ❌ Basic README     |
| **Community**        | ✅ Active contributors     | ❌ Solo project     |

### 🎯 Who Is This For?

- **🔰 Beginners**: Start with Day 1 agents and build up
- **🚀 Intermediate Devs**: Jump to advanced agents (RAG, Memory, MCP)
- **🏢 Enterprise Teams**: Production patterns and architectures
- **📚 Researchers**: Explore latest AI agent paradigms

---

## ✨ Features

<table>
<tr>
<td width="50%">

### 🧠 **Intelligence**

- OpenAI GPT-4, GPT-4o-mini integration
- Claude Anthropic support
- Local LLM compatibility (Ollama)
- Multi-model orchestration

</td>
<td width="50%">

### 🔗 **Integrations**

- Slack, Instagram, WhatsApp bots
- GitHub, Notion, Google APIs
- Web scraping & research
- Database connectors

</td>
</tr>
<tr>
<td>

### 🏗️ **Architecture Patterns**

- LangGraph state machines
- AutoGen multi-agent systems
- RAG (Retrieval Augmented Generation)
- Long-term memory systems
- MCP (Model Context Protocol)

</td>
<td>

### 🎨 **User Interfaces**

- Streamlit dashboards
- React + TypeScript frontends
- CLI tools
- REST/WebSocket APIs

</td>
</tr>
<tr>
<td>

### 📊 **Advanced Features**

- Vector databases (ChromaDB, FAISS, Pinecone)
- Semantic search & embeddings
- Agent evaluation frameworks
- Conversation simulation

</td>
<td>

### ☁️ **Deployment**

- Docker containerization
- Vercel/Railway ready
- PostgreSQL/SQLite support
- Environment management

</td>
</tr>
</table>

---

## 📊 Challenge Progress

<div align="center">

### 🏆 Current Status: **20 Agents Forged — And Counting!**

```
Progress: ████████████████████████████████░░░░░░░░░░░░░░░░░░░░░ 20+ (No finish line)
```

| Metric                     | Value   |
| -------------------------- | ------- |
| 🤖 **Agents Built**        | 20      |
| 📝 **Lines of Code**       | 35,000+ |
| 🌟 **Tech Stacks**         | 18      |
| 📚 **Frameworks**          | 14      |
| 🔗 **Integrations**        | 22      |
| 📖 **Documentation Pages** | 46+     |

</div>

---

## 🤖 Agent Directory

### ✅ Completed Agents

|  #  | Agent                                                                    | Description                                                                                                   | Tech Stack                                 | Difficulty |                     Demo                     |
| :-: | :----------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------ | :----------------------------------------- | :--------: | :------------------------------------------: |
| 01  | [🛎️ **Customer Support Agent**](./01_customer_support_agent_langgraph)   | Multi-agent system with intelligent query routing, sentiment analysis, and escalation workflows               | LangGraph, OpenAI, Streamlit               |    ⭐⭐    | [▶️](./01_customer_support_agent_langgraph)  |
| 02  | [🔍 **Web Search & Summarizer**](./02_search_the_internet_and_summarize) | Internet research agent with intelligent summarization and source citation                                    | LangChain, DuckDuckGo, OpenAI              |     ⭐     | [▶️](./02_search_the_internet_and_summarize) |
| 03  | [🤖 **Chatbot Simulation**](./03_chatbot-simulation-evaluation)          | Multi-bot conversation simulator with evaluation metrics and Plotly visualizations                            | LangChain, LangGraph, Plotly               |    ⭐⭐    |   [▶️](./03_chatbot-simulation-evaluation)   |
| 04  | [📝 **AI Prompt Generator**](./04%20information-gather-prompting)        | Structured data extraction using advanced prompt engineering techniques                                       | LangChain, LangGraph, Streamlit            |    ⭐⭐    |  [▶️](./04%20information-gather-prompting)   |
| 05  | [👗 **Vibe Matcher**](./05%20Vibe%20Matcher)                             | AI fashion recommender using embeddings & semantic similarity search                                          | OpenAI Embeddings, Scikit-learn            |    ⭐⭐    |         [▶️](./05%20Vibe%20Matcher)          |
| 06  | [🎯 **Lead Generation Agent**](./06%20lead_gen_agent)                    | B2B lead finder with scoring, enrichment & Google Maps integration                                            | LangChain, LangGraph, Apify                |   ⭐⭐⭐   |         [▶️](./06%20lead_gen_agent)          |
| 07  | [📱 **Instagram DM Bot**](./07%20AI-Powered-Instagram-DM-Bot)            | AI-powered auto-reply bot for Instagram DMs with human-like responses                                         | OpenAI GPT-4o-mini, Instagram API          |    ⭐⭐    |   [▶️](./07%20AI-Powered-Instagram-DM-Bot)   |
| 08  | [🌐 **AutoGen Web Info Agent**](./08_AutoGen_Web_Info_Agent)             | Multi-agent system for web research, stocks & academic paper analysis                                         | AutoGen, OpenAI, Streamlit                 |   ⭐⭐⭐   |      [▶️](./08_AutoGen_Web_Info_Agent)       |
| 09  | [🖥️ **AI Co-Browser**](./12%20AI-Co-Browser-main)                        | Full-stack AI portfolio assistant with co-browsing, page navigation & element highlighting                    | React, Express, OpenAI, PostgreSQL         |  ⭐⭐⭐⭐  |       [▶️](./12%20AI-Co-Browser-main)        |
| 10  | [🦾 **OpenClaw**](./14%20OpenClaw-From-Scratch-main)                     | Production-grade Slack AI bot with RAG, Long-Term Memory & 59 MCP tools                                       | Claude, Slack Bolt.js, ChromaDB, mem0      | ⭐⭐⭐⭐⭐ |   [▶️](./14%20OpenClaw-From-Scratch-main)    |
| 11  | [🎮 **AI Tic Tac Toe**](./11%20AI_tic_tac_toe_agent)                     | AI vs AI game with GPT-4o & Claude battling with strategic personalities & real-time gameplay                 | Agno, OpenAI, Anthropic, Streamlit         |    ⭐⭐    |      [▶️](./11%20AI_tic_tac_toe_agent)       |
| 12  | [👨‍⚖️ **AI Legal Agent Team**](./13%20Legal%20Agent)                       | Multi-agent legal team — contract review, risk assessment, compliance check & due diligence powered by GPT-4o | Agno, OpenAI GPT-4o, DuckDuckGo, Streamlit |   ⭐⭐⭐   |          [▶️](./13%20Legal%20Agent)          |
| 13  | [📚 **AI Tutor — Smart Quiz Generator**](./15%20ai-tutor)                | Converts PDF/Word study materials into chapter-wise AI quizzes with auto-grading and feedback                 | Python, NLP, Vector Embeddings, Node.js    |   ⭐⭐⭐   |             [▶️](./15%20ai-tutor)            |
| 14  | [🎨 **UI/UX Feedback Agent Team**](./16_UI_UX%20Feedback%20Agent_Nano_banana) | 5-specialist multi-agent design crew — critic, strategist, implementer, A11y auditor, CRO optimizer + Streamlit UI | Google ADK, Gemini 2.5 Flash, Nano Banana, Streamlit | ⭐⭐⭐⭐ | [▶️](./16_UI_UX%20Feedback%20Agent_Nano_banana) |
| 15  | [📜 **ClauseAI — Contract Analysis**](./Contract%20Analysis) | Industry-grade multi-agent contract review — 7 parallel specialists for risk scoring, missing-clause detection, conflict detection, GDPR/CCPA/HIPAA/SOX compliance, PII flagging, redlined DOCX export & grounded Q&A chat | LangGraph, OpenAI (4o + 4o-mini), FAISS, Pydantic, Streamlit | ⭐⭐⭐⭐ | [▶️](./Contract%20Analysis/streamlit_app) |
| 16  | [🏠 **AI Real Estate Agent Team**](./AI%20Real%20Estate%20Agent%20Team) | Multi-agent property search across Zillow/Realtor/Trulia/Homes — deterministic 0–100 investment scoring, 6-chart Plotly analytics dashboard, Firecrawl cache, SQLite search history, Markdown/JSON/CSV exports, pluggable LLM (Gemini · OpenAI · Anthropic · Ollama) | Agno, Firecrawl, Pydantic, Plotly, SQLite, Streamlit | ⭐⭐⭐⭐ | [▶️](./AI%20Real%20Estate%20Agent%20Team) |
| 17  | [🛍️ **ShoppingGPT**](./ShoppingGPT-main) | AI personal-shopper for an online fashion store — multi-intent semantic router (products · policy · recommend · chitchat), guarded SELECT-only SQL tool, FAISS policy retrieval, grounded outfit recommender, per-session memory, custom dark/light chat UI with product cards | OpenAI, LangChain, Flask, FAISS, SQLite | ⭐⭐⭐ | [▶️](./ShoppingGPT-main) |
| 18  | [🎧 **Audio-In-Chat**](./Audio-In-Chat) | Industry-grade audio transcription + RAG library — Whisper / AssemblyAI transcription, OpenAI / HuggingFace embeddings, Qdrant (memory · self-hosted · cloud), streaming GPT-4o chat with citations, typed exception hierarchy, Dockerfile + compose, FastAPI server example, importable `AudioChatPipeline` for any Python app | OpenAI Whisper, GPT-4o, Qdrant, Streamlit, FastAPI, Docker | ⭐⭐⭐⭐ | [▶️](./Audio-In-Chat) |
| 19  | [🧪 **E2E Testing Agent**](./E2E%20testing%20Agent) | AI agent that converts natural language test descriptions into executable Playwright E2E test scripts — multi-step LangGraph pipeline with DOM analysis, iterative code generation, retry logic, subprocess pytest execution & structured markdown reports | LangGraph, Playwright, Pydantic, Streamlit | ⭐⭐⭐⭐ | [▶️](./E2E%20testing%20Agent) |
| 20  | [🔀 **RAG + SQL Router**](./Rag-sql-router) | Intelligent hybrid query engine that auto-routes natural language between SQL (city stats DB) and RAG (uploaded PDFs/DOCX) via LangGraph StateGraph — Text-to-SQL with safety guards, ChromaDB retrieval, Cleanlab Codex trust scoring, FastAPI + React/Tailwind industry-grade UI with chat, database explorer & charts | LangGraph, LangChain, OpenAI GPT-4o-mini, ChromaDB, Cleanlab Codex, FastAPI, React, Tailwind | ⭐⭐⭐⭐ | [▶️](./Rag-sql-router) |

### 📈 Difficulty Legend

- ⭐ **Beginner**: Basic concepts, good for learning
- ⭐⭐ **Intermediate**: Multi-component, real APIs
- ⭐⭐⭐ **Advanced**: Complex workflows, production patterns
- ⭐⭐⭐⭐ **Expert**: Full-stack, enterprise-grade
- ⭐⭐⭐⭐⭐ **Master**: State-of-the-art, cutting-edge

---

<details>
<summary><strong>📂 View Future Agents Roadmap (Click to Expand)</strong></summary>

### 🚧 Coming Soon (Agents 15+)

|  #  | Agent                     | Description                                       | Tech Stack                        | Status |
| :-: | :------------------------ | :------------------------------------------------ | :-------------------------------- | :----: |
| 15  | 📧 **Email Assistant**    | Smart email drafting, categorization & auto-reply | LangChain, Gmail API              |   ⏳   |
| 16  | 📅 **Calendar Manager**   | AI scheduling assistant with conflict resolution  | Google Calendar, Natural Language |   ⏳   |
| 17  | 📊 **Data Analyst Agent** | Automated data analysis with visualization        | Pandas, Plotly, OpenAI            |   ⏳   |
| 19  | 🔐 **Security Scanner**   | Code vulnerability detection agent                | CodeQL, OpenAI                    |   ⏳   |
| 20  | 🎨 **Content Creator**    | Blog posts, social media content generation       | OpenAI, Stability AI              |   ⏳   |
| 21  | 💰 **Finance Tracker**    | Expense categorization & budget planning          | Plaid API, OpenAI                 |   ⏳   |
| 22  | 🏥 **Health Assistant**   | Symptom checker & wellness recommendations        | Medical APIs, Safety filters      |   ⏳   |
| 24+ | 🔜 **More Agents...**     | The forge never stops — new agents whenever ready | Multiple                          |   ⏳   |

### 🗓️ Future Planned Categories

| Category                 | Agents Planned | Examples                                        |
| :----------------------- | :------------: | :---------------------------------------------- |
| 🛎️ Customer Service      |       10       | Support, Ticketing, Feedback                    |
| 🔍 Research & Analysis   |       15       | Web Research, Data Mining, Competitive Analysis |
| 💬 Communication         |       12       | Email, Chat, Social Media, Scheduling           |
| 💼 Business & Sales      |       10       | Lead Gen, CRM, Proposals, Invoicing             |
| 📝 Content Creation      |       8        | Writing, Design, Video Scripts                  |
| 💰 Finance               |       8        | Trading, Budgeting, Analysis                    |
| 🏥 Health & Wellness     |       5        | Fitness, Nutrition, Mental Health               |
| 📚 Education             |       8        | Tutoring, Quiz, Language Learning               |
| 🔧 DevOps & Engineering  |       12       | CI/CD, Monitoring, Code Review                  |
| 🎮 Entertainment         |       5        | Gaming, Music, Recommendations                  |
| 🏠 Personal Productivity |       7        | Task Management, Notes, Reminders               |

</details>

---

## 🏗️ Architecture

### High-Level System Design

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                              AGENT FORGE                                    │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐             │
│  │  FRONTEND APPS  │  │   AI BACKENDS   │  │  INTEGRATIONS   │             │
│  │                 │  │                 │  │                 │             │
│  │  • Streamlit    │  │  • LangChain    │  │  • OpenAI API   │             │
│  │  • React/Vite   │  │  • LangGraph    │  │  • Claude API   │             │
│  │  • Gradio       │  │  • AutoGen      │  │  • Slack API    │             │
│  │  • CLI Tools    │  │  • Custom       │  │  • GitHub API   │             │
│  └────────┬────────┘  └────────┬────────┘  └────────┬────────┘             │
│           │                    │                    │                       │
│           └────────────────────┼────────────────────┘                       │
│                                │                                            │
│                                ▼                                            │
│           ┌────────────────────────────────────────────┐                    │
│           │             AGENT FRAMEWORK                │                    │
│           │                                            │                    │
│           │   ┌──────────┐ ┌──────────┐ ┌──────────┐   │                    │
│           │   │  TOOLS   │ │  MEMORY  │ │   RAG    │   │                    │
│           │   ├──────────┤ ├──────────┤ ├──────────┤   │                    │
│           │   │ Function │ │ Short    │ │ Vectors  │   │                    │
│           │   │ Calling  │ │ Long     │ │ Embedder │   │                    │
│           │   │ MCP      │ │ Session  │ │ Retriever│   │                    │
│           │   └──────────┘ └──────────┘ └──────────┘   │                    │
│           └────────────────────────────────────────────┘                    │
│                                │                                            │
│                                ▼                                            │
│           ┌────────────────────────────────────────────┐                    │
│           │           DATA & STORAGE LAYER             │                    │
│           │                                            │                    │
│           │  PostgreSQL │ ChromaDB │ FAISS │ Redis    │                    │
│           └────────────────────────────────────────────┘                    │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
```

### Agent Communication Patterns

```
┌──────────────────────────────────────────────────────────────────┐
│                    AGENT PATTERNS IMPLEMENTED                     │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│  1. SINGLE AGENT (ReAct)              2. MULTI-AGENT (Supervisor)│
│  ┌─────────┐                          ┌─────────┐                │
│  │  Agent  │──Think──Act──Observe     │Supervisor│               │
│  └─────────┘                          └────┬────┘                │
│                                       ┌────┴────┐                │
│                                    ┌──┴──┐  ┌──┴──┐              │
│                                    │Agent│  │Agent│              │
│                                    │  A  │  │  B  │              │
│                                    └─────┘  └─────┘              │
│                                                                  │
│  3. HIERARCHICAL                      4. COLLABORATIVE           │
│  ┌─────────┐                          ┌─────────────────┐        │
│  │  Lead   │                          │    Agent A      │◄──────┐│
│  └────┬────┘                          └────────┬────────┘       ││
│    ┌──┴──┐                                     │                ││
│  ┌─┴──┐┌─┴──┐                          ┌───────▼───────┐        ││
│  │Sub1││Sub2│                          │    Agent B    │────────┘│
│  └────┘└────┘                          └───────────────┘         │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘
```

---

## 🚀 Quick Start

### Prerequisites

Ensure you have the following installed:

| Requirement | Version  | Check Command      |
| ----------- | -------- | ------------------ |
| **Python**  | ≥ 3.10   | `python --version` |
| **Node.js** | ≥ 18.x   | `node --version`   |
| **npm**     | ≥ 9.x    | `npm --version`    |
| **Git**     | Any      | `git --version`    |
| **Docker**  | Optional | `docker --version` |

### Installation

```bash
# 1. Clone the repository
git clone https://github.com/ayusingh-54/agent-forge.git
cd agent-forge

# 2. Choose an agent (example: Customer Support Agent)
cd 01_customer_support_agent_langgraph

# 3. Create virtual environment (Python projects)
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 4. Install dependencies
pip install -r requirements.txt

# 5. Set up environment variables
cp .env.example .env
# Edit .env with your API keys

# 6. Run the application
streamlit run app.py
```

### Quick Start for Different Agent Types

<details>
<summary><strong>🐍 Python Agents (LangChain/LangGraph)</strong></summary>

```bash
cd <agent-folder>
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
# Add your OPENAI_API_KEY to .env
streamlit run app.py
```

</details>

<details>
<summary><strong>⚛️ React/TypeScript Agents (AI-Co-Browser)</strong></summary>

```bash
cd "12 AI-Co-Browser-main"
npm install
cp .env.example .env
# Add your OPENAI_API_KEY and DATABASE_URL to .env
npm run db:push
npm run dev
# Open http://localhost:5000
```

</details>

<details>
<summary><strong>🦾 Slack Bots (OpenClaw)</strong></summary>

```bash
cd "14 OpenClaw-From-Scratch-main/OpenClaw-From-Scratch-main"
npm install
cp .env.example .env
# Configure Slack tokens, API keys in .env
npm run setup-db
npm run dev
```

</details>

<details>
<summary><strong>🐳 Docker Deployment</strong></summary>

```bash
# Build and run with Docker Compose
docker-compose up --build

# Or build individual agents
cd <agent-folder>
docker build -t agent-name .
docker run -p 8501:8501 agent-name
```

</details>

---

## 📖 Documentation

### 📚 Detailed Guides

| Document                                   | Description                       |
| ------------------------------------------ | --------------------------------- |
| [CONTRIBUTING.md](./CONTRIBUTING.md)       | How to contribute to this project |
| [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md) | Community guidelines              |
| [SECURITY.md](./SECURITY.md)               | Security policy and reporting     |
| [CHANGELOG.md](./CHANGELOG.md)             | Version history and updates       |

### 🤖 Agent-Specific Documentation

Each agent folder contains:

- `README.md` - Setup and usage instructions
- `requirements.txt` / `package.json` - Dependencies
- `.env.example` - Required environment variables
- Architecture diagrams and flow charts

---

## 🛠️ Tech Stack

### Languages & Frameworks

| Category             | Technologies                                                  |
| :------------------- | :------------------------------------------------------------ |
| **Languages**        | Python 3.10+, TypeScript 5.x, JavaScript                      |
| **AI Frameworks**    | LangChain, LangGraph, AutoGen, Agno, MCP Protocol             |
| **LLM Providers**    | OpenAI (GPT-4, GPT-4o), Anthropic Claude, Ollama              |
| **Embeddings**       | OpenAI text-embedding-3-small, Ada-002, Sentence Transformers |
| **Vector Databases** | ChromaDB, FAISS, Pinecone                                     |

### Backend & Infrastructure

| Category             | Technologies                    |
| :------------------- | :------------------------------ |
| **Web Frameworks**   | Express 5, FastAPI, Flask       |
| **Databases**        | PostgreSQL, SQLite, Redis       |
| **ORM**              | Drizzle ORM, SQLAlchemy, Prisma |
| **Task Queues**      | Celery, Bull                    |
| **Containerization** | Docker, Docker Compose          |

### Frontend & UI

| Category          | Technologies               |
| :---------------- | :------------------------- |
| **Web Apps**      | React 18, Vite 7, Next.js  |
| **Dashboards**    | Streamlit, Gradio          |
| **Styling**       | TailwindCSS, shadcn/ui     |
| **Visualization** | Plotly, Chart.js, Recharts |

### APIs & Integrations

| Category            | Technologies                           |
| :------------------ | :------------------------------------- |
| **Messaging**       | Slack Bolt.js, Instagram API, WhatsApp |
| **Developer Tools** | GitHub API, Notion API                 |
| **Search**          | DuckDuckGo, Tavily, SerpAPI            |
| **Memory**          | mem0.ai, Zep                           |

---

## 📂 Project Structure

```
agent-forge/
│
├── 📁 01_customer_support_agent_langgraph/
│   ├── app.py                    # Streamlit frontend
│   ├── backend.py                # Agent logic
│   ├── requirements.txt          # Dependencies
│   └── README.md                 # Documentation
│
├── 📁 02_search_the_internet_and_summarize/
│   └── ...
│
├── 📁 03_chatbot-simulation-evaluation/
│   └── ...
│
├── 📁 04 information-gather-prompting/
│   └── ...
│
├── 📁 05 Vibe Matcher/
│   ├── src/                      # Core modules
│   ├── notebooks/                # Jupyter notebooks
│   └── data/                     # Cached embeddings
│
├── 📁 06 lead_gen_agent/
│   ├── graph/                    # LangGraph workflow
│   ├── tools/                    # Agent tools
│   └── models/                   # Data models
│
├── 📁 07 AI-Powered-Instagram-DM-Bot/
│   └── ...
│
├── 📁 08_AutoGen_Web_Info_Agent/
│   └── ...
│
├── 📁 12 AI-Co-Browser-main/           # AI co-browsing assistant
│   ├── client/                   # React frontend
│   ├── server/                   # Express backend
│   ├── shared/                   # Shared types
│   └── api/                      # API routes
│
├── 📁 14 OpenClaw-From-Scratch-main/   # Slack RAG bot with MCP + memory
│   └── OpenClaw-From-Scratch-main/
│       ├── src/
│       │   ├── agents/           # AI agent logic
│       │   ├── channels/         # Slack integration
│       │   ├── memory/           # Database layer
│       │   ├── mcp/              # MCP protocol
│       │   ├── rag/              # RAG system
│       │   └── tools/            # Agent tools
│       └── docs/                 # Architecture docs
│
├── 📁 11 AI_tic_tac_toe_agent/         # GPT-4o vs Claude game
│   └── ...
│
├── 📁 13 Legal Agent/                  # Multi-agent legal team
│   ├── legal_agent_team.py       # Streamlit app + multi-agent team
│   ├── requirements.txt          # Dependencies
│   ├── .env                      # API keys
│   └── README.md                 # Documentation
│
├── 📁 15 ai-tutor/                     # 🆕 PDF → AI quiz generator
│   ├── backend/                  # Python NLP + embeddings pipeline
│   ├── frontend/                 # Web UI
│   └── assets/                   # Screenshots
│
├── 📁 16_UI_UX Feedback Agent_Nano_banana/ # 🆕 Multi-agent design crew
│   ├── agent.py                  # Coordinator + 5 specialist agents
│   ├── prompts.py                # Centralized agent personas
│   ├── tools.py                  # generate / edit / compare / WCAG
│   ├── app.py                    # Streamlit UI
│   └── README.md                 # Documentation
│
├── 📁 Contract Analysis/                # 🆕 ClauseAI — industry-grade contract review
│   ├── ClauseAI.ipynb            # End-to-end notebook (FAISS + LangGraph)
│   ├── data/clauses.json         # Reference clause library (50 clauses, 6 types)
│   └── streamlit_app/            # Production multi-tab UI
│       ├── app.py                # 9-tab Streamlit entrypoint
│       ├── config.py             # Env-driven settings
│       ├── core/                 # state · graph · nodes · reporter · retrievers · chat · exporters
│       ├── prompts/prompts.py    # Centralized prompts
│       ├── ui/                   # sidebar · components · views
│       └── README.md             # Documentation
│
├── 📁 AI Real Estate Agent Team/        # 🆕 Multi-agent property search + analytics
│   ├── ai_real_estate_agent_team.py     # Cloud entry (Gemini/OpenAI/Anthropic)
│   ├── local_ai_real_estate_agent_team.py # Local entry (Ollama)
│   ├── src/real_estate/                 # Modular core
│   │   ├── config.py · schemas.py · prompts.py
│   │   ├── firecrawl_service.py         # Retry + cache + URL builder
│   │   ├── llm_factory.py               # Pluggable provider factory
│   │   ├── pipeline.py                  # 4-stage pipeline
│   │   ├── scoring.py                   # Deterministic 0–100 investment score
│   │   ├── analytics.py                 # Plotly metrics + charts
│   │   ├── history.py · exporters.py    # SQLite history · MD/JSON/CSV
│   │   └── ui.py                        # Streamlit views (search/analytics/compare/history/export)
│   ├── tests/                           # pytest: URL builder + scoring
│   ├── .env.example · pyrightconfig.json
│   └── README.md                        # Full documentation
│
├── 📁 ShoppingGPT-main/                  # 🆕 AI personal-shopper for fashion store
│   └── ShoppingGPT-main/
│       ├── app.py                        # Flask backend, JSON API, sessions
│       ├── main.py                       # CLI entry point
│       ├── scripts/init_db.py            # Build SQLite from products.csv
│       ├── shoppinggpt/
│       │   ├── config.py                 # Env, paths, OpenAI factories
│       │   ├── agent.py                  # Tool-calling shopping agent
│       │   ├── chain.py                  # Chitchat chain
│       │   ├── router/router.py          # Multi-intent semantic router
│       │   └── tool/                     # product_search · policy_search · recommend · catalogue
│       ├── static/ · templates/          # Custom CSS + vanilla JS chat UI
│       └── data/                         # products.csv · products.db · policy.txt · FAISS cache
│
├── 📁 Audio-In-Chat/                     # 🆕 Industry-grade audio RAG library + Streamlit/FastAPI
│   ├── app.py                            # Streamlit UI (sidebar config wizard, streamed chat, citations)
│   ├── code_rag.py                       # Backwards-compat shim for the old API
│   ├── audio_chat/                       # Importable library
│   │   ├── config.py · exceptions.py · logger.py
│   │   ├── embeddings.py                 # OpenAI · HuggingFace
│   │   ├── transcriber.py                # Whisper · AssemblyAI + file validation
│   │   ├── chunking.py                   # Speaker-aware overlapping chunks
│   │   ├── vector_store.py               # Qdrant (memory · self-hosted · cloud)
│   │   ├── llm.py · rag.py               # Streaming OpenAI + retrieval + sources
│   │   └── pipeline.py                   # AudioChatPipeline facade
│   ├── examples/                         # basic_usage.py · api_server.py (FastAPI SSE)
│   ├── tests/                            # Offline pytest: config + chunker (10 tests)
│   ├── Dockerfile · docker-compose.yml   # Streamlit + persistent Qdrant
│   ├── pyproject.toml · requirements.txt
│   └── README.md
│
├── 📁 Rag-sql-router/                    # 🆕 Hybrid SQL + RAG agent (LangGraph + LangChain)
│   ├── backend/                          # FastAPI + LangGraph backend
│   │   ├── main.py                       # FastAPI app + lifespan + CORS
│   │   ├── config.py · models.py         # Pydantic settings + schemas
│   │   ├── graph/                        # LangGraph StateGraph
│   │   │   ├── state.py                  # AgentState TypedDict
│   │   │   ├── workflow.py               # classify → sql/rag → trust → END
│   │   │   └── nodes/                    # classifier · sql_node · rag_node · trust_node
│   │   ├── services/                     # LangChain chains
│   │   │   ├── llm.py                    # Cached ChatOpenAI + OpenAIEmbeddings
│   │   │   ├── sql_chain.py              # LCEL Text-to-SQL + safety guards
│   │   │   ├── rag_chain.py              # Retriever + RAG prompt + LCEL
│   │   │   ├── vector_store.py           # Chroma + LangChain document loaders
│   │   │   └── trust_scorer.py           # Cleanlab Codex integration
│   │   ├── routes/                       # chat · documents · database
│   │   └── data/                         # city_database.sqlite + seed script (192 cities)
│   ├── frontend/                         # React 18 + Vite + Tailwind
│   │   └── src/
│   │       ├── App.jsx · api.js          # SPA shell + REST client
│   │       ├── components/               # Header · Sidebar · ChatInterface · MessageBubble · TrustBadge · DatabaseExplorer
│   │       └── hooks/useChat.js          # Custom chat state hook
│   ├── notebook.ipynb                    # End-to-end LangChain notebook
│   ├── run.py · requirements.txt · .env.example
│   └── README.md
│
├── 📁 .github/
│   ├── ISSUE_TEMPLATE/           # Issue templates
│   ├── PULL_REQUEST_TEMPLATE.md  # PR template
│   └── workflows/                # CI/CD
│
├── 📄 README.md                  # This file
├── 📄 CONTRIBUTING.md            # Contribution guide
├── 📄 CODE_OF_CONDUCT.md         # Community guidelines
├── 📄 SECURITY.md                # Security policy
├── 📄 CHANGELOG.md               # Version history
└── 📄 LICENSE                    # Apache 2.0
```

---

## 🗺️ Roadmap

### Q1 2026 - Foundation ✅

- [x] Launch project with 8 core agents
- [x] Add AI Co-Browser (full-stack React + Express)
- [x] Add OpenClaw with RAG + Memory + MCP
- [x] Add AI Tic Tac Toe multi-agent game
- [x] Add AI Legal Agent Team — multi-agent legal analysis
- [x] Add AI Tutor — PDF → quiz generator
- [x] Add UI/UX Feedback Agent Team — 5-specialist design crew
- [x] Add ClauseAI — industry-grade multi-agent contract review (LangGraph + OpenAI)
- [x] Add AI Real Estate Agent Team — multi-source listings, deterministic scoring, full analytics dashboard
- [x] Add ShoppingGPT — AI personal-shopper with multi-intent routing, guarded SQL, grounded recommendations
- [x] Add Audio-In-Chat — industry-grade audio transcription + RAG library (Whisper + OpenAI + Qdrant)
- [x] Add E2E Testing Agent — NL → Playwright test generation with LangGraph + DOM analysis
- [x] Add RAG + SQL Router — hybrid query engine with LangGraph routing, Text-to-SQL, ChromaDB RAG & Cleanlab trust scoring
- [x] Rebrand to **Agent Forge** — open-ended, no-deadline collection
- [x] Comprehensive documentation
- [x] Contributor guidelines

### Q2 2026 - Expansion

- [ ] Reach 25 agents
- [ ] Add Docker support for all agents
- [ ] Create video tutorials
- [ ] Launch Discord community
- [ ] Add automated testing
- [ ] Standardize agent template (folder layout + boilerplate)

### Q3 2026 - Scale

- [ ] Reach 50 agents
- [ ] Enterprise deployment guides
- [ ] Performance benchmarks
- [ ] Agent evaluation framework
- [ ] Multi-language support

### Beyond - No Finish Line 🚀

- [ ] Keep forging — one agent at a time, indefinitely!
- [ ] Publish book/course
- [ ] Conference presentations
- [ ] Case studies

---

## 🤝 Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.

### Quick Links

- 📖 **[CONTRIBUTING.md](./CONTRIBUTING.md)** - Detailed contribution guide
- 📜 **[CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)** - Community guidelines
- 🔐 **[SECURITY.md](./SECURITY.md)** - Security policy

### Ways to Contribute

| Type                 | Description                 |
| :------------------- | :-------------------------- |
| 🐛 **Bug Reports**   | Found a bug? Open an issue! |
| ✨ **Features**      | Have an idea? Share it!     |
| 📝 **Documentation** | Help improve our docs       |
| 🤖 **New Agents**    | Build and contribute agents |
| 🔍 **Code Review**   | Review pull requests        |
| 🌐 **Translations**  | Help translate docs         |

### Getting Started

```bash
# Fork the repository
git clone https://github.com/YOUR-USERNAME/agent-forge.git

# Create a branch
git checkout -b feature/amazing-feature

# Make changes and commit
git commit -m "Add amazing feature"

# Push and create PR
git push origin feature/amazing-feature
```

---

## 💬 Community

Join our growing community of AI enthusiasts!

| Platform       | Link                                                  |
| :------------- | :---------------------------------------------------- |
| 📧 **Email**   | [ayusingh693@gmail.com](mailto:ayusingh693@gmail.com) |
| 🐦 **Twitter** | Coming Soon                                           |
| 💬 **Discord** | Coming Soon                                           |
| 📺 **YouTube** | Coming Soon                                           |

### Star History

[![Star History Chart](https://api.star-history.com/svg?repos=ayusingh-54/agent-forge&type=Date)](https://star-history.com/#ayusingh-54/agent-forge&Date)

---

## ❓ FAQ

<details>
<summary><strong>Q: Do I need paid API keys?</strong></summary>

Most agents require an OpenAI API key. Some agents have free alternatives (Ollama for local LLMs, DuckDuckGo for search). Check each agent's README for specific requirements.

</details>

<details>
<summary><strong>Q: Can I use these agents commercially?</strong></summary>

Yes! This project is licensed under Apache 2.0. You can use, modify, and distribute the code for any purpose, including commercial use.

</details>

<details>
<summary><strong>Q: How do I add my own agent?</strong></summary>

1. Fork the repository
2. Create a new folder (e.g., `XX_your_agent_name`)
3. Include README.md, requirements.txt, app.py
4. Submit a pull request

</details>

<details>
<summary><strong>Q: Which agent should I start with?</strong></summary>

If you're new to AI agents, start with **#2 Web Search & Summarizer** — it's simple but demonstrates the core ReAct loop. For multi-agent patterns, try **#14 UI/UX Feedback Agent Team** (coordinator + 5 specialists), **#15 ClauseAI** (LangGraph parallel fan-out / map-reduce), or **#16 AI Real Estate Agent Team** (sequential pipeline + deterministic scoring + analytics). For production-grade patterns with RAG + memory + MCP, try **#10 OpenClaw**.

</details>

<details>
<summary><strong>Q: Is there a Discord community?</strong></summary>

Coming soon! Star the repo to stay updated on community launches.

</details>

---

## 📄 License

This project is licensed under the **Apache License 2.0** - see the [LICENSE](LICENSE) file for details.

```
Copyright 2024-2026 Ayush Singh

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```

---

## 👨‍💻 Author

<div align="center">

<img src="https://github.com/ayusingh-54.png" width="150" style="border-radius: 50%;" alt="Ayush Singh"/>

### **Ayush Singh**

_AI Engineer & Open Source Enthusiast_

[![GitHub](https://img.shields.io/badge/GitHub-ayusingh--54-181717?style=for-the-badge&logo=github)](https://github.com/ayusingh-54)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-ayush--singh54-0A66C2?style=for-the-badge&logo=linkedin)](https://www.linkedin.com/in/ayush-singh54/)
[![Email](https://img.shields.io/badge/Email-ayusingh693%40gmail.com-EA4335?style=for-the-badge&logo=gmail)](mailto:ayusingh693@gmail.com)

</div>

---

## 🙏 Acknowledgments

Special thanks to:

- **[LangChain](https://langchain.com/)** - The amazing AI framework
- **[Agno](https://github.com/agno-agi/agno)** - Multi-agent framework powering Days 11 & 12
- **[OpenAI](https://openai.com/)** - For GPT models
- **[Anthropic](https://anthropic.com/)** - For Claude
- **[Streamlit](https://streamlit.io/)** - For beautiful dashboards
- **All Contributors** - Who help make this project better ❤️

---

<div align="center">

### ⭐ If you find this project helpful, please give it a star! ⭐

<br/>

**🔨 Forging the future of AI, one agent at a time — no finish line. 🔨**

<br/>

Made with ❤️ by [Ayush Singh](https://github.com/ayusingh-54)

<br/>

[![GitHub Stars](https://img.shields.io/github/stars/ayusingh-54/agent-forge?style=for-the-badge&logo=github&color=gold)](https://github.com/ayusingh-54/agent-forge/stargazers)

</div>
