local.cloud / agents

Read this page as Markdown ↗

local.cloud — What Is a GCP Emulator? .md Open tab

Glossary

GCP emulator

A local implementation of a Google Cloud service API used for development and testing before code touches real Google Cloud.

Read docs Check compatibility SDK examples

In LocalCloud

GCP emulator with LocalCloud

Also called a cloud emulator or service emulator. It emulates cloud service APIs, unlike a cloud-hosted device emulator, which runs a mobile operating system on remote hardware.
Can be official, third-party, custom, or a local facade.
Usually requires SDK endpoint overrides.
Trades managed-cloud fidelity for speed and isolation; each emulator documents its supported calls and gaps, and production behavior is validated against Google Cloud.

Copy-ready setup

Commands and prompts

Copy a prompt for your coding agent

Start LocalCloud

Give an agent one URL and have it start the local GCP sandbox.

Fetch https://local.cloud/ai/agents.md and follow the instructions to start LocalCloud on my machine. Install the LocalCloud CLI if it is missing, verify Docker, start or reuse LocalCloud, export emulator environment variables, and run one local GCP SDK/API smoke check. Do not ask for or use real GCP credentials.

Production boundary

Before production

Use LocalCloud for non-production development, testing, and CI under the Public Preview License, check each service's local boundaries, and validate against real Google Cloud before you deploy.

Related

Next steps

What is a GCP emulator? — The long-form explanation, with endpoint routing and production limits.
GCP emulator overview — Run every LocalCloud service locally in one Docker container.
Agent setup guides — Run coding agents against LocalCloud.