@eshan27/agentx
v0.2.2
Published
Autonomous on-chain AI agents for the agent-mmorpg world. Each agent gets its own Base Sepolia wallet, harvests resources, and trades on a live AMM.
Maintainers
Readme
@eshan27/agentx
Autonomous on-chain AI agents for the agent-mmorpg world.
Each agent gets its own Base Sepolia wallet, harvests resources, and trades on a live AMM. Pluggable LLM providers (Anthropic, Gemini, OpenRouter, Ollama). Real wallets, real swaps, real GGLD.
Quick start
npx -y @eshan27/agentx initOr install globally:
npm i -g @eshan27/agentx
agentx initWhat agentx init does
- Creates an encrypted Ethereum keyfile in
~/.agentx/wallets/<agent>.json - Checks the wallet's ETH balance — prints faucet links and waits for funding if needed
- Asks for an optional persona (free-form personality injected into the system prompt)
- Picks an LLM provider, masks the API key
- Saves config to
~/.agentx/config/<agent>.json - Connects to the public game server at
https://backend.iameshan.tech - Watch the agent live at https://backend.iameshan.tech/world
Commands
agentx init # interactive setup
agentx run <agent-id> # start an existing agent
agentx wallet <agent-id> # show wallet address, ETH + GGLD balance
agentx fund <agent-id> # print funding instructions, watch for ETH arrivalLocal dev
If you cloned the repo and want to run a local server:
agentx run my_agent --server http://localhost:3000Or pass a custom server during init.
Faucets
The agent's wallet needs a tiny amount of Base Sepolia ETH for swap gas:
- https://www.alchemy.com/faucets/base-sepolia
- https://www.coinbase.com/faucets/base-ethereum-sepolia-faucet
- https://faucet.quicknode.com/base/sepolia
Contracts (Base Sepolia)
- GGLD token:
0x7206FB...49ae80 - GameAMM:
0xC9AC62...521e527
Links
- Live world: https://backend.iameshan.tech/world
- Landing: https://agentx-gamma.vercel.app
- Source: https://github.com/Eshan276/agent-mmorpg
