RagGo - macOS Edition (v0.9.52)

Supports: Intel (x64) and Apple Silicon (arm64) — native on both.

Quick Start
-----------
No terminal: double-click RagGo.app
Terminal:    ./start-raggo-macos.sh

First run installs Python dependencies (~200MB, 2-3 min) automatically.

Requirements
------------
Python 3.12    (brew install python@3.12)
macOS 12+
Internet connection (first run only)

Access
------
Web UI:   http://localhost:3235/ui/
MCP API:  http://localhost:3235/mcp

Architecture Support
--------------------
This package contains binaries for both Intel and Apple Silicon.
The launcher automatically selects the correct binary at runtime.
No Rosetta 2 required on Apple Silicon Macs.

What's Inside
-------------
RagGo.app             Double-click launcher
start-raggo-macos.sh  Terminal launcher
start-raggo-bg.sh     Background launcher
bin/raggo             Auto-picks amd64 or arm64 at runtime
bin/qdrant            Vector database (auto-picks arch)
python_service/       Python gRPC microservice
web/                  Web UI assets
scripts/              Helper scripts (install-python-deps, etc.)
.env                  Configuration

Gatekeeper
----------
macOS may block unsigned binaries. To allow:
  Right-click RagGo.app -> Open -> Open
  Or: xattr -dr com.apple.quarantine .

Troubleshooting
---------------
"Python not found"    -> brew install python@3.12
Port in use           -> Edit .env, change MCP_SERVER_PORT
Setup stuck           -> Check internet; try: rm -rf .venv && ./start-raggo-macos.sh
Services won't start  -> Check logs/raggo-go.log and logs/raggo-python.log

Enjoy using RagGo!
