๐ค
WeKnora agent by Tencent
โญ 48.8
๐ฌTechnical Deep Dive
Full Specifications [+]
Quick Commands
๐ PIP Install
pip install weknora โ๏ธ Nexus Index V2.0
48.8
TOP 100% SYSTEM IMPACT
Semantic (S) 50
Authority (A) 0
Popularity (P) 76
Recency (R) 100
Quality (Q) 50
๐ฌ Index Insight
FNI V2.0 for WeKnora: Semantic (S:50), Authority (A:0), Popularity (P:76), Recency (R:100), Quality (Q:50).
Free2AITools Nexus Index
Verification Authority
Unbiased Data
Node Refresh: VFS Live
Agent Architecture
VFS Recovering Reference...
| English | ็ฎไฝไธญๆ | ๆฅๆฌ่ช | ํ๊ตญ์ด |
Overview โข Architecture โข Key Features โข Getting Started โข API Reference โข Developer Guide
๐ก WeKnora โ Turn Documents into Living Knowledge with RAG, Agents and Auto-Wiki
๐ Overview
WeKnora is an open-source, LLM-powered knowledge framework built for enterprise-grade document understanding, semantic retrieval, and autonomous reasoning.
It is organized around three core capabilities: RAG-based Quick Q&A for everyday lookups, a ReAct Agent that autonomously orchestrates retrieval, MCP tools and web search to handle complex multi-step tasks, and a brand-new Wiki Mode in which agents distill raw documents into a self-maintaining, interlinked markdown knowledge base with an interactive knowledge graph. Combined with multi-source ingestion (Feishu / Notion / Yuque, and growing), 20+ LLM provider integrations, full Langfuse observability, and a fully self-hostable modular architecture, WeKnora turns scattered documents into a queryable, reasoning-capable, continuously evolving knowledge asset.
The framework supports auto-syncing knowledge from Feishu, Notion, and Yuque (more data sources coming soon), handles 10+ document formats including PDF, Word, images, and Excel, and can serve Q&A directly through IM channels like WeCom, Feishu, Slack, and Telegram. It is compatible with major LLM providers including OpenAI, DeepSeek, Qwen (Alibaba Cloud), Zhipu, Hunyuan, Gemini, MiniMax, NVIDIA, and Ollama. Its fully modular design allows swapping LLMs, vector databases, and storage backends, with support for local and private cloud deployment ensuring complete data sovereignty. WeKnora also integrates with Langfuse for comprehensive observability into agent reasoning, token usage, and pipeline tracing.
โจ Latest Updates
v0.5.0 Highlights:
- Wiki Mode: A brand-new agent-driven Wiki knowledge system that automatically distills raw documents into interlinked markdown pages. It ships with a dedicated WikiBrowser and an interactive knowledge graph that visualizes references and relationships between pages, helping teams grow a structured, continuously evolving knowledge base from their own materials.
- Observability: Integrated Langfuse for agent ReAct loop, LLM token tracking, tool calls, and asynq pipeline tracing, providing deep visibility into agent reasoning and system performance.
- Customizable Indexing Strategy: Users can now independently configure and toggle Vector Search, Keyword Search (Hybrid), Wiki, and Knowledge Graph indexing per knowledge base.
- Vector Store UI & Per-KB Binding: Full frontend management for Vector Stores with connectivity testing, plus the ability to bind distinct vector databases to specific knowledge bases.
- Yuque Connector: Yuque data source integration with API client, full and incremental fetch, enabling seamless synchronization of Yuque documents.
- Agent Capabilities: Added
json_repairtool for automatic JSON fixing, preloadedOpenMAIC Classroomskill, and DuckDB multi-sheet Excel data analysis. - Frontend & Debugging: Added copy action for model cards in settings, and enhanced LLM request debugging and logging across all model providers.
- Bug Fixes: Fixed DuckDB access issues by materializing knowledge files to temp path, removed rerank model requirement for wiki-only agents, and whitelisted offline protoc zip packages in dockerignore.
Earlier Releases
v0.4.0 Highlights:
- Knowledge Assistant: Cloud-hosted knowledge assistant service for quick onboarding without local deployment
- WeKnora Cloud: WeKnora Cloud provider with hosted LLM models and document parsing service, credential management and status checks
- Chrome Extension: Browser extension for web page knowledge capture
- ClawHub Skill: ClawHub Skill marketplace integration for one-click agent skill installation
- WeChat IM Integration: WeChat channel adapter with QR code login and long-polling message support
- Attachment Processing: File attachment support in chat pipeline with content formatting and metadata injection
- Azure OpenAI Provider: Full Azure OpenAI support for chat, VLM, and embedding models with deployment name preservation and dimensions parameter
- Alibaba Cloud OSS Storage: Object storage support via S3-compatible mode with configuration UI, connectivity test, and multi-language i18n
- Notion Connector: Notion data source integration with API client, markdown renderer, and Connector interface
- Baidu & Ollama Web Search: Added Baidu and Ollama as web search providers
- VectorStore Management: Full VectorStore CRUD with entity, repository, service layer, connection testing, and API endpoints
- Bug Fixes: Fixed Azure OpenAI endpoint handling, embedding truncation, IM citation tag stripping, neo4j Go 1.24 Windows compatibility, and OSS signature issues
v0.3.6 Highlights:
- ASR (Automatic Speech Recognition): Integrated ASR model support with audio file upload, in-document audio preview, and transcription capabilities
- Data Source Auto-Sync (Feishu): Complete data source management with Feishu Wiki/Drive auto-sync, incremental and full sync, sync logs, and tenant isolation
- OIDC Authentication: OpenID Connect login support with auto-discovery, custom endpoints, and user info mapping
- IM Quote/Reply Context: Quoted messages extracted in IM channels and injected into LLM prompts for contextual replies; anti-hallucination for non-text quotes
- Thread-Based IM Sessions: Per-thread session mode for IM channels (Slack, Mattermost, Feishu, Telegram), enabling multi-user collaboration within threads
- Document Summarization: AI-generated document summaries with configurable input limits and a dedicated summary section in document detail view
- Tavily Web Search: Added Tavily as a web search provider; refactored web search provider architecture for extensibility
- MCP Auto-Reconnection: Automatic reconnection for MCP tool calls when server connection is lost
- Parallel Tool Calling: Concurrent execution of multiple agent tool calls via errgroup for faster complex task handling
- Agent @Mention Scope Restriction: User @mentions restricted to agent's allowed knowledge base scope, preventing unauthorized access
- Login Page Performance: Removed all backdrop-filter blur effects, reduced animations, added GPU compositing hints for faster page load
v0.3.5 Highlights:
- Telegram, DingTalk & Mattermost IM Integration: Added Telegram bot (webhook/long-polling, streaming via editMessageText), DingTalk bot (webhook/Stream mode, AI Card streaming), and Mattermost adapter; IM channel coverage now includes WeCom, Feishu, Slack, Telegram, DingTalk, and Mattermost
- IM Slash Commands & QA Queue: Pluggable slash-command system (/help, /info, /search, /stop, /clear) with a bounded QA worker pool, per-user rate limiting, and Redis-based multi-instance coordination
- Suggested Questions: Agents surface context-aware suggested questions based on configured knowledge bases; image knowledge automatically enqueues question generation
- VLM Auto-Describe MCP Tool Images: When MCP tools return images, the agent generates text descriptions via the configured VLM model, enabling image content to be used by text-only LLMs
- Novita AI Provider: New LLM provider with OpenAI-compatible API supporting chat, embedding, and VLLM model types
- MCP Tool Name Stability: Tool names now based on service name (stable across reconnections) instead of UUID; unique name constraint added; frontend formats names into human-readable form
- Channel Tracking: Knowledge entries and messages record source channel (web/api/im/browser_extension) for traceability
- Bug Fixes: Fixed agent empty response when no knowledge base is configured, UTF-8 truncation in summaries for Chinese/emoji documents, API key encryption loss on tenant settings update, vLLM streaming reasoning content propagation, and rerank empty passage errors
v0.3.4 Highlights:
- IM Bot Integration: WeCom, Feishu, and Slack IM channel support with WebSocket/Webhook modes, streaming, and knowledge base integration
- Multimodal Image Support: Image upload and multimodal image processing with enhanced session management
- Manual Knowledge Download: Download manual knowledge content as files with proper filename sanitization
- NVIDIA Model API: Support NVIDIA chat model API with custom endpoint and VLM model configuration
- Weaviate Vector DB: Added Weaviate as a new vector database backend for knowledge retrieval
- AWS S3 Storage: Integrated AWS S3 storage adapter with configuration UI and database migrations
- AES-256-GCM Encryption: API keys encrypted at rest with AES-256-GCM for enhanced security
- Built-in MCP Service: Built-in MCP service support for extending agent capabilities
- Hybrid Search Optimization: Grouped targets and reused query embeddings for better retrieval performance
- Final Answer Tool: New final_answer tool with agent duration tracking for improved agent workflows
v0.3.3 Highlights:
- Parent-Child Chunking: Hierarchical parent-child chunking strategy for enhanced context management and more accurate retrieval
- Knowledge Base Pinning: Pin frequently-used knowledge bases for quick access
- Fallback Response: Fallback response handling with UI indicators when no relevant results are found
- Passage Cleaning for Rerank: Passage cleaning for rerank model to improve relevance scoring accuracy
- Storage Auto-Creation: Storage engine connectivity check with auto-creation of buckets
- Milvus Vector DB: Added Milvus as a new vector database backend for knowledge retrieval
v0.3.2 Highlights:
- ๐ Knowledge Search: New "Knowledge Search" entry point with semantic retrieval, supporting bringing search results directly into the conversation window
- โ๏ธ Parser & Storage Engine Configuration: Configure document parser engines and storage engines for different sources in settings, with per-file-type parser selection in knowledge base
- ๐ผ๏ธ Image Rendering in Local Storage: Support image rendering during conversations in local storage mode, with optimized streaming image placeholders
- ๐ Document Preview: Embedded document preview component for previewing user-uploaded original files
- ๐จ UI Optimization: Knowledge base, agent, and shared space list page interaction redesign
- ๐๏ธ Milvus Support: Added Milvus as a new vector database backend for knowledge retrieval
- ๐ Volcengine TOS: Added Volcengine TOS object storage support
- ๐ Mermaid Rendering: Support mermaid diagram rendering in chat with fullscreen viewer, zoom, pan, toolbar and export
- ๐ฌ Batch Conversation Management: Batch management and delete all sessions functionality
- ๐ Remote URL Knowledge: Support creating knowledge entries from remote file URLs
- ๐ง Memory Graph Preview: Preview of user-level memory graph visualization
- ๐ Async Re-parse: Async API for re-processing existing knowledge documents
v0.3.0 Highlights:
- ๐ข Shared Space: Shared space with member invitations, shared knowledge bases and agents across members, tenant-isolated retrieval
- ๐งฉ Agent Skills: Agent skills system with preloaded skills for smart-reasoning agent, sandboxed execution environment for security isolation
- ๐ค Custom Agents: Support for creating, configuring, and selecting custom agents with knowledge base selection modes (all/specified/disabled)
- ๐ Data Analyst Agent: Built-in Data Analyst agent with DataSchema tool for CSV/Excel analysis
- ๐ง Thinking Mode: Support thinking mode for LLM and agents, intelligent filtering of thinking content
- ๐ Web Search Providers: Added Bing and Google search providers alongside DuckDuckGo
- ๐ Enhanced FAQ: Batch import dry run, similar questions, matched question in search results, large imports offloaded to object storage
- ๐ API Key Auth: API Key authentication mechanism with Swagger documentation security
- ๐ In-Input Selection: Select knowledge bases and files directly in the input box with @mention display
- โธ๏ธ Helm Chart: Complete Helm chart for Kubernetes deployment with Neo4j GraphRAG support
- ๐ i18n: Added Korean (ํ๊ตญ์ด) language support
- ๐ Security Hardening: SSRF-safe HTTP client, enhanced SQL validation, MCP stdio transport security, sandbox-based execution
- โก Infrastructure: Qdrant vector DB support, Redis ACL, configurable log level, Ollama embedding optimization,
DISABLE_REGISTRATIONcontrol
v0.2.0 Highlights:
- ๐ค Agent Mode: New ReACT Agent mode that can call built-in tools, MCP tools, and web search, providing comprehensive summary reports through multiple iterations and reflection
- ๐ Multi-Type Knowledge Bases: Support for FAQ and document knowledge base types, with new features including folder import, URL import, tag management, and online entry
- โ๏ธ Conversation Strategy: Support for configuring Agent models, normal mode models, retrieval thresholds, and Prompts, with precise control over multi-turn conversation behavior
- ๐ Web Search: Support for extensible web search engines with built-in DuckDuckGo search engine
- ๐ MCP Tool Integration: Support for extending Agent capabilities through MCP, with built-in uvx and npx launchers, supporting multiple transport methods
- ๐จ New UI: Optimized conversation interface with Agent mode/normal mode switching, tool call process display, and comprehensive knowledge base management interface upgrade
- โก Infrastructure Upgrade: Introduced MQ async task management, support for automatic database migration, and fast development mode
๐ฑ Interface Showcase
๐ฌ Intelligent Q&A Conversation |
|
๐ Wiki Browser |
๐ธ๏ธ Wiki Knowledge Graph |
๐ค Agent Mode ยท Tool Call Process |
โ๏ธ Conversation Settings |
๐ญ Observability ยท Langfuse Tracing |
|
๐๏ธ Architecture
Fully modular pipeline from document parsing, vectorization, and retrieval to LLM inference โ every component is swappable and extensible. Supports local / private cloud deployment with full data sovereignty and a zero-barrier Web UI for quick onboarding.
๐งฉ Feature Overview
Intelligent Conversation
| Capability | Details |
|---|---|
| Intelligent Reasoning | ReACT progressive multi-step reasoning, autonomously orchestrating knowledge retrieval, MCP tools, and web search; custom agent support |
| Quick Q&A | RAG-based Q&A over knowledge bases for fast and accurate answers |
| Wiki Mode | Agent-driven auto-generation of structured, interlinked markdown Wiki pages from raw documents |
| Tool Calling | Built-in tools, MCP tools, web search |
| Conversation Strategy | Online Prompt editing, retrieval threshold tuning, multi-turn context awareness |
| Suggested Questions | Auto-generated question suggestions based on knowledge base content |
Knowledge Management
| Capability | Details |
|---|---|
| Knowledge Base Types | FAQ / Document / Wiki with folder import, URL import, tag management, and online entry |
| Data Source Import | Auto-sync from Feishu / Notion / Yuque (more data sources coming soon); incremental and full sync |
| Document Formats | PDF / Word / Txt / Markdown / HTML / Images / CSV / Excel / PPT / JSON |
| Retrieval Strategies | BM25 sparse / Dense retrieval / GraphRAG / parent-child chunking / multi-dimensional indexing |
| E2E Testing | Full-pipeline visualization with recall hit rate, BLEU / ROUGE metric evaluation |
Integrations & Extensions
| Capability | Details |
|---|---|
| LLMs | OpenAI / Azure OpenAI / DeepSeek / Qwen (Alibaba Cloud) / Zhipu / Hunyuan / Doubao (Volcengine) / Gemini / MiniMax / NVIDIA / Novita AI / SiliconFlow / OpenRouter / Ollama |
| Embeddings | Ollama / BGE / GTE / OpenAI-compatible APIs |
| Vector DBs | PostgreSQL (pgvector) / Elasticsearch / Milvus / Weaviate / Qdrant |
| Object Storage | Local / MinIO / AWS S3 / Volcengine TOS / Alibaba Cloud OSS |
| IM Channels | WeCom / Feishu / Slack / Telegram / DingTalk / Mattermost / WeChat |
| Web Search | DuckDuckGo / Bing / Google / Tavily / Baidu / Ollama |
Platform
| Capability | Details |
|---|---|
| Deployment | Local / Docker / Kubernetes (Helm) with private and offline support |
| UI | Web UI / RESTful API / Chrome Extension |
| Observability | Integrated Langfuse for ReAct loops, token tracking, tool calls, and pipeline tracing |
| Task Management | MQ async tasks, automatic database migration on version upgrade |
| Model Management | Centralized config, per-knowledge-base model selection, multi-tenant built-in model sharing, WeKnora Cloud hosted models and parsing |
๐งฉ Chrome Extension
WeKnora Chrome Extension lets you capture web content directly into your WeKnora knowledge base. Select text, images, or entire pages in the browser and save them as knowledge entries with one click โ no copy-paste or file upload needed.
๐ฆ ClawHub Skill
WeKnora ClawHub Skill is a WeKnora skill published on the ClawHub platform. Once installed, it enables document import (file / URL / Markdown), hybrid search (vector + keyword) across knowledge bases, and knowledge entry management โ all through the WeKnora REST API.
- Document Import โ Upload files, import web pages, or write Markdown knowledge via the agent
- Hybrid Search โ Search within or across knowledge bases with vector + keyword retrieval
- Knowledge Management โ List, browse, edit, and delete knowledge entries programmatically
๐ Getting Started
๐ Prerequisites
๐ฆ Installation & Launch
bash
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 up -d # Start core servicesOnce started, visit http://localhost to get started.
To use a local Ollama model, run
ollama serve > /dev/null 2>&1 &first.
๐ง Optional Services (Docker Compose Profiles)
Add --profile flags to enable additional components. Multiple profiles can be combined:
| Profile | Description | Command |
|---|---|---|
| (default) | Core services | docker compose up -d |
full |
All features | docker compose --profile full up -d |
neo4j |
Knowledge Graph (Neo4j) | docker compose --profile neo4j up -d |
minio |
Object Storage (MinIO) | docker compose --profile minio up -d |
langfuse |
Tracing (Langfuse) | docker compose --profile langfuse up -d |
Combine profiles: docker compose --profile neo4j --profile minio up -d
Stop services: docker compose down
๐ Service URLs
| Service | URL |
|---|---|
| Web UI | http://localhost |
| Backend API | http://localhost:8080 |
| Langfuse Tracing | http://localhost:3000 |
MCP Server
Please refer to the MCP Configuration Guide for the necessary setup.
๐ Using WeChat Dialog Open Platform
WeKnora serves as the core technology framework for the WeChat Dialog Open Platform, providing a more convenient usage approach:
- Zero-code Deployment: Simply upload knowledge to quickly deploy intelligent Q&A services within the WeChat ecosystem, achieving an "ask and answer" experience
- Efficient Question Management: Support for categorized management of high-frequency questions, with rich data tools to ensure accurate, reliable, and easily maintainable answers
- WeChat Ecosystem Integration: Through the WeChat Dialog Open Platform, WeKnora's intelligent Q&A capabilities can be seamlessly integrated into WeChat Official Accounts, Mini Programs, and other WeChat scenarios, enhancing user interaction experiences
๐ API Reference
Troubleshooting FAQ: Troubleshooting FAQ
Detailed API documentation is available at: API Docs
Product plans and upcoming features: Roadmap
๐งญ Developer Guide
โก Fast Development Mode (Recommended)
If you need to frequently modify code, you don't need to rebuild Docker images every time! Use fast development mode:
bash
# Start infrastructure
make dev-start
# Start backend (new terminal)
make dev-app
# Start frontend (new terminal)
make dev-frontendDevelopment Advantages:
- โ Frontend modifications auto hot-reload (no restart needed)
- โ Backend modifications quick restart (5-10 seconds, supports Air hot-reload)
- โ No need to rebuild Docker images
- โ Support IDE breakpoint debugging
Detailed Documentation: Development Environment Quick Start
๐ Directory Structure
text
WeKnora/
โโโ client/ # go client
โโโ cmd/ # Main entry point
โโโ config/ # Configuration files
โโโ docker/ # docker images files
โโโ docreader/ # Document parsing app
โโโ docs/ # Project documentation
โโโ frontend/ # Frontend app
โโโ internal/ # Core business logic
โโโ mcp-server/ # MCP server
โโโ migrations/ # DB migration scripts
โโโ scripts/ # Shell scripts๐ค Contributing
Welcome to submit Issues or Pull Requests.
Process: Fork โ Create branch โ Commit changes โ Open PR
Standards: Format code with gofmt, follow Conventional Commits (feat: / fix: / docs: / test: / refactor:)
๐ Security Notice
Important: Starting from v0.1.3, WeKnora includes login authentication functionality to enhance system security. For production deployments, we strongly recommend:
- Deploy WeKnora services in internal/private network environments rather than public internet
- Avoid exposing the service directly to public networks to prevent potential information leakage
- Configure proper firewall rules and access controls for your deployment environment
- Regularly update to the latest version for security patches and improvements
๐ฅ Contributors
Thanks to these excellent contributors:
๐ License
This project is licensed under the MIT License. You are free to use, modify, and distribute the code with proper attribution.
๐ Project Statistics
๐ Quick Start
bash
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 up -d # Start core services๐ Daily sync (03:00 UTC)
AI Summary: Based on GitHub metadata. Not a recommendation.
๐ก๏ธ Agent Transparency Report
Technical metadata sourced from upstream repositories.
Open Metadata
๐ Identity & Source
- id
- gh-model--tencent--weknora
- slug
- tencent--weknora
- source
- github
- author
- Tencent
- license
- NOASSERTION
- tags
- agent, agentic, ai, chatbot, chatbots, embeddings, evaluation, generative-ai, golang, knowledge-base, llm, multi-tenant, multimodel, ollama, openai, question-answering, rag, reranking, semantic-search, vector-search, go, wiki
โ๏ธ Technical Specs
- architecture
- null
- params billions
- null
- context length
- null
- pipeline tag
- text-generation
๐ Engagement & Metrics
- downloads
- 0
- stars
- 13,720
- forks
- 0
- github stars
- 13,720
Data indexed from public sources. Updated daily.