Local RAG for Markdown folders.

Ragship indexes a directory of Markdown files, stores embeddings locally, and serves a chat UI with source citations.

Install Read details

$ npx @stackctl/ragship ./docs
✓ indexed markdown
✓ http://localhost:3000

What it includes

Folder ingest

Reads Markdown recursively, uses frontmatter when present, chunks content, and skips unchanged files on later runs.

Local retrieval

Embeddings are generated with Ollama and stored in libSQL. Retrieval uses vector search over the local database.

Cited answers

The chat endpoint builds a prompt from retrieved chunks and returns source paths next to each answer.

Ragship runs on the user's machine. Install it from npm as @stackctl/ragship.

$ npm install -g @stackctl/ragship
$ ragship ./docs