@agentium/edge

中文文档
4.11.0发布于 2026/10/24MITTypeScriptESM + CJS近 30 天下载 1967

Aginium的边缘部署——IOT工具包(GPIO、传感器、相机、BLE)、边缘运行时间,以及Raspberry Pi的Ollama助手

中文使用文档
文档目录9 节
  1. 安装
  2. 快速启动 — Ollama 支持的本地代理
  3. 信息技术工具包
  4. 边缘运行时间
  5. 云同步
  6. 文档
  7. 社区
  8. 许可证
  9. 同步和相机行为

@ agentium/ edge (帮助)

Agentium的边缘部署——IOT工具包(GPIO,传感器,相机,BLE,Servo,系统)加上有资源监测,预设,和Ollama帮助器的边缘运行时间. 为Raspberry Pi所设计,但在任何Linux SBC上工作.

安装

npm install @agentium/edge

硬件工具包按要求装入其原生装订. 只安装您使用的东西, 例如 :

npm install onoff           # GPIO
npm install i2c-bus         # sensors
npm install @abandonware/noble  # BLE

快速启动 — Ollama 支持的本地代理

import { Agent } from "@agentium/core";
import { EdgeRuntime, edgePreset, ollama } from "@agentium/edge";

const runtime = new EdgeRuntime(edgePreset("pi-5-balanced"));
await runtime.start();

const agent = new Agent({
  name: "edge-bot",
  model: ollama(runtime.recommendedModel),
  instructions: "You are an edge AI assistant running on-device.",
});

console.log(await agent.run("hello"));

信息技术工具包

每个工具包都暴露了打入的工具(带有Zod schemas),代理可以称为:

工具包示例工具
GpioToolkitgpio.write, (中文(简体) ), gpio.read, (中文(简体) ), gpio.toggle
SensorToolkitsensor.read_temperature, (中文(简体) ), sensor.read_humidity (I2C/一线)
CameraToolkitcamera.snapshot, (中文(简体) ), camera.start_stream
BleToolkitble.scan, (中文(简体) ), ble.connect, (中文(简体) ), ble.read_characteristic
ServoToolkitservo.move_to, (中文(简体) ), servo.center
SystemToolkitsystem.cpu_temp, (中文(简体) ), system.uptime, (中文(简体) ), system.shutdown
import { Agent } from "@agentium/core";
import { GpioToolkit, SensorToolkit } from "@agentium/edge";

const agent = new Agent({
  name: "garden-bot",
  model: ollama("llama3.2:3b"),
  toolkits: [
    new GpioToolkit({ pumpPin: 17 }),
    new SensorToolkit({ moistureBus: 1 }),
  ],
});

await agent.run("Water the plants if soil moisture is below 30%.");

边缘运行时间

EdgeRuntime 持续监控CPU,RAM,温度和存储,以便能对资源压力做出反应(缩小模型大小,推迟非关键工具,同步到云等).

const runtime = new EdgeRuntime(edgePreset("pi-zero-2-low-power"));
runtime.on("threshold:cpu", (s) => console.warn("CPU pressure", s));
await runtime.start();

云同步

EdgeCloudSync 船舶本地代理运行/传感器日志到一个中央端点,并进行离线排队——对有间断连接的皮斯舰队有用.

文档

完整文件时间 参考文献. agentium.in

社区

加入对话 解析器。 。 。 .

许可证

麻省理工学院

同步和相机行为

同时期的冲锋呼叫共享活动交付批次. 下一批请求中排队的事件仍然存在;只有确认的身份证被取出。 出货失败保留了批次进行再试,因此接收者必须处理重复出货. 相机抓取在删除其临时文件之前返回完整的碱基64图像;应用程序仍然选择如何将图像呈现给多模式模型.

版本与发布记录

@agentium/edge 共发布 40 个版本,首次发布于 2026/05/22;过去 12 个月发布了 40 个版本。

版本发布日期距今
4.11.0latest2026/10/2414 天前
4.10.02026/10/2414 天前
4.9.02026/10/1325 天前
4.8.32026/10/1226 天前
4.8.22026/10/1028 天前
4.8.12026/10/1028 天前

关于 @agentium/edge 的常见问题

@agentium/edge 是什么?

Aginium的边缘部署——IOT工具包(GPIO、传感器、相机、BLE)、边缘运行时间,以及Raspberry Pi的Ollama助手

如何安装 @agentium/edge?

在项目目录运行 npm install @agentium/edge,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@agentium/core(^4.11.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@agentium/edge 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@agentium/edge 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@agentium/edge 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^22.18.0 || ^24.11.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@agentium/edge 可以商用吗?

@agentium/edge 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@agentium/edge 的下载量有多少?

根据 npm 官方下载统计,@agentium/edge 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,967 次,日均约 66 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agentium/edge 还在维护吗?

最新版本 4.11.0 发布于 2026/10/24(14 天前);至今共发布 40 个版本,其中过去 12 个月发布了 40 个;首次发布于 2026/05/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。