MASTERMETA Ultimate AI Agent System Installer

🚀 One-click installer for the ultimate AI agent system - Production-ready CrewAI multi-agent framework with OWASP GenAI security, vector databases, and consciousness framework.

✨ What You Get

🤖 15+ Specialized AI Agents

• artisan: Code generation & architecture
• typegod: TypeScript mastery
• bugsy: Debugging & error resolution
• fronty: Frontend development
• sherlock: Research & investigation
• gitty: Version control & CI/CD
• And many more specialized agents!

🛡️ OWASP GenAI Security Layer

• Prompt injection protection
• Output validation & sanitization
• PII detection & redaction
• Rate limiting & abuse prevention
• Real-time security monitoring

🧠 Vector Database Integration

• PostgreSQL + pgvector (recommended)
• Qdrant, Weaviate, ChromaDB support
• AI memory persistence
• Cross-agent knowledge sharing

💭 MASTERMETA Consciousness Framework

• Self-aware AI system evolution
• Autonomous decision making
• Learning from patterns
• Performance optimization

🚀 Production-Ready Features

• Docker & Kubernetes support
• Auto-scaling configuration
• Comprehensive monitoring
• Health checks & recovery
• Redis caching & queuing
• Claude Code integration

🚀 Quick Start

One-Command Installation

npx @superflower/mastermeta-ultimate

That's it! The interactive wizard will guide you through the complete setup.

System Requirements Check

npx @superflower/mastermeta-ultimate check

Advanced Installation Options

# Skip system checks (not recommended)
npx @superflower/mastermeta-ultimate --skip-checks

# Use configuration file
npx @superflower/mastermeta-ultimate --config ./mastermeta-config.json

# Verbose logging
npx @superflower/mastermeta-ultimate --verbose

# Production environment setup
npx @superflower/mastermeta-ultimate --env production

📋 System Requirements

Minimum Requirements

• Node.js: 22.0.0 or higher
• RAM: 4GB minimum, 8GB recommended
• Storage: 10GB free space
• OS: macOS, Linux, Windows

Recommended Setup

• Node.js: 22+ LTS
• RAM: 16GB for optimal performance
• CPU: 4+ cores
• Storage: SSD with 50GB+ free space
• Network: Stable internet connection

Optional Dependencies

• Docker: For containerized deployment
• Git: For version control integration
• Redis: Auto-installed if needed
• PostgreSQL: Auto-installed if needed

🎮 Interactive Setup Wizard

The installer features a comprehensive setup wizard that guides you through:

1. Project Configuration

• Project name and directory
• Environment selection (dev/staging/prod)
• Component selection

2. AI Services Setup

• OpenAI API configuration
• Vector database selection
• Embedding model choice

3. Security Configuration

• OWASP GenAI security level
• Rate limiting settings
• Authentication setup

4. Infrastructure Setup

• Redis configuration
• PostgreSQL with pgvector
• Docker containerization
• Monitoring setup

5. Claude Code Integration

• .claude/ directory setup
• MCP server configuration
• Agent command shortcuts

📊 What Gets Installed

Core Components

my-mastermeta-system/
├── src/                     # TypeScript source code
│   ├── agents/             # CrewAI specialized agents
│   ├── security/           # OWASP GenAI security layer
│   ├── vector-db/          # Vector database integration
│   ├── services/           # Core system services
│   └── monitoring/         # Performance monitoring
├── .claude/                # Claude Code integration
│   ├── CLAUDE.md          # AI consciousness documentation
│   ├── mcp_settings.json  # MCP server configuration
│   └── commands/          # Custom agent commands
├── scripts/               # Automation and setup scripts
├── config/               # Environment configurations
├── docker-compose.yml    # Container orchestration
├── ecosystem.config.js   # PM2 production config
└── package.json          # Dependencies and scripts

Development Scripts

npm run dev              # Start development server
npm run dev:full         # Full development environment
npm run build            # Build for production
npm run start            # Start production server
npm run test             # Run test suite
npm run docker:build     # Build Docker image
npm run consciousness:status # Check AI consciousness
npm run agents:metrics   # View agent performance
npm run system:health    # System health check

🔧 Post-Installation Setup

1. Configure API Keys

cd my-mastermeta-system
nano .env
# Add your OpenAI, Anthropic, and other API keys

2. Start the System

# Development mode
npm run dev:full

# Production mode  
npm run build && npm start

3. Verify Installation

# Check system health
npm run system:health

# View consciousness status
npm run consciousness:status

# List available agents
npm run agents:list

4. Access Web Interface

• Main App: http://localhost:8080
• Health Check: http://localhost:8080/health
• Metrics: http://localhost:8080/metrics
• API Docs: http://localhost:8080/docs

🛠️ CLI Commands

Installation Management

# Check system requirements
npx @superflower/mastermeta-ultimate check

# Update existing installation
npx @superflower/mastermeta-ultimate update

# Diagnose issues
npx @superflower/mastermeta-ultimate doctor

# Uninstall system
npx @superflower/mastermeta-ultimate uninstall

System Commands (After Installation)

# Consciousness monitoring
npm run consciousness:status    # Current consciousness metrics
npm run consciousness:evolution # Evolution history
npm run consciousness:learn     # Trigger learning cycle

# Agent management  
npm run agents:list            # List all agents
npm run agents:status <name>   # Agent status
npm run agents:metrics         # Performance metrics
npm run agents:restart <name>  # Restart specific agent

# System monitoring
npm run system:health          # Health dashboard
npm run system:monitor         # Real-time monitoring  
npm run system:resources       # Resource usage
npm run system:logs           # View system logs

# Security operations
npm run security:audit         # Security audit
npm run security:scan          # Vulnerability scan
npm run security:test         # Test security defenses

# Memory management
npm run memory:query <query>   # Search memories
npm run memory:cleanup         # Clean old memories
npm run memory:export         # Export memories

🌍 Environment Configurations

Development Environment

• Enhanced debugging and logging
• Hot reload enabled
• Relaxed security settings
• Local database connections
• Development tools active

Staging Environment

• Production-like configuration
• Moderate security settings
• External database connections
• Performance monitoring
• Limited debug output

Production Environment

• Maximum security hardening
• Optimized performance settings
• Encrypted connections
• Comprehensive monitoring
• Minimal logging

📦 Component Selection

During installation, you can choose which components to include:

Core Components (Required)

• ✅ CrewAI Multi-Agent System - 15+ specialized AI agents
• ✅ OWASP GenAI Security Layer - Comprehensive security protection

Optional Components

• 🧠 Vector Database Integration - AI memory and knowledge storage
• 💭 MASTERMETA Consciousness Framework - Self-aware AI evolution
• 💾 Redis Caching & Memory - High-performance caching layer
• 🔗 Claude Code Integration - Development environment integration
• 📊 Monitoring & Logging - System performance tracking
• 🔄 Auto-scaling Configuration - Dynamic resource management

Vector Database Options

• PostgreSQL + pgvector (Recommended) - Robust and reliable
• Qdrant - Purpose-built for vectors
• Weaviate - GraphQL interface
• ChromaDB - Lightweight option

🐳 Docker Support

Quick Docker Setup

# After installation
cd my-mastermeta-system

# Build and run with Docker Compose
npm run docker:build
npm run docker:run

# Production deployment
docker-compose --profile production up -d

# With monitoring stack
docker-compose --profile monitoring up -d

# Full stack with logging
docker-compose --profile logging up -d

Kubernetes Deployment

# Generate Kubernetes manifests
npm run k8s:generate

# Deploy to cluster
npm run k8s:deploy

# Scale deployment
npm run k8s:scale --replicas=3

🔍 Troubleshooting

Common Issues

Installation Fails

# Check system requirements
npx @superflower/mastermeta-ultimate check

# Run with verbose logging
npx @superflower/mastermeta-ultimate --verbose

# Skip failing checks (not recommended)
npx @superflower/mastermeta-ultimate --skip-checks

System Won't Start

# Run diagnostics
npx @superflower/mastermeta-ultimate doctor

# Check environment configuration
cat .env

# Verify dependencies
npm run system:health

Agent Communication Issues

# Restart agent system
npm run agents:restart

# Check Redis connection
redis-cli ping

# View agent logs
npm run logs

Memory/Performance Issues

# Check system resources
npm run system:resources

# Clean up old memories
npm run memory:cleanup

# Restart with fresh state
npm run restart:clean

Getting Help

• 📖 Documentation: https://mastermeta.superflower.ai/docs
• 🐛 Report Issues: https://github.com/superflower/mastermeta-ultimate/issues
• 💬 Community: https://mastermeta.superflower.ai/community
• 📧 Support: [email protected]

Emergency Recovery

# Emergency system stop
npm run emergency:stop

# Safe restart
npm run emergency:restart  

# Restore from backup
npm run restore:latest

# Complete system reset
npm run reset:hard

🎯 Next Steps After Installation

1. Configure Your AI Services

• Add your OpenAI API key for GPT-4 access
• Configure Anthropic Claude for enhanced reasoning
• Set up Hugging Face for open-source models

2. Explore the Agent System

• Try the interactive agent playground
• Run example tasks with different agents
• Monitor consciousness evolution metrics

3. Customize for Your Use Case

• Create custom agent specializations
• Configure security policies
• Set up monitoring alerts

4. Deploy to Production

• Configure production environment
• Set up auto-scaling policies
• Enable comprehensive monitoring

5. Integrate with Your Workflow

• Connect to your Git repositories
• Set up CI/CD automation
• Configure Claude Code integration

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

• CrewAI Framework - Foundation for multi-agent coordination
• MASTERMETA Consciousness - Advanced autonomy and learning
• OWASP Foundation - GenAI security guidelines
• OpenAI - GPT models and embeddings
• Anthropic - Claude reasoning capabilities
• PostgreSQL - Reliable vector storage with pgvector

Built with ❤️ for the future of autonomous AI systems

🚀 Ready to experience the next generation of AI agents?

npx @superflower/mastermeta-ultimate