Skip to content

安装与启动

小提示：如何使用电脑上的终端来操控电脑？

大部分用户都习惯使用鼠标点击来操控电脑，但还有另一种方式来操控电脑，就是使用电脑上自带的终端软件，通过在终端中执行文字命令来操控电脑（即：在终端中输入对应的文字命令，然后按回车执行）。

Step 1. 下载并解压源码

点击 harzoo 源码压缩包 下载，并解压，得到 harzoo-main 文件夹。

Step 2. 在源码文件夹中打开终端

在 harzoo-main 文件夹内的空白处右键 → 选择「在终端中打开」。

Note：若出现双层harzoo-main，则选择含有pyproject.toml的。

Note：若Windows 10，则按住 Shift 键再在空白处右键 → 选择「在此处打开 PowerShell 窗口」。

Step 3. 检查 Python 是否已安装

在终端中运行以下命令，查看 Python 版本：

python --version
  • 若显示 Python 3.10.0 或更高，进入步骤 4。
  • 若未安装或版本过低，请点击 python-3.13.14-amd64.exe 下载并安装（安装过程中务必勾选 Add python.exe to PATH 选项）。安装完成后，关闭终端，回到步骤 2 重新打开终端，再次执行上面的命令确认。

Step 4. 安装 Harzoo

在终端中运行以下命令：

python -m pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple

Note：这一步会自动下载安装运行 Harzoo 所需的依赖软件包。且会为 Harzoo源码文件 建立快捷方式，以后在终端输入 harzoo 就能启动。请勿删除 harzoo-main 源码文件夹。

Step 5. 启动

在终端中运行以下命令，启动 Harzoo：

harzoo

看到 Harzoo 界面，则说明安装已成功。

Step 6. 配置

Harzoo 本质是一个AI框架，其大脑、行为与专业能力完全由代码中的config文件夹中的文件决定，你可以通过添加相应的文件来构建你想要的AI。

为了让你快速上手，我们已为你预置了几个配置文件，你仅需对其进行两处修改即可：

  1. 将 ai_builder.md文件中 api_key、base_url、model_name替换为你自己的大模型 API 的值，然后保存；
  2. 将 config.json文件中的 xxxx.md 为 ai_builder.md，然后保存；
  3. 重启 Harzoo，与其进行交流即可；

这几个配置文件，本质是配置了一个AI智能体构建助手，你和它进行交流，它会自动帮你构建你想要的AI。

更多Harzoo官方提供的配置文件，可在github 或 国内gitee 上进行下载。

小提示：如何使用电脑上的终端来操控电脑？

大部分用户都习惯使用鼠标点击来操控电脑，但还有另一种方式来操控电脑，就是使用电脑上自带的终端软件，通过在终端中执行文字命令来操控电脑（即：在终端中输入对应的文字命令，然后按回车执行）。

Step 1. 下载并解压源码

点击 harzoo 源码压缩包 下载，并双击解压，得到 harzoo-main 文件夹。

Step 2. 在源码文件夹中打开终端

右键 harzoo-main 文件夹 →「新建位于文件夹位置的终端窗口」。

Step 3. 检查 Python 是否已安装

在终端中运行以下命令，查看 Python 版本：

python3 --version
  • 若显示 Python 3.10.0 或更高，进入步骤 4。
  • 若未安装或版本过低，请点击 python-3.13.14-macos11.pkg 下载并安装。安装完成后，关闭终端，回到步骤 2 重新打开终端，再次执行上面的命令确认。

Step 4. 安装 Harzoo

在终端中运行以下命令：

python3 -m pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple

Note：这一步会自动下载安装运行 Harzoo 所需的依赖软件包。且会为 Harzoo源码文件 建立快捷方式，以后在终端输入 harzoo 就能启动。请勿删除 harzoo-main 源码文件夹。

Step 5. 启动

在终端中运行以下命令，启动 Harzoo：

harzoo

看到 Harzoo 界面，则说明安装已成功。

Step 6. 配置

Harzoo 本质是一个AI框架，其大脑、行为与专业能力完全由代码中的config文件夹中的文件决定，你可以通过添加相应的文件来构建你想要的AI。

为了让你快速上手，我们已为你预置了几个配置文件，你仅需对其进行两处修改即可：

  1. 将 ai_builder.md文件中 api_key、base_url、model_name替换为你自己的大模型 API 的值，然后保存；
  2. 将 config.json文件中的 xxxx.md 为 ai_builder.md，然后保存；
  3. 重启 Harzoo，与其进行交流即可；

这几个配置文件，本质是配置了一个AI智能体构建助手，你和它进行交流，它会自动帮你构建你想要的AI。

更多Harzoo官方提供的配置文件，可在github 或 国内gitee 上进行下载。

Step 1. 打开终端

Step 2. 检查 Python是否已安装

在终端中运行以下命令，查看 Python 版本：

python3 --version
  • 若显示 Python 3.10.0 或更高，跳到步骤 3。
  • 若未安装或版本过低，先安装 Python：

在终端中运行以下命令，更新软件包列表：

sudo apt update

在终端中运行以下命令，安装 Python：

sudo apt install -y python3 python3-pip python3-venv

Step 3. 下载源码并安装

若尚未安装 Git，在终端中运行以下命令，安装 Git：

sudo apt install -y git

在终端中运行以下命令，下载源码：

git clone https://github.com/leeharhar/harzoo.git

在终端中运行以下命令，进入源码文件夹：

cd harzoo

在终端中运行以下命令：

python3 -m pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple

这一步类似给 Harzoo 建快捷方式，并会自动下载安装它运行所需的配套组件。以后在终端输入 harzoo 就能启动。请勿删除 harzoo 源码文件夹。

Step 4. 启动

在终端中运行以下命令，启动 Harzoo：

harzoo

看到 Harzoo 界面，则说明安装已成功。

Step 5. 配置

Harzoo 本质是一个AI框架，其大脑、行为与专业能力完全由代码中的config文件夹中的文件决定，你可以通过添加相应的文件来构建你想要的AI。

为了让你快速上手，我们已为你预置了几个配置文件，你仅需对其进行两处修改即可：

  1. 将 ai_builder.md文件中 api_key、base_url、model_name替换为你自己的大模型 API 的值，然后保存；
  2. 将 config.json文件中的 xxxx.md 为 ai_builder.md，然后保存；
  3. 重启 Harzoo，与其进行交流即可；

这几个配置文件，本质是配置了一个AI智能体构建助手，你和它进行交流，它会自动帮你构建你想要的AI。

更多Harzoo官方提供的配置文件，可在github 或 国内gitee 上进行下载。

安全风险说明（请阅读）

Harzoo 的安全风险取决于 profile 中 tool_names 所启用的工具能力（例如 Read 可读文件、Shell 可执行命令操作电脑、WebFetch 可访问网络）。工具可能会读取 profile 中的 api_key 或电脑上其他私人数据进行外传。因此，来自外部的、非官方的 tool、skill 和 profile 文件可能存在恶意行为，请一定警惕！！！不要轻易相信来源不明的配置文件。