AI-powered smart contract development platform

From natural language to production-ready, audited contracts in minutes

---

Screenshot

HyperAgent Dashboard - Generate, audit, and deploy smart contracts

---

Getting Started

Prerequisites

• Python 3.10+
• PostgreSQL 15+ (or Supabase - recommended)
• Google Gemini API Key

Hardware

For development:

• Minimum: 8 GB RAM, 2 cores (works but slow)
• Recommended: 16 GB RAM, 4 cores (smooth)
• Optimal: 32 GB RAM, 6+ cores (best experience) For production deployment:
• Use cloud services (Supabase, Redis Cloud) to reduce local requirements See GUIDE/SIMPLIFIED_SETUP.md for cloud-based setup

Minimum Local Storage

• Fresh Install: ~10-12 GB
• After 1 Month: ~15-18 GB
• After 3 Months: ~22-28 GB

Recommended Free Space

• Minimum: 30 GB free
• Recommended: 50 GB free
• Optimal: 100 GB free (SSD)

Largest Components

• Docker Images: ~5-8 GB (can be cleaned)
• Docker Volumes: ~5-15 GB (grows with usage)
• Python venv: ~1 GB
• Frontend node_modules: ~500 MB

Quick Savings

• Use Supabase (saves ~5-15 GB database volume)
• Clean Docker regularly (saves ~2-5 GB)
• Limit Prometheus retention (saves ~1-2 GB)
• Rotate logs (saves ~500 MB - 1 GB)
• Total potential savings: ~8-23 GB For development, 30-50 GB free space is recommended.

Performance

• First build: ~25-45 minutes
• Rebuild (with cache): ~5-15 minutes
• Frontend only: ~3-5 minutes
• Backend only: ~20-35 minutes The multi-stage build and layer caching help reduce rebuild times. Most time is spent installing Python dependencies and Solidity compilers.

Quick Install

# Clone repository
git clone https://github.com/JustineDevs/HyperAgent.git
cd Hyperkit_agent

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Set up environment
cp .env.example .env
# Edit .env with your API keys

# Initialize database
alembic upgrade head

# Run development server
uvicorn hyperagent.api.main:app --reload

Docker

# Start all services (frontend, backend, DB, Redis)
docker-compose up -d

# View logs
docker-compose logs -f

# Stop services
docker-compose down

Frontend (Optional)

cd frontend
npm install
npm run dev
# Open http://localhost:3000

---

Documentation

• 📖 Full Documentation - Complete guides and API reference
• 🚀 Getting Started Guide - Detailed setup and first contract
• 🏗️ Architecture Guide - System design and patterns
• 💳 x402 Payment Guide - Pay-per-use setup
• ⚡ Hyperion PEF Guide - Parallel batch deployment
• 🔧 API Reference - Complete API documentation

---

Features

• 🤖 AI-Powered Generation - Natural language → Solidity contracts
• 🛡️ Automated Auditing - Security analysis with Slither, Mythril, Echidna
• 🚀 Multi-Chain Deployment - Hyperion, Mantle, Avalanche
• 💳 x402 Payments - Pay-per-use on Avalanche networks
• ⚡ Parallel Deployment - 10-50x faster with Hyperion PEF
• 🎯 MetisVM Optimized - Floating-point and AI inference support

View all features →

---

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

---

License

MIT License - see LICENSE for details.

---

Links

• Website: hyperionkit.xyz
• GitHub: github.com/Hyperionkit/HyperAgent
• Organization: github.com/HyperionKit/Hyperkit
• Linktree: linktr.ee/Hyperionkit

---

Built with ❤️ by the HyperAgent team