FreedomGPT

环境要求

• Node.js（从 nodejs.org 下载安装）
• Git（从 git-scm.com 下载安装）
• macOS 需要 make 等编译工具以构建 llama.cpp
• Windows 需要 CMake（用于构建 llama.cpp）
• Linux 需要 nodejs、yarn、git、make、g++、npm

安装与启动步骤

1. 1克隆仓库

   必须带 --recursive 参数，否则 llama.cpp 等子模块不会被拉取，后续编译会失败。

   git clone --recursive https://github.com/ohmplatform/FreedomGPT.git freedom-gpt

   复制

2. 2安装项目依赖

   进入刚克隆的 freedom-gpt 目录，用 npx yarn 安装全部依赖。

   cd freedom-gpt
   npx yarn install

   复制

3. 3编译 llama.cpp（macOS）

   macOS 用户在项目根目录下进入 llama.cpp 子目录并执行 make 完成编译。

   cd llama.cpp
   make

   复制

4. 4编译 llama.cpp（Windows

   先安装 CMake，然后在 llama.cpp 目录下用 cmake 配置并构建 Release 版本。

   cd llama.cpp
   cmake .
   cmake --build . --config Release

   复制

5. 5安装 Linux 系统依赖

   Linux 用户先用 apt 安装 nodejs、yarn、git、make、g++、npm 这些必需软件包。

   sudo apt install nodejs
   sudo apt install yarn
   sudo apt install git
   sudo apt install make
   sudo apt install g++
   sudo apt install npm

   复制

6. 6启动应用

   回到项目根目录执行启动命令，Electron 会拉起桌面应用窗口。

   npx yarn start

   复制

关键配置

如何确认成功

终端执行 npx yarn start 后弹出应用窗口即成功；Windows 编译 llama.cpp 后应生成 Release/main.exe，可直接运行测试聊天客户端。

常见问题

注意事项

• 克隆必须使用 --recursive，否则子模块缺失。
• README 未提供模型文件的下载与放置步骤，模型管理请参考应用内界面或官网 http://www.freedomgpt.com。
• macOS 与 Windows 的 llama.cpp 编译命令不同，请按平台选择。
• 安装依赖阶段需要网络，应用运行时可离线使用本地模型。