macOS / Linux
Section titled “macOS / Linux”curl -fsSL https://raw.githubusercontent.com/srimon12/qql-go/main/install.sh | shWindows (PowerShell)
Section titled “Windows (PowerShell)”irm https://raw.githubusercontent.com/srimon12/qql-go/main/install.ps1 | iexGo Install
Section titled “Go Install”go install github.com/srimon12/qql-go/cmd/qql-go@latestFrom Source
Section titled “From Source”git clone https://github.com/srimon12/qql-go.git cd qql-go go build -o qql-go ./cmd/qql-goVerify Installation
Section titled “Verify Installation”qql-go version qql-go doctorBinary Name
Section titled “Binary Name”| Platform | Binary name |
|---|---|
| macOS / Linux | qql-go |
| Windows | qql-go.exe |
PATH Setup
Section titled “PATH Setup”The install script puts the binary on your PATH automatically. If you installed somewhere custom, set the QQL_BIN environment variable to the absolute path. The CLI checks: QQL_BIN env var → qql-go on $PATH → repo-local fallback.
export QQL_BIN=/absolute/path/to/qql-go$env:QQL_BIN = "C:\path\to\qql-go.exe"Prerequisites
Section titled “Prerequisites”| Requirement | Notes |
|---|---|
| Go 1.24+ | Only needed if building from source or using go install |
| Qdrant instance | Docker, native, or Qdrant Cloud |
| Embedding server | Only needed for --inference-mode local or external |
Start Qdrant with Docker
Section titled “Start Qdrant with Docker”docker run -p 6333:6333 -p 6334:6334 qdrant/qdrantNext Steps
Section titled “Next Steps”→ Quickstart — connect, create, insert, and query in 60 seconds
→ Configuration — set up inference modes and config file