Google Assistant for PC/Mac/Linux




no one cares.

Google Assistant is Google’s answer to Amazon’s Alexa smart home assistant. Initially only available with limited functionality in the Google Allo application, Google Assistant later rolled out with the Google Home and Pixel smartphones to bring the full power of Google’s assistant to consumers.

After a few months of waiting, smartphones running Android 6.0+ also received Google Assistant, and just a few days ago Google launched the Google Assistant SDK which allows Assistant to be run on basically any platform. Today, we will show you how to install Google Assistant onto your Windows, Mac, or Linux machine using Python.

Teacher Notes

Teachers! Did you use this instructable in your classroom?
Add a Teacher Note to share how you incorporated it into your lesson.

Step 1: Requirements

You’ll need to have Python installed no matter whether or not you are using Windows, macOS, or a GNU/Linux distribution. Installation is fairly simple. Just open the installation file and select customized installation. In the next step click next, select the Add Python to environment variables checkbox and then move to next steps and install Python.

You can confirm Python is working by opening up a terminal/command prompt and then simply typing python. If you see the terminal/command prompt return the current Python version on your computer, then you’re golden!

Step 2: Configure the Google Assistant API

What follows are step-by-step instructions walking you through the process to enable the Google Assistant API in the Cloud Platform Console so you can access Google Assistant through the Python program. All of these steps are platform independent, meaning that the steps are the same for Windows, macOS, and GNU/Linux OS.

  1. Go to the Projects page in the Google Cloud Platform Console.
  2. Click on “Create Project” up top.

  3. Name the Project “My Google Assistant” and click “Create.”

  4. Wait a few seconds for the Console to create your new Project. You should see a spinning progress icon in the top right. After it is done creating your Project, you will be brought to your Project’s configuration page.

  5. Click this link to go straight to the Google Assistant API page. Up top, click “Enable.”

  6. Google will warn you that you need to create credentials to use this API. Click “Create credentials” in the top right. This will take you to a setup wizard page where Google helps you figure out what kind of credentials you need to use this API.

  7. Under “where will you be calling the API from”, select “Other UI (e.g. Windows, CLI tool)“. For “what data will you be accessing” select the “User data” circle. Now tap “what credentials do I need?”

  8. Google should recommend that you create an OAuth 2.0 client ID. Name the Client ID anything you want, for example, your name + Desktop. Once done picking a name, click “create client ID.”

  9. Under “product name shown to users” enter “My Google Assistant.” Click continue.

  10. Click “done.” There’s no need to click download here as we only need the client secret, which we will download next.

  11. Now under the list of OAuth 2.0 client IDs, you should see the client ID you just made. All the way to the right, click on the download icon to download the client_secret_XXX.json file, where ‘XXX’ is your client ID. Save this file anywhere on your computer, ideally in a new folder called “googleassistant.”

  12. Go to the Activity controls page for your Google account and make sure that “Web & App Activity”, “Location History”, “Device Information”, and “Voice & Audio Activity” are enabled. This is so Google Assistant can actually read you personalized information.

We have now created a mechanism for a client, in this case our Windows/Mac/Linux machine, to access the Google Assistant API under our Google account. Next we need to set up the client that will access the Google Assistant API.

Step 3: Install the Google Assistant Sample Python Project

Open up a terminal/command prompt window and go through the following steps. First, enter this command:

python -m pip install google-assistant-sdk[samples]

You should see a whole bunch of dependencies being downloaded and installed when you enter this command. These are needed for the sample Python project to work. Wait for it to finish.

Once it’s done, next enter the following command (make sure to adjust the path):

pip install --upgrade google-auth-oauthlib[tool]
google-oauthlib-tool --client-secrets path/to/client_secret_XXXXX.json --scope --save --headless

(As in my case, it was: pip install --upgrade google-auth-oauthlib[tool]
google-oauthlib-tool --client-secrets "C:\Users\Arya Bhushan\Documents\GAssistant\additional\client_id.json" --scope --save --headless)

In the command prompt, you will see a response telling you to visit a URL in order to authorize the application.

Copy and paste this URL into your browser. Select the same Google account that you used to configure the Google Assistant API. On the next page, you will see a text box that contains your client’s Access Token.

Copy that Access token and paste it into the command prompt where it asks you for the authorization code. If done correctly, you will see a response that your credentials have been saved.

Step 4: Test the Google Assistant

enter this command to begin talking to Google Assistant:

start python -m googlesamples.assistant.grpc.pushtotalk

Wait for the command prompt to say “press Enter to send a new request”, then press Enter to begin talking to Google Assistant. After you’re done speaking, the command prompt will display a transcript of what you just stated and then play back the response. If you see a warning afterwards, just ignore it.

Have fun playing with Google Assistant on your Windows, macOS, or GNU/Linux machine! It’s not particularly useful in this format, but it is a very quick demonstration of the possibilities that the new Google Assistant SDK represents. Perhaps we may see desktop apps or browser extensions taking advantage of this functionality in the near future.

Step 5: Additional Info

Well this is my first instructables and if there are any mistakes or problem, feel free to comment and I will try to improve it!

Also I am attaching the pdf version of this instructables in this step so ENJOY:)

P.S. If you are on Ubuntu, you have to install a missing dependency, i.e. the python3-pyaudio package. Thanks to PeterB480

Source: XDA

Invention Challenge 2017

Participated in the
Invention Challenge 2017



  • Indoor Lighting Contest

    Indoor Lighting Contest
  • Make It Fly Challenge

    Make It Fly Challenge
  • Growing Beyond Earth Maker Contest

    Growing Beyond Earth Maker Contest

10 Discussions


Question 3 months ago

python -m googlesamples.assistant.grpc.pushtotalk
python3 -m googlesamples.assistant.grpc.pushtotalk

INFO:root:Connecting to

WARNING:root:Device config not found: [Errno 2] No such file or directory: '/home/eri/.config/googlesamples-assistant/device_config.json'

INFO:root:Registering device

ERROR:root:Option --device-model-id required when registering a device instance.ERROR:root:Option --device-model-id required when registering a device instance.


1 year ago

This seems to no longer work after recent updates to the google assistant packages, sadly :(


1 year ago

At step three I keep getting "no such option: --client-secrets"


1 year ago

Nice instructable, thanks.

On Ubuntu I was missing a dependency - I had to install the python3-pyaudio package. Hope that helps someone.

1 reply

Reply 1 year ago

I shall add that to the instructable, thanks:)


2 years ago

umm- got to step 2.10 then it said i needed to change the name not to inlcude google and now i'm lost :(

2 replies

Reply 1 year ago

No problem just follow all the steps till step 8 and and under product name type any name of your choice like Gassistance
That will surely work:)


2 years ago

That's an interesting system, I've been wondering if the Assistant or Alexa would be a better setup :)

1 reply

Reply 2 years ago

You can for sure install Amazon Alexa in your PC, here's an instructable I found regarding that-