Docs / Quickstart

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.