Sandbox
@theaiautomators/claude-code-agentic-rag-masterclass

Claude Code course for building agentic RAG apps

This repo teaches you how to build a full agentic RAG app with Claude Code as the coding partner. The course is split into eight modules covering chat UI, ingestion, hybrid search, reranking, text-to-SQL, and subagents.

187 stars98 forksUpdated 7mo ago
The Complete Agentic RAG Build: 8 Modules, 2+ Hours, Full Stack
The AI Automators58k views • 7 months ago
Who it's for

Builders who want to collaborate with Claude Code on a real RAG project.

What it delivers

You can follow a structured path to build and understand an agentic RAG app instead of starting from a blank page.

What it does

Eight-module build path

Covers app shell, retrieval and memory, record management, metadata extraction, multi-format support, hybrid search and reranking, extra tools, and subagents.

Claude Code workflow

Uses `CLAUDE.md`, `.claude/commands`, and `/onboard` to guide the build inside Claude Code.

Full RAG stack

Shows chat, document ingestion, chunking, embeddings, hybrid search, reranking, and observability with the stated stack.

Agentic patterns

Includes text-to-SQL, web search fallback, and subagents with isolated context for document analysis.

README

Cloud Code Agentic RAG Masterclass

Build an agentic RAG application from scratch by collaborating with Claude Code. Follow along with our video series using the docs in this repo.

Claude Code RAG Masterclass

Watch the full video on YouTube

What This Is

A hands-on course where you collaborate with Claude Code to build a full-featured RAG system. You're not the one writing code—Claude is. Your job is to guide it, understand what you're building, and course-correct when needed.

You don't need to know how to code. You do need to be technically minded and willing to learn about APIs, databases, and system architecture.

What You'll Build

  • Chat interface with threaded conversations, streaming, tool calls, and subagent reasoning
  • Document ingestion with drag-and-drop upload and processing status
  • Full RAG pipeline: chunking, embedding, hybrid search, reranking
  • Agentic patterns: text-to-SQL, web search, subagents with isolated context

Tech Stack

LayerTech
FrontendReact, TypeScript, Tailwind, shadcn/ui, Vite
BackendPython, FastAPI
DatabaseSupabase (Postgres + pgvector + Auth + Storage)
Doc ProcessingDocling
AI ModelsLocal (LM Studio) or Cloud (OpenAI, OpenRouter)
ObservabilityLangSmith

The 8 Modules

  1. App Shell — Auth, chat UI, managed RAG with OpenAI Responses API
  2. BYO Retrieval + Memory — Ingestion, pgvector, switch to generic completions API
  3. Record Manager — Content hashing, deduplication
  4. Metadata Extraction — LLM-extracted metadata, filtered retrieval
  5. Multi-Format Support — PDF, DOCX, HTML, Markdown via Docling
  6. Hybrid Search & Reranking — Keyword + vector search, RRF, reranking
  7. Additional Tools — Text-to-SQL, web search fallback
  8. Subagents — Isolated context, document analysis delegation

Getting Started

  1. Clone this repo
  2. Install Claude Code
  3. Open in your IDE (Cursor, VS Code, etc.)
  4. Run claude in the terminal
  5. Use the /onboard command to get started

Docs

  • PRD.md — What to build (the 8 modules in detail)
  • CLAUDE.md — Context for Claude Code
  • PROGRESS.md — Track your build progress

Join the Community

If you want to connect with hundreds of builders creating production-grade AI and RAG systems, join us in The AI Automators community. Share your progress, get help when you're stuck, and see what others are building.

Files in the repo

Repository payload7 top-level entries
  • .agent
  • .claude
  • CLAUDE.md
  • PRD.md
  • PROGRESS.md
  • README.md
  • video-thumbnail.png

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More tutorials & guides

shareAI-lab/
learn-claude-code

Bash is all you need - A nano claude code–like 「agent harness」, built from 0 to 1

77k
luongnv89/
claude-howto
luongnv89/claude-howtoTutorials & Guides

A visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.

41k
agentskills/
agentskills
agentskills/agentskillsTutorials & Guides

Specification and documentation for Agent Skills

25k