treethought / flask-assistant

Framework for Building Virtual Assistants with Dialogflow and python
Apache License 2.0
380 stars 100 forks source link
actions api-ai assistant bots chatbot dialogflow framework google-assistant google-home

Create Virtual Assistants with Python

image image image image

A flask extension serving as a framework to easily create virtual assistants using Dialogflow which may be integrated with platforms such as Actions on Google (Google Assistant).

Flask-Assistant allows you to focus on building the core business logic of conversational user interfaces while utilizing Dialogflow's Natural Language Processing to interact with users.

Now supports Dialogflow V2!

This project is heavily inspired and based on John Wheeler's Flask-ask for the Alexa Skills Kit.

Features

  • Mapping of user-triggered Intents to action functions
  • Context support for crafting dialogue dependent on the user's requests
  • Define prompts for missing parameters when they are not present in the users request or past active contexts
  • A convenient syntax resembling Flask's decoratored routing
  • Rich Responses for Google Assistant

Hello World

from flask import Flask
from flask_assistant import Assistant, ask

app = Flask(__name__)
assist = Assistant(app, project_id="GOOGLE_CLOUD_PROJECT_ID")

@assist.action("Demo")
def hello_world():
    speech = "Microphone check 1, 2 what is this?"
    return ask(speech)

if __name__ == "__main__":
    app.run(debug=True)

How-To

  1. Create an Assistant object with a Flask app.
  2. Use action decorators to map intents to the proper action function.
  3. Use action view functions to return ask or tell responses.

Documentation