Skip to main content

Installation

Prerequisites​

  • Node.js 22+
No Docker required

Qdrant is built-in — TeaRAGs automatically downloads and manages a Qdrant binary. Docker is only needed if you prefer to run Qdrant externally.

Install​

# Clone and install
git clone https://github.com/artk0de/TeaRAGs-MCP.git
cd TeaRAGs-MCP
npm install

# Build
npm run build

Qdrant starts automatically on first use. You only need an embedding provider (Ollama recommended):

# Install and pull the default embedding model
ollama pull unclemusclez/jina-embeddings-v2-base-code:latest
Using Docker for Qdrant (optional, advanced)

If you prefer external Qdrant via Docker:

# Start Qdrant + Ollama via Docker Compose
podman compose up -d   # or: docker compose up -d

# Pull the embedding model
podman exec ollama ollama pull unclemusclez/jina-embeddings-v2-base-code:latest
# or: docker exec ollama ollama pull unclemusclez/jina-embeddings-v2-base-code:latest

TeaRAGs will autodetect Qdrant on localhost:6333 and use it instead of the embedded version.

Next Steps​