Merge pull request #2 from hjerpe/update-uv-run-commands

hjerpe · web-flow · commit 09de81a8077c · 2026-01-17T14:38:37.000+01:00
Update tutorials to use uv run command and remove WIP notice
diff --git a/README.md b/README.md
@@ -1,5 +1,3 @@
-> **Work in Progress**: This tutorial is actively being developed.
-
 > **Note**: This is a Python implementation of [How to Build a Coding Agent](https://github.com/ghuntley/how-to-build-a-coding-agent), originally created in Go by [Geoffrey Huntley](https://github.com/ghuntley).
 
 # How to Build a Python Coding Agent
@@ -21,7 +19,7 @@ uv pip install -r requirements.txt
 export ANTHROPIC_API_KEY="your-api-key-here"
 
 # 4. Run the final agent
-python agents/agent_06_search.py
+uv run python agents/agent_06_search.py
 ```
 
 ## Tutorial Structure
@@ -96,7 +94,7 @@ Each section includes:
 After completing all sections:
 
 ```bash
-python agents/agent_06_search.py
+uv run python agents/agent_06_search.py
 ```
 
 Try these prompts:
diff --git a/tutorial_materials/TUTORIAL_01_basic_chat.md b/tutorial_materials/TUTORIAL_01_basic_chat.md
@@ -225,7 +225,7 @@ After implementing, test your agent with these prompts:
 
 4. **Verbose mode**:
    ```bash
-   python agents/agent_01_chat.py --verbose
+   uv run python agents/agent_01_chat.py --verbose
    ```
    Expected: See debug output showing message counts and stop reasons.
 
diff --git a/tutorial_materials/TUTORIAL_02_read_file.md b/tutorial_materials/TUTORIAL_02_read_file.md
@@ -238,7 +238,7 @@ After implementing, test your agent:
 
 5. **Verbose mode**:
    ```bash
-   python agents/agent_02_read.py --verbose
+   uv run python agents/agent_02_read.py --verbose
    ```
    Then: "Read test_files/fizzbuzz.js"
    Expected: See debug output showing tool calls and results.
diff --git a/tutorial_materials/TUTORIAL_03_list_files.md b/tutorial_materials/TUTORIAL_03_list_files.md
@@ -448,7 +448,7 @@ After implementing, test your agent:
 
 5. **Verbose mode**:
    ```bash
-   python agents/agent_03_list_files.py --verbose
+   uv run python agents/agent_03_list_files.py --verbose
    ```
    Then: "List all files"
    Expected: See debug output for both list_files and any subsequent tool calls.
diff --git a/tutorial_materials/TUTORIAL_04_bash.md b/tutorial_materials/TUTORIAL_04_bash.md
@@ -249,7 +249,7 @@ Run the agent:
 
 ```bash
 cd /path/to/agents
-python agent_04_bash_exercise.py --verbose
+uv run python agent_04_bash_exercise.py --verbose
 ```
 
 **Test cases:**
@@ -327,7 +327,7 @@ After implementing, test your agent:
 
 7. **Verbose mode**:
    ```bash
-   python agents/agent_04_bash.py --verbose
+   uv run python agents/agent_04_bash.py --verbose
    ```
    Then: "Run pwd"
    Expected: See debug output including the exact command being executed.
diff --git a/tutorial_materials/TUTORIAL_05_edit_file.md b/tutorial_materials/TUTORIAL_05_edit_file.md
@@ -161,7 +161,7 @@ preview = old_str[:50] + "..." if len(old_str) > 50 else old_str
 Run the agent:
 
 ```bash
-python agent_05_edit_exercise.py --verbose
+uv run python agent_05_edit_exercise.py --verbose
 ```
 
 **Test cases:**
@@ -238,7 +238,7 @@ After implementing, test your agent:
 
 7. **Verbose mode**:
    ```bash
-   python agents/agent_05_edit.py --verbose
+   uv run python agents/agent_05_edit.py --verbose
    ```
    Then: Make an edit and observe the debug output.
 
diff --git a/tutorial_materials/TUTORIAL_06_code_search.md b/tutorial_materials/TUTORIAL_06_code_search.md
@@ -190,7 +190,7 @@ def code_search(
 Run the agent:
 
 ```bash
-python agent_06_search_exercise.py --verbose
+uv run python agent_06_search_exercise.py --verbose
 ```
 
 **Test cases demonstrating all 5 tools:**
@@ -314,7 +314,7 @@ After implementing, test your complete coding agent:
 
 8. **Verbose mode**:
    ```bash
-   python agents/agent_06_search.py --verbose
+   uv run python agents/agent_06_search.py --verbose
    ```
    Then: Run searches and observe the ripgrep commands.
 
