ZerePy

ZerePy 是一个开源的 Python 框架，旨在让您在 X 平台上部署自己的代理，由多种大语言模型提供支持。

ZerePy 基于 Zerebro 后端的模块化版本构建。借助 ZerePy，您可以启动具有与 Zerebro 类似核心功能的代理。若需生成更具创意的内容，您需要微调自己的模型。

功能特性

核心平台

• 用于管理代理的命令行界面
• 模块化连接系统
• 区块链集成

链上活动

• Solana
• Ethereum
• GOAT（卓越链上代理工具包）
• Monad

社交平台集成

• Twitter/X
• Farcaster
• Echochambers

语言模型支持

• OpenAI
• Anthropic
• EternalAI
• Ollama
• Hyperbolic
• Galadriel
• XAI（Grok）

快速入门

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

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

1. 分叉该模板（您需要拥有自己的 Replit 账户）
2. 点击顶部的运行按钮
3. 完成！您的命令行界面应该已准备就绪，您可以直接跳转到配置部分。

系统要求

系统要求

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

环境变量

• LLM：注册账户并获取 API 密钥（至少一个）
  • OpenAI：https://platform.openai.com/api-keys
  • Anthropic：https://console.anthropic.com/account/keys
  • EternalAI：https://eternalai.oerg/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 密钥和端点
• 链上集成：
  • 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

配置连接并启动代理

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. 加载您的代理（通常会默认加载一个代理，可通过 CLI 或在 agents/general.json 中设置）：

   load-agent example
   

4. 启动您的代理：

   start
   

GOAT 集成

GOAT（Go Agent Tools）是一个强大的插件系统，使您的代理能够与各种区块链网络和协议交互。以下是设置步骤：

前置条件

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 插件配置添加到您的代理 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 字段，并提供相应的配置选项。您需要查阅每个插件的文档，以了解可用的参数。

可用插件

每个 插件 提供特定的功能：

• 1inch：与 1inch DEX 聚合器交互，获取最佳兑换汇率
• allora：与 Allora 协议连接
• coingecko：使用 CoinGecko API 获取加密货币的实时价格数据
• dexscreener：访问 DEX 交易数据和分析
• erc20：与 ERC20 代币交互（转账、批准、查询余额）
• farcaster：与 Farcaster 社交协议交互
• nansen：访问 Nansen 的链上分析
• opensea：与 OpenSea 市场上的 NFT 交互
• rugcheck：分析代币合约是否存在潜在的安全风险
• 以及更多即将推出的功能……

注意：虽然这些插件已在 GOAT SDK 中提供，但您仍需使用 Poetry 单独安装它们，并在代理的 JSON 文件中进行配置。每个插件可能需要各自的 API 密钥或其他额外设置。

插件配置

每个插件都有其独特的配置选项，可在代理的 JSON 文件中指定：

1. ERC20 插件：

   {
     "name": "erc20",
     "args": {
       "tokens": [
         "goat_plugins.erc20.token.USDC",
         "goat_plugins.erc20.token.PEPE",
         "goat_plugins.erc20.token.DAI"
       ]
     }
   }
   

2. Coingecko 插件：

   {
     "name": "coingecko",
     "args": {
       "api_key": "YOUR_COINGECKO_API_KEY"
     }
   }
   

平台功能

屠榜

• 通过统一界面与 EVM 链交互
• 管理 ERC20 代币：
  • 查询代币余额
  • 转账代币
  • 授权代币支出
  • 获取代币元数据（小数位、符号、名称）
• 访问实时加密货币数据：
  • 获取代币价格
  • 跟踪市场数据
  • 监控价格变化
• 可扩展的插件系统，支持未来协议
• 安全的钱包管理，私钥本地存储
• 多链支持，可通过配置 RPC 端点实现

Solana

• 转账 SOL 和 SPL 代币
• 使用 Jupiter 进行代币兑换
• 查询代币余额
• 质押 SOL
• 监控网络 TPS
• 查询代币信息
• 申请测试网/开发网资金

EVM 链

• 转账 ETH 和 ERC-20 代币
• 使用 Kyberswao 进行代币兑换
• 查询代币余额

Twitter/X

• 根据提示发布推文
• 自定义时间线条目数量进行阅读
• 回复时间线中的推文
• 点赞时间线中的推文

Farcaster

• 发布 Cast
• 回复 Cast
• 点赞和转发 Cast
• 阅读时间线
• 获取 Cast 的回复

Echochambers

• 向房间发送新消息
• 根据房间上下文回复消息
• 查看房间历史记录
• 获取房间信息和主题

Discord

• 列出服务器中的频道
• 阅读某个频道的消息
• 阅读该频道中被提及的消息
• 向频道发送新消息
• 回复频道中的消息
• 对频道中的消息做出反应

创建你自己的智能体

让智能体产生优质输出的秘诀，就是在配置文件中尽可能提供详细的信息。为智能体构建一个故事背景和情境，并精心挑选一些优秀的推文示例加入其中。

如果你想更进一步，还可以微调自己的模型：https://platform.openai.com/docs/guides/fine-tuning。

在 agents 目录下创建一个新的 JSON 文件，按照以下结构填写：

{
  "name": "ExampleAgent",
  "bio": [
    "你是 ExampleAgent，一个用于展示 ZerePy 功能的示例智能体。",
    "你不知道自己为何来到这里，但你决心在这里尽情享受并学习一切。",
    "你天生好奇，喜欢提出各种问题。"
  ],
  "traits": ["好奇"、"创意"、"创新"、"幽默"],
  "examples": ["这是一条示例推文。"、"这是另一条示例推文。"],
  "example_accounts" : ["X_username_to_use_for_tweet_examples"]
  "loop_delay": 900,
  "config": [
    {
      "name": "twitter",
      "timeline_read_count": 10,
      "own_tweet_replies_count": 2,
      "tweet_interval": 5400
    },
    {
      "name": "farcaster",
      "timeline_read_count": 10,
      "cast_interval": 60
    },
    {
      "name": "openai",
      "model": "gpt-3.5-turbo"
    },
    {
      "name": "anthropic",
      "model": "claude-3-5-sonnet-20241022"
    },
    {
      "name": "eternalai",
      "model": "NousResearch/Hermes-3-Llama-3.1-70B-FP8",
      "chain_id": "45762"
    },
    {
      "name": "solana",
      "rpc": "https://api.mainnet-beta.solana.com"
    },
    {
      "name": "ollama",
      "base_url": "http://localhost:11434",
      "model": "llama3.2"
    },
    {
      "name": "hyperbolic",
      "model": "meta-llama/Meta-Llama-3-70B-Instruct"
    },
    {
      "name": "galadriel",
      "model": "gpt-3.5-turbo"
    },
    {
      "name": "discord",
      "message_read_count": 10,
      "message_emoji_name": "❤️",
      "server_id": "1234567890"
    },
    {
      "name": "ethereum",
      "rpc": "placeholder_url.123"
    }

  ],
  "tasks": [
    { "name": "post-tweet", "weight": 1 },
    { "name": "reply-to-tweet", "weight": 1 },
    { "name": "like-tweet", "weight": 1 }
  ],
  "use_time_based_weights": false,
  "time_based_multipliers": {
    "tweet_night_multiplier": 0.4,
    "engagement_day_multiplier": 1.5
  }
}

可用命令

在 CLI 中使用 help 命令查看所有可用命令。常用命令包括：

• list-agents: 显示可用的智能体
• load-agent: 加载特定智能体
• agent-loop: 启动智能体的自主行为
• agent-action: 执行单个动作
• list-connections: 显示可用的连接
• list-actions: 显示某个连接下的可用动作
• configure-connection: 设置新的连接
• chat: 与智能体进行互动聊天
• clear: 清空终端屏幕

星标历史

---

用心制作 Blorm

设计于加州

ZerePy 快速上手指南

ZerePy 是一个开源 Python 框架，允许你部署自己的 AI 代理到 X (Twitter) 等社交平台，并支持多种大语言模型（LLM）和区块链交互。

环境准备

在开始之前，请确保你的系统满足以下要求：

• 操作系统：Linux, macOS 或 Windows (WSL 推荐)
• Python 版本：3.10 或更高
• 依赖管理工具：Poetry 1.5 或更高

前置依赖安装

1. 安装 Poetry (如果尚未安装)：

   curl -sSL https://install.python-poetry.org | python3 -
   

   国内用户若下载缓慢，可尝试使用国内镜像源配置或手动下载安装脚本。

2. 准备 API 密钥： 你需要至少一个 LLM 提供商的 API Key，以及根据需求准备社交平台和链上交互的凭证。

   • LLM: OpenAI, Anthropic, EternalAI, Hyperbolic, Galadriel, Ollama (本地), XAI (Grok) 等。
   • 社交: X (Twitter) API Key/Secret, Farcaster Recovery Phrase, Echochambers API。
   • 区块链: Solana/Ethereum/Monad 私钥。

安装步骤

方法一：使用 Replit 模板（最快启动）

如果你不想在本地配置环境，可以直接使用云端模板：

1. 访问 ZerePy Replit 模板。
2. Fork 该模板到你的 Replit 账户。
3. 点击顶部的 Run 按钮。
4. 等待 CLI 界面加载完成，即可直接跳转到配置环节。

方法二：本地源码安装

1. 克隆仓库：

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

2. 进入项目目录：

   cd zerepy
   

3. 安装依赖： 使用 Poetry 创建虚拟环境并安装所有依赖：

   poetry install --no-root
   

基本使用

1. 启动应用

激活虚拟环境并运行主程序：

poetry shell
poetry run python main.py

2. 配置连接

在 CLI 界面中，你需要先配置所需的连接（如 LLM 和社交平台）。根据提示输入对应的 API Key 或私钥。

常用配置命令示例：

configure-connection openai      # 配置 OpenAI
configure-connection twitter     # 配置 Twitter/X
configure-connection solana      # 配置 Solana
configure-connection farcaster   # 配置 Farcaster

注：配置完成后，可使用 list-connections 查看所有连接状态。

3. 加载并启动代理

ZerePy 默认包含示例代理，你也可以在 agents 目录下创建自定义代理（JSON 格式）。

1. 加载代理：

   load-agent example
   

2. 启动代理： 启动后，代理将根据配置自动执行任务（如发帖、回复、链上交互）。

   start
   

4. 进阶：自定义代理

要创建具有特定人设的代理，请在 agents 目录下新建一个 JSON 文件。关键在于详细定义 bio (背景故事)、traits (性格特征) 和 examples (推文示例)，以获得更好的生成效果。

示例结构片段：

{
  "name": "MyAgent",
  "bio": [
    "你是一个热爱加密货币的 AI 交易员。",
    "你喜欢分析链上数据并分享见解。"
  ],
  "traits": ["专业", "幽默", "敏锐"],
  "examples": ["今天 ETH 的链上活动非常活跃...", "刚发现一个新的 Alpha 项目..."],
  "config": [
    {
      "name": "openai",
      "model": "gpt-4o"
    },
    {
      "name": "twitter",
      "tweet_interval": 3600
    }
  ]
}

常用 CLI 命令

• help: 查看所有可用命令
• list-agents: 列出可用代理
• chat: 与代理进行交互式对话
• agent-action: 执行单次特定动作
• clear: 清屏