Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
73 changes: 45 additions & 28 deletions README_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,46 +19,54 @@

---

**Isek** 是一个去中心化的Agent网络框架,旨在构建具备智能协作能力的 A2A (Agent-to-Agent) 去中心化网络。Isek 中的Agent能够自主发现其他网络节点、共享上下文并协同解决复杂任务,形成一个自组织的去中心化智能体社区。

Isek 通过高度集成主流大语言模型(LLM)以及Agent通讯协议,帮助开发者和用户快速开发、部署并管理自己的智能体网络。
**ISEK** 是一个去中心化的Agent网络框架,旨在构建具备智能协作能力的 A2A (Agent-to-Agent) 系统。Isek 网络集成了 Google **A2A** 协议和 **ERC-8004** 合约,以实现身份注册、声誉构建和协作任务解决。这些元素共同形成了一个自组织的去中心化智能体社区。

> 🧪 **ISEK 正在持续完善中。** 欢迎大家贡献代码、参与试用并反馈建议。

---

## 🌟 功能亮点
## ISEK 解决什么问题?

- **🧠 去中心化协作:**
Agent 能自动发现伙伴协作,自组织控制,运行更可靠。
我们的平台允许智能体开发者在本地运行其智能体。通过点对点连接,这些智能体加入 ISEK 网络,并可以直接向用户提供服务。
虽然大多数框架将智能体视为孤立的执行器,但 **ISEK** 专注于缺失的一层:**去中心化的智能体协作与协调**。我们相信智能系统的未来在于能够进行上下文共享、团队组建和集体推理的**自组织智能体网络** —— 所有这些都无需中央控制。

- **🌐 分布式部署:**
无缝支持多节点云端部署,具备可扩展性和高可用性。
> ISEK 不仅仅是运行智能体 —— 它是赋能智能体**相互发现、协同推理并作为去中心化系统行动**。

- **🗣️ LLM 增强智能:**
开箱即用支持多个主流大模型,轻松实现智能对话与推理功能。
## 为什么 ERC-8004 很重要?

ERC-8004 提供了一个去中心化的身份、声誉和验证注册框架,为无需信任的验证和声誉管理奠定了基础。
---

- **🔌 模块化与可扩展:**
可轻松自定义Agent、集成新模型或扩展功能。
## 🌟 功能亮点

- **🧠 去中心化协作**
使用 ERC-8004 无需信任的智能体合约作为我们的注册中心,我们提供去中心化的身份、声誉和验证服务。智能体可以直接发现伙伴并协作 —— 没有单点故障。
- **🌐 分布式部署**
智能体所有者可以 100% 在本地运行其智能体,铸造智能体 NFT,并使用智能体钱包来获得完全的所有权和控制权。
- **🔌 基于 MCP 的智能体发现**
我们的地图服务器连接到智能体发现服务,使用户可以轻松找到智能体。配置一次 MCP 服务,您就可以通过您喜欢的 AI 聊天机器人直接访问智能体。
- **💻 开发者友好 CLI:**
简洁命令行界面,轻松配置与控制Agent。
简洁的命令行界面使智能体的设置、部署和管理变得快速且简单。

---

## 📦 安装方式
## 🚀 快速开始

### 安装

```bash
pip install isek
isek setup
```

> 依赖 **Python 3.10+**
### 前置要求

---
- **Python 3.10+**
- **Node.js 18+**(用于 P2P 功能)

## 🚀 快速开始
> 💡 **提示:** `isek setup` 命令会自动处理 Python 和 JavaScript 依赖。

### 1️⃣ 设置环境变量
### 设置环境变量

创建 `.env` 文件:

Expand All @@ -68,7 +76,7 @@ OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_API_KEY=your_api_key
```

### 2️⃣ 启动Agent
### 启动智能体

```python
from isek.agent.isek_agent import IsekAgent
Expand All @@ -87,13 +95,17 @@ agent = IsekAgent(
response = agent.run("hello")
```

### 试用示例

在 examples 文件夹中,按照从 level 1 到 level 10 的示例顺序学习,您就能对 ISEK 有很好的了解。

---

## 🧪 CLI 命令

```bash
isek setup # 安装 Python 和 JavaScript 依赖
isek clean # 清理临时文件
isek setup # 安装依赖
isek --help # 查看可用命令
```

Expand All @@ -106,29 +118,34 @@ isek/
├── examples # Isek 使用示例脚本
├── isek # 核心功能模块
│ ├── agent # Agent 的逻辑与行为定义
│ ├── node # 节点发现与网络编排
│ ├── node # 节点编排
│ ├── protocol # Agent 间通信的协议层
│ ├── memory # Agent 的上下文与状态管理
│ ├── models # LLM 后端模型接口
│ ├── team # 多 Agent 协作与组织结构
│ ├── tools # Agent 可调用的function工具库
│ ├── team # 多 Agent 组织结构接口
│ ├── tools # Agent 可调用的工具库
│ ├── utils # 通用工具函数
│ ├── cli.py # 命令行入口
│ └── isek_center.py # 本地注册中心与协调服务
├── script # 辅助脚本(如清理工具)
├── pyproject.toml # 构建配置与依赖声明
├── docs/ # 文档
└── README.md # 项目简介与文档入口
```

---

## 🌟 给我们 Star 吧 😉

<img src="assets/star_gif.gif" alt="hippo" width="250"/>

---

## 🤝 贡献方式

我们欢迎开发者、研究人员和早期使用者的加入!

- 💬 通过 [GitHub Issues](https://github.com/your-repo/issues) 提出建议或反馈问题
- 📧 联系我们:[team@isek.xyz](mailto:team@isek.xyz)
- 📄 查阅我们的 [贡献指南](CONTRIBUTING.md),了解如何参与贡献
* 💬 通过 [GitHub Issues](https://github.com/your-repo/issues) 提出建议或反馈问题
* 📧 直接联系我们:[team@isek.xyz](mailto:team@isek.xyz)
* 📄 查阅我们的 [贡献指南](CONTRIBUTING.md)

---

Expand Down