Go to file
zachary62 2a79a3ba24 update image 2025-03-08 21:11:04 -05:00
assets update image 2025-03-08 21:11:04 -05:00
cookbook update readme 2025-02-23 23:56:23 -05:00
docs update guide 2025-03-08 13:43:32 -05:00
pocketflow m 2025-02-02 22:30:18 +00:00
tests rename as mini llm flow is poor 2025-01-09 03:01:25 +00:00
.cursorrules update cursor rule 2025-03-05 12:01:38 -05:00
.gitignore add examples 2024-12-27 05:29:24 +00:00
LICENSE Create LICENSE 2024-12-26 00:44:17 -05:00
README.md update image 2025-03-08 21:11:04 -05:00
setup.py track the current retry 2025-01-25 05:39:44 +00:00

README.md

License: MIT Docs

Pocket Flow is a 100-line minimalist LLM framework

  • Expressive: Everything you love from larger frameworks—(Multi-)Agents, Workflow, RAG, and more.

  • Lightweight: Just the core graph abstraction in 100 lines. Zero bloat, zero dependencies, zero vendor lock-in.

  • Principled: Built with modularity and clear separation of concerns at its heart.

  • AI-Friendly: Intuitive enough for AI agents to assist humans in building complex LLM applications.

  • To install, pip install pocketflowor just copy the source code (only 100 lines).

  • To learn more, check out the documentation. For an in-depth design dive, read the essay.

  • 🎉 We now have a discord

What can Pocket Flow build?

Below are examples of LLM Apps, with Step-by-Step YouTube Tutorials:

Formal App Name Informal One-Liner Difficulty Learning Objectives
Youtube Summarizer Explain YouTube Videos to you like you're 5 ★☆☆
Beginner
Map Reduce
Cold Opener Generator Instant icebreakers that turn cold leads hot ★☆☆
Beginner
Map Reduce
Web Search
Ask AI Paul Graham Ask AI Paul Graham, in case you don't get in ★★☆
Medium
RAG
Map Reduce
Text-to-Speech
  • Want to create your own Python project? Start with this template

Why Pocket Flow?

For a new development paradigmn: Vibe Coding!

  • 🧑 Human describe LLM App requirements in a design doc.
  • 🤖 The agent (like Cursor AI) implements App your code automatically.


👈 (Click to expand) How to set up Pocket Flow for LLM agents?
👈 (Click to expand) How does Pocket Flow compare to other frameworks?

Pocket Flow is purpose-built for LLM Agents:

  1. 🫠 LangChain-like frameworks overwhelm Cursor AI with complex abstractions, deprecated functions and irritating dependency issues.
  2. 😐 Without a framework, code is ad hoc—suitable only for immediate tasks, not modular or maintainable.
  3. 🥰 With Pocket Flow: (1) Minimal and expressive—easy for Cursor AI to pick up. (2) Nodes and Flows keep everything modular. (3) A Shared Store decouples your data structure from compute logic.

In short, the 100 lines ensures LLM Agents follows solid coding practices without sacrificing flexibility.

How does Pocket Flow work?

The 100 lines capture what we believe to be the core abstraction of LLM frameworks:

  • Computation: A graph that breaks down tasks into nodes, with branching, looping, and nesting.
  • Communication: A shared store that all nodes can read and write to.


From there, its easy to implement popular design patterns like (Multi-)Agents, Workflow, RAG, etc.