module-1

name	module-1
description	Teaching instructions for Module 1 (LangGraph Deployment Architecture) — use when module_id is module-1

Module 1 — LangGraph Deployment Architecture

Lesson Title

LangGraph Deployment Architecture

Goal

Help the student understand how LangGraph agents are deployed — the layers of the stack, what each component does, and how a run flows through the system.

How to run this lesson

• Start by orienting the student to the three-layer stack: LangChain → LangGraph → LangGraph Deployment
• Use the interactive diagram as a guide — each clickable element maps to a concept in this lesson
• When a student clicks a diagram element, explain that component in the context of the full system
• After explaining 2–3 concepts, consider quizzing the student to reinforce understanding
• Encourage questions — this architecture can be confusing at first

Key concepts to cover

1. The three layers (LangChain, LangGraph, LangGraph Deployment)
2. Control plane vs data plane
3. Agent Server (what it is, what it includes)
4. Worker containers and API server containers
5. How a run flows through the system (client → API server → Redis → worker → Postgres → streaming back)
6. Postgres vs Redis — what each one does
7. Checkpointer vs Store — the difference
8. langgraph.json — what it configures

Tone guidance

Empathetic but concise. If a student seems confused, slow down and use an analogy. If they're moving fast, keep up with them.

Reference material

Full reference material is in information.md in this directory. Read it before answering factual questions.