Skip to main content
This page walks you through the full deploy process — from installing the CLI to having a live, shareable browser URL. By the end, your app will be running in the cloud and accessible to anyone with the link.

​
Before you start

You need a nowrun account with a verified card (a free plan is available at no charge) and Python 3.8 or later on your machine.

​
Install the CLI

Install nowrun from the Test PyPI registry:

​
Authenticate and set up the skill

Run nowrun init with your token from nowrun.io. This authenticates the CLI and installs the nowrun skill and MCP server that your AI agent uses:
Replace <your-token> with the token shown in your nowrun dashboard.
Make sure the following are ready before deploying:
  • The nowrun CLI is installed and nowrun init -t <token> has completed successfully.
  • An Android .apk file is built and ready on your machine.

​
Tell your agent to deploy

You don’t need to memorize any commands. Simply ask your AI agent to deploy the app — it already knows what to do from the nowrun skill installed during nowrun init. Example prompt:
“Deploy my app to nowrun.”
The agent will run the deploy command on your behalf:
The agent discovers the exact flags and options it needs by consulting nowrun help. You can run that command yourself at any time to see all available commands, or use nowrun <command> -h for help on a specific command. When the deploy finishes, the agent shares a live URL with you. That URL opens directly in any browser and streams your Android app — no installation, no app store, nothing to download. You can share it with testers, clients, or anyone you choose.

​
Viewing in the dashboard

Log in at nowrun.io to see all your deployed apps in one place. The dashboard shows each app’s live URL, version history, and current status.
The first deploy may take a moment while nowrun provisions your app. Subsequent deploys are faster.
Now that your app is live, see Managing Apps to learn how to update, share, and manage your deployments from the dashboard.