From 341e9b2416bb499b7bc5915ce1377e7624891310 Mon Sep 17 00:00:00 2001 From: Zachary Huang <33015448+zachary62@users.noreply.github.com> Date: Fri, 14 Mar 2025 19:31:04 -0400 Subject: [PATCH 1/4] Update README.md --- README.md | 75 ++++++++++++++++++++++++++----------------------------- 1 file changed, 36 insertions(+), 39 deletions(-) diff --git a/README.md b/README.md index eebe2bc..89df12f 100644 --- a/README.md +++ b/README.md @@ -26,7 +26,7 @@ Pocket Flow is a [100-line](pocketflow/__init__.py) minimalist LLM framework ## Why Pocket Flow? -Current LLM frameworks are bloated. You only need 100 lines for LLM Framework! +Current LLM frameworks are bloated... You only need 100 lines for LLM Framework!
@@ -45,7 +45,41 @@ Current LLM frameworks are bloated. You only need 100 lines for LLM Framework!
-Pocket Flow also makes an excellent educational resource by revealing exactly how an LLM framework works under the hoodβ€”without the heavy abstractions of larger libraries. +**Pocket Flow** is also a educational resource for understanding LLM frameworks: + +- Larger frameworks are overly abstract and hide away details. + +- **Pocket Flow** shows exactly how everything works under the hood. + +## How to Use Pocket Flow? + +πŸš€ Through **Agent Coding**β€”the fastest LLM App development paradigm-where humans design and agents code! + +
+
+ + IMAGE ALT TEXT + +
+
+ + +✨ Below are examples of LLM Apps: + +
+ +| Formal App Name | Informal One-Liner | Difficulty | Topics | Human
Design | Agent
Code | +| :------------- | :------------- | :-------------: | :---------------------: | :---: | :---: | +| [Ask AI Paul Graham](https://github.com/The-Pocket/Tutorial-YC-Partner) | Ask AI Paul Graham, in case you don't get in | β˜…β˜…β˜†
*Medium* | [RAG](https://the-pocket.github.io/PocketFlow/design_pattern/rag.html)
[Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html)
[TTS](https://the-pocket.github.io/PocketFlow/utility_function/text_to_speech.html) | [Design](https://github.com/The-Pocket/Tutorial-AI-Paul-Graham/blob/main/docs/design.md) | [Code](https://github.com/The-Pocket/Tutorial-AI-Paul-Graham/blob/main/flow.py) +| [Youtube Summarizer](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple) | Explain YouTube Videos to you like you're 5 | β˜…β˜†β˜†
*Beginner* | [Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html) | [Design](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple/blob/main/docs/design.md) | [Code](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple/blob/main/flow.py) +| [Cold Opener Generator](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization) | Instant icebreakers that turn cold leads hot | β˜…β˜†β˜†
*Beginner* | [Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html)
[Web Search](https://the-pocket.github.io/PocketFlow/utility_function/websearch.html) | [Design](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization/blob/master/docs/design.md) | [Code](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization/blob/master/flow.py) + +
+ +- Want to learn **Agent Coding**? Check out [my YouTube](https://www.youtube.com/@ZacharyLLM?sub_confirmation=1)! + +- Want to build your own LLM App? Start with [this template](https://github.com/The-Pocket/PocketFlow-Template-Python)! + ## How does Pocket Flow work? @@ -64,43 +98,6 @@ From there, it’s easy to implement popular design patterns like ([Multi-](http -## How to Use Pocket Flow? - - -πŸš€ It's highly recommended to **build Agents with Agents**β€”the fastest development paradigm! - -- 😎 **Humans** craft the **high-level requirements and system design**. - -- πŸ€– **AI agents** (e.g., Cursor AI) handle the **low-level implementation**. - -Check out the video to see the process in action! - -
-
- - IMAGE ALT TEXT - -
-
- - -## What can Pocket Flow build? - -✨ Below are examples of LLM Apps: - -
- -| Formal App Name | Informal One-Liner |Difficulty | Learning Objectives | -| :------------- | :------------- | :-------------: | :--------------------- | -| [Ask AI Paul Graham](https://github.com/The-Pocket/Tutorial-YC-Partner) | Ask AI Paul Graham, in case you don't get in | β˜…β˜…β˜†
*Medium* | [RAG](https://the-pocket.github.io/PocketFlow/design_pattern/rag.html)
[Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html)
[Text-to-Speech](https://the-pocket.github.io/PocketFlow/utility_function/text_to_speech.html) | -| [Youtube Summarizer](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple) | Explain YouTube Videos to you like you're 5 | β˜…β˜†β˜†
*Beginner* | [Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html) | -| [Cold Opener Generator](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization) | Instant icebreakers that turn cold leads hot | β˜…β˜†β˜†
*Beginner* | [Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html)
[Web Search](https://the-pocket.github.io/PocketFlow/utility_function/websearch.html) | - -
- -- Want to learn how I built these LLM Apps? Check out [my YouTube](https://www.youtube.com/@ZacharyLLM?sub_confirmation=1)! - -- Want to create your own Python project? Start with [this template](https://github.com/The-Pocket/PocketFlow-Template-Python)! From 40031ed2433dd06ecd4b2c25652afa509cce4dc8 Mon Sep 17 00:00:00 2001 From: Zachary Huang <33015448+zachary62@users.noreply.github.com> Date: Fri, 14 Mar 2025 19:34:11 -0400 Subject: [PATCH 2/4] Update README.md --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 89df12f..c0b8590 100644 --- a/README.md +++ b/README.md @@ -68,11 +68,11 @@ Current LLM frameworks are bloated... You only need 100 lines for LLM Framework!
-| Formal App Name | Informal One-Liner | Difficulty | Topics | Human
Design | Agent
Code | -| :------------- | :------------- | :-------------: | :---------------------: | :---: | :---: | -| [Ask AI Paul Graham](https://github.com/The-Pocket/Tutorial-YC-Partner) | Ask AI Paul Graham, in case you don't get in | β˜…β˜…β˜†
*Medium* | [RAG](https://the-pocket.github.io/PocketFlow/design_pattern/rag.html)
[Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html)
[TTS](https://the-pocket.github.io/PocketFlow/utility_function/text_to_speech.html) | [Design](https://github.com/The-Pocket/Tutorial-AI-Paul-Graham/blob/main/docs/design.md) | [Code](https://github.com/The-Pocket/Tutorial-AI-Paul-Graham/blob/main/flow.py) -| [Youtube Summarizer](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple) | Explain YouTube Videos to you like you're 5 | β˜…β˜†β˜†
*Beginner* | [Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html) | [Design](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple/blob/main/docs/design.md) | [Code](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple/blob/main/flow.py) -| [Cold Opener Generator](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization) | Instant icebreakers that turn cold leads hot | β˜…β˜†β˜†
*Beginner* | [Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html)
[Web Search](https://the-pocket.github.io/PocketFlow/utility_function/websearch.html) | [Design](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization/blob/master/docs/design.md) | [Code](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization/blob/master/flow.py) +| App Name | Difficulty | Topics | Human
Design | Agent
Code | +| :-------------: | :-------------: | :---------------------: | :---: | :---: | +| [Ask AI Paul Graham](https://github.com/The-Pocket/Tutorial-YC-Partner)
Ask AI Paul Graham, in case you don't get in | β˜…β˜…β˜†
*Medium* | [RAG](https://the-pocket.github.io/PocketFlow/design_pattern/rag.html)
[Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html)
[TTS](https://the-pocket.github.io/PocketFlow/utility_function/text_to_speech.html) | [Design](https://github.com/The-Pocket/Tutorial-AI-Paul-Graham/blob/main/docs/design.md) | [Code](https://github.com/The-Pocket/Tutorial-AI-Paul-Graham/blob/main/flow.py) +| [Youtube Summarizer](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple)
Explain YouTube Videos to you like you're 5 | β˜…β˜†β˜†
*Beginner* | [Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html) | [Design](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple/blob/main/docs/design.md) | [Code](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple/blob/main/flow.py) +| [Cold Opener Generator](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization)
Instant icebreakers that turn cold leads hot | β˜…β˜†β˜†
*Beginner* | [Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html)
[Web Search](https://the-pocket.github.io/PocketFlow/utility_function/websearch.html) | [Design](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization/blob/master/docs/design.md) | [Code](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization/blob/master/flow.py)
From fcbba71929938899ddac1f24b9134d5b1f9edcae Mon Sep 17 00:00:00 2001 From: Zachary Huang <33015448+zachary62@users.noreply.github.com> Date: Fri, 14 Mar 2025 19:35:09 -0400 Subject: [PATCH 3/4] Update README.md --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index c0b8590..da0fe82 100644 --- a/README.md +++ b/README.md @@ -68,11 +68,11 @@ Current LLM frameworks are bloated... You only need 100 lines for LLM Framework!
-| App Name | Difficulty | Topics | Human
Design | Agent
Code | +| App Name | Difficulty | Topics | Human Design | Agent Code | | :-------------: | :-------------: | :---------------------: | :---: | :---: | -| [Ask AI Paul Graham](https://github.com/The-Pocket/Tutorial-YC-Partner)
Ask AI Paul Graham, in case you don't get in | β˜…β˜…β˜†
*Medium* | [RAG](https://the-pocket.github.io/PocketFlow/design_pattern/rag.html)
[Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html)
[TTS](https://the-pocket.github.io/PocketFlow/utility_function/text_to_speech.html) | [Design](https://github.com/The-Pocket/Tutorial-AI-Paul-Graham/blob/main/docs/design.md) | [Code](https://github.com/The-Pocket/Tutorial-AI-Paul-Graham/blob/main/flow.py) -| [Youtube Summarizer](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple)
Explain YouTube Videos to you like you're 5 | β˜…β˜†β˜†
*Beginner* | [Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html) | [Design](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple/blob/main/docs/design.md) | [Code](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple/blob/main/flow.py) -| [Cold Opener Generator](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization)
Instant icebreakers that turn cold leads hot | β˜…β˜†β˜†
*Beginner* | [Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html)
[Web Search](https://the-pocket.github.io/PocketFlow/utility_function/websearch.html) | [Design](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization/blob/master/docs/design.md) | [Code](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization/blob/master/flow.py) +| [Ask AI Paul Graham](https://github.com/The-Pocket/Tutorial-YC-Partner)
Ask AI Paul Graham, in case you don't get in | β˜…β˜…β˜†
*Medium* | [RAG](https://the-pocket.github.io/PocketFlow/design_pattern/rag.html)
[Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html)
[TTS](https://the-pocket.github.io/PocketFlow/utility_function/text_to_speech.html) | [Design Doc](https://github.com/The-Pocket/Tutorial-AI-Paul-Graham/blob/main/docs/design.md) | [Flow Code](https://github.com/The-Pocket/Tutorial-AI-Paul-Graham/blob/main/flow.py) +| [Youtube Summarizer](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple)
Explain YouTube Videos to you like you're 5 | β˜…β˜†β˜†
*Beginner* | [Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html) | [Design Doc](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple/blob/main/docs/design.md) | [Flow Code](https://github.com/The-Pocket/Tutorial-Youtube-Made-Simple/blob/main/flow.py) +| [Cold Opener Generator](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization)
Instant icebreakers that turn cold leads hot | β˜…β˜†β˜†
*Beginner* | [Map Reduce](https://the-pocket.github.io/PocketFlow/design_pattern/mapreduce.html)
[Web Search](https://the-pocket.github.io/PocketFlow/utility_function/websearch.html) | [Design Doc](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization/blob/master/docs/design.md) | [Flow Code](https://github.com/The-Pocket/Tutorial-Cold-Email-Personalization/blob/master/flow.py)
From 2953a595bf63aa05511ce7d849c0d2e334477094 Mon Sep 17 00:00:00 2001 From: Zachary Huang <33015448+zachary62@users.noreply.github.com> Date: Fri, 14 Mar 2025 19:40:54 -0400 Subject: [PATCH 4/4] Update README.md --- README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/README.md b/README.md index da0fe82..c5d91ac 100644 --- a/README.md +++ b/README.md @@ -35,9 +35,7 @@ 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 | -| LlamaIndex | Agent, Graph | Native for RAG
(Summarization, KG Indexing) | Many [Optional]
(e.g., OpenAI, Pinecone, etc.) | 77K
(core-only) | +189MB
(core-only) | | CrewAI | Agent, Chain | Many
(e.g., FileReadTool, SerperDevTool) | Many
(e.g., OpenAI, Anthropic, Pinecone, etc.) | 18K | +173MB | -| Haystack | Agent, Graph | Many
(e.g., QA, Summarization) | Many
(e.g., OpenAI, Anthropic, Pinecone, etc.) | 31K | +195MB | | 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) |