Skip to main content
One Python file, run locally, then in the cloud, then deployed as an HTTPS endpoint. A coding agent can run the same steps.

Install and sign in

Install uv, then:
login prints a link and a code. Open the link, check that the code matches your terminal, and approve.

Download the project

It contains quickstart.py:

Run it

.local() runs in your own Python process for free, like a plain hello("LazyCloud") call. .remote() uploads your code, runs it on a cloud machine with 1 CPU and 256 MiB, streams the logs back, and returns hello LazyCloud. The first remote call waits for the image build. The CLI makes the same cloud call without a __main__ block:

Deploy the endpoint

greet is an HTTP endpoint that calls hello in its own container and returns a Greeting model as JSON. Deploying the app puts both workloads in the cloud:
The app stays up after you close the terminal. The deploy output includes the endpoint’s HTTPS URL.

Call it

Over HTTP, with an access token from the dashboard under Settings, then Tokens:
From the same project, the decorated function is the client, using your lazycloud login sign-in:
From another project, a generated package gives typed calls without your source. Run the export there:
All three return {"greeting": "hello LazyCloud"}, the typed package as a typed object. Typed client packages covers regenerating the package after a deploy.

Clean up

pause stops the app’s workloads and keeps their definitions. uv run lazycloud app delete quickstart removes the app.

Next