elizaOS/eliza

GitHub: elizaOS/eliza

面向多智能体开发的开源AI框架,提供从构建、部署到生命周期管理的一站式解决方案。

Stars: 18001 | Forks: 5473

elizaOS

用于多智能体 AI 开发的开源框架

通过现代、可扩展且功能齐全的平台,构建、部署和管理自主 AI 智能体。

elizaOS%2Feliza | Trendshift

Downloads Releases Paper Ask DeepWiki
GitHub Stars GitHub Forks Last Commit on GitHub
License NPM Version Contributors
Documentation Follow on X Discord
## ✨ 什么是 Eliza? elizaOS 是一个用于构建和部署 AI 驱动应用程序的一体化、可扩展平台。无论您是要创建复杂的聊天机器人、用于业务流程自动化的自主智能体,还是智能游戏 NPC,Eliza 都能为您提供所需的工具,助您快速上手并高效扩展。 它结合了模块化架构、强大的 CLI 以及丰富的 Web 界面,让您能够完全掌控智能体的开发、部署和管理生命周期。 有关完整的指南和 API 参考,请访问我们的官方**[文档](https://docs.elizaos.ai/)**。 ## 🚀 核心特性 - 🔌 **丰富的连接性**:开箱即用的连接器,支持 Discord、Telegram、Farcaster 等。 - 🧠 **模型无关**:支持所有主流模型,包括 OpenAI、Gemini、Anthropic、Llama 和 Grok。 - 🖥️ **现代 Web UI**:专业的仪表盘,用于实时管理智能体、分组和对话。 - 🤖 **多智能体架构**:专为创建和编排专业化智能体群组而从头设计。 - 📄 **文档摄取**:轻松摄取文档,并允许智能体从您的数据中检索信息并回答问题 (RAG)。 - 🛠️ **高度可扩展**:通过强大的插件系统构建您自己的功能。 - 📦 **开箱即用**:从第一天起就提供无缝的设置和开发体验。 ## 🏁 快速入门(5 分钟快速开始) 使用 Eliza 有两种推荐路径: - **面向初学者和独立项目 (CLI)**:如果您想在不修改 Eliza 核心代码的情况下创建和部署智能体,CLI 是最快、最简单的方法。以下指南正适合您。 - **面向高级用户和贡献者 (Monorepo)**:如果您计划为 Eliza 做贡献、创建复杂的自定义插件,或在一个地方管理多个项目,我们建议您克隆完整的 monorepo。请参阅[如何贡献](#-how-to-contribute)部分以开始。 只需几个命令,即可让您的第一个 AI 智能体运行起来。 **前置条件:** - [Node.js](https://nodejs.org/) (v23+) - [bun](https://bun.sh/docs/installation) ### 1. 安装 CLI ``` # 全局安装 elizaOS CLI bun install -g @elizaos/cli # 验证安装 elizaos --version ``` ### 2. 创建您的项目 ``` # 使用交互式设置创建新项目 elizaos create my-first-agent # 按照提示操作。对于初学者,我们建议: # - Database: pglite (无需设置) # - Model Provider: openai # - Project Type: project ``` ### 3. 配置您的 API Key ``` cd my-first-agent # 打开本地环境文件 elizaos env edit-local ``` 添加您模型提供商的 API Key(例如,用于 OpenAI): ``` OPENAI_API_KEY=your_api_key_here ``` ### 4. 启动您的智能体 ``` # 构建并启动 agent 服务器 elizaos start ``` 您的智能体现在已运行! - **Web 界面**:[http://localhost:3000](http://localhost:3000) - **API 端点**:`http://localhost:3000/api`
📚 **高级 CLI 命令与用法** Eliza 的 CLI 功能强大。以下是一些用于开发和管理的更多命令。 #### 开发工作流 ``` # 更改你的 agent 代码,然后重新构建并重启 bun run build elizaos start # 或者,以开发模式启动并启用自动重新构建 elizaos dev # 运行测试以验证你的更改 elizaos test ``` #### 智能体与环境管理 ``` # 列出所有可用的 agent elizaos agent list # 按名称启动特定的 agent elizaos agent start --name "MyAgent" # 显示所有环境变量 elizaos env list ``` #### 调试 ``` # 启动并显示详细 debug 日志 LOG_LEVEL=debug elizaos start ``` 有关完整的命令参考,请运行 `elizaos --help` 或 `elizaos --help`。
## 🔧 独立运行 elizaOS 核心 直接在您的应用程序中使用 elizaOS 智能体,无需 CLI 或 Web 界面。 ``` git clone https://github.com/elizaos/eliza.git cd eliza # 交互式聊天 OPENAI_API_KEY=your_key bun run examples/typescript/chat.ts # 基本消息处理 OPENAI_API_KEY=your_key bun run examples/typescript/standalone.ts ``` ## 🏛️ 架构概述 Eliza 是一个 monorepo,包含了运行整个平台所需的所有包。 ``` / ├── packages/ │ ├── server/ # Core backend server (Express.js) │ ├── client/ # Frontend web interface (React) │ ├── cli/ # Command-line tool for managing projects │ ├── core/ # Shared utilities, basic-capabilities plugin, and functions │ ├── app/ # Cross-platform desktop app (Tauri) │ ├── plugin-sql/ # Database integration (Postgres, PGLite) │ └── ... # Other plugins and project starters └── ... ``` - **`@elizaos/server`**:运行您的智能体并暴露 API 的 Express.js 后端。 - **`@elizaos/client`**:用于管理和与您的智能体交互的基于 React 的 Web UI。 - **`@elizaos/cli`**:用于脚手架生成、运行和管理项目的核心工具。 - **`@elizaos/core`**:包含基础功能插件的核心包,负责处理消息处理和基本智能体动作。 ## 📜 许可证 本项目基于 **MIT License** 授权。详情请参阅 [LICENSE](LICENSE) 文件。 ## 🎓 引用 如果您在研究中使用了 Eliza,请引用我们的论文: ``` @article{walters2025eliza, title={Eliza: A Web3 friendly AI Agent Operating System}, author={Walters, Shaw and Gao, Sam and Nerd, Shakker and Da, Feng and Williams, Warren and Meng, Ting-Chien and Han, Hunter and He, Frank and Zhang, Allen and Wu, Ming and others}, journal={arXiv preprint arXiv:2501.06781}, year={2025} } ``` ## 贡献者 Eliza project contributors ## Star 历史 [![Star History Chart](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date)
标签:AI开发框架, AI编程, DLL 劫持, elizaOS, GNU通用公共许可证, LLM, Node.js, PyRIT, RAG, TypeScript, Unmanaged PE, 人工智能, 多智能体, 多智能体系统, 大语言模型, 安全插件, 开源框架, 持续集成, 测试用例, 用户模式Hook绕过, 网络调试, 自主智能体, 自动化, 通知系统