Installation

Platform-specific installation instructions for RagGo.

Requires: Windows 10 or 11, x64. Python 3.12 is bundled — no separate installation required.

# Extract the zip archive, then double-click:
raggo-launcher.exe

For troubleshooting, run raggo-launcher.exe from a command prompt to see error output.

On first run, the launcher installs Python packages (~200 MB, requires internet). This only happens once. Once ready, the Web UI opens at http://localhost:3235/ui/.

How to stop

Run scripts\stop-raggo.ps1, or end raggo.exe in Task Manager.

Requires: x64, glibc 2.17+ (Ubuntu 16.04+, Debian 9+, RHEL 7+, Fedora 20+)

Install Python 3.12 first

# Ubuntu / Debian
sudo apt install python3.12 python3.12-venv

# Fedora / RHEL
sudo dnf install python3.12 python3.12-pip

# Arch Linux
sudo pacman -S python python-pip

Extract and run

tar xzf raggo-linux-x64-pyc-v*.tar.gz
cd raggo-linux-x64-pyc-v*
./start-raggo.sh

Or double-click raggo.desktop for a no-terminal launcher.

On first run, RagGo installs Python dependencies (~200 MB, requires internet). This only happens once. Once ready, the Web UI opens at http://localhost:3235/ui/.

How to stop

Press Ctrl+C in the terminal, or run scripts/stop-raggo.sh.

Requires: macOS 12+ (Universal binary — Intel and Apple Silicon, no Rosetta 2 required)

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

Or double-click RagGo.app. macOS may show a Gatekeeper warning — right-click the app, click “Open”, then click “Open” again.

On first run, RagGo installs Python dependencies (~200 MB, requires internet). This only happens once. Once ready, the Web UI opens at http://localhost:3235/ui/.

How to stop

Press Ctrl+C in the terminal, or run scripts/stop-raggo.sh.

Activating your license

After purchasing a paid plan, open the RagGo Web UI at http://127.0.0.1:3235/ui/license and enter your email address and activation code (found on your dashboard licenses page).

The license is stored locally on your machine and unlocks paid features immediately. See License Activation for full details.

Configuration

RagGo's configuration lives in a .env file in the project directory. Key settings:

# Server
SERVER_HOST=127.0.0.1
SERVER_PORT=3235

# Qdrant
QDRANT_HOST=127.0.0.1
QDRANT_PORT=6334

# Embedding model (local, no API key needed)
EMBEDDING_MODEL=intfloat/multilingual-e5-small

# MCP transport (http or stdio)
MCP_SERVER_TRANSPORT=http

Security note: Changing SERVER_HOST to 0.0.0.0 exposes the Web UI and MCP endpoint on your LAN. Use a firewall or reverse proxy with authentication for team deployments.

Uninstall

To uninstall RagGo, simply delete the directory where you extracted it. Your ingested data is stored in the data/ subdirectory within the RagGo folder — delete it to remove all indexes and documents.