Skip to content

Latest commit

 

History

History
78 lines (54 loc) · 2.14 KB

README.md

File metadata and controls

78 lines (54 loc) · 2.14 KB

🤖 AI Delivery Agent

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!

🌟 Features

  • Natural conversation interface for shopping
  • Onchain purchase of real world items
  • Order tracking and status updates

🚀 Get Started

  1. Clone the repository:
git clone https://github.com/worldstore/delivery-agent.git
cd delivery-agent
  1. 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)
  1. Install dependencies:
pnpm install
  1. Copy .env.template to .env to fill in the appropriate values.
cp .env.template .env
  1. 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 processing
  • OPENAI_API_KEY: Your OpenAI API key for AI interactions
  • CROSSMINT_API_KEY: Your Crossmint API key
  1. 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

Mode Differences

Human Mode (start:human)

  • 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

Agent Mode (start:agent)

  • Optimized for interactions with AI agent giveaways
  • Streamlined responses
  • Purchase products to users, by Twitter username

🚀 Keep track of your order

  • Upon payment, check your email for a purchase receipt
  • Expect an email over the next couple of days with shipping details