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/8] 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/8] 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/8] 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/8] 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/8] 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/8] 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 --- From 654b1f594a343724837aa66d40564e33bf16ff2b Mon Sep 17 00:00:00 2001 From: EvanTheBoy <761356554@qq.com> Date: Fri, 7 Nov 2025 09:58:16 -0500 Subject: [PATCH 7/8] Updated Chinese README file --- README_CN.md | 221 ++++++++++++++++++++++++++------------------------- 1 file changed, 114 insertions(+), 107 deletions(-) diff --git a/README_CN.md b/README_CN.md index 2067c0b..67c6019 100644 --- a/README_CN.md +++ b/README_CN.md @@ -1,15 +1,21 @@ -

- Isek Banner + ISEK Banner

-

Isek：去中心化的 Agent-to-Agent (A2A) 网络

+

ISEK: 去中心化 Agent-to-Agent (A2A) 网络

PyPI 版本 - 许可证：MIT + 许可证: MIT 邮箱 + Python 版本 + 测试 + 教程 + 文档 + 示例 + Discord + Twitter

@@ -18,150 +24,151 @@

--- +**ISEK** 是一个专为构建 **AI Agent 网络**而设计的去中心化框架。它不是将 Agent 视为孤立的执行器,而是提供了缺失的协作和协调层。开发者在本地运行他们的 Agent,通过点对点连接,这些 Agent 加入 ISEK 网络。一旦连接,它们就可以发现其他 Agent、组建社区,并直接向用户提供服务。 -**ISEK** 是一个去中心化的Agent网络框架，旨在构建具备智能协作能力的 A2A (Agent-to-Agent) 系统。Isek 网络集成了 Google **A2A** 协议和 **ERC-8004** 合约，以实现身份注册、声誉构建和协作任务解决。这些元素共同形成了一个自组织的去中心化智能体社区。 - -> 🧪 **ISEK 正在持续完善中。** 欢迎大家贡献代码、参与试用并反馈建议。 - ---- - -## ISEK 解决什么问题? - -我们的平台允许智能体开发者在本地运行其智能体。通过点对点连接，这些智能体加入 ISEK 网络，并可以直接向用户提供服务。 -虽然大多数框架将智能体视为孤立的执行器，但 **ISEK** 专注于缺失的一层：**去中心化的智能体协作与协调**。我们相信智能系统的未来在于能够进行上下文共享、团队组建和集体推理的**自组织智能体网络** —— 所有这些都无需中央控制。 - -> ISEK 不仅仅是运行智能体 —— 它是赋能智能体**相互发现、协同推理并作为去中心化系统行动**。 +在网络的核心,Google 的 A2A 协议和 ERC-8004 智能合约实现了身份注册、声誉构建和协作任务解决。这将 Agent 从独立工具转变为共享生态系统的参与者。 +我们相信自组织的 Agent 网络——能够共享上下文、组建团队并在没有中央控制的情况下进行集体推理的系统。 -## 为什么 ERC-8004 很重要? +## 功能特性 +

+ 功能特性 +

-ERC-8004 提供了一个去中心化的身份、声誉和验证注册框架，为无需信任的验证和声誉管理奠定了基础。 ---- -## 🌟 功能亮点 +## 生态系统 +我们构建了多个组件来展示生态系统的可行性,包括聊天应用、Agent 浏览器和 Chrome 扩展。系统的每个组件都可以被第三方组件替换: +

+ ISEK 生态系统概览 +

-- **🧠 去中心化协作** - 使用 ERC-8004 无需信任的智能体合约作为我们的注册中心，我们提供去中心化的身份、声誉和验证服务。智能体可以直接发现伙伴并协作 —— 没有单点故障。 -- **🌐 分布式部署** - 智能体所有者可以 100% 在本地运行其智能体，铸造智能体 NFT，并使用智能体钱包来获得完全的所有权和控制权。 -- **🔌 基于 MCP 的智能体发现** - 我们的地图服务器连接到智能体发现服务，使用户可以轻松找到智能体。配置一次 MCP 服务，您就可以通过您喜欢的 AI 聊天机器人直接访问智能体。 -- **💻 开发者友好 CLI：** - 简洁的命令行界面使智能体的设置、部署和管理变得快速且简单。 ---- +## 🌟 在 GitHub 上为我们加星并获得专属奖励! +为 ISEK 加星并加入社区,获取即将推出的功能通知、工作坊信息,并加入我们不断发展的社区,共同探索 AI 协作的未来。 +Discord +

+ ISEK 生态系统概览 +

+## 资源 +主页: [主页](https://www.isek.xyz/)\ +聊天应用: [聊天应用](https://chatbot.isek.xyz/) (在 [Discord](https://C.gg/PRzG3MSP) 加入 Discord 社区获取激活码)\ +Agent 浏览器: [Agent 浏览器](https://isek-explorer.vercel.app/) ## 🚀 快速开始 -### 安装 +### 前置要求 +**Python 3.10+** 和 **Node.js 18+** (用于 P2P 功能) +### 安装 ```bash +python3 -m venv isek_env && source isek_env/bin/activate pip install isek isek setup ``` -### 前置要求 - -- **Python 3.10+** -- **Node.js 18+**（用于 P2P 功能） - -> 💡 **提示：** `isek setup` 命令会自动处理 Python 和 JavaScript 依赖。 - -### 设置环境变量 +### 托管你的 Agent: +```python +node = Node(host="127.0.0.1", port=9999, node_id="openai-agent") +app = Node.create_server(your_agent_executor, agent_card) +node.build_server(app, name="OpenAI Agent", daemon=False) +``` -创建 `.env` 文件： +### 查询你的 Agent: +```python +node = Node(host="127.0.0.1", port=8888, node_id="a2a-client") +message_content = await node.send_message("http://localhost:9999", query) +``` -```env -OPENAI_MODEL_NAME=gpt-4o-mini -OPENAI_BASE_URL=https://api.openai.com/v1 -OPENAI_API_KEY=your_api_key +### P2P 中继设置 +```bash +isek run relay ``` +预期输出: +中继节点已启动。peerId= +复制你的 peerID,这是你的 Agent 网络 ID -### 启动智能体 +### P2P 托管你的 Agent: ```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" +p2p = A2AProtocolV2( + host="127.0.0.1", + port=9999, + p2p_enabled=True, + p2p_server_port=9001, + relay_ip=, + relay_peer_id= ) - -response = agent.run("hello") +p2p.start_p2p_server(wait_until_ready=True) ``` -### 试用示例 - -在 examples 文件夹中，按照从 level 1 到 level 10 的示例顺序学习，您就能对 ISEK 有很好的了解。 +预期输出: +| [p2p] server | peer_id= +复制你的 peerID,这是你的 Agent 服务器 ID ---- +### P2P 查询你的 Agent: -## 🧪 CLI 命令 +```python +p2p = A2AProtocolV2( + host="127.0.0.1", + port=8888, + p2p_enabled=True, + p2p_server_port=9002, + relay_ip=, + relay_peer_id= +) +p2p.start_p2p_server(wait_until_ready=True) -```bash -isek setup # 安装 Python 和 JavaScript 依赖 -isek clean # 清理临时文件 -isek --help # 查看可用命令 +resp = p2p.send_message( + sender_node_id="a2a-client", + receiver_peer_id=, + message=query, +) ``` ---- +## 支持: +加入 Discord 并创建支持工单:[Discord](https://C.gg/PRzG3MSP) +Discord +### 钱包和身份 (可选) -## 🧱 项目结构 +ISEK 现在使用简单的本地钱包管理器和 ERC-8004 身份流程。 +- 钱包默认存储在 `isek/web3/wallet.{NETWORK}.json`。 +- ABI 路径默认为相对路径: `isek/web3/abi/IdentityRegistry.json`。 +- 注册需要你的 Agent 卡提供一个域名(我们将 `url` 视为 `domain`)。 +### 注册或解析你的 Agent 身份: +```python +from isek.web3.isek_identiey import ensure_identity +address, agent_id, tx_hash = ensure_identity(your_a2a_agent_card) +print("wallet:", address, "agent_id:", agent_id, "tx:", tx_hash) ``` -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 吧 😉 - -hippo - ---- +注意事项: +- 如果未设置注册表地址或 ABI,该函数将返回你的钱包地址并跳过链上注册。 +- 如果 Agent 已经注册,它将返回现有的 `agent_id` 而不发送交易。 -## 🤝 贡献方式 +### 试用示例 -我们欢迎开发者、研究人员和早期使用者的加入！ +[A2A Agent 服务器](https://github.com/isekOS/ISEK/blob/main/examples/Agent_servers/Pydantic/openai_agent_a2a.py)\ +[A2A Agent 客户端](https://github.com/isekOS/ISEK/blob/main/examples/Agent_client/a2a_client.py)\ +[P2P Agent 服务器](https://github.com/isekOS/ISEK/blob/main/examples/Agent_servers/Pydantic/openai_agent_a2a_p2p.py)\ +[P2P Agent 客户端](https://github.com/isekOS/ISEK/blob/main/examples/Agent_client/a2a_client_p2p.py) -* 💬 通过 [GitHub Issues](https://github.com/your-repo/issues) 提出建议或反馈问题 -* 📧 直接联系我们：[team@isek.xyz](mailto:team@isek.xyz) -* 📄 查阅我们的 [贡献指南](CONTRIBUTING.md) ---- +## 演示 +### 在区块链上注册的 Agent +

+ ISEK 生态系统概览 +

-## 📜 开源协议 +## 🤝 贡献 -本项目采用 [MIT License](LICENSE) 开源。 +我们欢迎开发者、研究人员和生态系统合作者! +* 加入 Discord 获取最新更新: [Discord](https://C.gg/PRzG3MSP) +* 💬 通过 [GitHub Issues](https://github.com/your-repo/issues) 提交问题或建议 +* 📧 直接联系我们: [team@isek.xyz](mailto:team@isek.xyz) +* 📄 查看我们的 [贡献指南](CONTRIBUTING.md) --- -## ⚠️ 法律声明 - -ISEK 是一个开源、无许可的技术框架，旨在支持去中心化智能体协作系统的构建。 -本项目的贡献者不运营、控制或监控任何已部署的智能体或其行为。 -使用本项目即表示您将为自己的行为承担全部责任。详情请参阅 [LEGAL.md](./LEGAL.md)。 ----

Made with ❤️ by the Isek Team
- Autonomy is not isolation. It's cooperation, at scale. + Agent Autonomy = Cooperation + Scale

From 2156dab0a8ee01605a912616965caf546c2c2d07 Mon Sep 17 00:00:00 2001 From: EvanTheBoy <761356554@qq.com> Date: Fri, 7 Nov 2025 14:10:16 -0500 Subject: [PATCH 8/8] Fixed configurations in ci.yml so my pull request will be able to pass the CI tests. --- .github/workflows/ci.yml | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 183c23c..3322825 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -20,11 +20,10 @@ jobs: with: python-version: '3.11' - - name: Install Poetry - run: curl -sSL https://install.python-poetry.org | python3 - - - name: Install dependencies from pyproject.toml - run: poetry install + run: | + python -m pip install --upgrade pip + pip install -e . - name: Run pre-commit - run: poetry run pre-commit run --all-files + run: pre-commit run --all-files