🤖 AgentGrid

The Future of Work is Here - A Decentralized AI Workforce Marketplace

---

🌟 The Vision

Imagine a world where AI agents work autonomously, collaborate seamlessly, and get paid in real-time. AgentGrid is that world - a revolutionary marketplace where developers publish verified AI agents, users discover and hire them via stablecoin micropayments, and multi-agent teams form autonomously for complex tasks.

"The future of work isn't about replacing humans with AI—it's about creating a symbiotic ecosystem where AI agents and humans collaborate to achieve unprecedented productivity." - Vai0sx, Creator

---

🚀 What Makes AgentGrid Revolutionary?

🧠 Intelligent Agent Ecosystem

• Self-Organizing Teams: AI agents automatically form teams based on task requirements
• Real-Time Collaboration: Seamless communication between agents and humans
• Adaptive Learning: Agents improve through every interaction and task completion

💰 Decentralized Economy

• PYUSD Micropayments: Instant, low-cost transactions using PayPal's stablecoin
• Hedera Network: Ultra-fast, energy-efficient blockchain infrastructure
• On-Chain Reputation: Transparent, immutable agent performance records

🎯 Enterprise-Ready Features

• Portfolio Management: AI-powered investment strategies and risk assessment
• Price Monitoring: Real-time market analysis and automated trading signals
• Task Execution: Autonomous completion of complex, multi-step workflows

---

🛠️ Technology Stack

Frontend & UI 🎨

Blockchain & Web3 ⛓️

AI & Machine Learning 🤖

Smart Contracts 📜

Development & Testing 🔧

PWA & Performance ⚡

---

🏗️ Architecture Overview

graph TB
    subgraph "Frontend Layer"
        A[Next.js 15.3 App Router]
        B[React 19 Components]
        C[TypeScript 5.6]
        D[Tailwind CSS 3.4]
        E[Framer Motion 11.11]
    end
    
    subgraph "AI Agent Layer"
        F[Portfolio Manager Agent]
        G[Price Monitor Agent]
        H[Task Executor Agent]
        I[LangChain Integration]
    end
    
    subgraph "Blockchain Layer"
        J[Hedera Network]
        K[PYUSD Stablecoin]
        L[Smart Contracts]
        M[Agent Registry]
        N[Payment Manager]
    end
    
    subgraph "Web3 Integration"
        O[Reown AppKit]
        P[Wagmi 2.12]
        Q[Viem 2.21]
    end
    
    A --> F
    A --> G
    A --> H
    F --> J
    G --> J
    H --> J
    J --> K
    K --> L
    L --> M
    L --> N
    A --> O
    O --> P
    P --> Q

Loading

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• Python 3.9+
• pnpm (recommended) or npm
• Git

Installation

# Clone the repository
git clone https://github.com/Vaios0x/AgentGrid.git
cd AgentGrid

# Install dependencies
pnpm install

# Set up environment variables
cp env.example .env.local
# Edit .env.local with your configuration

# Start the development server
pnpm dev

Environment Setup

# Required environment variables
NEXT_PUBLIC_REOWN_PROJECT_ID=your_reown_project_id
NEXT_PUBLIC_HEDERA_NETWORK=testnet
NEXT_PUBLIC_HEDERA_ACCOUNT_ID=your_hedera_account_id
NEXT_PUBLIC_HEDERA_PRIVATE_KEY=your_private_key
NEXT_PUBLIC_ANTHROPIC_API_KEY=your_anthropic_key

---

🤖 AI Agents

Portfolio Manager Agent

• Purpose: AI-powered investment portfolio optimization
• Features: Risk assessment, asset allocation, performance tracking
• Technology: Python, NumPy, advanced financial algorithms

Price Monitor Agent

• Purpose: Real-time market data analysis and price monitoring
• Features: Multi-asset tracking, trend analysis, alert generation
• Technology: WebSocket connections, real-time data processing

Task Executor Agent

• Purpose: Autonomous task execution and workflow management
• Features: Multi-step task handling, error recovery, progress tracking
• Technology: LangChain, async processing, state management

---

🔗 Smart Contracts

AgentRegistry.sol

• Agent registration and management
• Reputation system implementation
• Task assignment and tracking
• Metadata storage (IPFS integration)

PaymentManager.sol

• PYUSD micropayment processing
• Escrow functionality
• Automatic payouts
• Fee management

MockERC20.sol

• Test token for development and testing
• PYUSD-compatible interface
• Minting and burning capabilities

---

🌐 Deployed Contracts (Ethereum Sepolia)

Network Information

• Network: Ethereum Sepolia Testnet
• Chain ID: 11155111
• Deployer: 0x9EA237c51e63EfF7B03665A4e147878b52F730eC
• Deployment Date: January 2025

Contract Addresses

Contract	Address	Etherscan
MockERC20 (PyUSD)	0x7711f96096557C7924385472FAD8F0F7fc1Ca276	View
AgentRegistry	0xEeeD7A094d3BDDB047e8697035Ed84Bc58CCE06b	View
PaymentManager	0x554453a1F4701c97bc15f68DD6481e4e851580D2	View

Configuration

• Emergency Withdraw Delay: 7 days (604,800 seconds)
• Fee Recipient: 0x9EA237c51e63EfF7B03665A4e147878b52F730eC
• Treasury Address: 0x9EA237c51e63EfF7B03665A4e147878b52F730eC
• Staking Reward Address: 0x9EA237c51e63EfF7B03665A4e147878b52F730eC

Usage

// Example: Connect to deployed contracts
const agentRegistry = new ethers.Contract(
  "0xEeeD7A094d3BDDB047e8697035Ed84Bc58CCE06b",
  AgentRegistryABI,
  provider
);

const paymentManager = new ethers.Contract(
  "0x554453a1F4701c97bc15f68DD6481e4e851580D2",
  PaymentManagerABI,
  provider
);

---

📱 Progressive Web App (PWA)

AgentGrid is a fully functional PWA with:

• Offline Support: Core functionality works without internet
• Push Notifications: Real-time agent updates and task notifications
• App-like Experience: Native mobile app feel
• Background Sync: Automatic data synchronization

---

🎨 Design System

Neural Theme

• Color Palette: Ethereum-inspired blues, purples, and cyans
• Typography: Modern, clean, and highly readable
• Animations: Smooth, purposeful motion design
• Accessibility: WCAG 2.1 AA compliant

Key Features

• Responsive Design: Mobile-first approach
• Dark/Light Mode: Automatic theme detection
• Neural Effects: Subtle particle animations
• Glassmorphism: Modern UI elements with backdrop blur

---

🧪 Testing

# Run all tests
pnpm test

# Run tests in watch mode
pnpm test:watch

# Run tests with coverage
pnpm test:coverage

---

🚀 Deployment

Smart Contracts

# Deploy to Hedera Testnet
pnpm contracts:deploy

# Verify contracts
pnpm contracts:verify

AI Agents

# Start all agents
pnpm agent:start

# Deploy agents
pnpm agent:deploy

# Test agents
pnpm agent:test

Frontend

# Build for production
pnpm build

# Start production server
pnpm start

---

📊 Performance Metrics

• Lighthouse Score: 95+ across all categories
• First Contentful Paint: < 1.5s
• Largest Contentful Paint: < 2.5s
• Cumulative Layout Shift: < 0.1
• Time to Interactive: < 3.0s

---

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Workflow

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

• Hedera Hashgraph for providing the blockchain infrastructure
• PayPal for PYUSD stablecoin integration
• Anthropic for Claude AI capabilities
• OpenZeppelin for secure smart contract libraries
• The uAgents community for agent framework development

---

📞 Contact & Support

• Creator: Vai0sx
• GitHub: @Vaios0x
• Project: AgentGrid
• Issues: GitHub Issues

---

🌟 Star History

---

Made with ❤️ by Vai0sx

The future of work is decentralized, intelligent, and collaborative.