Lumo Cloud

Last updated:

Lumo Cloud is the managed version of LumoSearch. Same BM25F engine, hosted on AWS with auth, API keys, usage tracking, billing, and optional semantic reranking via Bedrock Titan embeddings.

Why Lumo Cloud?

No infrastructure to manage

Upload documents, get a search API. Indexing, caching, and scaling are handled for you.

Hybrid search built in

Enable semantic reranking with one toggle. BM25F lexical scoring blended with Bedrock Titan cosine similarity.

Predictable pricing

Flat monthly plans based on search volume. No per-request fees. Starts free, scales to 2.5M searches/mo.

How It Works

  1. Sign up and create a project in the dashboard
  2. Create a collection with your search schema (field names + weights)
  3. Upload a JSON array of documents — indexing runs async
  4. Create an API key and search via POST /v1/search

SDK Quick Start

npm install @lumosearch/cloud
import { LumoCloud, LumoAdmin } from '@lumosearch/cloud'

// Admin: manage collections and upload documents
const admin = new LumoAdmin({
  adminKey: 'sk_admin_...',
  endpoint: 'https://api.lumosearch.com'
})

const { collection } = await admin.createCollection('proj_...', 'Products', {
  keys: [{ name: 'title', weight: 3 }, { name: 'description', weight: 1 }],
  semantic: { enabled: true }  // enable hybrid search
})

await admin.replaceDocuments(collection.collectionId, 'proj_...', [
  { id: '1', title: 'Running Shoes', description: 'Lightweight trainers', category: 'footwear' },
  { id: '2', title: 'Leather Boots', description: 'Durable winter boots', category: 'footwear' },
])

// Search: use a public key from the dashboard
const search = new LumoCloud({
  publicKey: 'pk_search_...',
  collection: 'products',
  endpoint: 'https://api.lumosearch.com'
})

const results = await search.search('comfortable shoes', {
  filters: { category: 'footwear' },
  facets: ['category'],
  limit: 10
})

Next Steps