English | δΈζ | EspaΓ±ol | ζ₯ζ¬θͺ | Deutsch | Π ΡΡΡΠΊΠΈΠΉ | PortuguΓͺs | FranΓ§ais | νκ΅μ΄
-
Lightweight: Just 100 lines. Zero bloat, zero dependencies, zero vendor lock-in.
-
Expressive: Everything you loveβ(Multi-)Agents, Workflow, RAG, and more.
-
Agentic Coding: Let AI Agents (e.g., Cursor AI) build Agentsβ10x productivity boost!
Get started with Pocket Flow:
- To install,
pip install pocketflowor just copy the source code (only 100 lines). - To learn more, check out the video tutorial and documentation
- π Join our Discord to connect with other developers building with Pocket Flow!
- π Pocket Flow now has Typescript, Java, C++, Go, Rust and PHP versions!
Current LLM frameworks are bloated... You only need 100 lines for LLM Framework!
| Abstraction | App-Specific Wrappers | Vendor-Specific Wrappers | Lines | Size | |
|---|---|---|---|---|---|
| LangChain | Agent, Chain | Many (e.g., QA, Summarization) |
Many (e.g., OpenAI, Pinecone, etc.) |
405K | +166MB |
| CrewAI | Agent, Chain | Many (e.g., FileReadTool, SerperDevTool) |
Many (e.g., OpenAI, Anthropic, Pinecone, etc.) |
18K | +173MB |
| SmolAgent | Agent | Some (e.g., CodeAgent, VisitWebTool) |
Some (e.g., DuckDuckGo, Hugging Face, etc.) |
8K | +198MB |
| LangGraph | Agent, Graph | Some (e.g., Semantic Search) |
Some (e.g., PostgresStore, SqliteSaver, etc.) |
37K | +51MB |
| AutoGen | Agent | Some (e.g., Tool Agent, Chat Agent) |
Many [Optional] (e.g., OpenAI, Pinecone, etc.) |
7K (core-only) |
+26MB (core-only) |
| PocketFlow | Graph | None | None | 100 | +56KB |
The 100 lines capture the core abstraction of LLM frameworks: Graph!
From there, it's easy to implement popular design patterns like (Multi-)Agents, Workflow, RAG, etc.
β¨ Below are basic tutorials:
| Name | Difficulty | Description |
|---|---|---|
| Chat | βββ Dummy | A basic chat bot with conversation history |
| Structured Output | βββ Dummy | Extracting structured data from resumes by prompting |
| Workflow | βββ Dummy | A writing workflow that outlines, writes content, and applies styling |
| Agent | βββ Dummy | A research agent that can search the web and answer questions |
| RAG | βββ Dummy | A simple Retrieval-augmented Generation process |
| Batch | βββ Dummy | A batch processor that translates markdown into multiple languages |
| Streaming | βββ Dummy | A real-time LLM streaming demo with user interrupt capability |
| Chat Guardrail | βββ Dummy | A travel advisor chatbot that only processes travel-related queries |
| Majority Vote | βββ Dummy | Improve reasoning accuracy by aggregating multiple solution attempts |
| Map-Reduce | βββ Dummy | Batch resume qualification using map-reduce pattern |
| CLI HITL | βββ Dummy | A command-line joke generator with human-in-the-loop feedback |
| Multi-Agent | β ββ Beginner | A Taboo word game for async communication between 2 agents |
| Supervisor | β ββ Beginner | Research agent is getting unreliable... Let's build a supervision process |
| Parallel | β ββ Beginner | A parallel execution demo that shows 3x speedup |
| Parallel Flow | β ββ Beginner | A parallel image processing showing 8x speedup |
| Thinking | β ββ Beginner | Solve complex reasoning problems through Chain-of-Thought |
| Memory | β ββ Beginner | A chat bot with short-term and long-term memory |
| Text2SQL | β ββ Beginner | Convert natural language to SQL queries with an auto-debug loop |
| Code Generator | β ββ Beginner | Generate test cases, implement solutions, and iteratively improve code |
| MCP | β ββ Beginner | Agent using Model Context Protocol for numerical operations |
| Agent Skills | β ββ Beginner | Route requests to reusable markdown skills and apply them in an agent flow |
| A2A | β ββ Beginner | Agent wrapped with A2A protocol for inter-agent communication |
| Streamlit FSM | β ββ Beginner | Streamlit app with finite state machine for HITL image generation |
| FastAPI WebSocket | β ββ Beginner | Real-time chat interface with streaming LLM responses via WebSocket |
| FastAPI Background | β ββ Beginner | FastAPI app with background jobs and real-time progress via SSE |
| Voice Chat | β ββ Beginner | An interactive voice chat application with VAD, STT, LLM, and TTS. |
| Judge | β ββ Beginner | LLM-as-Judge evaluator-optimizer loop for iterative content refinement |
| Debate | β ββ Beginner | Adversarial reasoning with two advocates and an impartial judge |
| Agentic RAG | β ββ Beginner | Agent-driven RAG that decides which documents to read |
| Self-Healing Mermaid | β ββ Beginner | Generate Mermaid diagrams with automatic error recovery |
| Heartbeat | β ββ Beginner | ClawBot-like always-on periodic monitoring with nested flows |
| Lead Generation | β β β Intermediate | Sales pipeline: scrape, enrich, score, and personalize emails |
| Newsletter | β β β Intermediate | AI newsletter curation: search, filter, summarize, and format |
| Invoice Processing | β β β Intermediate | Extract and validate invoice data from PDFs using vision |
| NotebookLM | β β β Intermediate | Turn documents into a podcast with two AI hosts |
| Deep Research | β β β Intermediate | Recursive map-reduce research with iterative refinement |
| Coding Agent | β β β Advanced | Production coding agent with 6 tools, memory, and patch-as-subflow |
π Want to see other tutorials for dummies? Create an issue!
π Through Agentic Codingβthe fastest LLM App development paradigm-where humans design and agents code!
β¨ Below are examples of more complex LLM Apps:
| App Name | Difficulty | Topics | Human Design | Agent Code |
|---|---|---|---|---|
| Website Chatbot Turn your website into a 24/7 customer support genius |
β
β
β Medium |
Agent RAG |
Design Doc | Flow Code |
| Danganronpa Simulator Forget the Turing test. Danganronpa, the ultimate AI experiment! |
β
β
β
Advanced |
Workflow Agent |
Design Doc | Flow Code |
| Codebase Knowledge Builder Life's too short to stare at others' code in confusion |
β
β
β Medium |
Workflow | Design Doc | Flow Code |
| Build Cursor with Cursor We'll reach the singularity soon ... |
β
β
β
Advanced |
Agent | Design Doc | Flow Code |
| Ask AI Paul Graham Ask AI Paul Graham, in case you don't get in |
β
β
β Medium |
RAG Map Reduce TTS |
Design Doc | Flow Code |
| Youtube Summarizer Explain YouTube Videos to you like you're 5 |
β
ββ Beginner |
Map Reduce | Design Doc | Flow Code |
| Cold Opener Generator Instant icebreakers that turn cold leads hot |
β
ββ Beginner |
Map Reduce Web Search |
Design Doc | Flow Code |
-
Want to learn Agentic Coding?
-
Check out my YouTube for video tutorial on how some apps above are made!
-
Want to build your own LLM App? Read this post! Start with this template!
-