Tencent/WeKnora

▲ 88 stars today★ 37,369⑂ 5,183

Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.

About Tencent/WeKnora

Tencent/WeKnora is an open-source project on GitHub, mainly written in Go. Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki. It currently holds 37,369 stars and 5,183 forks with 1,006 open issues, and was last pushed on 2026-11-09 (repository created 2025-07-22).

Project Overview

Git Homed tracks it on the Today's Trending board, currently at rank #57 with 88 new stars today.

GitHub Repository Details

Repository Tencent/WeKnora · default branch main · size 259467 KB · watchers 150 · source: GitHub REST API and repository README

README

https://github.com/Tencent/WeKnora/blob/HEAD/WeKnora: find the answers, and put knowledge to work. Tencent's open-source knowledge management framework for Q&A, tasks and wikis.

https://github.com/Tencent/WeKnora/blob/HEAD/Website https://github.com/Tencent/WeKnora/blob/HEAD/Docs https://github.com/Tencent/WeKnora/blob/HEAD/Release https://github.com/Tencent/WeKnora/blob/HEAD/License https://github.com/Tencent/WeKnora/blob/HEAD/Stars
https://github.com/Tencent/WeKnora/blob/HEAD/WeChat Dialog Open Platform https://github.com/Tencent/WeKnora/blob/HEAD/Chrome Extension https://github.com/Tencent/WeKnora/blob/HEAD/ClawHub Skill https://github.com/Tencent/WeKnora/blob/HEAD/npm @wxg-prc-cpg/dsh-weknora

English · 简体中文 · 日本語 · 한국어

Overview · Quick Start · What's New · Features · Clients · Docs · Development

https://github.com/Tencent/WeKnora/blob/HEAD/Tencent/WeKnora | Trendshift

Overview

WeKnora is an open-source, LLM-powered knowledge framework for enterprise document understanding, semantic retrieval and reasoning. It brings a team's documents together so they can be searched, reasoned over and kept up to date.

https://github.com/user-attachments/assets/de0e490a-e738-405e-bb3a-64b63edd7278

v0.9.0 · 2:45 · 1080p60 · English narration and subtitles

Use RAG to look things up, the agent for multi-step tasks, and the wiki to organize knowledge. All three work on the same knowledge bases.

https://github.com/Tencent/WeKnora/blob/HEAD/01 RAG: answers you can check, with hybrid search, multimodal parsing and citations. 02 Agent: tasks done with knowledge and tools, with multi-step reasoning, skills and sandbox, the local browser, MCP tools and memory. 03 Wiki: documents organized into a wiki, with a knowledge graph and rollback.

The agent's toolbox. Skills installed from ClawHub / SkillHub / Git / ZIP run in session-persistent Docker / E2B / Cube sandboxes, with an interactive terminal and graphical desktop beside the chat. Through the BrowserSkill extension the agent operates the user's own Chrome or Edge, and external MCP services (OAuth included) can be connected and enabled tool by tool.

Beyond the three modes:

Quick Start

https://github.com/Tencent/WeKnora/blob/HEAD/
ONLINE
WeChat Dialog Open Platform
Manage knowledge bases online and connect Q&A to Official Accounts, Mini Programs and other WeChat scenarios.

Open the platform →
https://github.com/Tencent/WeKnora/blob/HEAD/
CLOUD
Tencent Cloud Lighthouse
Deploy WeKnora from an application template and run it on your own cloud server.

Deploy on Tencent Cloud →
https://github.com/Tencent/WeKnora/blob/HEAD/
SELF-HOSTED
Your own environment
Deploy with Docker or Kubernetes and configure models, storage and networking yourself.

Run with Docker Compose ↓

Run with Docker Compose

Requires Docker, Docker Compose and Git.

git clone https://github.com/Tencent/WeKnora.git
cd WeKnora
cp .env.example .env    # Edit .env as needed, see comments in the file
docker compose pull     # Pull the latest images
docker compose up -d    # Start core services

Then open http://localhost and follow the onboarding guide. A walkthrough with sample data is in the Quickstart.

[!TIP]
To use a local Ollama model, run ollama serve > /dev/null 2>&1 & first. For the Ollama embedding model name, OLLAMA_BASE_URL, and RAM notes, see Configuration.

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

Optional services

Add --profile flags to enable additional components; multiple profiles can be combined.

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

docker compose --profile neo4j --profile minio pull
docker compose --profile neo4j --profile minio up -d
docker compose down     # Stop services

Upgrading

If you already have WeKnora running and downloaded a newer release:

# Set WEKNORA_VERSION in .env to the target release (e.g. 0.9.0), or keep latest
docker compose pull     # Pull images matching WEKNORA_VERSION
docker compose up -d    # Recreate containers with new images
[!NOTE]
docker compose up -d alone reuses locally cached images and may leave the UI version out of sync with the release you downloaded. Read the upgrade notes before upgrading. Deployments older than v0.8.2 should also read the v0.8.2 notes.

Other ways to deploy

| 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 |

All options, hardware requirements and deployment topologies: Installation guide.

[!WARNING]
WeKnora ships with login authentication, but for production deployments we strongly recommend that you:
- deploy it in an internal / private network rather than on the public internet;
- avoid exposing the service directly to public networks, to prevent information leakage;
- configure proper firewall rules and access controls for the deployment environment;
- regularly update to the latest version for security patches and improvements.

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

Agents can operate the browser on your computer, knowledge bases can be published to other AI tools over MCP, and a running conversation can be steered, forked or rewound.

[!IMPORTANT]
Breaking: DingTalk channels are Stream-only, and sandbox commands run as root. See the upgrade notes.

v0.8.0 · release notes

Earlier releases (v0.2.0 – v0.7.2)


  • v0.7.2 — Product documentation site; knowledge base folder tree; chunk editing with revision history; wiki page revisions; directly loadable file URLs (resource_urls=public); Feishu Drive data source; batch tagging; MCP Server 1.1 (29 tools); AWS S3 default credential chain.
  • v0.7.1 — Yunzhijia IM; Volcengine rerank; Zhipu AI web search; platform-scoped API keys; per-KB activity audit; FAQ filtering, tagging and export; Langfuse OTLP tracing; one-click Markdown export.
  • v0.7.0 — Scoped API keys and principal model; task-queue dashboard and worker-pool governance; multiple storage instances per workspace; temporary chat attachments; @Skill / @MCP mentions; mid-conversation MCP OAuth; QQBot and Lark IM; Redis TLS; weknora CLI v0.10.
  • v0.6.3 — Website embed widget & Integrations Center (secure-mode token exchange + rate limits); chat experience overhaul (citation popovers, RAG pipeline progress, streaming markdown); document multi-tag & batch reparse; Wiki folders & hierarchy navigation; RSS data source; MCP OAuth2; EPUB / MHTML parsing; agent model-readiness checks; model test debugger; session source filter; workspace deletion UI.
  • v0.6.2 — Per-upload process configuration with upload-confirm dialog; document reparse with process_config; weknora CLI v0.9 (bundled Agent Skills, session stop, auth/profile harmonization); KB marquee multi-select; HNSW index for 1024-dim pgvector embeddings; chat resources store refactor; Langfuse-only tracing (Jaeger removed).
  • v0.6.1 — Document parsing trace timeline (Langfuse-style span tree with stage-by-stage progress + stop-parse); OpenSearch vector store driver; declarative built-in models via YAML; system admin & consolidated platform settings + audit log; new-user onboarding guide; settings UI redesign; weknora CLI v0.7 / v0.8 (agent-first wire contract, NDJSON, --dry-run); OpenDataLoader + PaddleOCR-VL parsers; MCP server multi-transport (stdio / SSE / HTTP); per-model thinking-mode config; Tencent LKEAP rerank + native Gemini embeddings + MiniMax-M3.
  • v0.6.0 — Workspace RBAC (4-tier role matrix Owner / Admin / Contributor / Viewer + per-KB ownership + per-workspace audit log), workspace member management & multi-workspace UX, self-service workspaces; weknora CLI v0.4 GA with mcp serve; KB retrieval fan-out across vector stores; AES-256-GCM credential encryption + docreader gRPC TLS + Token; Zhipu embedder + Huawei OBS; server-side user preferences; Go 1.26.0. See Tenants & auth.
  • v0.5.2 — Wiki ingest scales to 40k-document KBs (task queue + DLQ); MCP human-in-the-loop tool approval; Anthropic / Apache Doris / Tencent VectorDB / KS3 / SearXNG backends; adaptive 3-tier chunking with live preview; global ⌘K command palette; Yuque connector + WeChat Mini Program; weknora CLI preview.
  • v0.5.1 — Knowledge-base batch management; workspace-wide IM channels overview; session search + user-scoped pinning; unified Model / Web Search / MCP settings cards; per-agent LLM timeout; desktop workspace switching.
  • v0.5.0 — Wiki Mode GA — agents auto-generate structured, interlinked Markdown wiki pages with a knowledge graph; wiki browser + visual graph in the UI.
  • v0.4.0 — WeKnora Cloud (hosted LLM + parsing); Chrome Extension; ClawHub Skill; WeChat IM; attachment processing; Azure OpenAI / Alibaba OSS; Notion connector; Baidu + Ollama web search; VectorStore management.
  • v0.3.6 — ASR (audio); Feishu data-source auto-sync; OIDC; IM quote-reply context + thread-based sessions; document summarization; Tavily search; parallel tool calling; agent @mention scope restriction.
  • v0.3.5 — Telegram / DingTalk / Mattermost IM; IM slash commands + QA queue; suggested questions; VLM auto-describe MCP tool images; Novita AI; channel tracking.
  • v0.3.4 — WeCom / Feishu / Slack IM; multimodal image support; NVIDIA model API; Weaviate; AWS S3; AES-256-GCM API-key encryption; built-in MCP service; hybrid-search optimization; final_answer tool.
  • v0.3.3 — Parent-child chunking; KB pinning; fallback response; passage cleaning for rerank; storage auto-creation; Milvus.
  • v0.3.2 — Knowledge Search entry; per-source parser & storage engine config; image rendering in local storage; document preview; Volcengine TOS; Mermaid rendering; batch session management; memory graph preview.
  • v0.3.0 — Shared Space; Agent Skills + sandboxed execution; custom agents; Data Analyst agent; thinking mode; Bing / Google web search; API Key auth; Helm chart; Korean i18n; Qdrant.
  • v0.2.0 — Agent Mode (ReACT); multi-type knowledge bases (FAQ + document); conversation strategy config; DuckDuckGo web search; MCP tool integration; new UI with agent mode switching; MQ async task management.
Full history: CHANGELOG.md.

Product Tour

Quick Q&A and smart reasoning

Two ways to ask. Quick Q&A answers from the knowledge base with RAG and cites the sources it used. In smart reasoning the agent plans multi-step work, searching, reading documents and calling tools and skills, and shows each step in the conversation. Docs →

https://github.com/Tencent/WeKnora/blob/HEAD/Quick Q&A and smart reasoning

Local browser

Operate the browser on your computer. Through Tencent's open-source BrowserSkill extension, the agent opens pages and fills in forms in your own Chrome or Edge, and hands over to you for logins and CAPTCHAs. Docs →

https://github.com/Tencent/WeKnora/blob/HEAD/Local browser

Skills and sandbox

Run skills and produce files. Docker, E2B and Cube backends are supported. Turns in the same session share one workspace, and generated files can be previewed and downloaded. Open the graphical desktop or interactive terminal beside the chat to follow each step and take over when needed. Docs →

https://github.com/Tencent/WeKnora/blob/HEAD/Skills and sandbox

Toolbox: MCP services and skills

Tools the agent can use. Connect external MCP services and choose, tool by tool, which are enabled and which calls need approval. Install s

GitHub Stars & Activity

37,369Stars
5,183Forks
1,006Open issues
GoLanguage

GitHub Popularity

GitHub stars37,369
Forks5,183
Open issues1,006
Primary languageGo
LicenseNOASSERTION
Stars gained today88
Created2025-07-22
Last pushed2026-11-09

Trending History

Daily boardrank #57 · ▲ 88 stars

Related GitHub Projects

1

ollama / ollama

Go★ 186,932⑂ 19,080▲ 141 stars
→
2

multica-ai / multica

Go★ 56,089⑂ 7,410▲ 167 stars
→
3

alibaba / open-code-review

Go★ 50,988⑂ 3,802▲ 215 stars
→
4

netbirdio / netbird

Go★ 30,985⑂ 1,859▲ 49 stars
→
5

tailscale / tailcat

Go★ 9,647⑂ 443▲ 256 stars
→
6

Gentleman-Programming / gentle-ai

Go★ 9,154⑂ 898▲ 242 stars
→
7

agent-substrate / substrate

Go★ 6,615⑂ 746▲ 52 stars
→
8

Tencent / LoopForge

Go★ 688⑂ 114▲ 174 stars
→

More Trending Repositories