LangGraph AI Repository

A comprehensive collection of LangGraph implementations, tutorials, and advanced AI workflows covering Agentic RAG systems, MCP (Model Context Protocol) development, and practical AI application patterns.

Overview

This repository serves as a implementation guide for building sophisticated AI applications using LangGraph. It contains practical examples, tutorials, and production-ready implementations across multiple domains:

Agentic RAG Systems: Advanced retrieval-augmented generation with adaptive routing and self-correction mechanisms
MCP Development: Complete Model Context Protocol server and client implementations
Workflow Patterns: Orchestration patterns for complex AI workflows
Human-in-the-Loop Systems: Interactive AI systems with human oversight
Advanced RAG Agents: Sophisticated retrieval and generation systems

Repository Structure

langgraph-ai/
├── agentic-rag/
│   ├── agentic-rag-systems/
│   │   └── building-adaptive-rag/
│   └── agentic-workflow-pattern/
│       ├── 1-prompting_chaining.ipynb
│       ├── 2-routing.ipynb
│       ├── 3-parallelization.ipynb
│       ├── 4-orchestrator-worker.ipynb
│       └── 5-Evaluator-optimizer.ipynb
├── mcp/
│   ├── 01-build-your-own-server-client/
│   ├── 02-build-mcp-client-with-multiple-server-support/
│   └── 03-build-mcp-server-client-using-sse/
├── langgraph-cookbook/
│   ├── human-in-the-loop/
│   │   ├── 01-human-in-the-loop.ipynb
│   │   ├── 02-human-in-the-loop.ipynb
│   │   └── 03-human-in-the-loop.ipynb
│   └── tool-calling -vs-react.ipynb
├── rag/
│   ├── Building an Advanced RAG Agent.ipynb
│   └── rag-as-tool-in-langgraph-agents.ipynb
├── .gitignore
├── .gitmodules
├── README.md
└── requirements.txt

Prerequisites

Before setting up this repository, ensure you have the following installed:

Python 3.10 or higher (depends on the project)
UV package manager (recommended) or pip
Git

Installation and Setup

Step 1: Clone the Repository

git clone https://github.com/piyushagni5/langgraph-ai.git
cd langgraph-ai

Step 2: Install UV Package Manager

If you haven't installed UV yet, install it using:

curl -LsSf https://astral.sh/uv/install.sh | sh

For Windows (PowerShell):

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Step 3: Create Virtual Environment

Navigate to the specific project directory you want to work with. For example, to work with the Adaptive RAG system:

cd langgraph-cookbook/agentic-patterns

Create a virtual environment using UV:

uv venv --python 3.10

Step 4: Activate Virtual Environment

On macOS/Linux:

source .venv/bin/activate

On Windows:

.venv\Scripts\activate

Step 5: Install Dependencies

Using UV (Recommended):

uv pip install -r requirements.txt

Using pip (Alternative):

pip install -r requirements.txt

Step 6: Adding Virtual Environment to Jupyter Kernel

To use your UV virtual environment with Jupyter notebooks, you need to install ipykernel and register the environment as a kernel: Install ipykernel in the virtual environment:

uv pip install ipykernel

Register the virtual environment as a Jupyter kernel:

python -m ipykernel install --user --name=langgraph-ai --display-name="LangGraph AI"

When you open a notebook, you can select the "LangGraph AI" kernel from the kernel menu.

Step 7: Environment Configuration

Create a .env file in your project directory with the necessary API keys:

ANTHROPIC_API_KEY="your-anthropic-api-key"
# LANGCHAIN_API_KEY="your-langchain-api-key"  # optional
# LANGCHAIN_TRACING_V2=True                   # optional
# LANGCHAIN_PROJECT="multi-agent-swarm"       # optional

Note: The LANGCHAIN_API_KEY is required if you enable tracing with LANGCHAIN_TRACING_V2=true.

Running Projects

Adaptive RAG System

cd agentic-rag/agentic-rag-systems/building-adaptive-rag
uv run main.py

Running Tests

uv run pytest . -s -v

Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues for:

Bug fixes and improvements
New tutorial implementations
Documentation enhancements
Performance optimizations

License

This project is open source and available under the MIT License.

Note: This repository contains multiple independent projects. Each project has its own requirements and setup instructions. Please refer to individual project README files for specific details.

langgraph-ai