OPEN-SOURCE PYTHON INFRASTRUCTURE · v1.16.1

Build agents that can actually execute.¶

Web3 Agent Kit gives autonomous agents a controlled path from intent to on-chain execution: wallets, chains, protocol tools, transaction simulation, and operator-defined policy in one Python framework.

Get started View source

INSTALL pip install web3-agent-kit

agent.pyREADY

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("check my balances")
print(result)

intent → policy → simulation → execution

25modules

1,791tests passing

8supported chains

74%coverage

MITlicense

01 / THE FRAMEWORK

Everything around the transaction.¶

The hard part of an on-chain agent is not calling a contract. It is making the full path observable, composable, and safe to operate. The kit keeps those concerns in one surface.

01

Agent runtime¶

Goal-driven execution with pluggable LLM providers, tool routing, structured results, and a Python API that stays readable.

Read the agent API →

02

Execution policy¶

Spend limits, operator confirmation, kill switches, and transaction simulation sit between an agent decision and a broadcast.

Review the security model →

03

Protocol primitives¶

DeFi, bridges, wallets, gas, portfolio, NFT, trading, oracle, and account-abstraction modules share the same chain-aware foundation.

Explore features →

04

Multi-chain by default¶

Use one interface across Ethereum, Base, Arbitrum, Polygon, Optimism, BSC, Solana, and Avalanche. Add a new chain without rebuilding every tool around it.

EthereumBaseArbitrumPolygonOptimismBSCSolanaAvalanche

02 / EXECUTION MODEL

One controlled path from goal to chain.¶

Every write operation should be explainable before it becomes irreversible. The framework makes the execution boundary explicit.

01IntentNatural language or Python call

02PlanTool routing and parameters

03PolicyLimits, approval, simulation

04ExecuteSigned transaction on-chain

i

Designed for controlled automation. The framework is beta software. Review the [maturity policy](project-maturity.md) and [risk disclosure](../RISKS.md) before using real funds.

03 / START HERE

Small surface. Serious foundations.¶

FIRST RUN

Build your first agent¶

Install the package, configure a wallet, and run a read-only balance check.

Open Getting Started →

TERMINAL

Use the `wak` CLI¶

Inspect chains, check dependencies, run examples, and operate without writing Python.

Open CLI reference →

REFERENCE

Browse the API¶

Go deeper into wallets, chains, LLMs, DeFi, bridges, security, and execution modules.

Open API reference →