Interface: The Autonomous Agent Economy

A production-grade interface and SDK for MNEE-powered AI agents.

Built for the MNEE Hackathon: AI & Agent Payments.

---

🚀 Vision

Interface provides the coordination layer for the next generation of digital commerce, where AI agents don't just "talk"—they transact. By leveraging the MNEE stablecoin, Interface enables agents to autonomously pay for high-value services, search real-time data, and execute complex browser automations with a secure, user-centric authorization flow.

✨ Key Features

• Deterministic Browser Automation: Beyond simple LLM responses, Interface includes a dedicated browser mockup system (FlightBrowserDemo) that simulates real-world tasks like flight booking.
• Micro-Authorization Interface: A high-polish "Slide-to-Pay" UI component integrated directly into the chat bubble, allowing for instant, branded session approvals.
• Granular Economy Controls: The AgentEconomyProvider tracks and enforces strict budgetary limits (total budget, per-transaction caps, hourly/daily limits) to prevent runaway agent spending.
• Multi-Currency Analytics: Real-time conversion switching between MNEE/ETH and USD across all dashboard metrics and transaction histories.
• Branded Design System: A premium experience powered by GSAP and Framer Motion, ensuring a state-of-the-art user experience.

🛠 Technical Architecture

Interface is a flattened modular project, separating reasoning from execution:

• Frontend (/dashboard): A high-performance React/Vite application utilizing ethers.js for on-chain interactions and GSAP for fluid animations.
• Intelligence Engine (/api_gateway): A unified FastAPI-based agent backend handling reasoning, service catalog, and MNEE payment routing.
• Core SDK (/core): The foundational Python logic for budget enforcement and agent economy management.

⛓ MNEE Implementation

Interface is natively built for the MNEE stablecoin on Ethereum:

• Contract Address: 0x8ccedbAe4916b79da7F3F612EfB2EB93A2bFD6cF
• Mock Service Catalog:

  Service	Price	Endpoint	Description
  Weather	0.10 MNEE	POST /api/weather	Detailed weather forecasts
  Stocks	0.25 MNEE	POST /api/stocks	Real-time market data
  Flights	0.50 MNEE	POST /api/flights	Flight search with AI predictions

📥 Getting Started

Prerequisites

• Python 3.9+
• Node.js 18+
• MetaMask or compatible EIP-1193 wallet

Quick Setup

1. Clone & Install:

   npm install
   # Install sub-project dependencies
   cd dashboard && npm install
   cd ../api_gateway && pip install -r requirements.txt
   cd ../core && pip install -e .

2. Environment Configuration: Create a .env in the root using .env.example. You MUST provide a GOOGLE_API_KEY.

3. Launch Everything:

   # Use our all-in-one launcher
   start.bat

🏆 Hackathon Alignment

Primary Track: AI & Agent Payments Focus: Demonstrating how programmable money can bridge the gap between autonomous AI thinking and real-world economic actions in a secure, intuitive way.

---

© 2026 Interface Team. Fully compliant with MNEE Ethereum Mainnet standards.