$ memista

API reference

memista's HTTP surface is three endpoints on 127.0.0.1:8083, served by Actix-web. The authoritative spec is generated by apistos and browsable in-server.

/swagger /redoc /rapidoc /scalar
POST /v1/insert

Add one or more chunks to a partition. Each chunk is an embedding, its text, and a metadata string. Returns the assigned chunk ids. The index file is saved to disk after the batch.

{
  "database_id": "my_app",
  "chunks": [
    { "embedding": [0.1, 0.2], "text": "Hello world", "metadata": "{}" }
  ]
}
POST /v1/search

Nearest-neighbour query against a partition, ranked by inner-product distance. Returns ranked chunks with their text, metadata, and distance.

{
  "database_id": "my_app",
  "query": [0.1, 0.2],
  "limit": 5
}
DELETE /v1/drop

Drop a partition entirely — its chunks_<database_id> SQLite table and its <database_id>.usearch index file.

No auth. The server binds to localhost and trusts everything on the wire. If it leaves the box, terminate authentication at a reverse proxy in front of it.

Full rustdoc is at docs.rs/memista; longer-form docs at docs.skelfresearch.com/memista.