Swiftpack.co - Package - vanshg/MacAssistant


Github All Releases Travis GitHub license Twitter

NOTE: I've currently hit the API limit. In the meantime, you can use your own OAuth credentials by following the instructions here.

A project that integrates the Google Assistant into macOS, using the Google Assistant SDK.

Google Assistant “is now on over 500 million devices” - Scott Huffman @ Google I/O 2018

MacAssistant can bring that number to 200 million


Downloads are listed under the Releases tab. Click here to directly download the latest version.

MacAssistant is currently in Beta.

Example Queries

"What's the weather today?"

"My agenda for tomorrow."

"When was Benedict Cumberbatch born?"

"Does the president of the United States have any children?"

Build Instructions

MacAssistant is built using Swift 4 and Xcode 9.1

Clone the project using git clone --recursive https://github.com/vanshg/MacAssistant.git (This project relies on some submodules to work)

Once cloned, cd into the grpc-swift directory, and run make.

You should then be able to open the MacAssistant.xcworkspace file (not xcproject!)

You will also need OAuth credentials from the Google Developer Console. In order to get them, you'll need to create a new project and enable the Google Assistant API for that project. Then, generate an OAuth credential, and select the application type of Other UI. State that you will be using User Data, and then download the json file. Finally, rename the file to google_oauth.json and place it in your project (/MacAssistant/google_oauth.json).

Use your own OAuth Credentials

Follow the final step of the Build Instructions to get your google_oauth.json. Then download MacAssistant, unzip the file, and right click the app to Show Package Contents. Next, go to Contents, Resources, and replace the google_oauth.json file with your own.


Please feel free to contribute to this project. I welcome all contributions and pull requests. There is a list of pending things that need to be worked on in the TODO file.


This project is licensed under the MIT License - see the LICENSE file for details


Stars: 1048
Help us keep the lights on


Used By

Total: 0


0.2 - May 15, 2017

NOTE: I've currently hit the API limit and am working with Google to resolve this issue and give me more API quota. In the meantime, you can obtain your own OAuth client key and build the project yourself by following the Build Instructions in the README.


  • Added Icon
  • Added Hotkey (Double Press Command)
  • Displaying spoken text

0.1 - May 15, 2017

This is the first release of any kind of MacAssistant. There will be bugs, and the UI/UX is not there yet. Functionally, it should work as expected.