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.
1. Install the CLI
Section titled “1. Install the CLI”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:
pip install pywa-cloud-cliPrefer an isolated install that doesn’t touch your project’s own virtualenv?
pipx or uv tool both work the same way:
uv tool install pywa-cloud-cli
pywa-cloud-cliis on its way to being bundled directly intopywa[server], sopip install "pywa[server]"alone will be enough — no separate install step. It isn’t there yet, so for now this page’spip install pywa-cloud-cli(oruv tool install) is still required.
Check it worked:
pywa cloud --help2. Log in
Section titled “2. Log in”pywa loginThis 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.
3. Get a pywa project
Section titled “3. Get a pywa project”If you already have a pywa bot, skip to step 4. Starting fresh? Scaffold one built for deploying:
pywa new --cloud -o my-botcd my-botThis 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.
4. Deploy
Section titled “4. Deploy”From your project’s directory:
pywa deployThe 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.
What’s next
Section titled “What’s next”- Connecting a WhatsApp Number — the full connect/reconnect story, including bringing your own Meta App if you already run one.
- Environment Variables & Secrets — set your own config and secrets alongside the ones Pywa Cloud manages for you.
- Logs — see exactly what your bot is doing right now.
- Local Development — iterate against real WhatsApp webhooks without redeploying for every change.