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