Skip to main content

Using ZerePy

This guide covers the main features and commands available in ZerePy.

Platform Capabilities​

Social Platforms​

Twitter/X Integration​

  • Post tweets using AI-generated prompts
  • Read timeline with configurable count settings
  • Reply to tweets in your timeline
  • Like tweets in your timeline

Farcaster Features​

  • Post new casts
  • Reply to existing casts
  • Like and requote casts
  • Read timeline content
  • Retrieve cast replies and threads

Discord Integration​

  • Send messages to channels
  • React to messages
  • Read channel history
  • Manage server interactions
  • Handle direct messages
  • Manage roles and permissions

Echochambers Integration​

  • Post new messages to rooms
  • Generate contextual replies
  • Read and analyze room history
  • Access room information and topics

Blockchain Features​

Solana Integration​

  • Send SOL transactions
  • Monitor wallet balance
  • Track transaction history
  • Interact with SPL tokens

Ethereum Integration​

  • Send ETH transactions
  • Send ERC-20 tokens
  • Check wallet balances
  • Get token information
  • Get configured address

Sonic Integration​

  • Send S transactions
  • Monitor wallet balance
  • Track transaction history
  • Interact with ERC-20 tokens
  • Execute token swaps on Sonic DEX
  • Custom slippage settings
  • Token lookup by ticker

GOAT Integration​

  • Enable agents to manage onchain wallets
  • Interact with ERC-20 tokens
  • Access token price data
  • Execute token transfers

AI/ML Features​

XAI Language Model​

  • 128k context length support
  • Function calling capabilities
  • System prompt support
  • OpenAI/Anthropic SDK compatibility
  • Advanced language understanding
  • Context-aware responses

GOAT Integration​

  • AI-powered decision making for onchain actions
  • Autonomous strategy execution
  • Context-aware transaction planning
  • Intelligent asset management

Allora Integration​

  • Access to decentralized inference models
  • Custom model selection
  • Inference parameter control
  • Chain-specific model deployment

LLM Integrations​

Hyperbolic Features​

  • Access to Meta-Llama models
  • Advanced text generation
  • Custom temperature settings
  • Token length control

Galadriel Features​

  • OpenAI-compatible API interface
  • Support for verified model access
  • Optional fine-tuning capabilities
  • System prompt support
  • Custom model selection

CLI Command Reference​

ZerePy provides a comprehensive set of CLI commands. Use help to see all available commands at any time.

Agent Management​

  • list-agents - Display all available agents
  • load-agent - Load a specific agent for use
  • agent-loop - Start the agent's autonomous behavior
  • agent-action - Execute a single agent action
  • chat - Start an interactive chat session with the agent

Connection Management​

  • list-connections - Show all available platform connections
  • list-actions - Display available actions for a specific connection
  • configure-connection - Set up a new platform connection

Additional Commands​

  • help [command] - Get detailed help for a specific command
  • exit or quit - Exit the ZerePy CLI
  • clear or cls - Clear the terminal environment

Blockchain Commands​

Common Commands (All Chains)​

  • Check native token balance:
    • get-eth-balance (Ethereum)
    • get-sonic-balance (Sonic)
    • get-balance (Solana)
  • Get token data by ticker: get-token-by-ticker
  • Send native tokens:
    • send-eth (Ethereum)
    • send-sonic (Sonic)
    • transfer (Solana)

EVM Chain Commands (Ethereum & Sonic)​

  • Send tokens:
    • send-eth-token (Ethereum)
    • send-sonic-token (Sonic)
  • Get wallet address: get-address

Chain-Specific Commands​

Solana Only​
  • trade - Swap tokens using Jupiter
  • stake - Stake SOL
  • get-tps - Get current network TPS
  • get-token-by-address - Get token data by address
Sonic Only​
  • swap-sonic - Swap tokens on DEX with custom slippage control

Note: EVM chains (Ethereum and Sonic) follow similar command patterns, just replace "eth" with "sonic" in the command name. For example: send-eth-token on Ethereum becomes send-sonic-token on Sonic chain.

Example Usage Flows​

Basic Usage Flow​

  1. Start ZerePy
  2. Use list-connections to check available platforms
  3. Configure required connections:
    • LLM providers: 
      configure-connection openai    # or
      configure-connection anthropic # or
      configure-connection eternalai # or
      configure-connection xai       # or
      configure-connection ollama    # or
      configure-connection hyperbolic
    • Social platforms: 
      configure-connection twitter     # or
      configure-connection farcaster   # or
      configure-connection discord     # or
      configure-connection echochambers
    • Blockchain: 
      configure-connection solana    # or
      configure-connection ethereum  # or
      configure-connection sonic
    • Additional tools: 
      configure-connection goat      # for onchain actions
      configure-connection allora    # for inference
  4. Load your agent with load-agent
  5. Start autonomous behavior with agent-loop

Interactive Usage​

  1. Load your agent
  2. Use chat to interact directly with the agent
  3. Use agent-action to trigger specific behaviors

Monitoring​

  • The agent will log its actions and thought process
  • Use Ctrl+C to safely stop the agent loop at any time
  • Check the console output for success/failure messages