What is librarium?

Librarium fans out research queries to multiple search and deep-research APIs in parallel, then merges everything into one structured output. It ships with 24 built-in provider adapters spanning traditional search engines, AI-grounded answers, deep-research APIs, and an opt-in ungrounded LLM tier. Librarium works both as a CLI and as an embeddable library via librarium/core, which runs in Cloudflare Workers and other edge runtimes.

Installation

npm

Requires Node.js 20.12 or later.

npm install -g librarium

pnpm

pnpm install -g librarium

yarn

yarn global add librarium

Homebrew (macOS and Linux)

brew install jkudish/tap/librarium

Standalone binary

curl -fsSL https://raw.githubusercontent.com/jkudish/librarium/main/scripts/install.sh | sh

npx (no install required)

npx librarium run "your query"

Quick start

The easiest way to get started is to run librarium with no arguments in a terminal. It launches an interactive wizard: enter your query, pick a provider group, choose a mode, and kick off the run — all with guided prompts.

librarium

Or run init --auto once to discover API keys already present in your environment and enable matching providers, then run a query directly:

librarium init --auto

# Fan out a research query across providers (live results table)
librarium run "PostgreSQL connection pooling best practices"

# Or get one grounded, cited answer synthesized from the results
librarium answer "what changed in postgres 17 logical replication"

# Use a specific group
librarium run "React Server Components" --group quick

# Check async deep research status
librarium status --wait

Upgrade

librarium upgrade auto-detects your install method (npm, pnpm, yarn, Homebrew, standalone) and runs the correct upgrade command.

librarium upgrade

Getting started