head to head · open source
mkdocs vs Yuxi
mkdocs has 22,512 GitHub stars, 2,661 forks, 192 open issues and last shipped 1.0 years ago. Yuxi has 7,485 stars, 1,220 forks, 90 open issues and last shipped 2 days ago. mkdocs leads on adoption by 201% (22,512 vs 7,485 stars). mkdocs is written in Python under BSD-2-Clause; Yuxi is written in Python under MIT. mkdocs has attracted 12% as many forks as stars, Yuxi 16%. Yuxi was the more recently maintained of the two, and both are self-hostable with no licence fee.
Two open source projects, one decision. Both are free and self-hostable — the differences are community size, license terms, language stack and release pace.
← all 20902 open source comparisons
Side by side
| mkdocs | Yuxi | |
|---|---|---|
| GitHub stars | ★ 23K | ★ 7.5K |
| License | BSD-2-Clause | MIT |
| Written in | Python | Python |
| Last push | 2025-10-20 | 2026-10-24 |
| Forks | ⑂ 2.7K | ⑂ 1.2K |
| Self-hosting | Yes | Yes |
| Data ownership | Your server | Your server |
pick mkdocs if
- You weight community size — 23K stars and counting
- You want the BSD-2-Clause license terms
- Your stack matches Python
- You value the larger contributor base for long-term maintenance
pick Yuxi if
- You want the Yuxi feature set and don't need the biggest community
- You prefer the MIT license terms
- Your stack matches Python
- You evaluated both and Yuxi fits your workflow better
About mkdocs
MkDocs Project documentation with Markdown [![PyPI Version][pypi v image]][pypi v link] [![Build Status][GHAction image]][GHAction link] [![Coverage Status][codecov image]][codecov link] MkDocs is a fast , simple and downright gorgeous static site generator that's geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file. It is designed to be easy to use and can be extended with third party themes, plugins, and Markdown extensions. Please see the [Documentation][mkdocs] for an introductory tutorial and a full user…
read the full mkdocs overview →
About Yuxi
Yuxi 是一个可私有部署的多租户知识智能体平台。它把知识库检索、知识图谱、LangGraph 多智能体编排、MCP/Skills、沙盒工具和权限管理放进同一个工作区。 项目主页 · 快速开始 · 演示视频 · 版本记录 · English Yuxi 能做什么 Yuxi 面向需要自己掌握数据、模型和权限的团队： 构建知识问答 ：上传文档，经过解析、分块和向量索引后，让智能体结合检索内容回答问题。 执行多步骤任务 ：组合工具、MCP、Skills、子智能体和沙盒，产出可预览、可下载的文件。 连接知识图谱 ：从 Milvus 知识库的文档块中抽取实体和关系，写入 Neo4j 并参与检索。 管理团队使用范围 ：按用户、部门和共享范围管理知识库、智能体、Skills 和模型。 对比运行质量 ：评估知识库的检索结果，也可以用 Langfuse Dataset 评估完整智能体任务。 技术栈 快速启动 前置条件 安装 Docker Engine 和 Docker Compose，并准备一个可用的大模型 API。当前仓库默认配置对应 v0.7.3 。 1. 获取代码并初始化 初始化脚本会创建 .env 、读取 SiliconFlow API Key，并为 JWT、API Key 派生和 Sandbox provisioner 生成独立的安全密钥。也可以手动复制 .env.template 并填写这些值。 2. 启动开发环境…
More in Content & Publishing
Related comparisons
More Documentation & Knowledge Base projects
Compare either of these against the rest of the Documentation & Knowledge Base field.
Frequently asked questions
Is mkdocs or Yuxi more popular?
mkdocs has 22,512 GitHub stars and Yuxi has 7,485. mkdocs has the larger community by that measure.
Are mkdocs and Yuxi free?
Both are open source. mkdocs is licensed under BSD-2-Clause and Yuxi under MIT. Neither carries a licence fee.
What is the difference between mkdocs and Yuxi?
mkdocs is written in Python and Yuxi in Python. The practical differences are community size, licence terms, language stack and release cadence — all compared in the table above.
Which should I choose, mkdocs or Yuxi?
Choose mkdocs if you want the larger community (22,512 stars) or its BSD-2-Clause licence terms. Choose Yuxi if its feature set, stack or MIT licence fits better. Both are self-hostable.