k-dense-byok

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• 桌面端本地环境（项目为本地优先的桌面应用，工作区保存在本机普通文件夹）
• 至少一个模型提供方的账号或 API Key（BYOK，自带密钥）
• 可选：本地安装 Ollama，用于数据不允许离开本机的场景
• 可访问 GitHub 与所选模型提供方的网络环境
• 无需编程经验，用自然语言描述任务即可

安装与启动步骤

1. 1观看官方入门视频

   README 顶部提供 Getting Started with K-Dense BYOK 录屏，讲解安装 Kady 并运行第一个研究任务，建议先看完再动手。

2. 2获取项目源码

   从 GitHub 克隆项目仓库到本地，后续按仓库最新文档安装。README 节选未给出安装命令，请以仓库说明为准。

   git clone https://github.com/K-Dense-AI/k-dense-byok.git

   复制

3. 3准备模型密钥

   按 BYOK 模式准备所选提供方的 API Key，支持通过 Ollama、OpenRouter 或 LiteLLM 接入模型，密钥由你自己持有。

4. 4配置本地模型（可选）

   若数据不能离开本机，改用本地 Ollama 模型；用托管模型时，请求所需内容会直接发送给所选提供方。

5. 5启动并创建项目

   安装完成后打开 Kady，新建项目作为独立研究工作区，用自然语言描述任务，如分析数据集、检索文献、生成图表。

关键配置

如何确认成功

安装说明缺失，无法给出确定验证方式；若能用自然语言下达任务并看到 Kady 逐步执行、产出文件出现在项目目录中，即表示可用。

常见问题

注意事项

• README 节选未包含具体安装命令、端口或路径，上述步骤仅为通用准备动作，实际安装请以仓库最新文档和官方录屏为准。
• 敏感数据建议使用本地 Ollama 模型，避免内容离开本机。
• 应用兼容 MCP 协议，便于后续扩展科学工具链。
• 工作区按项目隔离，项目目录会显示运行中、已完成、等待输入、阻塞或出错等状态。