Swiftpack.co - Package - vanshg/MacAssistant


Github All Releases Swift GitHub license Twitter Build Status

NOTE: There is a very limited number of API requests Google is willing to grant me. Please use your own OAuth credentials by following the instructions below.

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 up to 600 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.2 and Xcode 10

Get OAuth Credentials

You will need OAuth credentials from the Google Developer Console.

  • Create a new project in the Google Developer Console
  • Enable the Google Assistant API for that project
  • Generate an OAuth credential
    • Select the application type of Other UI
    • State that you will be using User Data
    • Download the JSON file
    • Rename the file to google_oauth.json
    • Place it in your project at ./MacAssistant/Config/google_oauth.json

Building MacAssistant

  • Clone the project using git clone https://github.com/vanshg/MacAssistant.git
  • Open the MacAssistant.xcworkspace file (not xcproject) in Xcode
  • Make sure you've obtained the OAuth Credentials as defined above
  • Hit the Play button on the top left

Updating the Assistant SDK Version

  • If you would like to contribute and the Assistant SDK version needs to be updated, clone the repository with the --recursive option
  • Update VERSION found at the top of the gen_swift_proto.sh as necessary
  • Run ./gen_swfit_proto.sh
    • This will build the grpc-swift module, and then generate the appropriate Swift files from the .proto definitions found in the googleapis submodule


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. Please follow the Code of Conduct.


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


Stars: 1239
Help us keep the lights on


Used By

Total: 0


0.2 - May 15, 2017

NOTE: This "release" is bug-ridden. Please try building from source instead for significantly more stability and functionality!!

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.