# floci-io/floci

Light, fluffy, and always free - The AWS Local Emulator alternative

Repository: https://github.com/floci-io/floci
Canonical: https://ross.abutalabs.com/products/floci
Homepage: https://floci.io/floci/
Language: Java
License: MIT
License Family: permissive
Topics: aws, aws-emulation, localstack, devops, docker, ec2, ecs, s3, sqs, testcontainers
Last push: 2026-08-27T00:17:37+00:00

## Health v2 (maintenance only)
Score: 82/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 98, longevity 14
- inputs: {"age_days": 197, "days_push": 7, "days_rel": 15, "gap_med": 2.5, "n_releases_24m": 51}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 22391, forks 2320 (observed 2026-08-28T04:11:32.554842+00:00)

## What it is
Floci is a free, open-source local AWS emulator that runs 83 AWS services (S3, SQS, DynamoDB, Lambda, ECS, and more) on your machine via Docker. It is a drop-in replacement for LocalStack Community, using the same port, wire protocols, and SDK configuration so existing AWS CLI, SDK, Terraform, and Testcontainers workflows work unchanged.

## Use cases
- run AWS services locally for development without a cloud account
- test AWS integrations in CI without paying for cloud resources
- replace LocalStack Community with a free alternative
- emulate S3, SQS, DynamoDB, and Lambda locally with docker compose
- run AWS integration tests with Testcontainers
- develop Terraform/CDK infrastructure against a local AWS endpoint

## When to choose
- you need a free, un-gated LocalStack alternative with no auth token or account
- you want fast startup and low memory (~24ms, ~13MiB) for local AWS emulation
- you need broad AWS service coverage (83 services) in local dev and CI
- you want a drop-in image swap from LocalStack with automatic env var translation

## When to avoid
- you need exact production parity for AWS behaviors not fully emulated
- you rely on LocalStack Pro features beyond what Floci implements
- you need comprehensive AWS pricing data rather than a minimal snapshot

## Facets
- artifact type: service
- maturity: active
- function: cloud, developer-tools, testing, mock-api, self-hosted, container-runtime
- domain: cloud-computing, developer-tools, testing, self-hosted
- platform: self-hosted, windows, jvm
- tags: aws-emulator, localstack-alternative, localstack, testcontainers, aws-local, ci-testing, quarkus, drop-in-replacement, devops, docker, linux, macos

## Member repositories
- floci-io/floci (main) score 82

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:32.554842+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:57:18.160252+00:00, confidence not recorded.
  - readme: https://github.com/floci-io/floci (fetched 2026-08-28T04:11:32.554842+00:00, sha ad3e1d00cba8)
  - homepage: https://floci.io/floci/ (fetched 2026-08-29T07:55:37.936539+00:00, sha 9bb55afa2dfe)
  - site_page: https://floci.io/floci/getting-started/quick-start (fetched 2026-08-29T07:55:37.945619+00:00, sha 358eea7d1987)
  - site_page: https://floci.io/floci/getting-started/installation (fetched 2026-08-29T07:55:37.947641+00:00, sha 771895645192)
  - site_page: https://floci.io/floci/getting-started/aws-setup (fetched 2026-08-29T07:55:37.949298+00:00, sha 41d17a195491)
  - site_page: https://floci.io/floci/getting-started/migrate-from-localstack (fetched 2026-08-29T07:55:37.950999+00:00, sha e5b08221323e)
  - site_page: https://floci.io/floci/services/pricing (fetched 2026-08-29T07:55:37.952800+00:00, sha 42bfe37557f4)
- Data as of 2026-08-30T08:39:29.467469+00:00.