kotaemon 文档问答应用

kotaemon：安装说明

这个工具包里只有安装说明，由 Mindket 编写。kotaemon 本身、它的 Docker 镜像和文档都来自 Cinnamon 的仓库：https://github.com/Cinnamon/kotaemon

这些说明不是 Cinnamon 写的，也没有得到它的认可。README 对 kotaemon 的介绍是 "An open-source clean & customizable RAG UI for chatting with your documents. Built with both end users and developers in mind."，意思是：一个简洁、可定制的开源 RAG 界面，用来和你的文档对话，同时照顾到终端用户和开发者。用户指南在 https://cinnamon.github.io/kotaemon/

许可证：Apache-2.0。LICENSE 文件（https://github.com/Cinnamon/kotaemon/blob/main/LICENSE.txt ）是标准的 Apache License 2.0 文本。它的附录保留了模板里的那行 "Copyright [yyyy] [name of copyright owner]"，所以没有写明版权所有者。

这些说明依据的是 README、用户指南各页和安装脚本，每个文件都写明了出处，于 2026 年 11 月 3 日阅读。Mindket 没有实际运行这个应用。

放到网络上之前先读这一段

截至 2026 年 11 月 3 日，Releases 页上的最新版本是 v0.12.0（2026 年 5 月 31 日发布）。美国国家漏洞数据库（NVD）列出了三份针对 0.12.0 及以前版本的报告。其中 CVE-2026-69098 说的是无需登录就能执行代码，VulnCheck 把它评为严重。另外两份，CVE-2026-82281 和 CVE-2026-86867，说的是聊天相关的函数不检查对话归谁所有。

GitHub 上的 issue #844 和 #846 是前两份报告的报告者写的说明。2026 年 11 月 3 日时，两个 issue 都还开着，没有评论，没有指派人，也没有关联的拉取请求。这些来源展示的是报告者自己的概念验证，没有提到真实环境中的攻击。setup/before-you-share-it.md 逐条列出每份报告和出处。在有版本修复之前，只在你自己的电脑上自己用 kotaemon，别让其他人能通过网络访问 7860 端口。

会安装什么

• Docker 方式：镜像 ghcr.io/cinnamon/kotaemon，有 main-full、main-lite 和 main-ollama 三种。出处：https://github.com/Cinnamon/kotaemon/blob/main/README.md
• zip 方式：最新发布版里的 kotaemon-app.zip。它的 scripts 文件夹里有 run_windows.bat、run_macos.sh 和 run_linux.sh。脚本会在解压后文件夹里的 install_dir 中安装 Miniconda 和一个 Python 3.10 环境，然后安装并启动 kotaemon。出处：https://github.com/Cinnamon/kotaemon/blob/main/docs/index.md 和 https://github.com/Cinnamon/kotaemon/tree/main/scripts
• 源码方式：仓库里的两个 Python 包 libs/kotaemon 和 libs/ktem，用 uv 或 conda 安装。出处：README。
• 每种方式都把应用数据放在 ktem_app_data 文件夹里。README 说，备份或复制这个文件夹，就能把整套安装搬到新电脑上。

事先要准备的

• Docker，用于 README 推荐的方式。源码安装需要 Python 3.10 或更新版本。
• Unstructured，只有源码安装、又要处理 .pdf、.html、.mhtml 和 .xlsx 以外的文件时才需要。full 版 Docker 镜像已经带了它的额外依赖。出处：README。
• 一个语言模型和一个嵌入模型：服务商的 API 密钥，或者 Ollama 这类本地服务。见 setup/models-and-env.md。

主要安装命令

README 推荐 Docker。下面的命令运行 full 镜像，在 7860 端口提供应用。请在一个可以创建 ktem_app_data 的文件夹里运行。

docker run \
-e GRADIO_SERVER_NAME=0.0.0.0 \
-e GRADIO_SERVER_PORT=7860 \
-v ./ktem_app_data:/app/ktem_app_data \
-p 7860:7860 -it --rm \
ghcr.io/cinnamon/kotaemon:main-full

出处：https://github.com/Cinnamon/kotaemon/blob/main/README.md 。然后打开 http://localhost:7860/ ，用户名 admin，密码 admin。第一件事是改掉这个密码。

各个文件

• setup/docker.md：full、lite 和 Ollama 三种镜像，平台参数，以及在 Docker 里连本地模型
• setup/zip-installer.md：Windows、macOS 和 Linux 的发布版 zip，以及脚本做了什么
• setup/from-source.md：uv 或 conda、.env 文件、PDF 阅读器和 python app.py
• setup/hugging-face-space.md：复制制作方的 Hugging Face 模板，以及在线演示
• setup/models-and-env.md：在 Resources 标签页或 .env 里设置模型，以及本地模型
• setup/graphrag.md：Nano GraphRAG、LightRAG 和微软 GraphRAG
• setup/document-loaders.md：Docling、PaddleOCR、Azure Document Intelligence 和 Adobe PDF Extract
• setup/before-you-share-it.md：第一次登录、用户管理和尚未处理的安全报告

更新或卸载

用户指南说，第一次安装之后，或者改动任何东西之后，再运行一次 run_* 脚本就能启动应用。README 说，从最新发布版下载 zip，就能拿到最新的功能和修复。Docker 镜像的各个标签列在 https://github.com/Cinnamon/kotaemon/pkgs/container/kotaemon

这些说明参考的页面都没有给卸载步骤。如果要手动清除，下面是 Mindket 根据 README 和脚本整理的做法，不是 Cinnamon 的说明。README 的 Docker 命令带了 --rm，容器停下就会被删除，你的数据留在 ktem_app_data 里，直到你删掉这个文件夹。zip 方式把 Miniconda、Python 环境和（Windows 上的）Portable Git 都放在解压后文件夹里的 install_dir 中，删掉解压后的文件夹就全部清除了。

使用数据和对外连接

这些说明参考的页面没有说 kotaemon 是否发送使用数据，Mindket 也没有读应用的代码去确认。页面上能看到的连接有这些：

• 你的模型服务商：应用会把你的问题和匹配到的段落发给你设置的模型。用户指南说，用 Ollama 这类本地模型时，文档在本地存储和处理。
• 安装脚本：从 repo.anaconda.com 下载 Miniconda，从 github.com 下载 kotaemon 本身，从 Mozilla 在 github.com 上的发布页下载 PDF.js。Windows 脚本还会从 7-zip.org 下载 7-Zip，从 github.com 下载 Portable Git。脚本还会用 pip 从默认的包索引（PyPI）安装 kotaemon 的 Python 依赖，并用 conda 创建 Python 3.10 环境。
• 你自己开启的服务：Cohere 重排序（.env.example 里的 COHERE_API_KEY 一行，以及用户指南里的重排序分数）、VoyageAI、Azure Document Intelligence 和 Adobe PDF Extract。

出处

• README：https://github.com/Cinnamon/kotaemon/blob/main/README.md
• 用户指南，入门：https://github.com/Cinnamon/kotaemon/blob/main/docs/index.md
• 用户指南，使用：https://github.com/Cinnamon/kotaemon/blob/main/docs/usage.md
• 在线安装：https://github.com/Cinnamon/kotaemon/blob/main/docs/online_install.md
• 本地模型：https://github.com/Cinnamon/kotaemon/blob/main/docs/local_model.md
• Docling：https://github.com/Cinnamon/kotaemon/blob/main/docs/integrations/docling.md
• PaddleOCR：https://github.com/Cinnamon/kotaemon/blob/main/docs/integrations/paddle_ocr.md
• 用户管理：https://github.com/Cinnamon/kotaemon/blob/main/docs/pages/app/ext/user-management.md
• 示例配置：https://github.com/Cinnamon/kotaemon/blob/main/.env.example
• 安装脚本：https://github.com/Cinnamon/kotaemon/tree/main/scripts
• 发布页：https://github.com/Cinnamon/kotaemon/releases
• Security 标签页：https://github.com/Cinnamon/kotaemon/security