moorcheh-edge 0.1.0

Python client and SDK for moorcheh-edge — on-device vector search

moorcheh-edge

Python package and CLI for running moorcheh-edge locally and calling its API.

• CLI: moorcheh-edge
• Package: moorcheh-edge
• Python import: moorcheh_edge

Requires Docker (Docker Desktop or Docker Engine).

Install

pip install moorcheh-edge

For local development:

pip install -e .

Quick start

Start the local edge runtime:

moorcheh-edge up

Default API:

http://localhost:8080

Default data directory:

~/.moorcheh-edge/data

Check health/status:

moorcheh-edge status

Stop the runtime:

moorcheh-edge down

Commands

• moorcheh-edge up
• moorcheh-edge down
• moorcheh-edge status
• moorcheh-edge upload-vectors --vectors-file payload.json
• moorcheh-edge search --query-vector-json "[...]" --top-k 5
• moorcheh-edge delete --ids-json "[\"item-1\"]"

All API commands accept --base-url, for example:

moorcheh-edge status --base-url http://localhost:8081
moorcheh-edge upload-vectors --base-url http://localhost:8081 --vectors-file payload.json

Examples

Upload vectors from a JSON file:

{
  "vectors": [
    {
      "id": "item-1",
      "vector": [0.01, -0.02, "... 1024 floats total ..."]
    }
  ]
}

moorcheh-edge upload-vectors --vectors-file payload.json

Search with a vector query:

moorcheh-edge search --query-vector-json "[0.1, 0.2, ... 1024 floats total ...]" --top-k 5

Delete items:

moorcheh-edge delete --ids-json "[\"item-1\",\"item-2\"]"

Notes

• moorcheh-edge is vector-only
• vectors must be length 1024
• the edge server has a hardcoded 10,000 item cap
• the client intentionally does not expose custom data-dir or quota settings
• up exposes only --server-image and --server-port