From 9c39b848f021138675d3952ee797455f70d761df Mon Sep 17 00:00:00 2001
From: Austin Godber <godber@uberhip.com>
Date: Thu, 2 Oct 2025 09:17:23 -0700
Subject: [PATCH] add macos notes

---
 README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README.md b/README.md
index 3596c4e..203480c 100644
--- a/README.md
+++ b/README.md
@@ -68,6 +68,18 @@ docker run -p 8050:8050 ghcr.io/godber/embedding-buddy:latest
 
 The application will be available at <http://127.0.0.1:8050>
 
+### macOS Installation Notes
+
+If installation fails with C++ compiler or library errors (common with `opentsne`), install Xcode Command Line Tools:
+
+```bash
+# Install or update Command Line Tools
+xcode-select --install
+
+# Or reset existing installation
+sudo xcode-select --reset
+```
+
 ### Using the Application
 
 1. **Open your browser** to <http://127.0.0.1:8050>