libragen

<p align="center"> <img src="packages/website/public/favicon.svg" alt="Libragen Logo" width="80" height="80"> </p> <h1 align="center">libragen</h1> <p align="center"> <em>(pronounced "LIB-ruh-jen")</em> </p> <p align="center"> <strong>Stop your AI from hallucinating code, and ground it in your actual documentation</strong> </p> <p align="center"> <a href="https://www.npmjs.com/package/@libragen/cli"><img src="https://img.shields.io/npm/v/@libragen/cli.svg?label=cli" alt="npm cli"></a> <a href="https://www.npmjs.com/package/@libragen/core"><img src="https://img.shields.io/npm/v/@libragen/core.svg?label=core" alt="npm core"></a> <a href="https://www.npmjs.com/package/@libragen/mcp"><img src="https://img.shields.io/npm/v/@libragen/mcp.svg?label=mcp" alt="npm mcp"></a> <a href="https://github.com/libragen/libragen/actions"><img src="https://github.com/libragen/libragen/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://github.com/libragen/libragen/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a> </p> <p align="center"> <a href="https://libragen.dev">Documentation</a> <a href="https://libragen.dev/docs/getting-started">Getting Started</a> <a href="https://github.com/libragen/libragen/discussions">Discussions</a> </p>

---

Create private, local RAG libraries that ground your AI in real documentationnot 2-year-old training data. No cloud, no API keys, just single files you can share with your whole team.

What's RAG? Retrieval-Augmented Generation lets AI retrieve relevant context before responding, instead of relying solely on training data. libragen packages your docs into searchable libraries your AI can query.

Why libragen?

• Ground AI in truth Give your coding agents authoritative docs to cite, dramatically reducing hallucinations
• Always current Rebuild libraries when docs change; your AI gets the latest APIs, not stale training data
• Private & local Everything runs on your machine. No API keys, no cloud bills, no data leaving your network
• Shareable Single .libragen files work anywhere. Share via git, S3, or install from curated collections

Features

• ** Hybrid Search** Combines vector similarity with BM25 keyword matching
• ** Reranking** Optional cross-encoder reranking for improved relevance
• ** Portable** Single-file SQLite databases with embedded vectors
• ** Smart Chunking** Language-aware splitting that respects code boundaries
• ** Multiple Sources** Build from local files or git repositories
• ** MCP Native** Works directly in Claude Desktop, VS Code, and any MCP client

Packages

Quick Start

Installation

npm install -g @libragen/cli

Build a Library

# From your internal docs
libragen build ./internal-api-docs --name internal-api

# From a private git repository
libragen build https://github.com/your-org/private-docs -o company-docs.libragen

# From any public repo
libragen build https://github.com/facebook/react -o react.libragen

Query a Library

libragen query "how to authenticate users" -l my-project.libragen

Use with AI Assistants

Install the MCP server globally:

npm install -g @libragen/mcp

Add to your Claude Desktop config (on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
   "mcpServers": {
      "libragen": {
         "command": "npx",
         "args": ["-y", "@libragen/mcp"]
      }
   }
}

Then install libraries to make them available:

libragen install my-project.libragen

CLI Commands

Collections

Collections are JSON files that group libraries together for easy installation:

{
   "name": "my-stack",
   "description": "Libraries for my project",
   "version": "1.0.0",
   "items": [
      { "library": "https://example.com/react.libragen" },
      { "library": "https://example.com/typescript.libragen" },
      { "library": "https://example.com/testing.libragen", "required": false },
      { "collection": "https://example.com/base-web.json" }
   ]
}

Create a collection:

# Initialize a template
libragen collection init my-stack.json

# Or create with libraries directly
libragen collection create my-stack.json \
   -l ./react.libragen \
   -l ./typescript.libragen \
   -o ./testing.libragen

Install a collection:

libragen install ./my-stack.json        # Required libraries only
libragen install ./my-stack.json --all  # Include optional libraries

Collections support:

• Nesting Collections can include other collections
• Deduplication Libraries are only installed once
• Optional items Mark libraries as "required": false
• Reference counting Uninstalling removes only unreferenced libraries

Configuration

Storage Location

By default, libragen stores libraries and configuration in a platform-specific directory:

| Platform | Default Location …