Amauo - Deploy Bacalhau Compute Nodes Globally

💡 What is Amauo?

Amauo is a modern deployment tool that makes it effortless to deploy Bacalhau compute nodes globally using AWS spot instances. Built with Python 3.9+ support, it provides a clean CLI interface for managing distributed computing infrastructure at scale.

Perfect for researchers, developers, and organizations who need cost-effective compute power without the complexity of manual infrastructure management.

90%

Cost Savings vs On-Demand

15+

AWS Regions Supported

3

Dependencies Only

📦 Installation

Recommended: Use uvx for isolated execution (no global installation needed)

uvx amauo --help

Alternative: Install globally with pip

pip install amauo

Requirements: Python 3.9+ • AWS CLI configured • Valid AWS credentials

🚀 Quick Start Guide

Get your distributed computing cluster running in under 5 minutes:

1. Setup Configuration

amauo setup

Interactive setup wizard for AWS credentials and deployment preferences

2. Deploy Nodes

amauo create

Deploy compute nodes across multiple regions with automatic configuration

3. Monitor Status

amauo list

View running instances with real-time status and connection details

4. Scale & Manage

amauo destroy

Clean shutdown of all resources with cost optimization

✨ Key Features

💰 Ultra Cost-Effective

Leverage AWS spot instances to reduce compute costs by up to 90% compared to on-demand instances. Automatic spot price optimization and failover handling.

🌍 Global Deployment

Deploy across 15+ AWS regions simultaneously for optimal performance, reduced latency, and geographic redundancy of your compute workloads.

🔧 Zero-Config Setup

Intelligent defaults and automated configuration. AMI auto-discovery, VPC setup, security groups, and Bacalhau node registration - all handled automatically.

⚡ Lightning Fast

93% faster startup times and 65% smaller package size compared to alternatives. Built with modern Python and optimized for performance.

🛡️ Enterprise Ready

Comprehensive error handling, retry logic, security best practices, and detailed logging. Production-ready with proper cleanup and monitoring.

📊 Rich Terminal UI

Beautiful tables, progress bars, and real-time status updates. Professional CLI experience with clear feedback and intuitive commands.

🏗️ Architecture Highlights

Amauo is built on modern principles for reliability and maintainability:

Immutable Infrastructure: Destroy and recreate pattern for consistency
Direct AWS APIs: No abstraction layers, maximum reliability
Modular Design: Clean separation between commands, core logic, and utilities
File-based State: Simple JSON tracking without complex databases
Automatic Node Identity: Deterministic sensor identity generation
Type Safety: Full type annotations for better developer experience

🚀 Amauo