WeKnora
Tencent's open-source knowledge-base and agent platform with document parsing, RAG and team workspaces.
Quick answer
WeKnora is a tencent's open-source knowledge-base and agent platform with document parsing, RAG and team workspaces, listed under Knowledge base & RAG. A typical small-business use: company knowledge base over manuals, contracts and scanned documents, answered in chat. Official hardware: recommended 4 vCPU · 8 GB RAM (no separate minimum published). That fits a Hetzner Cloud CPX32 server at about €35.99/month (server only, excl. VAT). License: MIT (with third-party components), which allows internal business use.
Last updated · facts verified against official docs on · sources
Activity data comes from GitHub and was last refreshed Oct 31, 2026.
What is WeKnora?
WeKnora is Tencent's document understanding and retrieval platform. It parses PDFs, Office files and images (with OCR), builds knowledge bases with vector, keyword and knowledge-graph retrieval, and answers questions through a chat UI, agents with MCP tools, a web embed, IM integrations and an API. Workspaces have member roles and can share knowledge bases through organizations. It runs as a Docker Compose stack (Go backend, docreader parser, PostgreSQL, Redis) and works with Ollama or hosted model APIs.
Where it fits in a 10–200 person business
- Company knowledge base over manuals, contracts and scanned documents, answered in chat
- Team workspaces with separate permissions that can still share selected knowledge bases
- Customer-facing Q&A widget or IM bot backed by your own documents
These use cases are our editorial suggestions, not claims made by the project.
Can a business use WeKnora? (license)
| License | MIT (with third-party components) |
|---|---|
| Type | Permissive: MIT / Apache-2.0: use, modify and sell with few obligations. |
| Internal business use | Allowed under the license text |
| What to watch | MIT for WeKnora itself; bundled third-party components keep their own licenses, listed in the LICENSE file. Internal and commercial use allowed. |
This is a plain-English summary of the license text, not legal advice. Third-party models you run with it have their own licenses.
Data & compliance: does WeKnora phone home?
| Telemetry (usage data sent to the vendor) | Not documented |
|---|---|
| Other calls home by default (updates, marketplaces, default cloud services) | Not documented |
| Single sign-on (OIDC / SAML / LDAP) | Free By protocol: OIDC free. Users sign in with a password or OIDC single sign-on; SAML and LDAP are not documented. Source: weknora.weixin.qq.com/docs/03-features/01-tenant-auth |
| Audit log | Yes, free Cross-workspace audit is available to the system administrator role in the open-source edition. Source: weknora.weixin.qq.com/docs/03-features/01-tenant-auth |
| Role-based access control (RBAC) | Yes, free Workspace roles Owner, Admin, Contributor and Viewer, plus a separate system administrator role and scoped API keys. Source: weknora.weixin.qq.com/docs/03-features/01-tenant-auth |
| Data residency / GDPR notes from the project | Not documented |
Checked against the project's own docs and repository on . "Not documented" means we could not find the answer in official sources; it does not mean the feature is missing or that no data is sent. Third-party services you connect (model APIs, vector databases, search engines) have their own data policies. Compare all apps.
What hardware does WeKnora need?
| Minimum | Not published |
|---|---|
| Recommended | 4 vCPU · 8 GB RAM |
| GPU | Not required. Local models run through Ollama or another model service you configure. |
Official guidance is to start from 4 CPU cores and 8 GB RAM because docreader bundles LibreOffice and Playwright. Disk depends on knowledge-base size. Optional Milvus, OpenSearch or Langfuse need more memory.
Source: weknora.weixin.qq.com/docs/01-getting-started/02-installation
How much does it cost to host WeKnora per month?
| Recommended spec | 4 vCPU · 8 GB RAM → CPX32 (4 vCPU, 8 GB, 160 GB disk) €35.99/mo |
|---|
How we got this: we took the cheapest Hetzner Cloud Regular Performance (shared AMD vCPU) plan with at least the RAM and vCPU the project lists, using prices read from www.hetzner.com/cloud/regular-performance on 2026-10-25. "From" monthly price cap shown by Hetzner, excluding VAT. Prices vary by location. Covers the server only; it excludes LLM API usage, backups, extra storage, GPUs and your time. Disk is not matched; add a volume if you need more than the plan includes.
How to deploy WeKnora
Method: Docker Compose
git clone https://github.com/Tencent/WeKnora.git && cd WeKnora
cp .env.example .env
# set DB_USER/DB_PASSWORD/DB_NAME, REDIS_PASSWORD, JWT_SECRET (openssl rand -hex 32) and SYSTEM_AES_KEY
docker compose pull
docker compose up -d
# web UI at http://localhost (FRONTEND_PORT, default 80); backend health at http://localhost:8080/health From the official instructions: weknora.weixin.qq.com/docs/01-getting-started/02-installation. Always check the source for the current version before you run it.
Known gotchas when self-hosting WeKnora
- Registration defaults to self_serve (anyone who can reach it can sign up). Set DISABLE_REGISTRATION=true or switch to invite registration before exposing it; a registration mode saved in the database settings is also checked on every request, so changing the env alone may not take effect. source
- JWT_SECRET and SYSTEM_AES_KEY are empty in .env.example. Generate them once at first deploy and keep them safe, along with the database and Redis passwords. source
- The backend port 8080 is mapped to the host as well as the frontend port; firewall it if the frontend is your only intended entry point. source
- docker compose up -d alone reuses cached images. Run docker compose pull before upgrading and read the upgrade notes. source
Alternatives in Knowledge base & RAG
- RAGFlow RAG engine with deep document parsing (OCR, layout and tables) and cited answers. Compare RAGFlow vs WeKnora
- AFFiNE Notion- and Miro-style workspace (docs, whiteboards, databases) with built-in AI, self-hostable with Docker. Compare AFFiNE vs WeKnora
- AnythingLLM All-in-one private chat with your documents, agents and an embeddable widget. Compare AnythingLLM vs WeKnora
- PrivateGPT API-first private document Q&A that sits on top of your own LLM server. Compare PrivateGPT vs WeKnora
- Open Notebook Private, self-hosted alternative to Google NotebookLM with your choice of AI models. Compare Open Notebook vs WeKnora
- LightRAG Graph-based RAG server that builds a knowledge graph from your documents, with a web UI and REST API. Compare LightRAG vs WeKnora
- Langchain-Chatchat Chinese-first local knowledge-base Q&A and agent app built on LangChain, wired to local model servers. Compare Langchain-Chatchat vs WeKnora
- Onyx (formerly Danswer) AI chat and enterprise search connected to 50+ workplace apps. Compare Onyx (formerly Danswer) vs WeKnora
- FastGPT Knowledge-base Q&A and visual AI workflow platform. Compare FastGPT vs WeKnora
- kotaemon Open-source RAG web app for chatting with your documents, with citations and GraphRAG. Compare kotaemon vs WeKnora
- MaxKB Enterprise knowledge-base and agent platform with RAG and workflows. Compare MaxKB vs WeKnora
- DocsGPT Open-source platform for AI agents and assistants that answer from your documents with sources. Compare DocsGPT vs WeKnora
- PipesHub Self-hosted workplace search and AI answers across 50+ connected apps, filtered by each user's permissions. Compare PipesHub vs WeKnora
WeKnora FAQ
How much RAM does WeKnora need?
The recommended spec is 4 vCPU · 8 GB RAM. Official guidance is to start from 4 CPU cores and 8 GB RAM because docreader bundles LibreOffice and Playwright. Disk depends on knowledge-base size. Optional Milvus, OpenSearch or Langfuse need more memory.
Does WeKnora need a GPU?
Not required. Local models run through Ollama or another model service you configure.
How much does it cost to self-host WeKnora?
The software is free to download. Based on the official recommended 4 vCPU · 8 GB RAM (no separate minimum published): That fits a Hetzner Cloud CPX32 server at about €35.99/month (server only, excl. VAT). That covers the server only, not LLM API usage, backups, extra storage or your time.
Is WeKnora free for commercial use?
WeKnora is licensed under MIT (with third-party components) (Permissive). Internal business use is allowed under the license text. MIT for WeKnora itself; bundled third-party components keep their own licenses, listed in the LICENSE file. Internal and commercial use allowed. This is a summary, not legal advice.
What are common problems when self-hosting WeKnora?
Registration defaults to self_serve (anyone who can reach it can sign up). Set DISABLE_REGISTRATION=true or switch to invite registration before exposing it; a registration mode saved in the database settings is also checked on every request, so changing the env alone may not take effect. JWT_SECRET and SYSTEM_AES_KEY are empty in .env.example. Generate them once at first deploy and keep them safe, along with the database and Redis passwords. The backend port 8080 is mapped to the host as well as the frontend port; firewall it if the frontend is your only intended entry point. docker compose up -d alone reuses cached images. Run docker compose pull before upgrading and read the upgrade notes.
Is WeKnora still maintained?
Yes, it is actively developed. Last commit: Oct 30, 2026. Latest release: v0.9.0 (Oct 29, 2026). Checked Oct 31, 2026.
How do I install WeKnora?
The official method is Docker Compose. The exact commands are in the "How to deploy" section above and in the official instructions: https://weknora.weixin.qq.com/docs/01-getting-started/02-installation
What are self-hosted alternatives to WeKnora?
Other apps in Knowledge base & RAG: RAGFlow, AFFiNE, AnythingLLM, PrivateGPT, Open Notebook, LightRAG, Langchain-Chatchat, Onyx (formerly Danswer), FastGPT, kotaemon, MaxKB, DocsGPT, PipesHub.
Sources
- GitHub repository: github.com/Tencent/WeKnora
- Official documentation, Hardware requirements, Deploy instructions, Gotcha 2, Gotcha 3, Gotcha 4: weknora.weixin.qq.com/docs/01-getting-started/02-installation
- License text: github.com/Tencent/WeKnora/blob/main/LICENSE
- Gotcha 1: weknora.weixin.qq.com/docs/03-features/01-tenant-auth
- Hetzner Cloud pricing (cost estimate): www.hetzner.com/cloud/regular-performance
- GitHub stars, commits and releases: GitHub REST API, fetched
Facts on this page were checked against the project's own repository and docs on 2026-10-31. Spotted something out of date? Tell us.