moorcheh-client 0.1.6

Moorcheh Community Edition: Free for single-node and non-commercial deployments.

The Information-Theoretic Search Engine for RAG & Agentic Memory - self-hosted on your infrastructure.

PyPI · Documentation · Contributing · Community License

Licensing: Moorcheh Community Edition is source-available and free for non-commercial and single-node self-hosted deployments (at most one active server node). If you need multi-node high availability, enterprise features, or commercial SaaS usage, see Moorcheh Enterprise or contact sales@moorcheh.ai.

Install

pip install moorcheh-client

Requirements: Python 3.10+, Docker, and an embedding provider (Ollama, OpenAI, or Cohere).

Quick start

moorcheh up          # first run prompts for embedding/LLM config
moorcheh status      # health + quota

API: http://localhost:8080 · Data: ~/.moorcheh/data

The moorcheh/server Docker image is governed by the same Community Edition license. The license file should be included at /LICENSE inside the server image and linked from the Docker Hub repository description.

from moorcheh import MoorchehClient

client = MoorchehClient("http://localhost:8080")

client.namespaces.create("docs", type="text")
job = client.documents.upload("docs", documents=[
    {"id": "doc-1", "text": "Hello from Moorcheh on-prem"},
])
# poll job["job_id"] until completed, then search or answer

results = client.similarity_search.query(
    namespaces=["docs"],
    query="Hello",
    top_k=5,
)

answer = client.answer.generate(
    namespace="docs",
    query="What is in my documents?",
)

moorcheh down        # stops containers; data is kept

CLI

Common commands: moorcheh up, moorcheh down, moorcheh status, moorcheh namespace-create, moorcheh upload-documents, moorcheh search, moorcheh answer.

Run moorcheh --help or see docs.moorcheh.ai/on-prem for the full CLI and API reference.

Project layout

Contributing

See CONTRIBUTING.md.

License

Moorcheh Community Edition License Agreement - free for single-node, non-commercial use. Not an OSI-approved open-source license. Enterprise licensing: sales@moorcheh.ai.