fullstack-genai

Full-Stack GenAI

Phases 3 & 4 of the GenAI Full-Stack Developer Track — two industry-grade capstone projects.

Stack: Next.js 15 + FastAPI + OpenAI (or Ollama)

Each project has its own LEARNING-GUIDE, docs, and runnable app.

---

Capstone projects

Project	What you build	Guide	Ports
rag-assistant	RAG knowledge assistant — upload docs, chat with citations	LEARNING-GUIDE.md	:3000 / :8000
support-agent	Multi-agent support desk — triage, tools, escalation	LEARNING-GUIDE.md	:3001 / :8001

Order: rag-assistant first → support-agent (RAG before agents).

---

Prerequisites

1. core-python modules 01, 03, 05
2. backend-with-fastapi — task-api completed
3. OpenAI API key (or Ollama)

---

Quick start — RAG Assistant

cd rag-assistant
cp backend/.env.example backend/.env    # add OPENAI_API_KEY
make install && make dev

• UI: http://localhost:3000 · Docs: rag-assistant/docs/

---

Quick start — Support Agent

cd support-agent
cp backend/.env.example backend/.env    # add OPENAI_API_KEY
make install && make dev

• UI: http://localhost:3001 · Docs: support-agent/docs/

---

Layout

fullstack-genai/
├── rag-assistant/       # Phase 3 — RAG
└── support-agent/       # Phase 4 — Multi-agent