From b07d01398e8496d42c6a7505c5a2ca4e6b9af310 Mon Sep 17 00:00:00 2001
From: Chandrasekharan M <chandrasekharan@zipstack.com>
Date: Mon, 16 Feb 2026 19:11:16 +0530
Subject: [PATCH] Update README installation section to recommend uv tool and
 pipx

---
 README.md | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 538d18f..aab2b1f 100644
--- a/README.md
+++ b/README.md
@@ -10,16 +10,26 @@ Command-line tool for the [mfbt](https://mfbt.ai) platform. Provides both an int
 - **Real-time Updates** -- WebSocket-powered job monitoring and status tracking
 - **Agent Orchestration** -- Auto-invoke coding agents to implement pending features with `mfbt ralph`
 
-## Requirements
+## Installation
 
-- Python 3.10+
+### Recommended
 
-## Installation
+```bash
+# Using uv (no Python required)
+uv tool install mfbt-cli
+
+# Using pipx
+pipx install mfbt-cli
+```
+
+### Alternative
 
 ```bash
 pip install mfbt-cli
 ```
 
+Requires Python 3.10+. Using `uv tool install` or `pipx` is preferred as they handle isolation and PATH setup automatically.
+
 ## Quick Start
 
 ```bash