A CLI-based delivery AI agent that buys real world items from Worldstore, an onchain marketplace. Pick the agentic framework you want to use and happy shopping!
- Natural conversation interface for shopping
- Onchain purchase of real world items
- Order tracking and status updates
- Clone the repository:
git clone https://github.com/worldstore/delivery-agent.git
cd delivery-agent- Prerequisites:
- Node & pnpm installed
- Have your wallet's private key ready (otherwise, generate new wallet via
pnpm generate-wallet) - Hold USDC
- OpenAI API key
- Crossmint API key (scopes required:
wallets.read,wallets.create,wallets:nft.read,wallets:messages.sign,wallets:signatures.create,users.read,wallets:signatures.read,orders.create)
- Install dependencies:
pnpm install- Copy
.env.templateto.envto fill in the appropriate values.
cp .env.template .env- Configure your variables:
WALLET_PRIVATE_KEY: Your wallet's private key (will be used for payment)RPC_PROVIDER_URL: Base network RPC endpoint for transaction processingOPENAI_API_KEY: Your OpenAI API key for AI interactionsCROSSMINT_API_KEY: Your Crossmint API key
- Start the agent in your preferred mode:
# For human users - includes friendly prompts and confirmations
pnpm start:human
# For AI agents - streamlined interface with minimal prompts to complete purchases
pnpm start:agent- Designed for human users
- Friendly conversational interface
- "I want to order some goodies for the weekend"
- "Do you see any games available for sale?"
- "I want cookies"
- Additional safety confirmations before purchases
- Step-by-step guidance through the shopping process
- Optimized for interactions with AI agent giveaways
- Streamlined responses
- Purchase products to users, by Twitter username
- Upon payment, check your email for a purchase receipt
- Expect an email over the next couple of days with shipping details