elizaOS/eliza
GitHub: elizaOS/eliza
面向多智能体开发的开源AI框架,提供从构建、部署到生命周期管理的一站式解决方案。
Stars: 18001 | Forks: 5473
elizaOS
用于多智能体 AI 开发的开源框架
通过现代、可扩展且功能齐全的平台,构建、部署和管理自主 AI 智能体。
## ✨ 什么是 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}
}
```
## 贡献者
## Star 历史
[](https://star-history.com/#elizaos/eliza&Date)
标签:AI开发框架, AI编程, DLL 劫持, elizaOS, GNU通用公共许可证, LLM, Node.js, PyRIT, RAG, TypeScript, Unmanaged PE, 人工智能, 多智能体, 多智能体系统, 大语言模型, 安全插件, 开源框架, 持续集成, 测试用例, 用户模式Hook绕过, 网络调试, 自主智能体, 自动化, 通知系统