elizaOS/eliza

Open source agentic operating system

elizaOS – 一个用于自主 AI 代理的开源、基于 TypeScript 的操作系统

是什么

  • 一个 monorepo,封装了运行 Eliza(一个代理型个人助理平台)所需的运行时,CLI,网页/桌面/移动端应用,云端服务,原生桥接器,以及第一方插件。
  • 核心是一个模型无关的框架 (@elizaos/core),定义了代理运行时,消息循环,内存原语和插件系统。插件可以增加聊天、语音、文档处理、日历 integration,设备传感器,区块链钱包,以及设备端推理等功能。
  • 该项目提供用户互动的 Eliza app(网页, 桌面, Android/iOS)以及用于搭建新代理或插件的 beta CLI (elizaos)。
  • 一个单独的仓库 (elizaOS/os) 包含可引导的 Linux 和 Android 镜像,可以将整个堆栈作为专用的 OS 运行。

关键组件

Package Role
@elizaos/core 定义 AgentRuntime, 消息处理, 内存/状态, 以及插件合约。
@elizaos/agent 将核心封装成一个独立的 HTTP 支撑的代理服务。
@elizaos/app-core 跨平台 Eliza UI 的共享托管逻辑。
@elizaos/ui integration React UI 库,用于网页/桌面/移动端外壳。
elizaos (CLI) 生成新项目或插件,处理升级和部署。
plugins/ 第一方插件:本地推理, 连接器(例如:日历, 邮件), 设备桥接器(例如:相机, 联系人), 区块链钱包, 等。
@elizaos/plugin-local-inference 启用 Eliza-1 模型(2B-27B 参数, 基于 Gemma)加上本地 embeddings, 语音, 视觉和图像生成资产。
Eliza Cloud (可选) 用于身份验证, 模型路由, 远程连接和跨设备同步的托管服务。

本地与云端推理

  • 运行时可以将每项功能路由至本地(下载的 GGUF 模型),一个直接供应商(例如:OpenAI, Anthropic),或 Eliza Cloud。硬件检测会自动选择一个支持的后端;如果设备无法运行模型,则会回退到远程供应商。

入门指南

  1. 从源码运行(需要 Bun ≥ 1.x 和 Node):
    git clone --filter=blob:none https://github.com/elizaOS/eliza.git
    cd eliza
    bun install          # 安装依赖, submodules, patches, and builds libelizainference
    bun run dev          # 启动开发服务器
    
    • bun run fetch:archive-artifacts 会在需要时拉取大型模型资产。
    • 常见脚本:bun run build, bun run test, bun run cloud:mock
  2. 使用 CLI 搭建新项目或插件:
    bun add --global elizaos@beta
    elizaos create my-project --template project
    1234567890
    elizaos create plugin-example --template plugin
    
  3. 尝试托管产品 – 打开 https://cloud.eliza.app 或从 GitHub releases 页面下载预建的发布版。

开发者典型工作流程

  • 编写一个导出 Plugin 对象的插件(注册动作, providers, routes, UI 视图, 等)。

  • 运行 bun run test:e2e 以验证与真实运行时的集成。

  • 在合并之前,请遵循 AGENTS.md 中描述的基于证据的 review 流程。

目标受众

  • 产品团队:正在构建 AI 驱动的个人助理, 自动化机器人, 或设备端代理。

  • 开发者:想要一个插件架构来实验不同的 LLM, embeddings, 逻辑-multimodal 模型, 而不被单一供应商 lock-in。

  • Boot Camp/Researchers:对现代 LLM (Gemma-based) 的设备端推理和多模态资产感興趣。

License

  • MIT – 宽松, 允许商业使用, 修改, 和重新分发。

Bottom line: elizaOS 是一个全堆叠, 开源平台, 让您可以在本地或云端运行自主 AI 代理, 通过丰富的插件系统进行扩展, 甚至可以发布一个专用的 OS 镜像, 将设备转换为一个自包含的 AI 助理。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目