Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.moorcheh.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Uploads precomputed vectors from a JSON file to a vector namespace. Returns an async job_id — poll with moorcheh upload-job-status. Each vector length must match the namespace vector_dimension.

​
Synopsis

moorcheh upload-vectors --namespace-name NAME --vectors-file PATH [--base-url URL]

​
Options

FlagRequiredDescription
--namespace-nameYesTarget vector namespace
--vectors-fileYesPath to JSON file with a vectors array
--base-urlNoDefault http://localhost:8080

​
Vectors file format

vectors.json: 
{
  "vectors": [
    {
      "id": "vec-1",
      "vector": [0.1, 0.2, 0.3, 0.4, 0.5],
      "source": "demo"
    }
  ]
}
The vector array length must match vector_dimension for the namespace (for example 5 or 768).

​
Examples

moorcheh upload-vectors --namespace-name my-embeddings --vectors-file vectors.json

moorcheh upload-job-status --namespace-name my-embeddings --job-id <job_id>

​
Output

Prints JSON from POST /namespaces/{namespace_name}/vectors:
​
status
string
"success" when the upload job was started; "failure" on error.
​
message
string
Human-readable result or error description.
​
job_id
string
Async upload job id.
​
namespace_name
string
Target namespace.
​
total
number
Number of vectors accepted into the job.
​
items
number
Current item count. Present on 409 item limit errors.
​
max_items
number
Global item cap. Present on 409 errors.
​
requested_new
number
New ids that would exceed the cap. Present on 409 errors.
Example output
{
  "status": "success",
  "message": "Vectors upload started. Poll job status for progress.",
  "job_id": "job-86a80193802144bbb718b48b1954997d",
  "namespace_name": "my-embeddings",
  "total": 1
}

​
Exit codes

CodeMeaning
0Upload job started
1API error (400, 404, 409, etc.)