eliza

环境要求

• Node.js 与 Bun：仓库在 package.json 中固定了两者版本，需先安装对应版本
• Git（用于克隆仓库）
• 本地推理功能需要下载嵌入 GGUF 模型，需可用网络
• 磁盘空间用于 monorepo 依赖与桌面端 libelizainference 构建产物

安装与启动步骤

1. 1克隆仓库

   使用 blob 过滤克隆，减少下载体积。请保持网络畅通，仓库为 monorepo，文件较多。

   git clone --filter=blob:none https://github.com/elizaos/eliza.git

   复制

2. 2进入项目目录

   切换到克隆下来的 eliza 目录，后续命令都在此目录执行。

   cd eliza

   复制

3. 3安装依赖

   该命令同时准备子模块与补丁、配置宿主构建前置，并构建或校验桌面端 libelizainference。

   bun install

   复制

4. 4启动开发环境

   运行本地开发流程。嵌入 GGUF 模型将在本地推理预热阶段自动下载，首次启动可能较慢。

   bun run dev

   复制

5. 5可选：构建工作区

   用 Turbo 构建整个工作区。需要验证产物或准备发布时再执行，非启动必需。

   bun run build

   复制

6. 6可选：运行校验

   执行包一致性、依赖、类型、lint 与审计等检查，改动提交前建议运行。

   bun run verify

   复制

7. 7可选：运行测试

   仓库单元/集成测试通道；端到端测试使用 bun run test:e2e。

   bun run test

   复制

8. 8可选：本地云栈

   使用 mock 启动本地 Eliza Cloud 栈，便于开发与调试云端相关功能。

   bun run cloud:mock

   复制

如何确认成功

bun run dev 执行后无报错并持续运行，终端输出开发服务启动信息即视为成功；README 未给出具体访问端口。

常见问题

注意事项

• bun install 会自动准备子模块与补丁、配置宿主构建前置，并构建或校验桌面端 libelizainference，请预留时间与磁盘空间。
• 嵌入 GGUF 模型保存在运行时并由其在推理预热时自动下载，请确保网络可用。
• 想整机运行 elizaOS（可启动的 Linux/Android 发行版），需前往独立的 elizaOS/os 仓库，不在本仓库内。
• 提交改动前应按 AGENTS.md 要求执行 bun run verify 等验证命令。