Agent runtime
Give an agent a goal, wallet, chain, and available tools. Provider fallback and routing stay inside the framework; write readiness depends on module configuration.
Read the agent API ↗ Open source infrastructure · v1.18.5
Build agents that
can actually execute.
Web3 Agent Kit is a Python framework for onchain agent workflows across EVM and Solana, with wallets, protocol integrations, and transaction-safety primitives. Write-path readiness varies by module.
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,971tests passing · 12 skipped
9supported chains
75%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
Spend limits and fail-closed pre-sign gate primitives. Application authorization is required, and write-path coverage is not yet uniform.
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 · Robinhood Chain · Solana
ETHBASEARBOPRHSOL
API & CLI surface
Use the Python API, the wak CLI, or expose selected actions through FastAPI.
COMPOSABLE02An explicit path
How it fits together
An explicit path
from goal to chain.
Separate planning from execution. Keep decisions inspectable before anything is signed.
01GoalNatural language or typed request
→
02IntentStructured, immutable action
→
03SimulationPre-flight where supported
→
04AuthorizationApplication-verified approval for gated writes
→
05ExecutionOnly through a configured signing path
i
Beta software; write controls have limits. The wallet gate fails closed, but coverage is not uniform. Gated signing requires an application authorization provider, and the current authorization fingerprint omits gas-limit and fee fields. Review known limitations before using real funds.
Review the security model ↗03 / Start here
Small surface.
Serious foundations.
Install the package and start with read-only workflows. Before enabling writes, review the gate requirements and module readiness.
Read the getting started guide ↗QUICKSTART.PYPYTHON 3.10+
# install
pip install web3-agent-kit
# start with a read-only agent flow
from web3_agent_kit import Agent, Wallet, Chain
wallet = Wallet.from_key("0x...")
agent = Agent(wallet=wallet, chains=[Chain.BASE])
result = agent.run("check my balances")
Open source. MIT licensed.
Built in public.