{"id":19362417,"url":"https://github.com/alancunningham/hotword","last_synced_at":"2026-06-18T11:31:01.579Z","repository":{"id":89430818,"uuid":"116881494","full_name":"AlanCunningham/hotword","owner":"AlanCunningham","description":"A voice assistant, along the same vein as Amazon Echo and Google Home using Snowboy hotword detection for the voice activation.","archived":false,"fork":false,"pushed_at":"2021-04-06T20:44:58.000Z","size":3068,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-11-18T11:06:39.068Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlanCunningham.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-09T23:14:11.000Z","updated_at":"2021-04-06T20:56:33.000Z","dependencies_parsed_at":"2024-05-03T06:45:45.738Z","dependency_job_id":null,"html_url":"https://github.com/AlanCunningham/hotword","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AlanCunningham/hotword","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanCunningham%2Fhotword","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanCunningham%2Fhotword/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanCunningham%2Fhotword/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanCunningham%2Fhotword/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlanCunningham","download_url":"https://codeload.github.com/AlanCunningham/hotword/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanCunningham%2Fhotword/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34489019,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-18T02:00:06.871Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-11-10T07:28:17.065Z","updated_at":"2026-06-18T11:31:01.557Z","avatar_url":"https://github.com/AlanCunningham.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Raspberry Pi hotword voice assistant\n\nA voice assistant, along the same vein as Amazon Echo and Google Home using\n[Snowboy hotword detection](https://snowboy.kitt.ai/) for the voice activation.\n\nThis is really a pet project, so a lot of the commands here are heavily \npersonalised for my use, but there's nothing really stopping anyone from modifying\nit for theirs.\n\n\n# Features\n- Weather updates (using [Dark Sky](https://darksky.net/dev/) and \n[Google TTS](https://pypi.python.org/pypi/gTTS))\n- News Flash briefing from BBC World News\n- Philips Hue lights\n- Wake-on-lan\n\n\n# Dependancies:\n- snowboy kitt.ai (Included as snowboy-linux or snowboy-pi, for Ubuntu and \nRaspberry Pi respectively)\n- sudo apt-get install mpg321 wakeonlan libatlas3-base python-mutagen libboost-all-dev\n- pip install qhue gTTS schedul pygame face_recognition\n\n# Setup\n- Sign up for a [Dark Sky dev account](https://darksky.net/dev/)\n- Update config.py with the following\n\n```\n[snowboy]\nraspberry_pi: False  # Set to True if running on a Raspberry Pi\n\n[hue]\nuser: your_hue_user_id\nbridge_ip: your_hue_bridge_ip_address\n\n[weather]\napi_key: your_dark_sky_api_token\n  location_lon: your_longitude\n  location_lat: your_latitude\n  units: uk2\n  ```\n\n# Running everything\nFrom terminal, run `python hotword.py`\n\n# Commands\nSaying `Okay SAM` will activate the assistant and open up a set of secondary commands (a bit like saying \"Okay Google\"):\n - Weather\n   - Any sentence with  the word `weather`\n   - \"What's the `weather` like?\"\n   - \"Give me the `weather`\"\n- News headlines\n  - Any sentence with `news` or `headlines`\n  - \"Play the `news`\"\n  - \"What are today's `headlines`?\"\n\nSome commands can be said without needing to say `Okay SAM`:\n- Lights\n  - \"Turn the lights on\"\n  - \"Turn the lights off\"\n  - \"Dim the lights\"\n  - \"Full brightness\"\n  - \"Everything off\"\n- Wake on LAN\n  - \"Computer\"\n- Stop command\n  - \"Cancel that\"\n  - \"Stop playing\"\n\nYou might find better results to record your own activation words on the [Snowboy Hotword Detection](https://snowboy.kitt.ai) website.  Hotword files (.pdml) can be placed in the `hotword_models` folder in the corresponding category folder.  For example, to add your own \"Okay SAM\" hotword:\n- Record your activation hotword on the Snowboy website (doesn't need to be \"Okay SAM\" - it could be \"Okay Google\")\n- Download the resulting .pdml file\n- Save this file to hotword_models/activation/\n- The file can be called anything (e.g. okay_google.pdml)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falancunningham%2Fhotword","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falancunningham%2Fhotword","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falancunningham%2Fhotword/lists"}