Quickstart
Get RagGo running and searching your documents in under 10 minutes.
RagGo supports Windows 10/11 (x64), Linux (x64, glibc 2.17+), and macOS 12+ (Universal binary).
Step 1 — Download
Head to your dashboard downloads page and grab the archive for your platform. If you're on the free tier, you can also download from the download page.
Step 2 — Extract and run
# Extract the zip archive, then double-click:
raggo-launcher.exe
Python 3.12 is bundled — no separate installation required.
# Install Python 3.12 first (e.g. Ubuntu/Debian):
sudo apt install python3.12 python3.12-venv
# Extract and run:
tar xzf raggo-linux-x64-pyc-v*.tar.gz
cd raggo-linux-x64-pyc-v*
./start-raggo.sh
# Install Python 3.12 first:
brew install [email protected]
# Extract and run:
unzip raggo-macos-universal-pyc-v*.zip
cd raggo-macos-universal-pyc-v*
./start-raggo-macos.sh
Step 3 — Auto-setup
On first run, RagGo installs Python dependencies (~200 MB, 2–3 minutes, requires internet). This only happens once. Once ready, the Web UI is available at http://localhost:3235/ui/.
Step 4 — Ingest documents
Open the Web UI at http://127.0.0.1:3235/ui/ingest. You can upload files directly or specify a directory path to ingest. RagGo will chunk, embed, and store everything locally.
Step 5 — Search
Web UI: Open http://127.0.0.1:3235/ui/search to search your documents and code.
MCP: Connect your MCP client (Claude, Cursor, etc.) to http://127.0.0.1:3235/mcp. See the MCP integration guide.
Activate your license (paid plans)
If you have a paid plan, open the Web UI at http://127.0.0.1:3235/ui/license and enter your email address and activation code (found on your licenses page). This unlocks unlimited ingestion, all file types, GraphRAG, and more.
Next: See Document Ingestion for details on supported file types, chunking settings, and MCP ingestion tools.