Upload folder using huggingface_hub

README.md

@@ -1,7 +1,16 @@
+---
+title: Email Classifier Agent
+emoji: 🤖
+colorFrom: blue
+colorTo: indigo
+sdk: docker
+pinned: false
+app_port: 7860
+---
 > **Read the full interactive version:**  
-> This repository is part of **AI Agents From Scratch** - a hands-on learning series where we build AI agents *step by step*, explain every design decision, and visualize what’s happening under the hood.  
+> This repository is part of **AI Agents From Scratch** - a hands-on learning series where we build AI agents *step by step*, explain every design decision, and visualize what’s happening under the hood.  
 >  
-> 👉 **https://agentsfromscratch.com**  
+> 👉 **https://agentsfromscratch.com**  
 >  
 > If you prefer **long-form explanations, diagrams, and conceptual deep dives**, start there - then come back here to explore the code.
 
@@ -38,7 +47,7 @@ Learn AI product development fundamentals with local LLMs. Covers prompt enginee
 ## Next Phase: Build LangChain & LangGraph Concepts From Scratch
 
 > After mastering the fundamentals, the next stage of this project walks you through **re-implementing the core parts of LangChain and LangGraph** in plain JavaScript using local models.
-> This is **not** about building a new framework, it’s about understanding *how frameworks work*.  
+> This is **not** about building a new framework, it’s about understanding *how frameworks work*.  
 
 ## Phase 1: Agent Fundamentals - From LLMs to ReAct
 
@@ -170,7 +179,7 @@ Follow these examples in order to build understanding progressively:
 `react-agent/` | [Code](examples/09_react-agent/react-agent.js) | [Code Explanation](examples/09_react-agent/CODE.md) | [Concepts](examples/09_react-agent/CONCEPT.md)
 
 **What you'll learn:**
-- ReAct pattern (Reason → Act → Observe)
+- ReAct pattern (Reason → Act → Observe)
 - Iterative problem solving
 - Step-by-step tool use
 - Self-correction loops
@@ -216,52 +225,52 @@ Each example folder contains:
 
 ```
 AI Agent = LLM + System Prompt + Tools + Memory + Reasoning Pattern
-           ─┬─   ──────┬──────   ──┬──   ──┬───   ────────┬────────
-            │          │           │       │              │
+           ─┬─   ──────┬──────   ──┬──   ──┬───   ────────┬────────
+            │          │           │       │              │
          Brain      Identity    Hands   State         Strategy
 ```
 
 ### Evolution of Capabilities
 
 ```
-1. intro          → Basic LLM usage
-2. translation    → Specialized behavior (system prompts)
-3. think          → Reasoning ability
-4. batch          → Parallel processing
-5. coding         → Streaming & control
-6. simple-agent   → Tool use (function calling)
-7. memory-agent   → Persistent state
-8. react-agent    → Strategic reasoning + tool use
+1. intro          → Basic LLM usage
+2. translation    → Specialized behavior (system prompts)
+3. think          → Reasoning ability
+4. batch          → Parallel processing
+5. coding         → Streaming & control
+6. simple-agent   → Tool use (function calling)
+7. memory-agent   → Persistent state
+8. react-agent    → Strategic reasoning + tool use
 ```
 
 ### Architecture Patterns
 
 **Simple Agent (Steps 1-5)**
 ```
-User → LLM → Response
+User → LLM → Response
 ```
 
 **Tool-Using Agent (Step 6)**
 ```
-User → LLM ⟷ Tools → Response
+User → LLM ⟷ Tools → Response
 ```
 
 **Memory Agent (Step 7)**
 ```
-User → LLM ⟷ Tools → Response
-       ↕
+User → LLM ⟷ Tools → Response
+       ↕
      Memory
 ```
 
 **ReAct Agent (Step 8)**
 ```
-User → LLM → Think → Act → Observe
-       ↑      ↓      ↓      ↓
-       └──────┴──────┴──────┘
+User → LLM → Think → Act → Observe
+       ↑      ↓      ↓      ↓
+       └──────┴──────┴──────┘
            Iterate until solved
 ```
 
-## ️ Helper Utilities
+## ️ Helper Utilities
 
 ### PromptDebugger
 `helper/prompt-debugger.js`
@@ -274,53 +283,53 @@ Utility for debugging prompts sent to the LLM. Shows exactly what the model sees
 
 Usage example in `simple-agent/simple-agent.js`
 
-## ️ Project Structure - Fundamentals
+## ️ Project Structure - Fundamentals
 
 ```
 ai-agents/
-├── README.md                          ← You are here
-├─ examples/
-├── 01_intro/
-│   ├── intro.js
-│   ├── CODE.md
-│   └── CONCEPT.md
-├── 02_openai-intro/
-│   ├── openai-intro.js
-│   ├── CODE.md
-│   └── CONCEPT.md
-├── 03_translation/
-│   ├── translation.js
-│   ├── CODE.md
-│   └── CONCEPT.md
-├── 04_think/
-│   ├── think.js
-│   ├── CODE.md
-│   └── CONCEPT.md
-├── 05_batch/
-│   ├── batch.js
-│   ├── CODE.md
-│   └── CONCEPT.md
-├── 06_coding/
-│   ├── coding.js
-│   ├── CODE.md
-│   └── CONCEPT.md
-├── 07_simple-agent/
-│   ├── simple-agent.js
-│   ├── CODE.md
-│   └── CONCEPT.md
-├── 08_simple-agent-with-memory/
-│   ├── simple-agent-with-memory.js
-│   ├── memory-manager.js
-│   ├── CODE.md
-│   └── CONCEPT.md
-├── 09_react-agent/
-│   ├── react-agent.js
-│   ├── CODE.md
-│   └── CONCEPT.md
-├── helper/
-│   └── prompt-debugger.js
-├── models/                             ← Place your GGUF models here
-└── logs/                               ← Debug outputs
+├── README.md                          ← You are here
+├─ examples/
+├── 01_intro/
+│   ├── intro.js
+│   ├── CODE.md
+│   └── CONCEPT.md
+├── 02_openai-intro/
+│   ├── openai-intro.js
+│   ├── CODE.md
+│   └── CONCEPT.md
+├── 03_translation/
+│   ├── translation.js
+│   ├── CODE.md
+│   └── CONCEPT.md
+├── 04_think/
+│   ├── think.js
+│   ├── CODE.md
+│   └── CONCEPT.md
+├── 05_batch/
+│   ├── batch.js
+│   ├── CODE.md
+│   └── CONCEPT.md
+├── 06_coding/
+│   ├── coding.js
+│   ├── CODE.md
+│   └── CONCEPT.md
+├── 07_simple-agent/
+│   ├── simple-agent.js
+│   ├── CODE.md
+│   └── CONCEPT.md
+├── 08_simple-agent-with-memory/
+│   ├── simple-agent-with-memory.js
+│   ├── memory-manager.js
+│   ├── CODE.md
+│   └── CONCEPT.md
+├── 09_react-agent/
+│   ├── react-agent.js
+│   ├── CODE.md
+│   └── CONCEPT.md
+├── helper/
+│   └── prompt-debugger.js
+├── models/                             ← Place your GGUF models here
+└── logs/                               ← Debug outputs
 ```
 
 ## Phase 2: Building a Production Framework (Tutorial)
@@ -348,46 +357,46 @@ A lightweight but complete agent framework with:
 
 ```
 tutorial/
-├── 01-foundation/              # 1. Core Abstractions
-│   ├── 01-runnable/
-│   │   ├── lesson.md           # Why Runnable matters
-│   │   ├── exercises/          # Hands-on practice
-│   │   └── solutions/          # Reference implementations
-│   ├── 02-messages/            # Structuring conversations
-│   ├── 03-llm-wrapper/         # Wrapping node-llama-cpp
-│   └── 04-context/             # Configuration & callbacks
-│
-├── 02-composition/             # 2. Building Chains
-│   ├── 01-prompts/             # Template system
-│   ├── 02-parsers/             # Structured outputs
-│   ├── 03-llm-chain/           # Your first chain
-│   ├── 04-piping/              # Composition patterns
-│   └── 05-memory/              # Conversation state
-│
-├── 03-agency/                  # 3. Tools & Agents
-│   ├── 01-tools/               # Function definitions
-│   ├── 02-tool-executor/       # Safe execution
-│   ├── 03-simple-agent/        # Basic agent loop
-│   ├── 04-react-agent/         # Reasoning + Acting
-│   └── 05-structured-agent/    # JSON mode
-│
-└── 04-graphs/                  # 4. State Machines
-    ├── 01-state-basics/        # Nodes & edges
-    ├── 02-channels/            # State management
-    ├── 03-conditional-edges/   # Dynamic routing
-    ├── 04-executor/            # Running workflows
-    ├── 05-checkpointing/       # Persistence
-    └── 06-agent-graph/         # Agents as graphs
+├── 01-foundation/              # 1. Core Abstractions
+│   ├── 01-runnable/
+│   │   ├── lesson.md           # Why Runnable matters
+│   │   ├── exercises/          # Hands-on practice
+│   │   └── solutions/          # Reference implementations
+│   ├── 02-messages/            # Structuring conversations
+│   ├── 03-llm-wrapper/         # Wrapping node-llama-cpp
+│   └── 04-context/             # Configuration & callbacks
+│
+├── 02-composition/             # 2. Building Chains
+│   ├── 01-prompts/             # Template system
+│   ├── 02-parsers/             # Structured outputs
+│   ├── 03-llm-chain/           # Your first chain
+│   ├── 04-piping/              # Composition patterns
+│   └── 05-memory/              # Conversation state
+│
+├── 03-agency/                  # 3. Tools & Agents
+│   ├── 01-tools/               # Function definitions
+│   ├── 02-tool-executor/       # Safe execution
+│   ├── 03-simple-agent/        # Basic agent loop
+│   ├── 04-react-agent/         # Reasoning + Acting
+│   └── 05-structured-agent/    # JSON mode
+│
+└── 04-graphs/                  # 4. State Machines
+    ├── 01-state-basics/        # Nodes & edges
+    ├── 02-channels/            # State management
+    ├── 03-conditional-edges/   # Dynamic routing
+    ├── 04-executor/            # Running workflows
+    ├── 05-checkpointing/       # Persistence
+    └── 06-agent-graph/         # Agents as graphs
 
 src/
-├── core/                       # Runnable, Messages, Context
-├── llm/                        # LlamaCppLLM wrapper
-├── prompts/                    # Template system
-├── chains/                     # LLMChain, SequentialChain
-├── tools/                      # BaseTool, built-in tools
-├── agents/                     # AgentExecutor, ReActAgent
-├── memory/                     # BufferMemory, WindowMemory
-└── graph/                      # StateGraph, CompiledGraph
+├── core/                       # Runnable, Messages, Context
+├── llm/                        # LlamaCppLLM wrapper
+├── prompts/                    # Template system
+├── chains/                     # LLMChain, SequentialChain
+├── tools/                      # BaseTool, built-in tools
+├── agents/                     # AgentExecutor, ReActAgent
+├── memory/                     # BufferMemory, WindowMemory
+└── graph/                      # StateGraph, CompiledGraph
 ```
 
 ### Why This Matters
@@ -407,7 +416,7 @@ src/
 
 ### Getting Started with Phase 2
 
-After completing the fundamentals (intro → react-agent), start the tutorial:
+After completing the fundamentals (intro → react-agent), start the tutorial:
 
 [Overview](tutorial/README.md)
 
@@ -497,8 +506,10 @@ Educational resource - use and modify as needed for learning.
 
 ---
 
-**Built with ❤️ for people who want to truly understand AI agents**
+**Built with ❤️ for people who want to truly understand AI agents**
 
 Start with `intro/` and work your way through. Each example builds on the previous one. Read both CODE.md and CONCEPT.md for full understanding.
 
 Happy learning! 
+
+