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
Click here to directly download the latest version.
MacAssistant is currently in Beta.
"What's the weather today?"
"My agenda for tomorrow."
"When was Benedict Cumberbatch born?"
"Does the president of the United States have any children?"
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)
cd into the
grpc-swift directory, and run
You should then be able to open the
MacAssistant.xcworkspace file (not
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
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
Help us keep the lights on
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.