Web3 Agent Kit¶

Build autonomous AI agents that interact with blockchains — in minutes, not months.

pip install web3-agent-kit

Get Started View on GitHub

v1.6.0

Version

19

Modules

565+

Tests

7+

Chains

MIT

License

🚀 From Zero to Agent in 5 Lines¶

from web3_agent_kit import Agent, Wallet, Chain
from web3_agent_kit.defi import Uniswap

agent = Agent(wallet=Wallet.from_env("PRIVATE_KEY"), chains=[Chain.BASE], tools=[Uniswap()])
result = agent.run("Swap 0.1 ETH to USDC on Base")
print(result)

Or use the CLI — no Python needed:

wak agent "Swap 0.1 ETH to USDC on Base"

✨ Everything You Need¶

🤖

Agent Framework¶

Goal-driven autonomous agents with LLM reasoning. Natural language in, on-chain actions out.

💰

DeFi Tools¶

Uniswap V2, Aerodrome, Aave, Curve. Real swaps, quotes, approvals, slippage protection.

🎯

Airdrop Suite¶

Galxe, Zealy, Layer3, Gleam, QuestN, Intract. Multi-wallet farming, auto-discovery.

🔐

Security Audit¶

Static analysis, fuzzing, exploit PoC, forensics. 10 specialized audit skills built-in.

⚡

MEV Bots¶

Cross-DEX arbitrage, liquidation bot, Flashbot support. Extract value from mempool.

🖼️

NFT Tools¶

Deploy collections, batch mint, marketplace listing. ERC-721A optimized.

📈

Trading Bots¶

DCA with price triggers, yield optimizer, token sniper. Automated strategies.

🌉

Cross-Chain Bridge¶

Li.Fi + Socket aggregators. Best routes, lowest fees, 7+ chains.

🛠️

CLI Tool¶

wak — 7 commands for terminal usage. Check balances, gas, run agents, zero Python.

🏗️ Architecture¶

User / Application
        │
        ▼
┌───────────────────────────┐
│     Agent Framework       │
│  Goal → LLM → Tool → TX  │
└─────────────┬─────────────┘
              │
   ┌──────────┼──────────┐
   │   Safety Layer      │
   │  Governor + Kill SW │
   └──────────┼──────────┘
              │
   ┌──────────┼──────────────────────────────────┐
   │          Tool Ecosystem                      │
   │  DeFi · Airdrop · Security · MEV · NFT      │
   │  Trading · Portfolio · Bridge · Gas · Wallet │
   └──────────┼──────────────────────────────────┘
              │
   ┌──────────┼──────────┐
   │  Chain Abstraction   │
   │  ETH · BASE · ARB   │
   │  OP · MATIC · BSC   │
   └─────────────────────┘

⚡ Quick Start¶

PythonCLIAirdrop FarmingSecurity Audit

from web3_agent_kit import Agent, Wallet, Chain, ChainManager
from web3_agent_kit.defi import Uniswap

chain_manager = ChainManager(chains=[Chain.BASE])
wallet = Wallet.from_env("PRIVATE_KEY", chain_manager=chain_manager)
uniswap = Uniswap(chain_manager=chain_manager)

agent = Agent(wallet=wallet, chains=[Chain.BASE], tools=[uniswap])
result = agent.run("Swap 0.1 ETH to USDC on Base")

# Check your wallet
wak wallet

# Check gas prices
wak gas

# Run an agent
wak agent "Swap 0.1 ETH to USDC on Base"

from web3_agent_kit.airdrop import MultiWalletManager

manager = MultiWalletManager.from_csv("wallets.csv")
manager.execute_on_all("swap", token_in="ETH", token_out="USDC", amount=0.01)

from web3_agent_kit.security import StaticAnalyzer

analyzer = StaticAnalyzer()
results = analyzer.analyze("contracts/Token.sol")
for vuln in results.vulnerabilities:
    print(f"[{vuln.severity}] {vuln.name}")

📦 Supported Chains¶

Chain	Status	DeFi	Bridge
Ethereum	✅	✅	✅
Base	✅	✅	✅
Arbitrum	✅	✅	✅
Optimism	✅	✅	✅
Polygon	✅	✅	✅
Avalanche	✅	—	✅
BSC	✅	—	✅

🤝 Contributing¶

We welcome contributions! Whether it's bug reports, feature requests, documentation improvements, or code contributions.

Contributing Guide

Built by [Maulana](https://github.com/ulsreall) · [Twitter](https://twitter.com/itseywacc) · [PyPI](https://pypi.org/project/web3-agent-kit/)