ZerePy

ZerePy 是一个开源的 Python 框架，旨在让你利用多种 LLM（大语言模型）在 X（Twitter）上部署你自己的 AI Agent。

ZerePy 构建于 Zerebro 后端的模块化版本之上。通过 ZerePy，你可以启动与 Zerebro 具有相似核心功能的 Agent。若需输出具有创造性的内容，你需要微调自己的模型。

功能特性

核心平台

• 用于管理 Agent 的 CLI 界面
• 模块化连接系统
• 区块链集成

链上活动

• Solana
• Ethereum
• GOAT (Great Onchain Agent Toolkit)
• Monad

社交平台集成

• Twitter/X
• Farcaster
• Echochambers

语言模型支持

• OpenAI
• Anthropic
• EternalAI
• Ollama
• Hyperbolic
• Galadriel
• XAI (Grok)

快速开始

开始使用 ZerePy 最快捷的方法是使用我们的 Replit 模板：

https://replit.com/@blormdev/ZerePy?v=1

1. Fork 该模板（你需要拥有自己的 Replit 账号）
2. 点击顶部的运行按钮
3. 大功告成！你的 CLI 应该已经准备就绪，你可以直接跳转到配置部分。

系统要求

系统：

• Python 3.10 或更高版本
• Poetry 1.5 或更高版本

环境变量：

• LLM：注册账号并获取 API Key（至少需要一个）
  • OpenAI: https://platform.openai.com/api-keys
  • Anthropic: https://console.anthropic.com/account/keys
  • EternalAI: https://eternalai.org/api
  • Hyperbolic: https://app.hyperbolic.xyz
  • Galadriel: https://dashboard.galadriel.com
• 社交平台（根据你的需求）：
  • X API: https://developer.x.com/en/docs/authentication/oauth-1-0a/api-key-and-secret
  • Farcaster: Warpcast 恢复短语
  • Echochambers: API key 和 endpoint
• 链上集成：
  • Solana: 私钥
  • Ethereum: 私钥
  • Monad: 私钥

安装

1. 首先，如果你还没有安装 Poetry 用于依赖管理，请先安装：

请参考官方安装指南：https://python-poetry.org/docs/#installing-with-the-official-installer

2. 克隆代码仓库：

git clone https://github.com/blorm-network/ZerePy.git

3. 进入 zerepy 目录：

cd zerepy

4. 安装依赖：

poetry install --no-root

这将创建一个虚拟环境并安装所有必需的依赖。

使用方法

1. 激活虚拟环境：

poetry shell

2. 运行应用程序：

poetry run python main.py

配置连接并启动 Agent

1. 配置你所需的连接：

   configure-connection twitter    # 用于 Twitter/X 集成
   configure-connection openai     # 用于 OpenAI
   configure-connection anthropic  # 用于 Anthropic
   configure-connection farcaster  # 用于 Farcaster
   configure-connection eternalai  # 用于 EternalAI
   configure-connection solana     # 用于 Solana
   configure-connection goat       # 用于 Goat
   configure-connection galadriel  # 用于 Galadriel
   configure-connection ethereum   # 用于 Ethereum
   configure-connection discord    # 用于 Discord
   configure-connection ollama     # 用于 Ollama
   configure-connection xai        # 用于 Grok
   configure-connection allora     # 用于 Allora
   configure-connection hyperbolic # 用于 Hyperbolic
   

2. 使用 list-connections 查看所有可用连接及其状态。

3. 加载你的 Agent（通常默认会加载一个，你可以通过 CLI 或在 agents/general.json 中设置）：

   load-agent example
   

4. 启动你的 Agent：

   start
   

GOAT 集成

GOAT (Go Agent Tools) 是一个强大的插件系统，允许你的 Agent 与各种区块链网络和协议进行交互。以下是设置方法：

前置条件

1. 一个 RPC 提供商 URL（例如来自 Infura、Alchemy 或你自己的节点）
2. 用于签署交易的钱包私钥

安装

安装你想要使用的任何额外 GOAT 插件：

poetry add goat-sdk-plugin-erc20         # 用于 ERC20 代币交互
poetry add goat-sdk-plugin-coingecko     # 用于价格数据

配置

1. 使用 CLI 配置 GOAT 连接：

   configure-connection goat
   

   系统会提示你输入：

   • RPC 提供商 URL
   • 钱包私钥（将安全存储在 .env 文件中）

2. 将 GOAT 插件配置添加到你的 Agent JSON 文件中：

   {
     "name": "YourAgent",
     "config": [
       {
         "name": "goat",
         "plugins": [
           {
             "name": "erc20",
             "args": {
               "tokens": [
                 "goat_plugins.erc20.token.PEPE",
                 "goat_plugins.erc20.token.USDC"
               ]
             }
           },
           {
             "name": "coingecko",
             "args": {
               "api_key": "YOUR_API_KEY"
             }
           }
         ]
       }
     ]
   }
   

注意：配置中插件的顺序并不重要，但每个插件都必须包含 name 和 args 字段。