Skip to content
Pywa Cloud is not live yet - there is no running control plane or dashboard to sign up on, and the CLI package is not published. Everything on this site describes a real, working, tested system, not a roadmap - but none of it is something you can actually run against Pywa Cloud today, and commands/flags/behavior can still change before it is.

Quick Start

By the end of this page you’ll have a real pywa bot running in the cloud, with a real WhatsApp number attached to it. Total time: about five minutes, most of which is Meta’s own signup screens.

Pywa Cloud is controlled entirely through pywa’s own command line — but pip install pywa alone isn’t enough. pywa cloud ... is a separate, optional package (pywa-cloud-cli) that pywa mounts onto its own CLI once both are installed together; installing pywa-cloud-cli pulls in pywa[server] for you (it depends on it), so one install is all you need:

Terminal window
pip install pywa-cloud-cli

Prefer an isolated install that doesn’t touch your project’s own virtualenv? pipx or uv tool both work the same way:

Terminal window
uv tool install pywa-cloud-cli

pywa-cloud-cli is on its way to being bundled directly into pywa[server], so pip install "pywa[server]" alone will be enough — no separate install step. It isn’t there yet, so for now this page’s pip install pywa-cloud-cli (or uv tool install) is still required.

Check it worked:

Terminal window
pywa cloud --help
Terminal window
pywa login

This opens a confirmation page in the dashboard (sign in there however you normally do — no password typed into the terminal) and prints a short code to match, as a fallback if the browser doesn’t open on its own:

To finish logging in, open:
https://dashboard.pywa.cloud/device?user_code=WSXR-KPQJ
and confirm the code shown there: WSXR-KPQJ
✅ Logged in as '[email protected]'

Approve it, and you’re logged in — the CLI remembers your login, so every command after this one just works, from any directory.

Don’t have an account yet? Sign up at dashboard.pywa.cloud first — signing up automatically creates a personal team, which is all you need to get started. One thing to do before anything else: signing up sends a verification email, and creating or deploying a bot is blocked until you click the link in it — the dashboard makes this unmissable (you can’t get past a “check your email” screen otherwise), but if you’re driving everything from the CLI, verify first or pywa cloud bots create/pywa deploy will fail with a 403 telling you to.

If you already have a pywa bot, skip to step 4. Starting fresh? Scaffold one built for deploying:

Terminal window
pywa new --cloud -o my-bot
cd my-bot

This writes a small, real pywa project: a main.py that reads its WhatsApp credentials from environment variables (never hardcoded — see step 4 for where those come from) and a pyproject.toml declaring pywa[server] as a dependency. Nothing about it is Pywa-Cloud-specific beyond that — it’s a project you could just as easily run yourself with pywa run.

From your project’s directory:

Terminal window
pywa deploy

The first deploy in a new directory asks which bot this is (or lets you create one on the spot), then remembers your answer for next time. A bot can’t run without a WhatsApp number, so if it has none yet, deploy connects one first, right in your browser through Meta’s own Embedded Signup flow: log in with your Meta Business account, pick or create a WhatsApp Business Account, verify a phone number. If your team already has one WhatsApp Business Account with a single number, it is used without asking. Pywa Cloud writes the token, phone ID and WABA ID your bot needs straight into its environment. A minute or so later:

📦 Packaging /path/to/my-bot...
12 files, 18.4 KB
🚀 Uploading and building - this can take a minute or two...
✅ Deployed in 48s (Python 3.13)
Message +1 555 0100 on WhatsApp to try it.

If a .env file sits next to your code, deploy offers to set the variables the bot doesn’t have yet (as secrets): .env itself is never uploaded.

Message the number you just connected. Your bot should reply.