{"id":15033859,"url":"https://github.com/vanshg/macassistant","last_synced_at":"2025-05-15T23:04:25.596Z","repository":{"id":41413311,"uuid":"89634004","full_name":"vanshg/MacAssistant","owner":"vanshg","description":"Google Assistant for macOS!","archived":false,"fork":false,"pushed_at":"2023-03-05T23:23:35.000Z","size":44918,"stargazers_count":1615,"open_issues_count":31,"forks_count":126,"subscribers_count":76,"default_branch":"master","last_synced_at":"2025-05-15T23:04:25.246Z","etag":null,"topics":["assistant","cocoa","google","google-assistant","google-assistant-sdk","macos","osx","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vanshg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":"vanshg","custom":"https://venmo.com/vanshg"}},"created_at":"2017-04-27T19:40:13.000Z","updated_at":"2025-05-06T23:07:37.000Z","dependencies_parsed_at":"2022-09-12T15:53:30.066Z","dependency_job_id":"1f434fdb-6dab-4f11-bc4e-cf2e23be2345","html_url":"https://github.com/vanshg/MacAssistant","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanshg%2FMacAssistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanshg%2FMacAssistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanshg%2FMacAssistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanshg%2FMacAssistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vanshg","download_url":"https://codeload.github.com/vanshg/MacAssistant/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254436944,"owners_count":22070946,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["assistant","cocoa","google","google-assistant","google-assistant-sdk","macos","osx","swift"],"created_at":"2024-09-24T20:23:00.903Z","updated_at":"2025-05-15T23:04:25.578Z","avatar_url":"https://github.com/vanshg.png","language":"Swift","readme":"# MacAssistant\n\n[![Github All Releases](https://img.shields.io/github/downloads/vanshg/MacAssistant/total.svg)](https://github.com/vanshg/MacAssistant/releases) \n[![Swift](https://img.shields.io/badge/Swift-4.2-blue.svg)](https://github.com/vanshg/MacAssistant)\n[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/vanshg/MacAssistant/master/LICENSE)\n[![Twitter](https://img.shields.io/twitter/url/https/github.com/vanshg/MacAssistant.svg?style=social)](https://twitter.com/intent/tweet?text=Wow:\u0026url=%5Bobject%20Object%5D)\n[![Build Status](https://dev.azure.com/MacAssistant/MacAssistant%20CI/_apis/build/status/vanshg.MacAssistant)](https://dev.azure.com/MacAssistant/MacAssistant%20CI/_build/latest?definitionId=2)\n\n***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](https://github.com/vanshg/MacAssistant#Get-OAuth-Credentials).***\n\nA project that integrates the Google Assistant into macOS, using the Google Assistant SDK.\n\n*\"Google Assistant is now on over 500 million devices”  - Scott Huffman @ Google I/O 2018*\n\nMacAssistant can bring that number up to 600 million\n\n![](images/1.png)\n![](images/2.png)\n![](images/3.png)\n\n## Download\nDownloads are listed under the `Releases` tab.\nClick [here](https://github.com/vanshg/MacAssistant/releases/download/0.2/MacAssistant.zip) to directly download the latest version.\n\nMacAssistant is currently in Beta.\n\n## Example Queries\n- *What's the weather today?*\n- *My agenda for tomorrow*\n- *When was Benedict Cumberbatch born?*\n- *Does the President of the United States have any children?*\n\n## Build Instructions\nMacAssistant is built using Swift 4.2 and Xcode 10\n\n### Get OAuth Credentials\nYou will need OAuth credentials from the [Google Developer Console](https://console.developers.google.com). \n- Create a new project in the Google Developer Console\n- Enable the Google Assistant API for that project\n- Generate an OAuth credential\n    - Select the application type of `Other UI`\n    - State that you will be using `User Data`\n    - Download the JSON file\n    - Rename the file to `google_oauth.json`\n    - Place it in your project at `./MacAssistant/Config/google_oauth.json`\n\n### Building MacAssistant\n- Clone the project using `git clone https://github.com/vanshg/MacAssistant.git`\n- Open the `MacAssistant.xcworkspace` file (not `xcproject`) in Xcode\n- Make sure you've obtained the OAuth Credentials as defined above\n- Hit the Play button on the top left\n\n### Updating the Assistant SDK Version \n- If you would like to contribute *and* the Assistant SDK version needs to be updated, clone the repository with the `--recursive` option\n- Update `VERSION` found at the top of the `gen_swift_proto.sh` as necessary\n- Run `./gen_swfit_proto.sh`\n    - This will build the `grpc-swift` module, and then generate the appropriate Swift files from the `.proto` definitions found in the `googleapis` submodule\n\n## Contributing\nPlease 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](TODO.md) file. Please follow the [Code of Conduct](CODE_OF_CONDUCT.md).\n\n## License\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details\n","funding_links":["https://github.com/sponsors/vanshg","https://venmo.com/vanshg"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanshg%2Fmacassistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvanshg%2Fmacassistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanshg%2Fmacassistant/lists"}