Chromium ARM64 Browser

# MCP Chromium ARM64 - Raspberry Pi Edition <p align="center"> <img src="https://img.shields.io/badge/Raspberry%20Pi-5%2016GB-red?style=for-the-badge&logo=raspberry-pi" alt="Raspberry Pi"> <img src="https://img.shields.io/badge/Budget-Under%20$500-green?style=for-the-badge" alt="Budget Friendly"> <img src="https://img.shields.io/badge/Power-15W%20Total-yellow?style=for-the-badge" alt="Low Power"> <img src="https://img.shields.io/badge/ROI-99%25%20Cost%20Reduction-brightgreen?style=for-the-badge" alt="ROI"> </p> <p align="center"> <strong>The Revolution: AI Development for Everyone</strong><br> <em>From $50K enterprise workstations to $480 complete AI development systems</em> </p> --- ## 🚀 The Democracy of AI Development **The Old Way**: Enterprise AI development required $50,000+ workstations, excluding 95% of global developers **The New Way**: A $480 Raspberry Pi setup that gives you the same AI capabilities as Silicon Valley startups ### Why This Changes Everything **💰 Financial Barrier Removed**: What cost $50K now costs $480 (99% reduction) **🌍 Global Access**: Affordable in every country, not just Silicon Valley **🎯 No-Code Revolution**: AI builds your SaaS while you focus on customers **⚡ Complete Automation**: From idea to deployed app without manual coding **🧪 Instant Testing**: AI tests every feature before your users see it --- ## 🎯 Perfect For the Global Maker Movement - **🌐 International Entrepreneurs**: Access Silicon Valley AI tools on local budgets - **🎓 Students & Educators**: Learn modern AI development without debt - **💼 Side Hustlers**: Build SaaS products while keeping your day job - **👤 Solo Founders**: Complete development team in a $80 device - **👥 Small Teams**: Compete with venture-funded startups - **🏔️ Remote Communities**: AI development anywhere with internet --- ## 💡 What You Can Build (No Coding Required!) ### AI-Driven SaaS Ideas That Actually Work **🛒 E-commerce Tools** - Price monitoring across thousands of competitors - Product research and market analysis - Automated inventory tracking - Customer sentiment analysis from reviews **📊 Business Intelligence** - Social media monitoring dashboards - SEO rank tracking services - Lead generation and qualification - Competitor analysis platforms **⚡ Automation Services** - Website uptime monitoring - Content verification and compliance - Data entry and processing - Form filling and submission services **📈 Marketing Solutions** - A/B testing platforms - Landing page optimization - Email campaign monitoring - Social proof collection ### ✨ The Magic: AI Does the Heavy Lifting 1. **💬 Describe Your Idea**: "I want to monitor competitor prices" 2. **🤖 AI Writes the Code**: Claude builds the scraping logic 3. **🧪 AI Tests Everything**: Automated browser testing ensures it works 4. **🚀 Deploy & Scale**: Your SaaS is ready for customers 5. **💰 Profit**: Focus on marketing while AI maintains the product --- ## 🌟 What Makes This Special ### 🎨 No-Code SaaS Development - Describe your app idea in plain English - AI writes, tests, and deploys your application - Focus on customers, not coding - Launch in days, not months ### 💸 Massive Cost Reduction - $480 vs $50,000+ for traditional AI development - Same capabilities as Silicon Valley startups - No recurring cloud bills or licensing fees - Own your development infrastructure ### 🌍 Global Accessibility - Works anywhere with internet connection - Affordable in every country and currency - No technical background required - Complete tutorials and examples included ### ⚡ Instant Results - See your SaaS working in real-time - AI tests every feature automatically - No debugging or technical troubleshooting - Deploy to customers the same day --- ## 🛠️ Complete Startup AI Setup - Under $500 Build a complete AI-powered development environment for less than a high-end graphics card: | Component | Purpose | Cost¹ | |-----------|---------|--------| | **Raspberry Pi 5 16GB** | Main compute unit | $180 | | **Official Pi Display 2** | Touch interface | $120 | | **Official Pi Power Supply** | Reliable 27W power | $25 | | **SanDisk Extreme 128GB A2** | Fast storage | $35 | | **Claude Code Pro (2 months)** | AI development platform | $80 | | **Case + Cables** | Protection & connectivity | $40 | | **Total** | **Complete AI Workstation** | **$480** | ### 🎁 What You Get: - **📱 Portable AI Workstation**: Desktop-class performance in a 4"×3" footprint - **🧠 Claude Sonnet 4 Access**: Latest AI model with 200K context window - **🤖 Browser Automation**: Web scraping, testing, monitoring capabilities - **⏰ 24/7 Operation**: Always-on AI assistant and automation - **⚡ Low Power**: 15W total system power (vs 500W+ traditional setup) - **🔇 Silent Operation**: No fans, completely quiet - **👆 Touch Interface**: Direct interaction with built-in display --- ## 📈 ROI for Startups: - **🧪 Autonomous Testing**: AI agents test entire SaaS flows without human debugging - saves 40+ hours/week - **📊 Continuous Validation**: 24/7 monitoring ensures your app works before customers find bugs - **💰 QA Cost Savings**: Replace expensive manual testing teams with automated AI validation - **🚀 Faster Shipping**: Deploy with confidence knowing AI has tested all user journeys - **🔒 Zero Regression**: Automated visual and functional testing prevents breaking changes - **📊 Market Research**: Automated competitor analysis saves 20+ hours/week - **💬 Customer Support**: AI-powered response generation and testing - **📝 Content Creation**: Automated social media monitoring and content ideas - **⚙️ Product Development**: AI-assisted coding and rapid prototyping --- ## 🚀 Quick Start for Makers ### Complete Beginner Guide **Never set up a Raspberry Pi before?** **[COMPLETE SETUP GUIDE](docs/COMPLETE-SETUP-GUIDE.md)** - Step-by-step from zero to SaaS builder in 30 minutes! ### Prerequisites ```bash # Install system dependencies sudo apt update sudo apt install chromium-browser nodejs npm python3 # Verify Chromium works chromium-browser --version ``` ### Installation ```bash git clone https://github.com/nfodor/mcp-chromium-arm64 cd mcp-chromium-arm64 npm install chmod +x *.py *.sh ``` ### Quick Test (One-Liner) ```bash # Verify it works immediately after install: python3 -c "import sys; sys.path.append('.'); import arm64_browser; print('[OK] ARM64 Browser Works!' if 'error' not in arm64_browser.navigate('https://example.com').lower() else '[FAIL] Failed')" ``` **Expected Result:** `[OK] ARM64 Browser Works!` ### >>> Run the Kick-Ass Demo ```bash # Quick demo with immediate visible results (30 seconds) python3 instant_demo.py # Or comprehensive demo showing all capabilities (2-3 minutes) ./run_demo.sh ``` --- ## 🏆 Why ARM64 + Browser Automation = SaaS Gold ### The Critical Gap in SaaS Development **Every SaaS startup MUST ensure their application works end-to-end before shipping.** Traditional approaches fail because: - **👥 Manual Testing**: Expensive, slow, error-prone, doesn't scale - **💻 x86_64 Only Tools**: Puppeteer/Playwright fail on ARM64 with broken binaries - **🐛 Human Debugging**: QA teams spend days debugging test failures - **📉 Limited Coverage**: Can't test every user journey without massive teams - **🔍 Regression Blind Spots**: Changes break existing features without detection ### Our Breakthrough: Autonomous AI Testing on ARM64 - **🤖 Zero Human Debugging**: AI agents test complete user flows autonomously - **⏰ 24/7 Continuous Testing**: Always-on validation on budget hardware - **🔄 Full Stack Coverage**: Frontend + Backend + API validation through real browser - **📸 Visual Regression Detection**: Screenshots catch UI breaking changes automatically - **📱 Cross-Device Testing**: Mobile/tablet/desktop viewport automation - **🛠️ Native ARM64**: Uses system Chromium instead of broken x86_64 binaries - **💸 Cost Effective**: $480 setup vs $50K+ traditional QA infrastructure ### Why This Changes SaaS Development Forever **Before**: Manual QA teams → Expensive → Slow → Human errors → Limited coverage ``` Deploy → Hope → Customer finds bugs → Emergency fixes → Reputation damage ``` **After**: AI agents → Autonomous → Fast → Comprehensive → 24/7 monitoring ``` Code → AI tests everything → Deploy with confidence → Happy customers ``` ### The ARM64 Advantage Standard browser automation fails on ARM64 because Puppeteer/Playwright download x86_64 binaries that don't run. Our solution: - Uses system-installed Chromium (native ARM64) - Proper launch flags for headless ARM64 operation - MCP protocol compliance for Claude Code integration - Zero dependency on pre-built browser binaries --- ## 🧪 Real-World Use Cases ### 1. **End-to-End SaaS Testing (The Game Changer)** ```python # Complete user journey testing - NO HUMAN DEBUGGING NEEDED def test_saas_signup_flow(): # Navigate to signup page simple_browser.browser_navigate("https://yourapp.com/signup") # Fill registration form simple_browser.browser_fill("#email", "test@example.com") simple_browser.browser_fill("#password", "securepass123") simple_browser.browser_click("#signup-btn") # Verify successful signup success_msg = simple_browser.browser_evaluate("document.querySelector('.success-message').textContent") # Test dashboard access simple_browser.browser_navigate("https://yourapp.com/dashboard") dashboard_loaded = simple_browser.browser_evaluate("document.querySelector('.dashboard').style.display !== 'none'") # Take screenshot for visual regression simple_browser.browser_screenshot("dashboard_post_signup.png") return "PASS" if success_msg and dashboard_loaded else "FAIL" ``` ### 2. **Autonomous API + Frontend Testing** ```python # Backend API validation through frontend def validate_api_through_ui(): # Test data creation via UI simple_browser.browser_navigate("https://yourapp.com/create-project") simple_browser.browser_fill("#project-name", "Test Project AI") simple_browser.browser_click("#create-btn") # Verify data appears in list view simple_browser.browser_navigate("https://yourapp.com/projects") project_exists = simple_browser.browser_evaluate("document.querySelector('[data-project=\"Test Project AI\"]') !== null") # Test data modification simple_browser.browser_click("[data-project=\"Test Project AI\"] .edit-btn") simple_browser.browser_fill("#project-name", "Modified by AI") simple_browser.browser_click("#save-btn") # Verify backend persistence simple_browser.browser_navigate("https://yourapp.com/projects") updated = simple_browser.browser_evaluate("document.querySelector('[data-project=\"Modified by AI\"]') !== null") return {"api_create": project_exists, "api_update": updated} ``` ### 3. **Cross-Browser Compatibility (Zero Human Intervention)** ```python # Automated cross-platform testing def test_responsive_design(): test_results = {} # Mobile viewport simple_browser.browser_evaluate("window.resizeTo(375, 667)") # iPhone size simple_browser.browser_navigate("https://yourapp.com") simple_browser.browser_screenshot("mobile_view.png") mobile_nav = simple_browser.browser_evaluate("document.querySelector('.mobile-nav').style.display !== 'none'") # Desktop viewport simple_browser.browser_evaluate("window.resizeTo(1920, 1080)") simple_browser.browser_screenshot("desktop_view.png") desktop_nav = simple_browser.browser_evaluate("document.querySelector('.desktop-nav').style.display !== 'none'") return {"mobile_responsive": mobile_nav, "desktop_responsive": desktop_nav} ``` ### 4. **Competitive Analysis Automation** ```python # Monitor competitor pricing simple_browser.browser_navigate("https://competitor.com/pricing") simple_browser.browser_screenshot("competitor_pricing.png") prices = simple_browser.browser_evaluate("document.querySelectorAll('.price').length") ``` ### 5. **SEO Monitoring** ```python # Check search rankings simple_browser.browser_navigate("https://google.com/search?q=your+keywords") simple_browser.browser_screenshot("serp_results.png") rankings = simple_browser.browser_evaluate("document.querySelector('.g').textContent") ``` --- ## 🔧 System Requirements ### Hardware - **💻 OS**: Raspberry Pi OS (64-bit) or any ARM64 Linux - **🧠 RAM**: 4GB minimum, 8GB recommended - **💾 Storage**: 32GB+ fast SD card (Class 10/A2) - **🌐 Browser**: Chromium (installed via apt) - **⚙️ Runtime**: Node.js 18+, Python 3.8+ ### Browser Configuration ```javascript // Optimized for ARM64 { executablePath: '/usr/bin/chromium-browser', headless: true, args: [ '--no-sandbox', '--disable-setuid-sandbox', '--disable-dev-shm-usage', '--disable-gpu', '--disable-web-security', '--disable-features=VizDisplayCompositor' ] } ``` --- ## 🔗 Links & Resources - **🔧 Technical Documentation**: [README-TECHNICAL.md](README-TECHNICAL.md) - **📖 Main Project**: [README.md](README.md) - **🐛 Issues**: [GitHub Issues](https://github.com/nfodor/mcp-chromium-arm64/issues) - **💬 Discussions**: [GitHub Discussions](https://github.com/nfodor/mcp-chromium-arm64/discussions) - **📧 Email**: github@fodor.app - **📁 Repository**: [github.com/nfodor/mcp-chromium-arm64](https://github.com/nfodor/mcp-chromium-arm64) --- ## 🤝 Contributing to the Maker Revolution We welcome contributions! This project democratizes AI access for startups and makers worldwide. ### Areas for Contribution: - 📱 Mobile browser support (Android/iOS testing) - 🔧 Additional MCP tools and integrations - ⚡ Performance optimizations for Pi Zero/smaller devices - 🎨 UI/UX improvements for touch interface - 📚 Tutorial content and use-case examples ### Development Setup: ```bash git clone https://github.com/nfodor/mcp-chromium-arm64 cd mcp-chromium-arm64 npm install # No development server needed - ready to use! ``` --- ## 📜 License MIT License - feel free to use in commercial projects! --- ## 🙏 Acknowledgments - **🤖 Anthropic** for Claude Code and MCP protocol - **🍓 Raspberry Pi Foundation** for democratizing computing - **🌐 Chromium Project** for ARM64 browser support - **👥 Open Source Community** for making this possible --- <p align="center"> <strong>⭐ Star this repo if it helps your startup leverage AI on a budget!</strong><br> <em>Every star helps more developers discover affordable AI solutions</em> </p> --- ### Footnotes ¹ **Pricing as of 2025** (USD, approximate): - **Raspberry Pi 5 16GB**: $180 (official MSRP) - **Pi Display 2 (11.9" Touch)**: $120 (official accessory) - **Official 27W USB-C PSU**: $25 (recommended for Pi 5) - **SanDisk Extreme 128GB A2**: $35 (high-speed micro SD) - **Claude Code Pro**: $40/month (2-month startup period) - **Case & Cables**: $40 (official case + HDMI/USB accessories) *Prices may vary by region and availability. Check official retailers for current pricing.* --- <p align="center"> _{Built with ❤️ for the maker and startup community} </p>