AWS, Azure, GCP and OCI emulators that start in 24 ms. Give your coding agents a real cloud to build and test against: no credentials, no bill, no blast radius.
Coding agents write cloud code faster than ever, but they can't safely run it against a real account. Point them at Floci instead: a local cloud to build, run, and verify against. Instant, free, and credential-free.
The agent loop, on any cloud
# agent task: add an upload endpoint backed by S3floci starteval $(floci env)# endpoint → :4566aws s3 mb s3://uploadspytest tests/# ✓ no AWS account used
# agent task: store invoices in Blob Storagefloci az starteval $(floci az env)# endpoint → :4577az storage container create --name invoicespytest tests/# ✓ no Azure subscription used
# agent task: publish order events to Pub/Subfloci gcp starteval $(floci gcp env)# SDK endpoints → :4588# gcloud needs its own override, plus a dummy tokenexport CLOUDSDK_API_ENDPOINT_OVERRIDES_PUBSUB=http://localhost:4588/export CLOUDSDK_CORE_PROJECT=floci-local CLOUDSDK_AUTH_ACCESS_TOKEN=flocigcloud pubsub topics create orderspytest tests/# ✓ no GCP project used
# agent task: archive reports to Object Storagefloci oci startfloci oci setup# throwaway profile, onceeval $(floci oci env)# endpoint → :4599oci os ns getpytest tests/# ✓ no OCI tenancy used
Teach your agent once
## Local cloud (floci)
- Never run code or tests against a real cloud account. Use floci instead.
- Start the emulator you need: `floci start` (AWS), `floci az start`, `floci gcp start` or `floci oci start`.
- Load its endpoints before running anything: `eval $(floci env)` (or `floci az env`, `floci gcp env`, `floci oci env`).
- State is disposable: `floci stop` then `floci start` gives you a clean cloud.
Paste into your repo's AGENTS.md or CLAUDE.md.
Works with Claude Code, Cursor, GitHub Copilot, OpenAI Codex, Aider and Gemini CLI: anything that can run a shell command.
0
No credentials to leak.
Agents connect with throwaway keys. No real cloud secrets in the agent's context or sandbox. Nothing to exfiltrate, nothing to bill.
24ms
Inner-loop fast.
24 ms cold start, 13 MiB idle. Agents spin up, test, and tear down inside the edit loop instead of waiting on round-trips to a remote account.
real
Real signal, not mock theater.
Lambda, RDS, Redis, and Kafka run for real, so code an agent verifies locally behaves the same in production. No mock-shaped false positives.
✗
Zero blast radius.
Let agents iterate aggressively. Worst case, they reset a local container, not your staging environment or your cloud bill.
Cloud Emulators
Pick your cloud. Start instantly.
Standalone MIT-licensed emulators. No account, no auth token.
# Start the AWS emulator & export env vars floci start; floci env | Invoke-Expression
# Create a bucket aws s3 mb s3://my-bucket
# Upload a file "Why pay for S3 when floci is free? 🎉" | Out-File hello-floci.txt aws s3 cp hello-floci.txt s3://my-bucket/
# Download it back aws s3 cp s3://my-bucket/hello-floci.txt hello-back.txt; Get-Content hello-back.txt
# Run all 125 AWS services on port 4566 docker run --rm -p 4566:4566 \
-v /var/run/docker.sock:/var/run/docker.sock \
floci/floci:latest
# Point the AWS CLI at floci export AWS_ENDPOINT_URL=http://localhost:4566
export AWS_ACCESS_KEY_ID=test AWS_SECRET_ACCESS_KEY=test
# Create a bucket aws s3 mb s3://my-bucket
# Upload a file echo "Why pay for S3 when floci is free? 🎉" > hello-floci.txt aws s3 cp hello-floci.txt s3://my-bucket/
# Download it back aws s3 cp s3://my-bucket/hello-floci.txt hello-back.txt cat hello-back.txt
# Run Blob, Queue, Table & Functions on port 4577 docker run --rm -p 4577:4577 \
floci/floci-az:latest
# Configure the Azure CLI export AZURE_STORAGE_CONNECTION_STRING="DefaultEndpointsProtocol=http;\
AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;\
BlobEndpoint=http://localhost:4577/devstoreaccount1;"
# Create a container & upload a file az storage container create -n my-container echo "Azure locally, no bill, no drama. 🚀" > hello-floci.txt az storage blob upload -c my-container -f hello-floci.txt -n hello-floci.txt
# Download it back az storage blob download -c my-container -n hello-floci.txt -f hello-back.txt cat hello-back.txt
# Run Cloud Storage on port 4588 docker run --rm -p 4588:4588 \
floci/floci-gcp:latest
# Point the gcloud CLI at floci-gcp (any token works locally) export CLOUDSDK_API_ENDPOINT_OVERRIDES_STORAGE=http://localhost:4588/
export CLOUDSDK_CORE_PROJECT=floci-local
export CLOUDSDK_AUTH_ACCESS_TOKEN=floci
# Create a bucket & upload a file gcloud storage buckets create gs://my-bucket echo "No billing alert? Must be floci. ☁️" > hello-floci.txt gcloud storage cp hello-floci.txt gs://my-bucket/
# Download it back gcloud storage cp gs://my-bucket/hello-floci.txt hello-back.txt cat hello-back.txt
# Run all 8 OCI services on port 4599 docker run --rm -p 4599:4599 \
-v /var/run/docker.sock:/var/run/docker.sock \
floci/floci-oci:latest
# Create a bucket & upload a file oci os bucket create \
--namespace-name floci-local --name my-bucket --compartment-id $TENANCY_OCID echo "Oracle Cloud locally: no bill, no drama. 🚀" > hello-floci.txt oci os object put \
--namespace-name floci-local --bucket-name my-bucket --file hello-floci.txt
# Download it back oci os object get \
--namespace-name floci-local --bucket-name my-bucket --name hello-floci.txt --file hello-back.txt cat hello-back.txt
125 AWS services ready on :4566. S3 · SQS · DynamoDB · Lambda · RDS · +120 more
Developer Tools
One toolchain. All clouds.
Manage and explore every Floci emulator from a unified CLI or visual dashboard.
CLI
floci-cli
A unified command-line interface to start, stop, and inspect all Floci emulators. One install covers AWS, Azure, GCP, and OCI from a single tool.
# Install (macOS / Linux) curl -fsSL https://floci.io/install.sh | sh
No gatekeeping. No pricing tiers. No surprises. A local cloud that starts in milliseconds and works everywhere.
$0
MIT Licensed. Forever free.
Fork it, embed it, extend it. No "community edition" sunset, no enterprise feature flags. Every service is available to every developer, always.
✗
No auth token. Ever.
Pull the Docker image and go. No sign-ups, no API keys, no telemetry. LocalStack started requiring an auth token in March 2026. Floci never will.
24ms
Native binary speed.
Compiled with GraalVM Mandrel. Starts in 24ms, idles at 13 MiB, fast enough for inner-loop iteration. Your CI, your laptop, and your AI agents will all thank you.
real
Real engines, not mocks.
Lambda runs in real Docker containers. RDS uses real PostgreSQL/MySQL. ElastiCache runs real Redis. 100% protocol fidelity, no surprises in production.
Use Cases
Where teams put Floci to work.
From the inner loop to CI to the classroom: anywhere a real cloud account is too slow, too risky, or too expensive.
CI
Ephemeral test environments.
Spin up the full stack inside every pipeline job. 24 ms startup adds nothing to the build, each job gets an isolated cloud, and teardown is free.
λ
Local-first development.
Build against S3, Pub/Sub, or Service Bus on your laptop, offline if you want. No shared dev account to trip over, no credentials to rotate.
tf
Infrastructure-as-code dry runs.
Apply Terraform, OpenTofu, or CloudFormation against localhost first. Catch typos, drift, and bad refactors before they ever touch a real account.
101
Workshops & onboarding.
Teach cloud services with zero billing risk. Every student runs the whole stack on their own machine: no accounts to provision, nothing to clean up.
♥ Open Source Sustainability
We're looking for sponsors
Floci is free, MIT licensed, and built in the open. Sponsorships help us keep it that way, funding infrastructure, development time, and new cloud emulators.
