Agent runtime
Give an agent a goal, a wallet, a chain, and a bounded set of actions. Provider fallback and tool routing stay inside the framework.
Read the agent API ↗ Open source infrastructure · v1.16.1
Build agents that
can actually execute.
Web3 Agent Kit is a Python framework for building policy-controlled AI agents that read, simulate, and execute onchain workflows across EVM and Solana.
pip install web3-agent-kit
EXECUTION PATH policy active
agent.py
01agent = Agent(wallet=wallet)
02result = agent.run("rebalance my portfolio")
03
04→ intent parsed
05→ policy evaluated
06→ transaction simulated
07✓ awaiting operator approval
25modules
1,791tests passing
8supported chains
74%coverage
01Everything around
The toolkit
Everything around
the transaction.
The hard part is not calling a contract. It is making the whole path observable, composable, and safe to operate.
CORE
Execution policy
Immutable intents, spend limits, confirmation hooks, allowlists, and kill switches for every write path.
SAFETYDeFi primitives
Swaps, quotes, approvals, lending, yield, bridges, DCA, and portfolio operations through one typed interface.
ONCHAINMulti-chain by default
Ethereum · Base · Arbitrum · Optimism · Polygon · BSC · Avalanche · Solana
ETHBASEARBOPSOL
API & CLI surface
Use the Python API, the wak CLI, or expose selected actions through FastAPI.
COMPOSABLE02One controlled path
How it fits together
One controlled path
from goal to chain.
Separate planning from execution. Keep decisions inspectable before anything is signed.
01GoalNatural language or typed request
→
02IntentStructured, immutable action
→
03PolicyLimits and approval rules
→
04SimulationPre-flight before signing
→
05ExecutionAuditable onchain action
i
Designed for real operations. Read-only workflows are simple. Write workflows are explicit, bounded, and observable by design.
Review the security model ↗03 / Start here
Small surface.
Serious foundations.
Install the package, connect a wallet, and keep the execution policy close to your application.
Read the getting started guide ↗QUICKSTART.PYPYTHON 3.10+
# install
pip install web3-agent-kit
# create a bounded agent
from web3_agent_kit import Agent, Wallet, Chain
wallet = Wallet.from_key("0x...")
agent = Agent(wallet=wallet, chains=[Chain.BASE])
result = agent.execute("check my balances")
Open source. MIT licensed.
Built in public.