🚀 HackForge AI – Multi-Agent Hackathon Builder

HackForge AI is a futuristic Multi-Agent AI platform that helps developers, students, and hackathon teams generate complete hackathon-ready project plans automatically using local AI models powered by Ollama and Phi3.

Built during the Build with AI – Agent Builder Camp organized by GeeksforGeeks × Google for Developers.

---

✨ Features

✅ Multi-Agent AI Workflow
✅ AI-Powered Project Idea Generation
✅ Tech Stack Recommendation System
✅ GitHub README Generator
✅ Modern Futuristic UI
✅ Local AI Inference using Ollama + Phi3
✅ Streamlit Interactive Dashboard
✅ Export Generated Outputs
✅ Lightweight & Beginner Friendly
✅ Offline AI Support

---

🤖 AI Agents Included

1. Idea Generator Agent

Generates:

• Hackathon project ideas
• Startup concepts
• Problem statements
• Target users
• Core features

2. Tech Stack Agent

Suggests:

• Frontend technologies
• Backend frameworks
• APIs
• AI tools
• Deployment stack

3. README Agent

Automatically generates:

• GitHub README structure
• Installation instructions
• Project documentation
• Setup guide

---

🛠️ Tech Stack

Technology	Purpose
Python	Core Development
Streamlit	Frontend Dashboard
Ollama	Local LLM Runtime
Phi3	Lightweight AI Model
Requests	API Communication

---

📸 Project Screenshots

Dashboard UI

---

AI Generated Output

⚙️ Installation Guide

1️⃣ Clone Repository

git clone https://github.com/shreya975/hackforge-ai.git
cd hackforge-ai

---

2️⃣ Install Requirements

pip install -r requirements.txt

---

3️⃣ Install Ollama

Download Ollama:

https://ollama.com/download

---

4️⃣ Run Phi3 Model

ollama run phi3

Wait until you see:

>>> Send a message

Keep this terminal open.

---

5️⃣ Run Streamlit App

Open another terminal:

python -m streamlit run app.py

---

🚀 Usage

1. Select:

   • Domain
   • Difficulty Level
   • Team Size
   • Tech Stack
   • Hackathon Theme

2. Click:

Generate Project

3. AI Agents will:

• Generate project ideas
• Suggest technologies
• Create documentation

4. Export generated output as Markdown.

---

🧠 How It Works

HackForge AI uses multiple AI agents that collaborate together to generate structured hackathon-ready outputs.

Workflow:

User Input
   ↓
Idea Generator Agent
   ↓
Tech Stack Agent
   ↓
README Agent
   ↓
Final AI Output

---

🌟 Key Highlights

✅ Local AI Processing
✅ No Paid API Required
✅ Lightweight AI Architecture
✅ Offline AI Support
✅ Portfolio-Ready Project
✅ Modern AI SaaS UI

---

📂 Project Structure

hackforge-ai/
│
├── app.py
├── requirements.txt
├── README.md
├── Dockerfile
└── .dockerignore

---

🔥 Future Improvements

• More AI Agents
• PDF Export
• Agent Memory
• Workflow Visualization
• Real-time Collaboration
• Cloud Deployment
• Authentication System
• Project Saving Feature

---

🎯 Workshop Experience

This project was built as part of the:

Build with AI – Agent Builder Camp
by GeeksforGeeks × Google for Developers.

The workshop helped in understanding:

• AI Agents
• Local LLM Workflows
• Prompt Engineering
• AI Product Building
• Streamlit UI Development

---

📜 License

This project is licensed under the MIT License.

---

👩‍💻 Author

Shreya Mahajan

Passionate about:

• AI/ML
• Open Source
• Streamlit Apps
• Multi-Agent Systems
• Data Science

---