Any cloud.
Locally.
A local cloud your coding agents can't break. AWS, Azure, GCP and OCI emulators that start in 24 ms: no credentials, no bill, no blast radius.
# Install floci-cli curl -fsSL https://floci.io/install.sh | sh # Start the AWS emulator and load its endpoints floci start && eval $(floci env)
Needs Docker or Podman running. Homebrew, Windows and other options
Give your AI agents a cloud they can't break.
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 S3 floci start eval $(floci env) # endpoint → :4566 aws s3 mb s3://uploads pytest tests/ # ✓ no AWS account used
# agent task: store invoices in Blob Storage floci az start eval $(floci az env) # endpoint → :4577 az storage container create --name invoices pytest tests/ # ✓ no Azure subscription used
# agent task: publish order events to Pub/Sub floci gcp start eval $(floci gcp env) # SDK endpoints → :4588 # gcloud needs its own override, plus a dummy token export CLOUDSDK_API_ENDPOINT_OVERRIDES_PUBSUB=http://localhost:4588/ export CLOUDSDK_CORE_PROJECT=floci-local CLOUDSDK_AUTH_ACCESS_TOKEN=floci gcloud pubsub topics create orders pytest tests/ # ✓ no GCP project used
# agent task: archive reports to Object Storage floci oci start floci oci setup # throwaway profile, once eval $(floci oci env) # endpoint → :4599 oci os ns get pytest tests/ # ✓ no OCI tenancy used
Teach your agent once
# Asks which agents to install it for npx skills add floci-io/floci-cli
The Floci skill teaches Claude Code, Codex, Cursor, Kiro and other coding agents to run the emulators with floci-cli.
No skill support? Paste these rules into AGENTS.md or CLAUDE.md
## 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.
Works with Claude Code, Cursor, GitHub Copilot, OpenAI Codex, Aider and Gemini CLI: anything that can run a shell command.
-
No real credentials, nothing to break.
Agents connect with throwaway keys, so no cloud secret reaches their context or sandbox. Worst case, they reset a local container, not your staging environment or your bill.
-
Starts in 24 ms, idles at 13 MiB.
Each emulator is a GraalVM native image in a small container, fast enough to start, test and tear down inside the edit loop. The first run also pulls the image.
-
Real engines, not mocks.
Lambda runs in real Docker containers, RDS on real PostgreSQL and MySQL, ElastiCache on real Redis. Real wire protocols, so code an agent verifies locally behaves the same in production.
-
MIT, free forever, no auth token.
No sign-up, no API key, no telemetry, no paid tier or feature flags. Every service is available to everyone.
Four clouds. Four emulators.
Each one is standalone, runs on its own port, and needs no cloud account. Run one, or all four side by side.
-
Drop-in replacement for LocalStack.
126 services S3, SQS, Lambda, DynamoDB, RDS +121 more
-
No Azure account required.
29 services Blob, Queue, Table, Functions, Key Vault +24 more
-
No GCP project, no billing account.
27 services GCS, Pub/Sub, Firestore, Datastore, Secret Manager +22 more
-
No Oracle Cloud account required.
8 services Object Storage, Queue, Streaming, KMS, Vault +3 more
Install floci-cli and make your first bucket.
No account, no token. One CLI starts and manages all four emulators.
curl -fsSL https://floci.io/install.sh | sh
# Start the AWS emulator and load its endpoints
floci start && eval $(floci env)
# Create a bucket
aws s3 mb s3://my-bucket
# Upload a file
echo "hello from floci" > 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
brew install floci-io/floci/floci
# Start the AWS emulator and load its endpoints
floci start && eval $(floci env)
# Create a bucket
aws s3 mb s3://my-bucket
# Upload a file
echo "hello from floci" > 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
irm https://floci.io/install.ps1 | iex
# Start the AWS emulator and load its endpoints
floci start; floci env | Invoke-Expression
# Create a bucket
aws s3 mb s3://my-bucket
# Upload a file
"hello from floci" | 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
Something not starting? Run floci doctor.
One toolchain. All clouds.
Manage and explore every Floci emulator from a unified CLI or visual dashboard.
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.
Something not starting? floci doctor checks Docker, ports and your environment.
On laptops, in CI and in workshops.
Anywhere a real cloud account is too slow, too risky, or too expensive.
-
One cloud per CI job.
Run Floci as a service container. Every 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, no credentials to rotate.
-
Infrastructure-as-code dry runs.
Apply Terraform, OpenTofu or CloudFormation against localhost first, and catch drift and bad refactors before a real account sees them.
-
Workshops and onboarding.
Every student runs the whole stack on their own machine with zero billing risk. Start from the 101 Labs.
jobs:
test:
runs-on: ubuntu-latest
services:
floci:
image: floci/floci
ports: ["4566:4566"]
env:
AWS_ENDPOINT_URL: http://localhost:4566
AWS_ACCESS_KEY_ID: test
AWS_SECRET_ACCESS_KEY: test
AWS_DEFAULT_REGION: us-east-1
steps:
- uses: actions/checkout@v4
- run: pytest tests/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.
- Gold
- $500+ / mo
- Large logo, top placement · Logo in the emulator READMEs and on floci.io · Mention in release notes
- Silver
- $150 / mo
- Logo in the emulator READMEs and on floci.io · Mention in release notes
- Community
- $25 / mo
- Name in the emulator READMEs · Sponsor badge on GitHub · Our sincere thanks