floci-io

floci-io / floci-gcp

Public

Light, fluffy, and always free - GCP Local Emulator

floci.io docker floci floci-gcp gcp google
12
0
89% credibility
Found May 24, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Java
AI Summary

floci-gcp is a free, open-source local emulator that replicates Google Cloud Platform services on your own computer. It lets developers build and test applications that use GCP services — like storage buckets, message queues, databases, and secret storage — without needing a cloud account, credentials, or paying for resources. The emulator speaks the same protocols as real GCP, so existing code and SDKs work without modification. It runs as a single Docker container and supports multiple projects with configurable data persistence.

How It Works

1
💡 You need cloud services for your app

Your application relies on Google Cloud services like storage, messaging, or databases, but setting up a real cloud account feels like overkill for development.

2
🔍 You discover a free local alternative

You find floci-gcp, a tool that runs the same cloud services on your own computer — no account, no credit card, no waiting for approvals.

3
🚀 You start it with one simple command

A single Docker command launches everything. All cloud services become available instantly on your machine.

4
🔌 Your existing code just works

You point your app at the local emulator instead of the cloud. Your code, your SDKs, your tests — nothing needs to change.

5
You build and test your way
💻
Write code and test by hand

Create storage buckets, send messages, store secrets — just like the real cloud, but faster and private.

⚡
Run your test suite automatically

Your existing tests run against the emulator. No mocks, no stubs — real SDK calls, real behavior.

🎉 Everything runs smoothly, ready for the real cloud

When you're ready, switch the emulator address to real Google Cloud — your code works unchanged, and you never lost a minute to setup.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 12 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is floci-gcp?

floci-gcp is a local emulator for Google Cloud Platform services, built in Java using the Quarkus framework. It lets you run Pub/Sub, Firestore, Datastore, Cloud Storage, Secret Manager, IAM, and Managed Kafka entirely on your machine—no cloud account, no credentials, no billing. You point your existing GCP SDKs at `localhost:4588` and everything just works. The emulator speaks the same wire protocols as real GCP: gRPC for some services, REST for others, and binary HTTP/protobuf for Datastore. It ships as a single Docker container and starts in milliseconds.

Why is it gaining traction?

The official GCP emulators are scattered across separate binaries, each running on different ports with different setup requirements. floci-gcp consolidates everything onto one port and one container. The "no account required" angle is the real hook—developers can test against GCP-shaped APIs without any cloud configuration. It also covers services GCP itself doesn't emulators for, like Secret Manager and IAM. The multi-project isolation and configurable storage modes (memory, persistent, hybrid, write-ahead log) make it practical for both fast CI runs and durable local development.

Who should use this?

Backend developers integrating GCP services who want to test locally without cloud credentials. Teams running CI pipelines that need fast, isolated test environments. Infrastructure engineers validating Terraform or OpenTofu configurations against a local target. Anyone frustrated with the overhead of GCP's official emulator suite.

Verdict

floci-gcp solves a real pain point with solid engineering and comprehensive SDK compatibility testing (186 tests across Java, Python, Node, and Go). The credibility score of 0.8999999761581421% and 12 stars reflect its early-stage status—mature enough to be useful, but still building community traction. If you need local GCP emulation, this is worth a serious look.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.