A digital twin of AWS, robotocore provides a faithful local replica that responds to real AWS API calls, enabling developers and AI agents to test and build against AWS infrastructure without incurring cloud costs. It offers a free, MIT-licensed, drop-in replacement for services like LocalStack, running anywhere with no registration or telemetry.

How It Works

robotocore functions as a digital twin of AWS, running locally within a Docker container. It employs a Starlette ASGI gateway to route AWS API requests. For 46 core services, it utilizes 'Native Providers' offering high behavioral fidelity, including actual Lambda execution, SQS visibility timeouts, and IAM policy evaluation. For an additional 112 services, it bridges to Moto's in-memory backends. State is meticulously isolated per AWS account and region, enabling comprehensive local testing without cloud costs.

Quick Start & Requirements

• Primary install/run command:

  docker run -d -p 4566:4566 ghcr.io/robotocore/robotocore:latest
  

• Non-default prerequisites: Docker is required for running the service. Python 3.12+ is needed for local development and testing.
• Links: AGENTS.md for AI agent specific setup.

Highlighted Details

• Supports 158 AWS services (46 native, 112 Moto-backed), aiming for 88% API operation coverage.
• Achieves high behavioral fidelity, particularly in native providers, for realistic local development.
• Enables multi-account and multi-region deployments within a single container, with complete state isolation.
• Distributed under an MIT license, offering perpetual free use with no registration or telemetry.

Maintenance & Community

The project is built by Jack Danger, a maintainer of Moto, and leverages AI for development, with prompts and reasoning logged in the prompts/ directory. Contributions are welcome, with bug fixes often submitted upstream to Moto. Detailed architecture notes are available in CLAUDE.md.

Licensing & Compatibility

Licensed under the MIT license, robotocore is free for commercial use and integration with closed-source applications without notable restrictions.

Limitations & Caveats

While extensive, the fidelity of service implementations varies between the 46 "Native Providers" and the 112 "Moto-backed" services. The project focuses on comprehensive API coverage and behavioral fidelity where possible, but specific edge cases or less common operations within Moto-backed services may not perfectly mirror AWS behavior.