From c9049f2adb805c45f79b878ccfdb087b2228f059 Mon Sep 17 00:00:00 2001 From: zachary62 Date: Fri, 4 Apr 2025 13:32:10 -0400 Subject: [PATCH] add nav --- docs/_config.yml | 2 +- docs/design.md | 6 +++++ docs/index.md | 70 +++++++++--------------------------------------- 3 files changed, 20 insertions(+), 58 deletions(-) diff --git a/docs/_config.yml b/docs/_config.yml index 34f65f0..e3c3d17 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -1,5 +1,5 @@ # Basic site settings -title: Turns Codebase into Easy Tutorial +title: Codebase to Tutorial # Theme settings remote_theme: just-the-docs/just-the-docs diff --git a/docs/design.md b/docs/design.md index 61c60ab..9662b2b 100644 --- a/docs/design.md +++ b/docs/design.md @@ -1,3 +1,9 @@ +--- +layout: default +title: "Design" +nav_order: 2 +--- + # Design Doc: Your Project Name > Please DON'T remove notes for AI diff --git a/docs/index.md b/docs/index.md index a56a48c..d308438 100644 --- a/docs/index.md +++ b/docs/index.md @@ -4,66 +4,22 @@ title: "Home" nav_order: 1 --- -# Pocket Flow +# Turns Codebase into Easy Tutorial -A [100-line](https://github.com/the-pocket/PocketFlow/blob/main/pocketflow/__init__.py) minimalist LLM framework for *Agents, Task Decomposition, RAG, etc*. +Ever stared at a new codebase written by others feeling completely lost? This project analyzes GitHub repositories and creates beginner-friendly tutorials explaining exactly how the code works. -- **Lightweight**: Just the core graph abstraction in 100 lines. ZERO dependencies, and vendor lock-in. -- **Expressive**: Everything you love from larger frameworks—([Multi-](./design_pattern/multi_agent.html))[Agents](./design_pattern/agent.html), [Workflow](./design_pattern/workflow.html), [RAG](./design_pattern/rag.html), and more. -- **Agentic-Coding**: Intuitive enough for AI agents to help humans build complex LLM applications. +

+ + + +

-
- -
+Built with [Pocket Flow](https://github.com/The-Pocket/PocketFlow), a 100-line LLM framework. + +## Example Result -## Core Abstraction +- [Autogen Core](./AutoGen Core/index.md) -We model the LLM workflow as a **Graph + Shared Store**: - -- [Node](./core_abstraction/node.md) handles simple (LLM) tasks. -- [Flow](./core_abstraction/flow.md) connects nodes through **Actions** (labeled edges). -- [Shared Store](./core_abstraction/communication.md) enables communication between nodes within flows. -- [Batch](./core_abstraction/batch.md) nodes/flows allow for data-intensive tasks. -- [Async](./core_abstraction/async.md) nodes/flows allow waiting for asynchronous tasks. -- [(Advanced) Parallel](./core_abstraction/parallel.md) nodes/flows handle I/O-bound tasks. - -
- -
- -## Design Pattern - -From there, it’s easy to implement popular design patterns: - -- [Agent](./design_pattern/agent.md) autonomously makes decisions. -- [Workflow](./design_pattern/workflow.md) chains multiple tasks into pipelines. -- [RAG](./design_pattern/rag.md) integrates data retrieval with generation. -- [Map Reduce](./design_pattern/mapreduce.md) splits data tasks into Map and Reduce steps. -- [Structured Output](./design_pattern/structure.md) formats outputs consistently. -- [(Advanced) Multi-Agents](./design_pattern/multi_agent.md) coordinate multiple agents. - -
- -
- -## Utility Function - -We **do not** provide built-in utilities. Instead, we offer *examples*—please *implement your own*: - -- [LLM Wrapper](./utility_function/llm.md) -- [Viz and Debug](./utility_function/viz.md) -- [Web Search](./utility_function/websearch.md) -- [Chunking](./utility_function/chunking.md) -- [Embedding](./utility_function/embedding.md) -- [Vector Databases](./utility_function/vector.md) -- [Text-to-Speech](./utility_function/text_to_speech.md) - -**Why not built-in?**: I believe it's a *bad practice* for vendor-specific APIs in a general framework: -- *API Volatility*: Frequent changes lead to heavy maintenance for hardcoded APIs. -- *Flexibility*: You may want to switch vendors, use fine-tuned models, or run them locally. -- *Optimizations*: Prompt caching, batching, and streaming are easier without vendor lock-in. - -## Ready to build your Apps? - -Check out [Agentic Coding Guidance](./guide.md), the fastest way to develop LLM projects with Pocket Flow!