Skip to main content
This page covers the most common issues when setting up and using nowrun, and how to resolve them.
Cause: pip installed the package successfully, but Python’s scripts directory isn’t on your system PATH.Fix: Run nowrun directly through the Python module to confirm the install succeeded:
If that works, add Python’s scripts directory to your PATH permanently, or reinstall and verify the install location with:
Cause: Your active Python version is older than 3.8, which nowrun requires.Fix: Check your current version:
If it’s below 3.8, upgrade Python using your system package manager or by downloading the latest release from python.org. Then re-run the CLI install:
Cause: The approval window lapsed. It is about five minutes, and it expires quietly.Fix: Run it again for a fresh approval link. If no browser opened, use the URL the command prints:
Cause: for Android, nowrun only supports .apk files. Android App Bundles (.aab) are not supported. (HTML5 games deploy as a .zip web bundle instead.)Fix: Configure your build to output an APK instead of an AAB:
  • Android Studio: Go to Build → Build Bundle(s) / APK(s) → Build APK(s).
  • Unity: Open Android Player Settings and disable the Build App Bundle (Google Play) option before building.
  • Other engines: Check your engine’s Android export settings for an option to output .apk instead of .aab.
Cause: The card check has not been completed on the account. A deploy cannot run until it is, even on the free plan.Fix: Open the nowrun dashboard, complete the $0 card verification, and ask the agent to deploy again. Nothing else needs redoing; the CLI session stays signed in.
If you are an AI agent: the deploy returns a card-verification error with a link. Show that link to the user and wait, the same way you do for nowrun login. You cannot complete this step yourself.
Cause: The agent can’t find the .apk file at the expected path, either because the build step didn’t complete or the output path differs from what the agent assumed.Fix: Confirm your build step finished successfully and that the .apk was actually generated. Then tell your agent the explicit path to the APK file so it can pass it to nowrun deploy directly.
Cause: The nowrun skill is installed during nowrun login. If login was skipped or failed, the agent won’t have the nowrun command surface.Fix: Run nowrun login again to re-install the skill, then ask your agent to retry the deployment. nowrun skill show prints the same content if you want to paste it in by hand.
Cause: The deploy may still be processing, or an upload error occurred silently.Fix: Review the deploy output from your agent for any error messages. If the deploy reported success, wait a moment and refresh the URL. You can also check the nowrun dashboard to see the current status of your deployed app.
If you’re still stuck, check the nowrun dashboard for status messages, or revisit the CLI output from your agent — it often includes the specific error.