bybit-exchange/kaas

View on GitHub ↗

Turn scattered notes, docs and transcripts into a queryable Markdown wiki — an LLM knowledge-base compiler with MCP access, no embeddings, self-hosted.

105 ★14 forksPythonUpdated 18d ago

What you need to know

Knowledge-as-a-Service: compiles scattered notes, documents, and transcripts into a searchable, queryable personal wiki via a 4-phase LLM pipeline, queryable through an MCP ask tool.

Install

docker run -d --name kaas -p 8080:8080 -v ./data:/app/data -e LLM_API_KEY=sk-xxx -e LLM_BASE_URL=https://api.openai.com/v1 -e LLM_MODEL=gpt-4o-mini ghcr.io/bybit-exchange/kaas:edge
curl -fsSL https://raw.githubusercontent.com/bybit-exchange/kaas/main/install.sh | sh

Usage

  • kaas serve
  • claude mcp add kaas -- kb-ai mcp
  • claude mcp add --transport http kaas http://host:8080/mcp
  • Set KAAS_MCP_ENABLED=true to expose the /mcp endpoint

Key features

  • 4-phase compile pipeline (extract, classify, write, index) producing human-readable Markdown wiki articles
  • LLM-iterative retrieval with cited answers via a single ask tool (no embeddings)
  • Git-friendly output: all wiki articles are plain Markdown
  • Streaming chat with SSE source citations
  • Multiple input sources: paste text, upload files, or provide URLs
  • MCP access over both stdio and streamable-http transports
  • Worker acceleration with circuit breaker and lease recovery

Best for

Individuals or teams who want to distill long-lived knowledge into a compoundable wiki queryable by coding agents

Caveats

  • No darwin/amd64 build; Intel Macs must use Docker or the agent path
  • Requires an OpenAI-compatible LLM API key (LLM_API_KEY)
  • HTTP MCP endpoint is unauthenticated by default unless KAAS_MCP_TOKEN is set
  • Single Docker image bundles Go backend + Python daemon + web UI
Platforms: Linux · macOSClients: Claude Code · Codex · openclaw
Documentation ↗

Reviewed 2026-08-11

Topics

ai-agentsclaude-codegolangknowledge-baseknowledge-managementllmmarkdownmcpmodel-context-protocolopenai-apipersonal-knowledge-managementpythonragreactsecond-brainself-hostedsqlitetypescriptwiki
Stars
105★
Forks
14
Language
Python
License
MIT
Created
2026-07-29
Last push
2026-08-17