跳转到内容
ilearnassist

下载与安装

方式一：下载安装包（推荐）

Section titled “方式一：下载安装包（推荐）”

到 GitHub Releases 下载对应你系统的安装包：

系统 文件
macOS（Apple 芯片，M 系列） ilearnassist-…-mac-arm64.dmg
macOS（Intel 芯片） ilearnassist-…-mac-x64.dmg
Windows 64 位 ilearnassist-…-win-x64.exe
Linux 64 位 ilearnassist-…-linux-x86_64.AppImage 或 ilearnassist-…-linux-amd64.deb

也可以直接在 下载页 上选，那一页会检测你的系统并高亮对应的行。

安装包没有代码签名

Section titled “安装包没有代码签名”

这个项目没有购买代码签名证书，所以系统会拦你一下。这不是文件损坏，只是系统不认识这个开发者：

  • macOS：在应用上点右键 → 打开 → 再点一次「打开」。只需一次。
  • Windows：在 SmartScreen 提示里点 更多信息 → 仍要运行。
  • Linux：AppImage 下载后先 chmod +x，再运行。

方式二：从源码运行

Section titled “方式二：从源码运行”

需要 Node.js ≥ 20 和 pnpm ≥ 9。

终端窗口
git clone https://github.com/waychan23/ilearnassist.git
cd ilearnassist
pnpm install


# 配置：数据目录 + 模型 Key
cp .env.example .env
# 编辑 .env，至少填一个 DEEPSEEK_API_KEY（或其他服务商的 Key）


# 全新的数据目录里没有管理员，先创建一个
pnpm --filter @ilearnassist/server cli create-admin --username <你的用户名> --generate


pnpm dev

打开 http://localhost:5173 登录。后端监听 127.0.0.1:3720。

装好之后怎么走，见首次运行。