项目地址：https://github.com/skyfireitdiy/Jarvis

2. 快速开始

本章节将指导您如何快速安装、配置并开始使用 Jarvis，开启您的智能 AI 助手之旅。

2.1 系统要求

• 操作系统: Jarvis 的许多核心工具依赖于 Linux 环境，因此目前主要支持在 Linux 系统下使用。

• Windows 用户: 虽然未经原生测试，但 Windows 10/11 用户可以通过 WSL (Windows Subsystem for Linux) 来完整地体验 Jarvis 的所有功能。

• Python 版本: 需要 Python 3.8 或更高版本。

2.2 安装

我们提供了两种安装方式：一键安装脚本（推荐）和手动安装。

一键安装 (推荐)

为了简化安装过程，我们提供了一个一键安装脚本，它会自动处理所有依赖和配置。只需在您的终端中执行以下命令：

bash -c "$(curl -fsSL https://raw.githubusercontent.com/skyfireitdiy/Jarvis/main/scripts/install.sh)"

该脚本会执行以下操作：

1. 检测并验证您的 Python 环境。

2. 从 GitHub 克隆最新的 Jarvis 项目代码。

3. 安装所有必需的依赖项。

4. 设置好相关的环境变量和路径。

手动安装

如果您希望更好地控制安装过程，可以选择手动安装。

1. 从源码安装 (获取最新功能)

# 1. 克隆仓库git clone https://github.com/skyfireitdiy/Jarvis
# 2. 进入项目目录cd Jarvis
# 3. 安装项目为可编辑模式pip3 install -e .

提示: 使用 -e . (可编辑模式) 安装后，您对源码的任何修改都会立刻生效，非常适合开发者。

2. 通过 PyPI 安装 (版本可能稍旧)

pip3 install jarvis-ai-assistant

2.3 首次运行与配置

安装完成后，您需要进行一次简单的配置，将 Jarvis 连接到 AI 大模型平台。这是使用 Jarvis 的关键步骤。

2.3.1 生成配置文件

首次运行任何 jarvis 命令（例如 jvs 或 jpm info），系统会自动在您的用户主目录下创建 ~/.jarvis/ 文件夹，以及一个默认的配置文件 config.yaml。

2.3.2 获取平台凭证

Jarvis 支持多个 AI 平台。我们首选推荐腾讯元宝，因为它免费且功能强大。

腾讯元宝 (Tencent Yuanbao)

1. 在浏览器中访问并登录 腾讯元宝网页版。

2. 按 F12 打开浏览器开发者工具，切换到 “网络 (Network)” 标签页。

3. 在页面上随便进行一次对话，以确保有网络请求产生。

4. 在网络请求列表中，找到任意一个发往 yuanbao.tencent.com 的请求。

5. 点击该请求，在右侧的 “标头 (Headers)” 面板中，向下找到 “请求标头 (Request Headers)” 部分。

6. 找到 Cookie 字段，并完整复制其对应的长字符串值。

Kimi

Kimi 的 API Key 需要通过类似的方式从网络请求中获取。

1. 在浏览器中访问并登录 Kimi 网页版。

2. 按 F12 打开浏览器开发者工具，切换到 “网络 (Network)” 标签页。

3. 发起一次对话，在网络请求中找到名为 completion 的请求。

4. 点击该请求，在 “请求标头 (Request Headers)” 中找到 authorization 字段。

5. 其值的格式为 Bearer <API_KEY>。您需要复制 <API_KEY> 这部分内容（即 Bearer 后面的所有字符）。

其他平台

• 通义千问: 采用与元宝类似的方式，登录后在开发者工具中获取 Cookie。

• OpenAI: 获取您的 OPENAI_API_KEY 和 OPENAI_API_BASE (如果使用代理)。

2.3.3 编辑配置文件

现在，打开刚刚生成的配置文件 ~/.jarvis/config.yaml，将您获取到的凭证填入。

# yaml-language-server: $schema=https://raw.githubusercontent.com/skyfireitdiy/Jarvis/main/docs/schema/config.schema.json
# ... 其他配置 ...# 默认平台是元宝，如果使用其他平台，请修改这里的 JARVIS_PLATFORM 和 JARVIS_MODELJARVIS_PLATFORM: yuanbaoJARVIS_MODEL: deep_seek_v3
# 将凭证填入 ENV 环境配置中ENV:  # 将从浏览器复制的元宝Cookie粘贴到这里  YUANBAO_COOKIES: '复制到此处的长长的Cookie字符串...'    # 如果使用Kimi，请填入这里  KIMI_API_KEY: ''    # 如果使用通义，请填入这里  TONGYI_COOKIES: ''
  # 如果使用OpenAI，请填入这里 (可选)  # OPENAI_API_KEY: ''  # OPENAI_API_BASE: ''

保存文件后，您的 Jarvis 就配置完成了！

2.4 验证安装

配置完成后，您可以运行以下命令来验证 Jarvis 是否已成功连接到 AI 平台：

jpm info

如果配置正确，它将尝试连接所有您已在 ENV 中提供凭证的 AI 平台，并列出每个平台下所有可用的模型。这是一个验证所有凭证是否正确的绝佳方式。如果某个或多个平台未能成功列出模型，请返回检查 config.yaml 中对应的凭证。

注意: 有的平台即使没有正确配置凭证，也可能会列出可用的模型，但这并不代表配置一定成功。要最终确认配置是否正确，最好的方式是尝试直接与模型进行对话，例如使用 jpm chat -p <platform> -m <model> 命令。如果能够成功对话，则说明配置无误。

2.5 命令概览

Jarvis 安装后会向系统注册一系列命令。每个命令都对应一个特定的功能代理，并提供了一个长命令和一个短的快捷方式。

现在您已经完成了所有设置，可以尝试运行 jvs 或 jca 来开始您的第一次 Jarvis 之旅了！