@bendyline/gezel-服务
gezeld,则 格泽尔 服务。 一个本地的 HTTP
拥有聊天会话的服务,通往 LLM 提供者的路线,管理记忆,
任务和工程,并读取和写出全部内容 ~/.gezel/。 。 。 .
这就是 @bendyline/gezel-cli 在幕后运行。 直接安装
只有您正在嵌入 Gezel 或单独运行服务时.
npm install @bendyline/gezel-service
npx -p @bendyline/gezel-service gezeld
gezeld 在前景中运行,并通过环境配置
变量(参见 环境(三); npx -p @bendyline/gezel-service gezeld --help
列出他们。 总是命名 @bendyline/ 软件包 npx: 一个赤裸的 npx gezeld
在您安装的文件夹外, 请求 npm 提供不相关的软件包 .
里面的东西
- Hono HTTP API 在回放、无记名托肯认证上
Store——所有磁盘状态的单一读/写路径ChatManager- 会议周期、持久性、提供者 -- -- 状态恢复- 供应商:副驾驶、OpenAI、Anthropic、lama.cpp、MLX、ds4和a 用于测试的决定性模拟器
- 每段 MCP 桥, 跨越 Stdio 和可流的 HTTP
- 记忆(sqlite-vec),历史,任务,使用跟踪,引擎下载
- 捆绑的网络用户界面 时间
dist/ui/这样gezel start --web满座 仅安装节点的浏览器界面, 没有其它要获取的
入境点
| 子路径 | 目录 |
|---|---|
@bendyline/gezel-service | startService() 服务类型 |
@bendyline/gezel-service/handboek | Handboek 渲染助手 |
@bendyline/gezel-service/gezapp | AI App (英语:.gezapp验证、包装和阅读,不开始服务 |
@bendyline/gezel-service/native-release | 被钉住的本地引擎发布及其存档摘要,作为数据 |
@bendyline/gezel-service/media | 用于构建知识目录的图像、音频和视频嵌入 |
@bendyline/gezel-service/packaging | 搭建时间辅助器,为Electron App推出被钉住的本地引擎 |
@bendyline/gezel-service/dist/bin/gezeld.js | 服务可执行文件, 也安装为 gezeld 命令。 为您启动 Gezel 的工具, 如 CLI 和应用程序 SDK , 启动此文件 |
import { startService } from '@bendyline/gezel-service';
const { port, clientToken, stop } = await startService({ home: '/tmp/gezel-home' });
console.log({ port, clientToken });
await stop();
可选同伴
基 npm 安装出一些大块或原生块. 云供养者, 本地引擎, HTTP API, MCP, UI, 任务, 和文件特性不工作 他们。 仅在部署需要时安装 :
| 软件包 | 需要时间 |
|---|---|
@huggingface/transformers@^4.3.1 | 进程内存嵌入 |
kokoro-js@^1.2.1 | Kokoro 文本对语音 |
node-pty@^1.1.0 | 交互终端;没有它,打开终端报告 node-pty 失踪了,其他的都继续工作 |
npm install @huggingface/transformers@^4.3.1 kokoro-js@^1.2.1
npm 消费者还应在应用程序根上添加两个覆盖
package.json (npm忽略了依赖关系宣布的覆盖). kokoro-js
1.2.1 仍然宣布变形器。js ^3.5.1; 没有覆盖 npm
在服务4.x 1旁边安装一个秒, 3.x 复制件, 以及服务
kokoro 的抗震器是用自己的副本建造的. adm-zip 0.6.1是第一个
发表其咨询意见:
{
"overrides": {
"adm-zip": "0.6.1",
"kokoro-js": { "@huggingface/transformers": "^4.3.1" }
}
}
桌面安装器和可调试的节点分布已经包含 此 ML 运行时间与已审查的覆盖 。 两种路径都使用一个变形器 4.x / ONNX 运行时行而不是安装独立的 3.x 和 4.x 堆栈.
本地发动机
On-device推论需要本地引擎二进制. 它们不是捆绑的——
服务在第一次使用时下载 native-v* 释放情况
Gezel 仓库,核查
释放的 SHA256SUMS 对抗此套件中包含的文摘
信任任何个人档案散列。 设定 GEZEL_LLAMA_SERVER_BIN (和
兄弟姐妹)指向自己的建筑,或者 GEZEL_NATIVE_BIN_DIR 以美元计
包含全部内容的目录.
云供养者不取此相.
共享语音模型
语音对文本(Whiper)和文字对语音(Kokoro)的重量来自被钉住的
目录中 @bendyline/gezel/speech-models,该模块的节点模块
@bendyline/gezel 其他桌面应用程序也可以使用的软件包 。 每个文件都是
以修订、尺寸和SHA-256为支柱,并在使用前加以核实.
- 每个用户保存一次经核实的文件,单位:
<GEZEL_HOME>/engines/speech-assets/<sha256>。每个应用程序都保留自己的 安装与这些文件的硬链接(或复制,不另加) 下载, 当它们处于不同的音量时, 因此两个应用程序永远不会下载 同一型号两次,删除一个应用程序的安装永不中断 另一个. - 跨进程下载和清理协调;删除缓存文件 只有在没有安装时才使用.
- 搜索还发现 Gezel 的旧模型文件夹中已经存在的模型, in
只有读取的模范住宅(
GEZEL_READONLY_MODEL_HOMES),并在桌面中 app的全机资产文件夹. 它从来没有读过机器服务 私人国家. - 没有下载自己:健康检查从不找模型 旧的 Kokoro 导出更新只当您再次拉出模型时进行 .
- 一个必须保存文件的应用程序可以提供
SpeechAssetStore(单位:千美元)root联 合 国null,它关闭共享.
环境
| 变量 | 效果 |
|---|---|
GEZEL_HOME | 国家目录( 默认) ~/.gezel(中文(简体) ) |
GEZEL_PORT | 听听这个口号 默认: 6228 当它是自由的, 否则是一个自由端口 |
GEZEL_LOG_LEVEL | debug | info | warn | error | silent |
GEZEL_MOCK_PROVIDER=1 | 决定提供者,不需要证书 |
GEZEL_SKIP_SYSTEM_BOOTSTRAP=1 | 跳过先启动的背景下载 |
GEZEL_DISABLE_FIRST_USE_GRACE=1 | 把新鲜的家当作一个固定的安装:背景索引从头半个小时开始,而不是等待出来,还有一个随时可以聊天的模式,从第一天开始就报道了安静的夜晚。 可用于测试和自动运行 |
GEZEL_EMBEDDED_INFERENCE_ONLY=1 | 开始 gezeld 当一个应用程序运行时 @bendyline/gezel-inference'表面(聊天,应答,嵌入,知识,模型管理)位于服务回回听器后方,没有产品API,秘密存储,设备身份,远程对接或局域网服务. 应用程序SDK设置为 inferenceOnly 儿童托管服务 |
GEZEL_DAEMON_LOG_FILE=1 | 将服务输出写入 <home>/logs/service-YYYY-MM-DD.log (10个MB卷,保存了7天). 启动时CLI和应用程序SDK设置 gezeld 一、导 言 |
GEZEL_NATIVE_ENGINE_VERSION | 覆盖被钉住的本地释放 |
稳定
公众API 在semver下. HTTP API 单独版本于 /api· ;
首选项 @bendyline/gezel-client {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}我直接叫它来.
文档
麻省理工学院