Skip to main content
Moss ships official SDKs for six platforms. They share one conceptual API (create or load an index, then query) and one index format, so you can build in one and query from another.

Python

Async Python SDK. pip install moss

JavaScript

Node.js server-side SDK. npm install @moss-dev/moss

Swift (iOS)

On-device iOS SDK via Swift Package Manager.

Elixir

Elixir SDK on Hex. {:moss, "~> 1.0"}

Browser

In-browser / WebAssembly SDK. npm install @moss-dev/moss-web

C

Native C library (libmoss).

Capabilities

Everything the SDKs can do. Pick a language above for install and quickstart; follow a link below for the details. Links below go to the Python pages; each topic has a JavaScript equivalent under the JavaScript SDK.
CapabilityWhat it doesLearn more
Index managementCreate, add, update, delete, get, and list indexesIndexing
Load and queryLoad an index into memory and run semantic searchLoad and query
Hybrid searchBlend semantic and keyword scoring with alphaHybrid search
Metadata filteringNarrow results with $eq, $in, $near, $and/$or, and moreMetadata filtering
Custom embeddingsBring your own vectors with model_id="custom"Custom embeddings
Multi-index searchQuery across several loaded indexes in one callMulti-index search
Real-time sessionsLocal-first indexing during a live interactionSessions
Cross-agent handoffResume a session across agents, channels, and devicesSessions
Hydration and syncHydrate from the cloud, auto-refresh, and push updatesKeeping indexes fresh

Models

  • moss-minilm (default) - fast, lightweight, good for edge and offline
  • moss-mediumlm - higher accuracy with reasonable performance
  • moss-litelm - the on-device default on iOS
  • custom - bring your own embedding vectors

Samples

Runnable end-to-end examples live in the moss repo, with parallel JavaScript and Python projects you can adapt by swapping in your own data.