↓ Skip to main content
tomrochette.com
  1. Agents/
  2. Retrieval/

Orama

Author
glm-5.3-flash
History / Edit / PDF / EPUB / MD
Created: / Updated: / Status: finished / Readability: 3 / 5 minutes read (~906 words)
agent-curated 576 fully-ai-generated 679 llm=glm-5.3-flash 586 rag 23 research-note 546 retrieval 17 search-engine 2 typescript 6
Table of Contents

Orama is an Apache-2.0 search engine and RAG pipeline library that runs in-process in the browser, on a server, or at the edge, with full-text, vector, and hybrid search in a ~2kb-core TypeScript package.

What it is
#

A dependency, not a deployment: you install @orama/orama and the index lives inside your process. You declare a schema (ten data types, including vector[<size>]), insert documents, and search with BM25 full-text, vector, or hybrid mode; typo tolerance, stemming and tokenization in 30 languages, facets, filters, geosearch, and merchandising rules ship in the box. Since v3.0.0 it also sells the RAG loop itself: Answer Engine chat sessions over your index, with plugins for embeddings, a secure client-side proxy for OpenAI keys, persistence, and analytics. It is made by OramaSearch Inc., written in TypeScript, and runs in Node, browsers, Deno, and edge runtimes; official guides cover Chinese and Japanese tokenization.

Status
#

Actively installed, slowly maintained: the npm firehose keeps flowing while the repository has gone quiet. 10,574 stars and 407 forks as of 2026-10-13; the latest release is still v3.1.18, published 2025-12-19, the most recent main-branch commit is still the 2026-07-03 community CJK plugin fix (re-verified 2026-10-25), and the repository shows push activity on 2026-10-18 without a main-branch commit since July.

Star History Chart

npm reports 5,194,510 downloads in the trailing month for @orama/orama (window 2026-09-23 to 2026-10-22), the window the section’s npm-gaps ruling prefers for adoption claims, while the last complete weekly window (2026-10-16 to 2026-10-22) read 1,044,238, down about 27 percent from the 1,440,525 recorded two weeks earlier, a fall worth watching even allowing for npm’s zero-day reporting gaps, all while the release train sits still. The discussion footprint is nearly empty for that scale: the only HN story dedicated to Orama is a 1-point 2023 post, with demos and integration posts at 2 to 5 points.

Strengths
#

  • One schema-driven package covers full-text, vector, and hybrid search plus an Answer Engine, deployable anywhere JavaScript runs, with no server to operate.
  • The plugin system (embeddings, secure proxy, persistence, analytics, framework integrations) extends it without forking.
  • Apache-2.0 with no hosted dependency, so the data never leaves your process.

Cautions
#

  • The release train has stalled: nothing since v3.1.18 in December 2025, and 2026 main-branch commits are sparse, so budget for owning its maintenance.
  • GitHub detects the license as NOASSERTION even though LICENSE.md is the standard Apache-2.0 text, a detection quirk that will mislead any tool keying off the license field.
  • Searching npm for “orama” surfaces an unrelated 2018 “Plug and play React charts” package (latest 2.0.6, 217 downloads/week as of 2026-10-25) that traps searches for the name.
  • Nothing code-specific: no AST-aware chunking or repo structure awareness, it indexes whatever text you hand it.

Pricing
#

Apache-2.0 open source; no paid tiers or hosted plans surfaced in this run’s fetches (the docs root documents only the open-source library and its plugins), so pricing does not apply.

Compared to
#

  • LlamaIndex: the framework that orchestrates retrieval pipelines over external stores; choose Orama when the index itself must live in your JS/TS process.
  • open-codebase-index: the code-aware self-hosted index served over MCP; choose it for repositories, Orama for application content.
  • Chonkie: the chunking layer that would feed an Orama index in a larger pipeline.

Bottom line
#

Recommended for JS/TS teams that want search or RAG to live inside their app or edge function with zero infrastructure, accepting that they may inherit its maintenance. Not for code-aware retrieval (grep-first loops or a code index serve better) or for anyone who needs a vendor to call.

Changes
#

  • 2026-10-06 - Created.
  • 2026-10-07 - Added the oramasearch/orama star history chart to the Status section.
  • 2026-10-18 - Corrected the matrix See-also line from fifteen to sixteen columns, stale since R2R joined on 2026-10-11; the rotation re-verification re-fetched every cited URL and found all claims unchanged.
  • 2026-10-25 - Rotation re-verification re-fetched every cited URL live and moved the adoption figure to the trailing-month window per the npm-gaps ruling: 5,194,510 downloads (2026-09-23 to 2026-10-22), with the last complete weekly window at 1,044,238, down about 27 percent from the prior recorded week; the release stall, the quiet main branch, the license, the name collision, and the HN footprint all unchanged.

See also
#

References
#