Tencent/WeKnora

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/Tencent/WeKnora.svg?style=card)](https://bestofgithub.dev/repo/Tencent/WeKnora)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/Tencent/WeKnora.svg)](https://bestofgithub.dev/repo/Tencent/WeKnora)

Loading README…

Service	URL
Web UI	`http://localhost`
Backend API	`http://localhost:8080`
Langfuse Tracing	`http://localhost:3000`

Profile	Adds
(default)	Core services
`full`	All features
`neo4j`	Knowledge Graph (Neo4j)
`minio`	Object Storage (MinIO)
`langfuse`	Tracing (Langfuse)

Option	When to use it
Docker Compose	The standard deployment above: all features, multiple services
Kubernetes (Helm)	Production clusters; the chart is in `helm/`
Lite single binary	Local or low-resource use with no external dependencies (SQLite + in-memory queue); see Lite vs. standard
Desktop app	The Lite runtime with a GUI, login-free start and a macOS host sandbox; no installer is published yet, so build it from source

Area	Highlights
Q&A and agent	Quick Q&A answers from knowledge bases with citations; smart reasoning runs a ReAct agent over knowledge bases, web search, MCP tools, skills and the local browser. Steer, fork or rewind a running conversation, and keep long-term memory across sessions
Wiki	Agent-generated, interlinked wiki pages with a knowledge graph; in-browser editing, revision diff and rollback
Skills and sandbox	Skill catalog installed from ClawHub / SkillHub / Git / ZIP; session-persistent Docker / E2B / Cube sandboxes with network policy; terminal and graphical desktop beside the chat
Knowledge bases	FAQ, document and wiki bases; folder tree; chunk editing with revisions; per-upload parsing, chunking and multimodal settings; auto-tagging
Retrieval	Keyword + vector hybrid search, rerank, parent-child chunking and GraphRAG (Neo4j); end-to-end evaluation with recall and BLEU / ROUGE
Access and security	Workspace RBAC with four roles and an audit log; scoped API keys; OIDC; AES-256-GCM credential encryption; SSRF-safe outbound requests with a whitelist-only mode
Operations	Langfuse tracing for agent steps, tokens and pipelines; document parsing timeline; task-queue dashboard with worker pools; automatic migrations on upgrade

Component	Options
LLMs	29 built-in vendors, including OpenAI / Azure OpenAI / Anthropic / DeepSeek / Qwen / Zhipu / Hunyuan / Doubao / Gemini / MiniMax / NVIDIA / SiliconFlow / OpenRouter / LiteLLM / Ollama
Embeddings	Ollama / BGE / GTE / Zhipu / OpenAI-compatible APIs
Vector databases	PostgreSQL (pgvector + ParadeDB) / Elasticsearch / OpenSearch / Milvus / Weaviate / Qdrant / Apache Doris / Tencent VectorDB
Object storage	Local / Tencent Cloud COS / MinIO / AWS S3 / Volcengine TOS / Alibaba Cloud OSS / Kingsoft Cloud KS3 / Huawei Cloud OBS
Document formats	PDF / Word / PPT / Excel / CSV / TXT / Markdown / HTML / EPUB / MHTML / JSON / XMind / images
Data sources	Feishu wiki / Feishu Drive / Lark / Confluence / GitLab / Tencent IMA / Notion / Yuque / DingTalk Docs / Seafile / RSS
IM channels	WeCom / Feishu / Lark / QQBot / Slack / Telegram / DingTalk / Mattermost / WeChat / Yunzhijia
Web search	DuckDuckGo / Bing / Google / Tavily / Baidu / Ollama / SearXNG / Keenable / Zhipu AI / Exa / Metaso / Bocha / Serply
Deployment	Docker Compose / Kubernetes (Helm) / Lite single binary / desktop app; offline and private-cloud installs; UI in Chinese, English, Japanese, Korean and Russian

Tencent/WeKnora

Overview

Quick Start

Run with Docker Compose

Optional services

Upgrading

Other ways to deploy

What's New

v0.9.0 _{· 2026-10-29 · release notes}

v0.8.3 _{· 2026-10-14 · release notes}

v0.8.2 _{· 2026-09-24 · release notes}

v0.8.0 _{· release notes}

Product Tour

Quick Q&A and smart reasoning

Local browser

Skills and sandbox

Toolbox: MCP services and skills

Automatic wiki

Observability

Architecture

Features

Supported backends

Clients and Integrations

Command-Line Interface

Documentation

Development

Contributing

Contributors

License

	Client	What it does
	CLI `weknora`	Agent-first command line for the full API, with a curated MCP tool surface and bundled Agent Skills
	Built-in MCP Server	Publishes knowledge bases to Cursor, Claude and other MCP clients over Streamable HTTP; the Python `mcp-server/` is deprecated
	Local Browser (BrowserSkill)	Lets agents operate the user's own Chrome / Edge
	Chrome Extension	Select text, images, or entire pages in the browser and save them as knowledge entries with one click, without copy-paste or file upload
	WeChat Mini Program	Lightweight mobile client: configure API access, select knowledge bases, import URLs, and ask knowledge chat from WeChat
	ClawHub Skill	A WeKnora skill on ClawHub for document import, hybrid search and knowledge management via the REST API
	DeepSeek Harness plugin	Gives `dsh` coding agents four read-only tools: search, read document, ask and list knowledge bases
	Website Embed Widget	Publishes agents on external sites
	Go SDK	CRUD for knowledge bases, documents and sessions, plus SSE streaming Q&A
	WeChat Dialog Open Platform	Hosted Q&A built on WeKnora: upload knowledge and publish a Q&A service in WeChat without writing code

Start here
Introduction	Capabilities overview
Installation	Docker Compose, Helm, Lite and desktop
Configuration	Environment variables and models
Troubleshooting FAQ	Common problems and fixes
API reference	REST API overview
Release notes	What changed in each release