Vectraspace Docs
Beginner-friendly setup for local, private media search.
Quick Start
For most users, install once and run one command: vectraspace start.
Install (macOS/Linux)
curl -fsSL https://vectraspace.org/install.sh | bashInstall (Windows PowerShell)
irm https://vectraspace.org/install.ps1 | iexInstall with npm
npm i -g vectraspaceWhat Happens On Start
- Vectraspace validates Docker and your local config.
- It starts Qdrant, embedding host, and app in Docker.
- It waits for readiness checks.
- It opens Vectraspace in your browser.
Useful Commands
| Command | Purpose |
|---|---|
| vectraspace start | One-command startup for most users |
| vectraspace stop | Stop all running services |
| vectraspace logs | Show service logs |
| vectraspace doctor | Check your setup and configuration |
| vectraspace index | Reindex your media for semantic search |
| vectraspace search "query" | Find files by semantic meaning |
Health Check
Quickly verify if your local Vectraspace services are reachable.
App: Not checkedEmbedding: Not checked
- Run `vectraspace doctor` for a full diagnostics pass.
Terminal fallback:
vectraspace doctorTroubleshooting
If startup fails, run vectraspace doctor. On macOS, make sure your media folders are shared in Docker Desktop.