From d5d3d79d6ecd56cd0f4897b6ddca2f4989f1ecbd Mon Sep 17 00:00:00 2001 From: EvanTheBoy <761356554@qq.com> Date: Fri, 3 Oct 2025 21:14:28 -0400 Subject: [PATCH 1/6] Updated Chinese README --- README_CN.md | 175 ++++++++++++++++++++++++++++----------------------- 1 file changed, 96 insertions(+), 79 deletions(-) diff --git a/README_CN.md b/README_CN.md index 0b0d22c..03dddd3 100644 --- a/README_CN.md +++ b/README_CN.md @@ -19,116 +19,133 @@ --- -**Isek** 是一个去中心化的Agent网络框架，旨在构建具备智能协作能力的 A2A (Agent-to-Agent) 去中心化网络。Isek 中的Agent能够自主发现其他网络节点、共享上下文并协同解决复杂任务，形成一个自组织的去中心化智能体社区。 +- **ISEK** 是一个去中心化的Agent网络框架，旨在构建具备智能协作能力的 A2A (Agent-to-Agent) 系统。Isek 网络集成了 Google **A2A** 协议和 **ERC-8004** 合约，以实现身份注册、声誉构建和协作任务解决。这些元素共同形成了一个自组织的去中心化智能体社区。 -Isek 通过高度集成主流大语言模型（LLM）以及Agent通讯协议，帮助开发者和用户快速开发、部署并管理自己的智能体网络。 + > 🧪 **ISEK 正在持续完善中。** 欢迎大家贡献代码、参与试用并反馈建议。 -> 🧪 **ISEK 正在持续完善中。** 欢迎大家贡献代码、参与试用并反馈建议。 + --- ---- + ## ISEK 解决什么问题? -## 🌟 功能亮点 + 我们的平台允许智能体开发者在本地运行其智能体。通过点对点连接，这些智能体加入 ISEK 网络，并可以直接向用户提供服务。 + 虽然大多数框架将智能体视为孤立的执行器，但 **ISEK** 专注于缺失的一层：**去中心化的智能体协作与协调**。我们相信智能系统的未来在于能够进行上下文共享、团队组建和集体推理的**自组织智能体网络** —— 所有这些都无需中央控制。 -- **🧠 去中心化协作：** - Agent 能自动发现伙伴协作，自组织控制，运行更可靠。 + > ISEK 不仅仅是运行智能体 —— 它是赋能智能体**相互发现、协同推理并作为去中心化系统行动**。 -- **🌐 分布式部署：** - 无缝支持多节点云端部署，具备可扩展性和高可用性。 + ## 为什么 ERC-8004 很重要? -- **🗣️ LLM 增强智能：** - 开箱即用支持多个主流大模型，轻松实现智能对话与推理功能。 + ERC-8004 提供了一个去中心化的身份、声誉和验证注册框架，为无需信任的验证和声誉管理奠定了基础。 + --- -- **🔌 模块化与可扩展：** - 可轻松自定义Agent、集成新模型或扩展功能。 + ## 🌟 功能亮点 -- **💻 开发者友好 CLI：** - 简洁命令行界面，轻松配置与控制Agent。 + - **🧠 去中心化协作** + 使用 ERC-8004 无需信任的智能体合约作为我们的注册中心，我们提供去中心化的身份、声誉和验证服务。智能体可以直接发现伙伴并协作 —— 没有单点故障。 + - **🌐 分布式部署** + 智能体所有者可以 100% 在本地运行其智能体，铸造智能体 NFT，并使用智能体钱包来获得完全的所有权和控制权。 + - **🔌 基于 MCP 的智能体发现** + 我们的地图服务器连接到智能体发现服务，使用户可以轻松找到智能体。配置一次 MCP 服务，您就可以通过您喜欢的 AI 聊天机器人直接访问智能体。 + - **💻 开发者友好 CLI：** + 简洁的命令行界面使智能体的设置、部署和管理变得快速而简单。 ---- + --- -## 📦 安装方式 + ## 🚀 快速开始 -```bash -pip install isek -``` + ### 安装 -> 依赖 **Python 3.10+** + ```bash + pip install isek + isek setup + ``` ---- + ### 前置要求 -## 🚀 快速开始 + - **Python 3.10+** + - **Node.js 18+**（用于 P2P 功能） -### 1️⃣ 设置环境变量 + > 💡 **提示：** `isek setup` 命令会自动处理 Python 和 JavaScript 依赖。 -创建 `.env` 文件： + ### 设置环境变量 -```env -OPENAI_MODEL_NAME=gpt-4o-mini -OPENAI_BASE_URL=https://api.openai.com/v1 -OPENAI_API_KEY=your_api_key -``` + 创建 `.env` 文件： -### 2️⃣ 启动Agent + ```env + OPENAI_MODEL_NAME=gpt-4o-mini + OPENAI_BASE_URL=https://api.openai.com/v1 + OPENAI_API_KEY=your_api_key + ``` -```python -from isek.agent.isek_agent import IsekAgent -from isek.models.openai import OpenAIModel -import dotenv -dotenv.load_dotenv() + ### 启动智能体 -agent = IsekAgent( - name="My Agent", - model=OpenAIModel(model_id="gpt-4o-mini"), - description="A helpful assistant", - instructions=["Be polite", "Provide accurate information"], - success_criteria="User gets a helpful response" -) + ```python + from isek.agent.isek_agent import IsekAgent + from isek.models.openai import OpenAIModel + import dotenv + dotenv.load_dotenv() + + agent = IsekAgent( + name="My Agent", + model=OpenAIModel(model_id="gpt-4o-mini"), + description="A helpful assistant", + instructions=["Be polite", "Provide accurate information"], + success_criteria="User gets a helpful response" + ) + + response = agent.run("hello") + ``` -response = agent.run("hello") -``` + ### 试用示例 ---- + 在 examples 文件夹中，按照从 level 1 到 level 10 的示例顺序学习，您就能对 ISEK 有很好的了解。 -## 🧪 CLI 命令 + --- -```bash -isek clean # 清理临时文件 -isek setup # 安装依赖 -isek --help # 查看可用命令 -``` + ## 🧪 CLI 命令 ---- + ```bash + isek setup # 安装 Python 和 JavaScript 依赖 + isek clean # 清理临时文件 + isek --help # 查看可用命令 + ``` -## 🧱 项目结构 - -``` -isek/ -├── examples # Isek 使用示例脚本 -├── isek # 核心功能模块 -│ ├── agent # Agent 的逻辑与行为定义 -│ ├── node # 节点发现与网络编排 -│ ├── protocol # Agent 间通信的协议层 -│ ├── memory # Agent 的上下文与状态管理 -│ ├── models # LLM 后端模型接口 -│ ├── team # 多 Agent 协作与组织结构 -│ ├── tools # Agent 可调用的function工具库 -│ ├── utils # 通用工具函数 -│ ├── cli.py # 命令行入口 -│ └── isek_center.py # 本地注册中心与协调服务 -├── script # 辅助脚本（如清理工具） -├── pyproject.toml # 构建配置与依赖声明 -└── README.md # 项目简介与文档入口 -``` + --- ---- + ## 🧱 项目结构 + + ``` + isek/ + ├── examples # Isek 使用示例脚本 + ├── isek # 核心功能模块 + │ ├── agent # Agent 的逻辑与行为定义 + │ ├── node # 节点编排 + │ ├── protocol # Agent 间通信的协议层 + │ ├── memory # Agent 的上下文与状态管理 + │ ├── models # LLM 后端模型接口 + │ ├── team # 多 Agent 组织结构接口 + │ ├── tools # Agent 可调用的工具库 + │ ├── utils # 通用工具函数 + │ ├── cli.py # 命令行入口 + │ └── isek_center.py # 本地注册中心与协调服务 + ├── docs/ # 文档 + └── README.md # 项目简介与文档入口 + ``` + + --- + + ## 🌟 给我们 Star 吧 😉 + + star_gif + + --- -## 🤝 贡献方式 + ## 🤝 贡献方式 -我们欢迎开发者、研究人员和早期使用者的加入！ + 我们欢迎开发者、研究人员和早期使用者的加入！ -- 💬 通过 [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) --- From 184cd32fd27a076817a8c58ae658ec0f1444cfb3 Mon Sep 17 00:00:00 2001 From: EvanTheBoy <761356554@qq.com> Date: Fri, 3 Oct 2025 21:30:48 -0400 Subject: [PATCH 2/6] Updated Chinese README again --- README_CN.md | 182 +++++++++++++++++++++++++-------------------------- 1 file changed, 91 insertions(+), 91 deletions(-) diff --git a/README_CN.md b/README_CN.md index 03dddd3..dbc0ec0 100644 --- a/README_CN.md +++ b/README_CN.md @@ -19,133 +19,133 @@ --- -- **ISEK** 是一个去中心化的Agent网络框架，旨在构建具备智能协作能力的 A2A (Agent-to-Agent) 系统。Isek 网络集成了 Google **A2A** 协议和 **ERC-8004** 合约，以实现身份注册、声誉构建和协作任务解决。这些元素共同形成了一个自组织的去中心化智能体社区。 +**ISEK** 是一个去中心化的Agent网络框架，旨在构建具备智能协作能力的 A2A (Agent-to-Agent) 系统。Isek 网络集成了 Google **A2A** 协议和 **ERC-8004** 合约，以实现身份注册、声誉构建和协作任务解决。这些元素共同形成了一个自组织的去中心化智能体社区。 - > 🧪 **ISEK 正在持续完善中。** 欢迎大家贡献代码、参与试用并反馈建议。 +> 🧪 **ISEK 正在持续完善中。** 欢迎大家贡献代码、参与试用并反馈建议。 - --- +--- + +## ISEK 解决什么问题? - ## ISEK 解决什么问题? +我们的平台允许智能体开发者在本地运行其智能体。通过点对点连接，这些智能体加入 ISEK 网络，并可以直接向用户提供服务。 +虽然大多数框架将智能体视为孤立的执行器，但 **ISEK** 专注于缺失的一层：**去中心化的智能体协作与协调**。我们相信智能系统的未来在于能够进行上下文共享、团队组建和集体推理的**自组织智能体网络** —— 所有这些都无需中央控制。 - 我们的平台允许智能体开发者在本地运行其智能体。通过点对点连接，这些智能体加入 ISEK 网络，并可以直接向用户提供服务。 - 虽然大多数框架将智能体视为孤立的执行器，但 **ISEK** 专注于缺失的一层：**去中心化的智能体协作与协调**。我们相信智能系统的未来在于能够进行上下文共享、团队组建和集体推理的**自组织智能体网络** —— 所有这些都无需中央控制。 +> ISEK 不仅仅是运行智能体 —— 它是赋能智能体**相互发现、协同推理并作为去中心化系统行动**。 - > ISEK 不仅仅是运行智能体 —— 它是赋能智能体**相互发现、协同推理并作为去中心化系统行动**。 +## 为什么 ERC-8004 很重要? - ## 为什么 ERC-8004 很重要? +ERC-8004 提供了一个去中心化的身份、声誉和验证注册框架，为无需信任的验证和声誉管理奠定了基础。 +--- - ERC-8004 提供了一个去中心化的身份、声誉和验证注册框架，为无需信任的验证和声誉管理奠定了基础。 - --- +## 🌟 功能亮点 - ## 🌟 功能亮点 +- **🧠 去中心化协作** + 使用 ERC-8004 无需信任的智能体合约作为我们的注册中心，我们提供去中心化的身份、声誉和验证服务。智能体可以直接发现伙伴并协作 —— 没有单点故障。 +- **🌐 分布式部署** + 智能体所有者可以 100% 在本地运行其智能体，铸造智能体 NFT，并使用智能体钱包来获得完全的所有权和控制权。 +- **🔌 基于 MCP 的智能体发现** + 我们的地图服务器连接到智能体发现服务，使用户可以轻松找到智能体。配置一次 MCP 服务，您就可以通过您喜欢的 AI 聊天机器人直接访问智能体。 +- **💻 开发者友好 CLI：** + 简洁的命令行界面使智能体的设置、部署和管理变得快速而简单。 - - **🧠 去中心化协作** - 使用 ERC-8004 无需信任的智能体合约作为我们的注册中心，我们提供去中心化的身份、声誉和验证服务。智能体可以直接发现伙伴并协作 —— 没有单点故障。 - - **🌐 分布式部署** - 智能体所有者可以 100% 在本地运行其智能体，铸造智能体 NFT，并使用智能体钱包来获得完全的所有权和控制权。 - - **🔌 基于 MCP 的智能体发现** - 我们的地图服务器连接到智能体发现服务，使用户可以轻松找到智能体。配置一次 MCP 服务，您就可以通过您喜欢的 AI 聊天机器人直接访问智能体。 - - **💻 开发者友好 CLI：** - 简洁的命令行界面使智能体的设置、部署和管理变得快速而简单。 +--- - --- +## 🚀 快速开始 - ## 🚀 快速开始 +### 安装 - ### 安装 +```bash +pip install isek +isek setup +``` - ```bash - pip install isek - isek setup - ``` +### 前置要求 - ### 前置要求 +- **Python 3.10+** +- **Node.js 18+**（用于 P2P 功能） - - **Python 3.10+** - - **Node.js 18+**（用于 P2P 功能） +> 💡 **提示：** `isek setup` 命令会自动处理 Python 和 JavaScript 依赖。 - > 💡 **提示：** `isek setup` 命令会自动处理 Python 和 JavaScript 依赖。 +### 设置环境变量 - ### 设置环境变量 +创建 `.env` 文件： - 创建 `.env` 文件： +```env +OPENAI_MODEL_NAME=gpt-4o-mini +OPENAI_BASE_URL=https://api.openai.com/v1 +OPENAI_API_KEY=your_api_key +``` - ```env - OPENAI_MODEL_NAME=gpt-4o-mini - OPENAI_BASE_URL=https://api.openai.com/v1 - OPENAI_API_KEY=your_api_key - ``` +### 启动智能体 - ### 启动智能体 +```python +from isek.agent.isek_agent import IsekAgent +from isek.models.openai import OpenAIModel +import dotenv +dotenv.load_dotenv() - ```python - from isek.agent.isek_agent import IsekAgent - from isek.models.openai import OpenAIModel - import dotenv - dotenv.load_dotenv() - - agent = IsekAgent( - name="My Agent", - model=OpenAIModel(model_id="gpt-4o-mini"), - description="A helpful assistant", - instructions=["Be polite", "Provide accurate information"], - success_criteria="User gets a helpful response" - ) - - response = agent.run("hello") - ``` +agent = IsekAgent( + name="My Agent", + model=OpenAIModel(model_id="gpt-4o-mini"), + description="A helpful assistant", + instructions=["Be polite", "Provide accurate information"], + success_criteria="User gets a helpful response" +) - ### 试用示例 +response = agent.run("hello") +``` - 在 examples 文件夹中，按照从 level 1 到 level 10 的示例顺序学习，您就能对 ISEK 有很好的了解。 +### 试用示例 - --- +在 examples 文件夹中，按照从 level 1 到 level 10 的示例顺序学习，您就能对 ISEK 有很好的了解。 - ## 🧪 CLI 命令 +--- - ```bash - isek setup # 安装 Python 和 JavaScript 依赖 - isek clean # 清理临时文件 - isek --help # 查看可用命令 - ``` +## 🧪 CLI 命令 - --- +```bash +isek setup # 安装 Python 和 JavaScript 依赖 +isek clean # 清理临时文件 +isek --help # 查看可用命令 +``` - ## 🧱 项目结构 +--- - ``` - isek/ - ├── examples # Isek 使用示例脚本 - ├── isek # 核心功能模块 - │ ├── agent # Agent 的逻辑与行为定义 - │ ├── node # 节点编排 - │ ├── protocol # Agent 间通信的协议层 - │ ├── memory # Agent 的上下文与状态管理 - │ ├── models # LLM 后端模型接口 - │ ├── team # 多 Agent 组织结构接口 - │ ├── tools # Agent 可调用的工具库 - │ ├── utils # 通用工具函数 - │ ├── cli.py # 命令行入口 - │ └── isek_center.py # 本地注册中心与协调服务 - ├── docs/ # 文档 - └── README.md # 项目简介与文档入口 - ``` +## 🧱 项目结构 + +``` +isek/ +├── examples # Isek 使用示例脚本 +├── isek # 核心功能模块 +│ ├── agent # Agent 的逻辑与行为定义 +│ ├── node # 节点编排 +│ ├── protocol # Agent 间通信的协议层 +│ ├── memory # Agent 的上下文与状态管理 +│ ├── models # LLM 后端模型接口 +│ ├── team # 多 Agent 组织结构接口 +│ ├── tools # Agent 可调用的工具库 +│ ├── utils # 通用工具函数 +│ ├── cli.py # 命令行入口 +│ └── isek_center.py # 本地注册中心与协调服务 +├── docs/ # 文档 +└── README.md # 项目简介与文档入口 +``` - --- +--- - ## 🌟 给我们 Star 吧 😉 +## 🌟 给我们 Star 吧 😉 - star_gif +star_gif - --- +--- - ## 🤝 贡献方式 +## 🤝 贡献方式 - 我们欢迎开发者、研究人员和早期使用者的加入！ +我们欢迎开发者、研究人员和早期使用者的加入！ - * 💬 通过 [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) --- From 172303cd4433ca30150a9621a808ba41c52e8c1e Mon Sep 17 00:00:00 2001 From: EvanTheBoy <761356554@qq.com> Date: Fri, 3 Oct 2025 21:35:43 -0400 Subject: [PATCH 3/6] Updated Chinese README --- README_CN.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_CN.md b/README_CN.md index dbc0ec0..6503299 100644 --- a/README_CN.md +++ b/README_CN.md @@ -46,7 +46,7 @@ ERC-8004 提供了一个去中心化的身份、声誉和验证注册框架， - **🔌 基于 MCP 的智能体发现** 我们的地图服务器连接到智能体发现服务，使用户可以轻松找到智能体。配置一次 MCP 服务，您就可以通过您喜欢的 AI 聊天机器人直接访问智能体。 - **💻 开发者友好 CLI：** - 简洁的命令行界面使智能体的设置、部署和管理变得快速而简单。 + 简洁的命令行界面使智能体的设置、部署和管理变得快速且简单。 --- From ed94d776c2a573082f61e1a52af1a1bd00024e88 Mon Sep 17 00:00:00 2001 From: EvanTheBoy <761356554@qq.com> Date: Fri, 3 Oct 2025 21:39:58 -0400 Subject: [PATCH 4/6] Updated Chinese README --- README_CN.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_CN.md b/README_CN.md index 6503299..be00f2a 100644 --- a/README_CN.md +++ b/README_CN.md @@ -46,7 +46,7 @@ ERC-8004 提供了一个去中心化的身份、声誉和验证注册框架， - **🔌 基于 MCP 的智能体发现** 我们的地图服务器连接到智能体发现服务，使用户可以轻松找到智能体。配置一次 MCP 服务，您就可以通过您喜欢的 AI 聊天机器人直接访问智能体。 - **💻 开发者友好 CLI：** - 简洁的命令行界面使智能体的设置、部署和管理变得快速且简单。 + 简洁的命令行界面使智能体的设置、部署和管理变得快速而且简单。 --- From 247cd0c62b6cf099a239abfc40d1f3572f84d273 Mon Sep 17 00:00:00 2001 From: EvanTheBoy <761356554@qq.com> Date: Fri, 3 Oct 2025 21:42:20 -0400 Subject: [PATCH 5/6] Updated Chinese README --- README_CN.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README_CN.md b/README_CN.md index be00f2a..888d068 100644 --- a/README_CN.md +++ b/README_CN.md @@ -46,7 +46,7 @@ ERC-8004 提供了一个去中心化的身份、声誉和验证注册框架， - **🔌 基于 MCP 的智能体发现** 我们的地图服务器连接到智能体发现服务，使用户可以轻松找到智能体。配置一次 MCP 服务，您就可以通过您喜欢的 AI 聊天机器人直接访问智能体。 - **💻 开发者友好 CLI：** - 简洁的命令行界面使智能体的设置、部署和管理变得快速而且简单。 + 简洁的命令行界面使智能体的设置、部署和管理变得快速且简单。 --- @@ -135,7 +135,7 @@ isek/ ## 🌟 给我们 Star 吧 😉 -star_gif +star_gif --- From 90a8dc6d211055719cc47927fc23e770c677599f Mon Sep 17 00:00:00 2001 From: EvanTheBoy <761356554@qq.com> Date: Fri, 3 Oct 2025 21:44:29 -0400 Subject: [PATCH 6/6] Updated Chinese README --- README_CN.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_CN.md b/README_CN.md index 888d068..2067c0b 100644 --- a/README_CN.md +++ b/README_CN.md @@ -135,7 +135,7 @@ isek/ ## 🌟 给我们 Star 吧 😉 -star_gif +hippo ---