Built for streamlining development of Google Assistant Actions

Last update: May 16, 2019

Overview

Apprentice

Apprentice is a framework built for developing Google Actions via Dialogflow and Google Cloud (serverless) Functions.

Includes:

plug-and-play feel to get going quickly
basic Dialogflow API 2.0 response handling
local setup for quick iteration

Installation

pip install apprentice

Quickstart

We recommend you read the full tutorial here.

A Google Action project will consist of two things:

Dialogflow Intent
A webhook to satisfy your users intent

To generate a "Hello World" webhook, run:

$ apprentice init

This will create a file structure:

src/
    main.py
    requirements.txt

Run a local server with

$ apprentice run

and expose to localhost port via an https tunnel. Then add the url to the fulfillment webhook in Dialogflow.

For a more indepth example please see the tutorial I wrote here.

Deployment

Note

gcloud cli must be installed and authorized for the following command to work. If you wish to not have gcloud cli installed, you can copy the file contents via the gcloud function dashboard.

$ apprentice -f hello_world -s hello_world_agent -e hello_world

This will generate the command to execute a gcloud function deploy via the cli.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

GNU 3.0

Comments

Increase the usability of the Apprentice API

This is what I could imagine the API for Apprentice looking like:


from apprentice import Apprentice

apr = Apprentice(__name__)

ENTITIES = {
    "name": "History",
    "entries": [
        {
            "value": "history",
            "synonyms": [
                "history",
                "past event",
                "the past",
                "past"
            ]
        }, {
            "value": "birth",
            "synonyms": [
                "birth",
                "births",
                "born"
            ]
        }
    ]
}


@apr.action(entities=['name'])
def cool_fact_generator(*args, **kwargs):
    reply = _fact_response(apr.entity)
    return apr.make_repsonse(reply)

opened by andrewgy8 1

Add suggestions

When creating a response a user should be able to configure the view of suggestions.

The resulting payload would look like:

'payload': {
                'google': {
                    'expect_user_response': False,
                    'is_ssml': True,
                    'permissions_request': None,
                    "richResponse": {
                        "items": [],
                        "suggestions": [],
                        "linkOutSuggestion": {}
                    }
                }
            }

opened by andrewgy8 0

.env with the Flask App path
For the local server to work as plug-and-play, it would be nice to have .env file that is read as a default to the installed main.py flask app. That way a user could execute:

apprentice init

apprentice run

And have the local server running immediately.
opened by andrewgy8 0
Fix triplicate deployment issue

It seems that travis is trying to deploy the package with every version of python declared. For instance, https://travis-ci.com/andrewgy8/apprentice/builds/93792889

The build succeeds with 3.7, but with 3.6 and 3.5, it fails. It shouldn't be deploying with all the python versions, only one.

opened by andrewgy8 0
Allow user to define init directory name and function name

Be able to handle and argument such as:

apprentice init --name=foo_bar

and the output should be a direct called /foo_bar with a main.py file containing a foo_bar function.
enhancement

opened by andrewgy8 0

Releases(v0.4.4)

v0.4.4(May 16, 2019)

Source code(tar.gz)
Source code(zip)
v0.4.3(May 16, 2019)

Source code(tar.gz)
Source code(zip)
v0.4.2(Mar 23, 2019)

Source code(tar.gz)
Source code(zip)
v0.4.1(Mar 23, 2019)

Source code(tar.gz)
Source code(zip)
v0.4.0(Jan 10, 2019)
SimpleResponse and BasicCardResponse per the docs

Add .editorconfig

Update example to use the new response objects

Source code(tar.gz)
Source code(zip)
v0.3.1(Dec 20, 2018)
v0.3.1

Remove nested directories from init command

Update the readme

Source code(tar.gz)
Source code(zip)
v0.3.0(Dec 9, 2018)

Encapsulate all functions in the apprentice class
Source code(tar.gz)
Source code(zip)
v0.2.0(Dec 6, 2018)
Update to Dialogflow API 2.0

Fix routing issue

Source code(tar.gz)
Source code(zip)
v0.1.7(Dec 6, 2018)
Clean up the public API interface for Apprentice (#24)

Implement Apprentice class.

Built in flask app.

No need to instantiate a flask app yourself

Update commands and readme with new api interface

Source code(tar.gz)
Source code(zip)
v0.1.6(Nov 18, 2018)

Source code(tar.gz)
Source code(zip)
v0.1.5(Nov 17, 2018)

Source code(tar.gz)
Source code(zip)
v0.1.4(Nov 17, 2018)

Source code(tar.gz)
Source code(zip)
v0.1.3(Nov 17, 2018)

Source code(tar.gz)
Source code(zip)
v0.1.2(Nov 17, 2018)

Source code(tar.gz)
Source code(zip)
v0.1.1(Nov 17, 2018)

Source code(tar.gz)
Source code(zip)

Owner

Andrew Graham-Yooll

Software engineer with background in molecular biology

GitHub Repository

An almost dependency-less, synchronous Discord gateway library meant for my personal use

An almost dependency-less, synchronous Discord gateway library meant for my personal use.

4 Feb 05, 2022

A simple Telegram bot that analyses a given word, built with python-telegram-bot

Telegram Word Bot A simple Telegram bot that analyses a given word, built with python-telegram-bot. The bot is fairly useless - unless you often need

2 Jul 14, 2022

Bagas Mirror&Leech Bot is a multipurpose Telegram Bot written in Python for mirroring files on the Internet to our beloved Google Drive. Based on python-aria-mirror-bot

- [ MAYBE UPDATE & ADD MORE MODULE ] Bagas Mirror&Leech Bot Bagas Mirror&Leech Bot is a multipurpose Telegram Bot written in Python for mirroring file

4 Nov 23, 2021

Modern, privacy-friendly, and detailed web analytics that works without cookies or JS.

Modern, privacy-friendly, and cookie-free web analytics. Getting started » Screenshots • Features • Office Hours Motivation There are a lot of web ana

2.1k Jan 03, 2023

A program that automates the boring parts of completing the Daily accounting spreadsheet at Taos Ski Valley

TSV_Daily_App A program that automates the boring parts of completing the Daily accounting spreadsheet at my old job. To see how it works you will nee

2 Jan 01, 2022

Marketplace for self published books

Nile API API for the imaginary Nile marketplace for self published books. This is a project created to try out FastAPI as the post promising ASGI serv

1 Jan 31, 2022

This automation protect against subdomain takeover on AWS env which also send alerts on slack.

AWS_Subdomain_Takeover_Detector Purpose The purpose of this automation is to detect misconfigured Route53 entries which are vulnerable to subdomain ta

8 May 18, 2022

Apex lets you build, deploy, and manage AWS Lambda functions with ease.

No longer maintained This software is no longer being maintainted and should not be chosen for new projects. See this issue for more information Apex

25 Dec 23, 2022

BlueMoonVampireBot - A Telegram Antispam Based Bot

Blue Moon Vampire Bot An Telegram Antispam Based Bot A Pyogram Bot to make banne

13 Nov 24, 2022

Wrapper around the Mega API

python-mega Overview Wrapper around the Mega API. Based on the work of Julien Marchand. Installation Install using pip, including any optional package

104 Nov 26, 2022

WaifuGen - A program made in waifuGen that generates SFW and NSFW waifus from the waifu.pics API

waifuGen A program made in waifuGen that generates SFW and NSFW waifus from the

1 Jan 05, 2022

The Most advanced and User-Friendly Google Collab NoteBook to download Torrent directly to Google Drive with File or Magnet Link support and with added protection of Timeout Preventer.

Torrent To Google Drive (UI Added! 😊 ) A Simple and User-Friendly Google Collab Notebook with UI to download Torrent to Google Drive using (.Torrent)

33 Aug 16, 2022

Built for streamlining development of Google Assistant Actions

Related tags

Overview

Apprentice

Installation

Quickstart

Deployment

Note

Contributing

License

Comments

Increase the usability of the Apprentice API

Add suggestions

.env with the Flask App path

Fix triplicate deployment issue

Allow user to define init directory name and function name

Releases(v0.4.4)

v0.4.4(May 16, 2019)

v0.4.3(May 16, 2019)

v0.4.2(Mar 23, 2019)

v0.4.1(Mar 23, 2019)

v0.4.0(Jan 10, 2019)

v0.3.1(Dec 20, 2018)

v0.3.1

v0.3.0(Dec 9, 2018)

v0.2.0(Dec 6, 2018)

v0.1.7(Dec 6, 2018)

v0.1.6(Nov 18, 2018)

v0.1.5(Nov 17, 2018)

v0.1.4(Nov 17, 2018)

v0.1.3(Nov 17, 2018)

v0.1.2(Nov 17, 2018)

v0.1.1(Nov 17, 2018)

Owner

Andrew Graham-Yooll

An almost dependency-less, synchronous Discord gateway library meant for my personal use

A simple Telegram bot that analyses a given word, built with python-telegram-bot

Bagas Mirror&Leech Bot is a multipurpose Telegram Bot written in Python for mirroring files on the Internet to our beloved Google Drive. Based on python-aria-mirror-bot

Modern, privacy-friendly, and detailed web analytics that works without cookies or JS.

A program that automates the boring parts of completing the Daily accounting spreadsheet at Taos Ski Valley

Marketplace for self published books

This automation protect against subdomain takeover on AWS env which also send alerts on slack.

Apex lets you build, deploy, and manage AWS Lambda functions with ease.

BlueMoonVampireBot - A Telegram Antispam Based Bot

Wrapper around the Mega API

WaifuGen - A program made in waifuGen that generates SFW and NSFW waifus from the waifu.pics API

The Most advanced and User-Friendly Google Collab NoteBook to download Torrent directly to Google Drive with File or Magnet Link support and with added protection of Timeout Preventer.

Asynchronous Guilded API wrapper for Python

A frame to create discord bots (for myself) that uses cogs, JSON, activities, and more.

A visualization of people a user follows on Twitter

企业微信消息推送的python封装接口，让你轻松用python实现对企业微信的消息推送

Poll-Bot Repo For Telegram #telegram

🖥️ Python - P1 Monitor API Asynchronous Python Client

ETL python utilizando API do Spotify

Python3 program to control Elgato Ring Light on your local network without Elgato's Control Center software