Skip to main content

​
What is Moorcheh On-Prem?

Moorcheh On-Prem runs on your machine: semantic search over text documents and precomputed vectors. Text embeddings use Ollama (local), OpenAI, or Cohere — configured once with moorcheh configure or on first moorcheh up. You install moorcheh-client from PyPI, start the stack with one command, and call the API from your app or the CLI.
On-prem has no Moorcheh cloud API keys. If you use OpenAI or Cohere for embeddings, your provider API key is stored locally in ~/.moorcheh/config.json. Ollama needs no API key.

​
What you can do

  • Create text namespaces (documents embedded via your configured provider) or vector namespaces (you supply vectors)
  • Upload text documents by id, or upload files (PDF, DOCX, etc.) from ~/.moorcheh/uploads
  • Upload, get, and delete items by id; list and delete indexed files separately
  • Semantic search across one or more namespaces (top hit can include batch summary_text)
  • AI Answer — RAG or direct LLM via POST /answer (Ollama, OpenAI, or Cohere)
  • Check global storage quota via /health

​
Prerequisites

  • Python 3.10+
  • Docker (Desktop or Engine) — works on Windows, macOS (Intel and Apple Silicon), and Linux
  • Embedding provider for text workflows — Ollama, OpenAI, or Cohere (Ollama is optional if you use cloud embeddings or vector-only)

​
Install and run

See Quickstart for a full upload-and-search walkthrough.
Config vs runtime: moorcheh configure writes ~/.moorcheh/config.json only. To apply new embedding or LLM settings to a server that is already running, use moorcheh down then moorcheh up. If you already have data under ~/.moorcheh/data, changing the embedding model can break text search and RAG until you re-upload — see Embedding providers.

​
Limits

  • Unlimited namespaces - no cloud-tier namespace count limit; create as many text or vector namespaces as you need
  • 100,000 items total across all namespaces (text + vectors)
  • Item ids are unique per namespace (the same id string may exist in different namespaces)
  • Get/delete by id: at most 100 ids per request

​
Documentation

​
Data persistence

Vectors and documents are stored under:
moorcheh down stops containers but does not delete this folder. Back up ~/.moorcheh to save everything. File upload indexes content from uploads/; deleting an index does not remove files on disk.