elizaOS/eliza

elizaOS – 一個用於自主 AI 代理的開源、基於 TypeScript 的作業系統

是什麼

• 一個單一儲存庫（monorepo），封裝了執行環境、CLI、網頁/桌面/行動裝置應用程式、雲端服務、原生橋接器以及執行 Eliza（一個代理型個人助理平台）所需的第一方外掛程式。
• 核心是一個模型無關的框架 (@elizaos/core)，定義了代理執行環境、訊息迴圈、記憶原語與外掛程式系統。外掛程式可增加聊天、語音、文件處理、行事曆整合、裝置感測器、區塊鏈錢包以及裝置端推論等功能。
• 該專案提供使用者互動的 Eliza app（網頁、桌面、Android/iOS）以及用於搭建新代理或外掛程式的 beta CLI (elizaos)。
• 一個獨立的儲存庫 (elizaOS/os) 包含可開機的 Linux 與 Android 映像檔，可將整個堆疊作為專用的作業系統執行。

關鍵組件

套件	角色
@elizaos/core	定義 AgentRuntime, 訊息處理、記憶/狀態，以及外掛程式合約。
@elizaos/agent	將核心封裝成獨立的 HTTP 支援的代理服務。
@elizaos/app-core	跨平台 Eliza UI 的共享託管邏輯。
@elizaos/ui	網頁/桌面/行動裝置外殼使用的 React UI 函式庫。
elizaos (CLI)	產生新專案或外掛程式，處理升級與部署。
plugins/	第一方外掛程式：本地推論、連接器（例如：行事曆、電子郵件）、裝置橋接器（相機、聯絡人）、區塊鏈錢包等。
@elizaos/plugin-local-inference	啟用 Eliza-1 模型（2B-27B 參數，基於 Gemma）的裝置端執行，以及本地嵌入、語音、視覺與圖像生成資產。
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          # 安裝依賴、子模組、補丁與建立 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
   elizaos create plugin-example --template plugin
   

3. 嘗試託管產品 – 開啟 https://cloud.eliza.app 或從 GitHub releases 頁面下載預建的發行版。

開發者典型工作流程

• 撰寫一個匯出 Plugin 物件的外掛程式（註冊動作、供應商、路由、UI 檢視等）。
• 執行 bun run test:e2e 以驗證與真實執行環境的整合。n
• 在合併之前，請遵循 AGENTS.md 中描述的基於證據的審查流程。

目標受眾

• 產品團隊：正在開發 AI 驅動的個人助理、自動化機器人或裝置端代理。
• 開發者：希望透過外掛程式架構來實驗不同的 LLM、嵌入或多模態模型，而不被單一供應商綁定。
• 研究人員：對現代 LLM（基於 Gemma）的裝置端推論與多模態資產感興趣。

授權

• MIT – 寬鬆，允許商業使用、修改與重新分發。

---

總結：elizaOS 是一個全堆疊、開源的平台，讓您可以在本地或雲端執行自主 AI 代理，透過豐富的外掛程式系統進行擴展，甚至可以發佈專用的作業系統映像檔，將裝置轉換為獨立的 AI 助理。