Agent-KB

A portable research library

Research people can return to.

Agent-KB gives agents a repeatable way to turn reviewed research into a local library for reading, watching, presenting, and listening.

Open source. Local-first. No account or hosted service required to read a library.

An open book linked to diagram, video, and audio cards

The problem

A good answer is not yet a useful body of knowledge.

Research gets stranded in chat history, loose documents, and one-off presentations. Agent-KB keeps the explanation, sources, media, and validation close enough to travel together.

A bounded workflow

Give an agent a clear job. Keep the result inspectable.

  1. 01

    Investigate

    Map questions, primary sources, alternatives, and caveats. Keep unpublished work outside the served library.

  2. 02

    Explain

    Write guides with a reading path, evidence links, diagrams, and precise claims that can be checked later.

  3. 03

    Publish locally

    Serve an ordinary repository. Add reviewed slides, images, video, captions, or narration when they help the reader.

  4. 04

    Verify

    Check source identity, links, layout, reader surfaces, and media metadata before sharing the result.

One shared reader

Use the format that helps the idea land.

All of these surfaces come from the same portable content repository. Nothing requires a model or API key to read.

Read

Guides that hold their shape

Editorial pages, local Mermaid diagrams, math, source evidence, chapter navigation, and a precise Markdown download.

Agent-KB library homepage showing guide, video, and presentation cards on a desktop screen

Listen

Narration that follows the guide

Use browser voice as a fallback or attach prepared recordings. A verified guide track can continue through its chapters.

Agent-KB guide page and narration controls on a phone

Watch

Video with context

Native playback, captions, transcripts, chapter selection, download links, and byte-range seeking from a verified local cache.

Present

Slides that keep the evidence nearby

Simple deck navigation, keyboard controls, speaker notes, and source links let a presentation stay connected to the guide.

Designed for handoff

The workflow lives in the repository.

The included skill, templates, authoring guide, and validation commands describe what to make, where it belongs, and how to inspect it. A smaller model has completed the bundled cold-start exercise from those materials alone; it is an example of reproducibility, not a claim that all models have the same research judgment.

Read the cold-start exercise

Start from source

Make a library you can keep.

Clone the repository with Node 22 or newer, initialize a new library, then serve it on your own machine. Chromium is only needed for browser validation and narration plans.

Read the full setup and hosting guide

git clone https://github.com/fakoli/agent-knowledge-base.git
cd agent-knowledge-base
npm ci
npx playwright install chromium
npm link

kb init ../my-library --name 'My Library'
cd ../my-library
kb serve