Bi

安装与首次运行

下载、解压与模型配置。

Markdown 原文Raw markdown

Bi 以压缩包或安装盘形式提供,不需要安装依赖,也不需要单独的运行时。

下载

前往下载页,按系统选择对应产物。每个平台提供 x64 与 ARM64 两种架构:

  • Windows:解压后运行 bi-windows-*.exe。请先解压,不要在压缩包内直接双击,否则 ocr/ 无法随程序加载。
  • macOS:推荐 .dmg 安装盘,双击挂载后把 Bi 拖入「应用程序」;也可以使用绿色版 .zip。
  • Linux:解压后运行对应架构的可执行文件。

ocr/ 是文档识别组件,需要与可执行文件保持同级。删除它只会失去扫描件的文字识别能力,其他功能不受影响。

首次运行

启动后 Bi 在本机运行,并自动在浏览器中打开工作台。三个平台的操作方式略有不同:

  • Windows 以 GUI 模式启动,并常驻系统托盘。
  • macOS 提供菜单栏图标,可打开工作台、工作区、配置目录与日志。
  • Linux 以服务模式运行,界面在浏览器中访问。

数据保存在程序目录旁的 .bi 目录内:设置与模型密钥、会话记录、本地数据库和运行日志都在这里。Bi 没有自己的服务器。

配置一个模型

Bi 不包含模型。首次使用前,在「设置」中添加至少一个模型服务——云端 API,或本机运行的 Ollama / LM Studio。具体步骤见添加模型。

校验下载(可选)

下载页给出了每个文件的 SHA-256。按系统执行:

# macOS / Linux
shasum -a 256 bi-linux-amd64.zip

# Windows PowerShell
Get-FileHash .\bi-windows-amd64.zip -Algorithm SHA256

把输出与下载页显示的值比对即可。

Install and first run

Download, unzip, configure a model — three steps to start using Bi.

Markdown 原文Raw markdown

Bi ships as an archive or an installer. There is no dependency to install and no separate runtime.

Download

Go to the download page and pick the build for your system. Each platform offers x64 and ARM64:

  • Windows: unzip, then run bi-windows-*.exe. Unzip first — launching from inside the archive prevents ocr/ from loading.
  • macOS: the .dmg installer is recommended; mount it and drag Bi into Applications. A portable .zip is also available.
  • Linux: unzip and run the executable for your architecture.

ocr/ is the document recognition component and must sit next to the executable. Removing it only disables text recognition for scans; everything else keeps working.

First run

Bi runs on your machine and opens the workbench in your browser. The platforms differ slightly:

  • Windows launches in GUI mode and stays in the system tray.
  • macOS provides a menu bar icon that opens the workbench, workspace, config directory and logs.
  • Linux runs as a service; the workbench is reached in the browser.

Data lives in the .bi directory next to the application: settings and model keys, sessions, the local database and logs. Bi has no server of its own.

Configure a model

Bi does not ship a model. Before first use, add at least one model provider in Settings — a cloud API, or a local Ollama / LM Studio instance. See Add a model.

Verify the download (optional)

The download page lists a SHA-256 for every file. Run the command for your system:

# macOS / Linux
shasum -a 256 bi-linux-amd64.zip

# Windows PowerShell
Get-FileHash .\bi-windows-amd64.zip -Algorithm SHA256

Compare the output with the value on the download page.