Skip to content

A local-first multi-agent app development platform, built on PenguinHarness

2.6 KB
Raw Blame

title: 快速开始 description: 在桌面应用、命令行与 Web App、Docker、SDK 四条路线中任选一条,安装 Adelie 并跑通第一个 Task。

Adelie 有四条入口:桌面应用、命令行与 Web App、Docker 和 SDK。它们背后是同一个引擎,区别只在于你以什么方式接触它。挑一条适合自己的路线,每条路线的页面都会一路带你跑通第一个 Task。

开始之前

Adelie 不内置任何模型凭据,跑第一个 Task 之前要先配置一个模型。准备好一个供应商的 API Key 即可,每条路线的页面都包含这一步。

模型始终以 (provider, model_id) 二元组引用,供应商绝不由模型 id 推断。内置分组见模型与 Provider。

选择路线

路线 适合 需要终端吗?
桌面应用 想直接把 Adelie 当作产品来用 不需要,而且它会替你装好 penguin 命令
命令行与 Web App 装到服务器或远程机器上,或者想要 penguin 命令 安装时用一次
Docker 部署而非安装的服务端:一个容器、一个卷 启动时用一次
SDK 把引擎嵌入自己的 TypeScript 程序 需要

拿不准就选桌面应用:它步骤最少,以后换到别的路线也不用付出任何代价。macOS 和 Windows 的安装包都已签名,只有下载来的 Linux AppImage 在首次启动前需要多做一步,桌面应用页面里写了。

各条路线的共同点

  • 同一个数据目录:~/.adelie/data(Windows 为 %USERPROFILE%\.adelie\data,容器内为 /data)。Agent、模型配置和历史会话都在其中,所以同一台机器上的几条路线可以随意混用:在桌面应用里配好的模型,CLI 和 SDK 立刻就能用。
  • 同一时刻只有一个服务端:一个数据目录只运行一个服务端进程。如果你已经用 penguin web 启动了一个,桌面应用会直接接入它,而不会再启动第二个。
  • 同一套界面:桌面应用与 penguin web 打开的是同一个 Web App,只是桌面应用内嵌了服务端,并免去了登录。

下一步

  • 桌面应用:双击安装,打开即已登录。
  • 命令行与 Web App:一行命令装好 penguin,附完整的安装参考。
  • Docker:官方镜像,用于经网络访问的服务端。
  • SDK:在自己的程序里创建 Agent 与 Session。
  • 核心概念:文档中通用的术语。