K-Dense BYOK
在本地研究工作区中执行科学分析、证据检索与报告产出的助手。
这个 Agent 能做什么，适合哪些场景？
K-Dense BYOK 是一款在桌面电脑上运行的开源科学研究应用，核心助手名为 Kady。用户以自然语言在项目工作区中提出任务，Kady 可检查文件、编写并运行分析代码、检索与阅读资料，并生成图表、报告和可追溯的工作记录。项目、对话、笔记本和结果保存在本机普通文件夹；使用托管模型时，请求所需材料会直接发送给用户选择的提供商，也可使用 Ollama 或其他 OpenAI 兼容服务器运行本地模型。它提供项目、并行聊天标签、Living Lab Notebook、科学文件预览、LaTeX 编辑和可选 Modal 计算等界面能力，定位是可监督的研究执行环境而非单纯问答工具。
用户创建项目并上传或附加项目文件后，可让 Kady 清洗数据、做质量检查、选择并运行统计方法、比较分组、拟合模型，以及生成可用于发表的图。它可搜索网页并读取网页、PDF、GitHub 仓库和 YouTube 视频，也能处理文本、数据和图像输入。执行过程会在项目目录中留下脚本、中间文件、表格、图、报告和 Living Lab Notebook 条目；笔记本可导出 Markdown、JSON、含工件的 bundle，或打印为 PDF，并可生成论文式 Methods 草稿。模型可经 Settings → Model providers 连接 openai-codex、anthropic、GitHub Copilot 或 xAI 订阅，经 OpenRouter 使用托管模型，或接入 Ollama / OpenAI-compatible server；还可通过 MCP 连接外部研究工具，并用 Modal 执行按需云端 CPU 或 GPU 任务。
- 生物信息学研究者拿到 counts.csv，需要比较处理组与对照组、完成差异表达分析并绘制火山图。
- 科研人员需要搜索和阅读论文、网页、PDF、GitHub 仓库或 YouTube 材料，并整理方法或证据摘要。
- 实验室成员希望把分析代码、产生的图表、决策和相关工件保存在可导出的 Living Lab Notebook 中。
- 使用敏感研究数据的个人或团队希望在本机项目目录工作，并通过 Ollama 或其他 OpenAI-compatible server 使用本地模型。
- 需要较长计算任务的研究者希望在单个聊天中选择 Modal 的云端 CPU 或单/多 GPU 环境，并将输出带回本地项目。
这个 Agent 有哪些优点和局限？
- 本地项目目录保留脚本、数据工件、对话和结果，便于检查、移动、备份或用其他软件访问。
- 覆盖从数据分析到文献检索、科学文件预览、图表与报告的一条研究执行链，而不是只生成文本回答。
- 可在同一界面使用 OpenRouter、多个订阅登录、Ollama 或其他 OpenAI-compatible server，并按聊天选择模型。
- Living Lab Notebook 可关联假设、方法、观察、决策、代码与工件，并支持多种导出。
- 产品目前处于 beta，文档明确表示仍有待改进之处。
- 应用免费不代表模型和计算免费：OpenRouter、Anthropic OAuth 的计量使用及 Modal 计算可能产生费用，且受项目预算限制。
- 托管模型请求会将该请求所需材料发送给所选提供商；严格数据驻留需求需改用本地模型。
- Windows 依赖 Node.js 22+ 与 Git for Windows，首次启动还需要数分钟自动安装依赖。
如何安装或部署这个 Agent？
需要 macOS、Linux 或 Windows 10/11，以及至少一个模型来源：OpenRouter API key、可连接的 ChatGPT Plus/Pro、Claude Pro/Max、GitHub Copilot 或 xAI 订阅，或本地 Ollama 模型。macOS/Linux：git clone https://github.com/K-Dense-AI/k-dense-byok.gitcd k-dense-byokcp .env.example .env./start.sh
Windows 先安装 Node.js 22+ 和 Git for Windows，然后运行：git clone https://github.com/K-Dense-AI/k-dense-byok.gitcd k-dense-byokcopy .env.example .env.\start.cmd
首次启动会自动安装依赖，随后在 http://localhost:3000 打开；.env 为可选设置，可填写 OpenRouter key。
如何使用这个 Agent？
打开本地应用后创建项目，放入数据或在对话中附加项目文件，再以自然语言提出具体任务，例如：“Run a differential expression analysis on counts.csv comparing treated vs control, and plot a volcano plot.” 如使用订阅，在 Settings → Model providers 登录并在模型选择器中选择模型和推理级别；如使用 OpenRouter，则配置其 API key。运行中可查看工具调用与生成的文件，最多向正在运行的对话追加五条跟进消息，也可停止运行；在 Living Lab Notebook 检查、注释或导出记录。
这个 Agent 与同类方案有什么区别？
README 展示了 K-Dense 自行设计、运行和评估的 20 条提示内部基准，将 K-Dense BYOK 与 Claude Science、Biomni Lab 对比。该测试中 K-Dense BYOK 使用 Claude Opus 4.8 和 xHigh 推理级别；结果不是独立评测，也不应视为通用平台排名。