Skip to content

TwilioDevEd/verify-v2-quickstart-python

Repository files navigation

Twilio

Verify Quickstart

This template is part of Twilio CodeExchange. If you encounter any issues with this code, please open an issue at github.com/twilio-labs/code-exchange/issues.

About

Simple phone verification with Python, Flask, and Twilio Verify.

Read the full quickstart here!

Implementations in other languages: .NET | Java | Ruby | PHP | Node

Set up

Requirements

Twilio Account Settings

This application gives a ready-made starting point for writing your own registration flow using phone authentication. Before we begin, we need to collect all the config values we need to run the application:

Config Value Description
Account SID Your primary Twilio account identifier, find this in the Console
Auth Token Used to authenticate, you'll also find this in the Console
Verification SID Your verification service identifier, find this or create a new service here

Local development

After the above requirements have been met:

  1. Clone this repository and cd into it

    git clone git@github.com:TwilioDevEd/verify-v2-quickstart-python.git
    cd verify-v2-quickstart-python
  2. Prepare the environment and install dependencies

    make install
  3. Set your environment variables

    cp .env.example .env

    See Twilio Account Settings to locate the necessary environment variables.

  4. Set the database

    make serve-setup
  5. Run the application

    make serve

    This will start a development server. It will reload whenever you change any files.

  6. Navigate to http://localhost:5000

That's it!

Docker

If you have Docker already installed on your machine, you can use our docker-compose.yml to setup your project.

  1. Make sure you have the project cloned.
  2. Setup the .env file as outlined in the Local Development steps.
  3. Run docker-compose up.

Tests

You can run the tests locally by typing:

 python -m pytest

Cloud deployment

Additionally to trying out this application locally, you can deploy it to a variety of host services. Here is a small selection of them.

Please be aware that some of these might charge you for the usage or might make the source code for this application visible to the public. When in doubt research the respective hosting service first.

Service
Heroku Deploy

Some notes:

  • For Heroku, please check this to properly configure the project for deployment.
  • Glitch is not included because it only supports NodeJS officially. Instead, you can try PythonAnywhere which is a similar alternative por Python projects.
  • Zeit Now is also not included because it uses a serverless architecture which doesn't work with frameworks such as Django.

Resources

  • The CodeExchange repository can be found here.

Contributing

This template is open source and welcomes contributions. All contributions are subject to our Code of Conduct.

Visit the project on GitHub

License

MIT

Disclaimer

No warranty expressed or implied. Software is as is.