# GCP emulator

> A local implementation of a Google Cloud service API used for development and testing before code touches real Google Cloud.
>
> Source: https://local.cloud/glossary/gcp-emulator/

Glossary

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

[Read docs](https://local.cloud/docs/) [Check compatibility](https://local.cloud/compatibility/) [SDK examples](https://local.cloud/docs/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](https://local.cloud/license/), check [each service's local boundaries](https://local.cloud/compatibility/), and validate against real Google Cloud before you deploy.

Related

## Next steps

- [What is a GCP emulator?](https://local.cloud/docs/what-is-gcp-emulator/) — The long-form explanation, with endpoint routing and production limits.
- [GCP emulator overview](https://local.cloud/gcp-emulator/) — Run every LocalCloud service locally in one Docker container.
- [Agent setup guides](https://local.cloud/agents/) — Run coding agents against LocalCloud.