diff --git a/README.md b/README.md
index 38af3e9..e247afb 100644
--- a/README.md
+++ b/README.md
@@ -58,20 +58,20 @@ Requires: Go 1.24+, Node.js 18+, CGO-compatible compiler
 
 **macOS:**
 ```bash
-brew install python3
-pip3 install uvx
+brew install python@3.13
+pip3 install uv
 ```
 
 **Linux (Ubuntu/Debian):**
 ```bash
 sudo apt install python3 python3-pip
-pip3 install uvx
+pip3 install uv
 ```
 
 **Windows:**
 ```powershell
-winget install Python.Python.3
-pip install uvx
+winget install Python.Python.3.13
+pip install uv
 ```
 
 Note: Requires Python 3.13+. Most package managers install the latest version.
diff --git a/docs/src/App.vue b/docs/src/App.vue
index aa6122f..96ad4ba 100644
--- a/docs/src/App.vue
+++ b/docs/src/App.vue
@@ -253,17 +253,17 @@
             <div class="bg-slate-800/50 rounded-lg p-3">
               <p class="text-slate-400 mb-2">macOS</p>
               <code class="text-amber-400">brew install python3</code><br>
-              <code class="text-amber-400">pip3 install uvx</code>
+              <code class="text-amber-400">pip3 install uv</code>
             </div>
             <div class="bg-slate-800/50 rounded-lg p-3">
               <p class="text-slate-400 mb-2">Linux</p>
               <code class="text-amber-400">apt install python3</code><br>
-              <code class="text-amber-400">pip3 install uvx</code>
+              <code class="text-amber-400">pip3 install uv</code>
             </div>
             <div class="bg-slate-800/50 rounded-lg p-3">
               <p class="text-slate-400 mb-2">Windows</p>
               <code class="text-amber-400">winget install Python.Python.3</code><br>
-              <code class="text-amber-400">pip install uvx</code>
+              <code class="text-amber-400">pip install uv</code>
             </div>
           </div>
           <p class="text-slate-500 text-xs mt-3">
@@ -468,7 +468,7 @@ const requiredDeps = [
 
 const optionalDeps = [
   { name: 'Python 3.13+', description: 'Required for ChromaDB semantic search. Natural language queries like "that auth bug" work.', icon: 'fab fa-python' },
-  { name: 'uvx', description: 'Python package runner for ChromaDB MCP server.', icon: 'fas fa-box' },
+  { name: 'uv', description: 'Python package manager for ChromaDB MCP server. Provides the uvx command.', icon: 'fas fa-box' },
 ]
 
 const faqs = [