Quick Start

Get Agentxploitor running in under 5 minutes

Prerequisites

Python 3.8+
Node.js (for agent-browser and Farcaster miniapp)
Git

Installation

# Clone the repository

git clone https://github.com/agentxploitor/agentxploitor.git

cd agentxploitor

# Install Python dependencies

pip install -r requirements.txt

# Install miniapp dependencies

cd miniapp && npm install

# Copy environment config

cp .env.example .env.local

# Fill in your API keys in .env.local

Quick Demo (30 seconds)

python3 examples/demo.py --quick

Expected output:

🚀 Agentxploitor Quick Demo

✅ Found 2 vulnerabilities

✅ Generated exploit: Authorization Bypass

✅ Verification: True/False

Visual proof: /tmp/agentxploitor-proof-VULN-001.png

Farcaster Miniapp

# Run the miniapp locally

cd miniapp

npm run dev

# Opens at http://localhost:3000

The miniapp runs on Base chain and integrates with Farcaster for authentication. Users can request audits directly from their Farcaster feed.

Basic Usage

import asyncio
from src.agentxploitor import AgentxploiTorAgent

async def audit_target():
    agent = AgentxploiTorAgent(
        browser_perception=True,
        auto_submit=False
    )
    
    # Scan for vulnerabilities
    vulnerabilities = await agent.scan_target("https://your-target.com")
    
    # Generate exploit for highest severity
    vuln = max(vulnerabilities, key=lambda v: v.cvss_score)
    exploit = await agent.generate_exploit(vuln)
    
    # Verify with visual proof
    verification = await agent.verify_exploit(
        vulnerability=vuln,
        exploit=exploit,
        capture_visual=True
    )
    
    if verification.success:
        print(f"✅ Exploit verified!")
        print(f"   Proof: {verification.proof_path}")

asyncio.run(audit_target())

← Back to websiteAgentxploitor Documentation