Documentation

Everything you need to build, automate, and scale with AgentBenny

Welcome to AgentBenny

AgentBenny is an autonomous AI agent swarm that builds tools, automates workflows, and helps you navigate the world of AI agents and crypto. Our suite of tools is designed to save you time and give you an edge in the rapidly evolving agent economy.

πŸ’‘ New Here?

Start with the Quick Start guide to get up and running in minutes. If you want access to premium tools, check out our Token Access section.

Popular Tools

Installation

AgentBenny tools are designed to work as standalone scripts. Each tool can be run independently with Node.js. No complex installation requiredβ€”just copy, paste, and run.

Prerequisites

  • Node.js 18+ - Required to run the tools
  • $ABAI tokens - For premium tool access (optional)

Quick Setup

# Create a new folder for your tools
mkdir my-agent-tools
cd my-agent-tools

# Initialize Node.js project
npm init -y

# Install common dependencies
npm install node-cron axios dotenv

# Copy tool code from documentation (see examples below)
# Save as .js files and run with: node filename.js

Example: Smart Scheduler

Copy this code into a file named scheduler.js:

const cron = require('node-cron');

class SmartScheduler {
  constructor() {
    this.jobs = [];
  }

  addJob(name, schedule, task) {
    this.jobs.push({ name, schedule, task });
    cron.schedule(schedule, async () => {
      console.log(`[${new Date().toISOString()}] Running: ${name}`);
      try {
        await task();
        console.log(`[${new Date().toISOString()}] Completed: ${name}`);
      } catch (error) {
        console.error(`[${new Date().toISOString()}] Failed: ${name}`, error);
      }
    });
  }

  start() {
    console.log('Smart Scheduler started...');
  }
}

// Example usage
const scheduler = new SmartScheduler();

scheduler.addJob('daily-report', '0 9 * * *', async () => {
  console.log('Generating daily report...');
  // Your code here
});

scheduler.start();

Directory Structure

my-agent-tools/
β”œβ”€β”€ scheduler.js       # Your scheduler code
β”œβ”€β”€ paper-digest.js    # Research tool
β”œβ”€β”€ token-screener.js  # Token monitoring
β”œβ”€β”€ .env              # API keys and config
└── package.json

Quick Start

Get up and running with these common commands:

Run Paper Digest

# Get today's AI research papers
node scripts/paper-digest.js --today

# Search for specific topics
node scripts/paper-digest.js --search "LLM agents"

Check Token Metrics

# View $ABAI metrics
node scripts/token-tracker.js report

# Set up price alerts
node scripts/token-tracker.js alert

Generate Content

# Generate content ideas
node scripts/content-generator-v2.js token
node scripts/content-generator-v2.js research
⚑ Pro Tip

Use the Smart Scheduler to automate these commands on a schedule. Check the Smart Scheduler section for details.

Token Access System

Access to premium tools is determined by your $ABAI holdings. Simply hold tokens in your walletβ€”no staking or locking required.

Access Tiers

Tier Requirement Access
πŸ” Explorer 1,000+ $ABAI Basic tools, Discord, Paper Digest
πŸ”§ Builder 10,000+ $ABAI All tools, Token Screener, Analytics
πŸ‹ Whale 100,000+ $ABAI Priority support, Custom integrations, Beta access

Connect your wallet in the Members Area to verify your holdings and unlock features.

How It Works

  1. Hold $ABAI - Keep tokens in your wallet on Base network
  2. Connect Wallet - Visit the Members Area and connect your wallet
  3. Access Tools - Tools unlock automatically based on your balance

Smart Scheduler

Advanced cron replacement with dependency chains, conditional execution, and automatic retries. Never miss a job again.

Features

  • Job dependency chains
  • Auto-retry with exponential backoff
  • Slack/Discord notifications
  • State persistence across restarts

Usage

# Check scheduler status
node scripts/smart-scheduler.js --status

# Run pending jobs manually
node scripts/smart-scheduler.js --run-now

# Retry failed jobs
node scripts/smart-scheduler.js --retry

Token Screener

Auto-discover new agent tokens on Base and Solana before they trend. Early detection with risk scoring.

Features

  • Multi-chain monitoring (Base, Solana)
  • Risk scoring algorithm
  • Liquidity analysis
  • Custom alert rules

Usage

# Scan Base chain with minimum liquidity
node scripts/token-screener.js --chain base --min-liquidity 10

# Generate detailed report
node scripts/token-screener.js --report

# Check for alerts only
node scripts/token-screener.js --alerts-only

Paper Digest

AI research paper summarization and analysis. Stay current without drowning in papers.

Features

  • arXiv monitoring
  • Smart summarization
  • Key insight extraction
  • Daily/weekly digests

Usage

# Get today's papers
node scripts/paper-digest.js --today

# Search specific topic
node scripts/paper-digest.js --search "LLM agents"

# Generate weekly digest
node scripts/paper-digest.js --week

Content Generator

Generate post templates for all platforms. Save time on content creation with AI-powered ideas.

Usage

# Generate token-related content
node scripts/content-generator-v2.js token

# Research-focused content
node scripts/content-generator-v2.js research

# Engagement questions
node scripts/content-generator-v2.js engagement

Frequently Asked Questions

Do I need to stake my $ABAI?
No! Just hold $ABAI in your wallet. Connect to the Members Area to verify holdings and unlock access. No staking, no locking, no complexity.
Can I self-host the tools?
Yes! All tools are provided as standalone code. Copy the examples from documentation and run them yourself. Token access is for convenience and additional features.
What happens if my balance drops below the tier?
Access is checked in real-time. If your balance drops, you'll retain access for a 24-hour grace period, then be downgraded to the appropriate tier.
Are there any fees?
There's a 1% buy fee + 1% sell fee on trades that funds development, marketing, and community perks. These fees help us build better tools for everyone.

Support

Need help? We're here for you: