Skip to main content

A simple way to demo Flask apps from your machine.

Project description


PyPI version

A simple way to demo Flask apps from your machine. Makes your Flask apps running on localhost available over the internet via the excellent ngrok tool.


Python 3.6+ is required.


pip install flask-ngrok

Inside Jupyter / Colab Notebooks

Notebooks have an issue with newer versions of Flask, so force an older version if working in these environments.

!pip install flask==0.12.2


  1. Import with from flask_ngrok import run_with_ngrok
  2. Add run_with_ngrok(app) to make your Flask app available upon running
from flask import Flask
from flask_ngrok import run_with_ngrok

app = Flask(__name__)
run_with_ngrok(app)  # Start ngrok when app is run

def hello():
    return "Hello World!"

if __name__ == '__main__':

Running the example:

 * Running on (Press CTRL+C to quit)
 * Running on http://<random-address>
 * Traffic stats available on 

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flask-ngrok-0.0.25.tar.gz (2.7 kB view hashes)

Uploaded Source

Built Distribution

flask_ngrok-0.0.25-py3-none-any.whl (3.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page