Skip to main content

Introduction

ZerePy

What is ZerePy?​

ZerePy is an open-source Python framework designed to let you deploy autonomous agents across multiple platforms and blockchains. Powered by a variety of LLM providers, it enables seamless integration between social, blockchain, and AI capabilities.

Built from a modularized version of the Zerebro backend, ZerePy enables you to launch your own agent with similar core functionality as Zerebro. For creative outputs, you'll need to fine-tune your own model.

Key Features​

Core Features​

  • Command Line Interface (CLI) for managing agents
  • Modular connection system for easy extensibility
  • Structured logging system
  • Optional server mode for deployment and advanced workflows

Platform Integrations​

  • Social Platforms:
    • Twitter/X
    • Farcaster
    • Echochambers
    • Discord
  • Blockchain Networks:
    • Solana
    • EVM Networks:
      • Ethereum
      • Polygon
      • Sonic
      • Monad
  • AI/ML Tools:
    • GOAT Onchain Agent Toolkit
    • Allora Inference

LLM Providers​

  • OpenAI
  • Anthropic
  • EternalAI
  • Ollama
  • Hyperbolic
  • Galadriel
  • Allora
  • xAI
  • Together AI
  • Groq

System Requirements​

Software Requirements​

  • Python 3.10 or higher (3.10 and 3.11 recommended for beginners)
  • Poetry 1.5 or higher

API Keys Required​

LLM Providers (at least one)​

Note: Ollama is run locally and doesn't require an API key.

Social Platforms (as needed)​

Blockchain Requirements​

Each blockchain integration requires specific credentials and resources:

Solana​

  • Private key (base58 format)
  • Sufficient SOL for:
    • Transaction fees
    • Token transfers
    • Smart contract interactions
  • RPC URL (optional, defaults to public endpoints)

EVM Networks​

  • Private key
  • Sufficient native tokens for:
    • Gas fees
    • Token transfers
    • Contract interactions
  • Networks supported:
    • Ethereum (ETH)
    • Polygon (MATIC)
    • Sonic (S)
    • Monad (MONAD)
  • RPC URL (optional, defaults to public endpoints)

GOAT Integration​

  • Private key for transaction signing
  • RPC URL from:
    • Infura
    • Alchemy
    • Custom node
  • Plugin requirements:
    • Coingecko API key (for price data)
    • Uniswap API key (for DEX operations)
    • ERC20 token configurations
    • DexScreener access

Quick Start​

You can get started with ZerePy in two ways:

Option 1: Replit Template (Fastest)​

  1. Visit ZerePy Replit Template
  2. Fork the template (requires a Replit account)
  3. Click the run button at the top
  4. Your CLI should be ready to use

Option 2: Local Installation​

  1. Clone the repository:

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

  2. Navigate to the directory:

    cd zerepy

  3. Install Poetry:

    # Linux, macOS, WSL
    curl -sSL https://install.python-poetry.org | python3 -

    # Windows (PowerShell)
    (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -

    For detailed installation instructions, visit python-poetry.org

  4. Install dependencies:

    poetry install --no-root

  5. Activate the virtual environment:

    poetry shell

  6. Start ZerePy:

    poetry run python main.py

For detailed setup instructions, see our Installation Guide.

Optional Features​

Server Mode​

For advanced workflows and remote control capabilities, ZerePy includes an optional server mode that can be installed via:

poetry install --extras server

See the Server Mode Guide for more details.

Star History​

Star History Chart

Made with ♥ @Blorm.xyz