Floci

Floci

Local emulator for AWS services that allows developers to test infrastructure and applications without a cloud account. It supports standard SDKs and tools by providing local endpoints for common services.

Made by floci-io on GitHub. These notes are Minda's, written from its README; the project's own files and license are in its repository.

About

What it is: Floci is an open-source tool that provides AWS-compatible services on your local machine. It allows you to develop and test using AWS tools without an AWS account or authentication tokens.

Who it suits: It suits developers, test engineers, and operators who need to mirror AWS infrastructure for local testing.

Where to use it: You can run Floci on your laptop, within Docker containers, or inside CI pipelines. It works by intercepting standard AWS requests at a local endpoint.

How to set it up:

1. Install the Floci CLI.
2. Start the emulator.
3. Export the local environment variables.

floci start
eval $(floci env)

How to use it: You point your existing AWS tools to the local address provided by Floci. It handles your commands as the live cloud would.

aws s3 mb s3://my-bucket

aws dynamodb create-table \
  --table-name demo-table \
  --attribute-definitions AttributeName=pk,AttributeType=S \
  --key-schema AttributeName=pk,KeyType=HASH \
  --billing-mode PAY_PER_REQUEST

aws dynamodb list-tables

For newcomers and experts: If you have never used an emulator, think of it as a version of AWS that runs on your computer. It pretends to be the real service so you can experiment without cloud costs. For an experienced user, Floci acts as a transparent proxy and state engine that maps AWS API calls to local implementations, including Docker-backed execution for container services. It prioritizes speed and portability.

Good to know:

• Does not require authentication tokens for local requests.
• Maps services to localhost:4566.
• Licensed under MIT.

On GitHub, 4 November 2026

• Stars: 28,850 (482 that day)
• Forks: 3,208
• Watching: 88
• Open issues and pull requests: 170
• Language: Java
• License: MIT
• Topics: aws, aws-emulation, devops, docker, ec2, ecs, localstack, s3, sqs, testcontainers
• Trending: #8 repository of the day on GitHub trending (4 November 2026)

Links

• Code: https://github.com/floci-io/floci
• Website: https://floci.io/floci/
• Releases: https://github.com/floci-io/floci/releases
• Issues: https://github.com/floci-io/floci/issues
• Star history: https://www.star-history.com/#floci-io/floci&Date

Get the code

git clone https://github.com/floci-io/floci.git

Then follow the setup in its README. Nothing in this kit runs by itself.