{"id":30428920,"url":"https://github.com/OpenVoiceOS/ovos-installer","last_synced_at":"2025-08-22T16:03:15.165Z","repository":{"id":206081578,"uuid":"715783395","full_name":"OpenVoiceOS/ovos-installer","owner":"OpenVoiceOS","description":"Open Voice OS and/or HiveMind installer using Ansible with an intuitive and easy Text-based User Interface","archived":false,"fork":false,"pushed_at":"2025-08-14T13:27:16.000Z","size":2798,"stargazers_count":192,"open_issues_count":9,"forks_count":44,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-08-21T09:23:33.476Z","etag":null,"topics":["ai","ansible","container","devkit","docker","hivemind","hivemind-installer","installer","macos","mark1","mark2","openvoiceos","ovos","ovos-installer","rapsberrypi","tui","virtualenv","voice-assistant","windows","wsl2"],"latest_commit_sha":null,"homepage":"https://www.openvoiceos.org","language":"Shell","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/OpenVoiceOS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["OpenVoiceOS"],"patreon":"openvoiceos","liberapay":"OpenVoiceOS-Foundation","custom":"https://paypal.me/openvoiceos"}},"created_at":"2023-11-07T20:31:20.000Z","updated_at":"2025-08-16T01:44:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"baa7cf27-f63a-4d9a-a960-fc07eb3898a2","html_url":"https://github.com/OpenVoiceOS/ovos-installer","commit_stats":null,"previous_names":["smartgic/ovos-installer"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/OpenVoiceOS/ovos-installer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenVoiceOS","download_url":"https://codeload.github.com/OpenVoiceOS/ovos-installer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-installer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271664762,"owners_count":24799291,"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","status":"online","status_checked_at":"2025-08-22T02:00:08.480Z","response_time":65,"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":["ai","ansible","container","devkit","docker","hivemind","hivemind-installer","installer","macos","mark1","mark2","openvoiceos","ovos","ovos-installer","rapsberrypi","tui","virtualenv","voice-assistant","windows","wsl2"],"created_at":"2025-08-22T16:01:49.425Z","updated_at":"2025-08-22T16:03:14.982Z","avatar_url":"https://github.com/OpenVoiceOS.png","language":"Shell","readme":"# 🎉 Open Voice OS and HiveMind Installer 🎉\n\nWelcome to the world of Open Voice OS and HiveMind! Get ready for a straightforward journey into voice tech.\n\n## 🚀 Quickstart\n\nBefore we begin, make sure you have `curl`, `git`, and `sudo` installed. Here’s your installation incantation:\n\n```shell\nsudo sh -c \"$(curl -fsSL https://raw.githubusercontent.com/OpenVoiceOS/ovos-installer/main/installer.sh)\"\n```\n\n👉 [Start your Open Voice OS journey!](https://community.openconversational.ai/t/howto-begin-your-open-voice-os-journey-with-the-ovos-installer/14900)\n\n### 🐧 Supported Linux distributions\n\n| Distribution        | Version   |\n| ------------------- | --------- |\n| AlmaLinux           | `\u003e= 8`    |\n| Arch                | `rolling` |\n| CentOS              | `\u003e= 8`    |\n| Debian GNU/Linux    | `\u003e= 10`   |\n| EndeavourOS         | `rolling` |\n| KDE Neon            | `\u003e=20.04` |\n| Fedora              | `\u003e= 37`   |\n| Linux Mint          | `\u003e= 21`   |\n| openSUSE Leap       | `\u003e= 15`   |\n| openSUSE Tumbleweed | `rolling` |\n| openSUSE Slowroll   | `rolling` |\n| Pop!\\_OS            | `\u003e=22.04` |\n| Manjaro             | `rolling` |\n| Raspbian            | `10`      |\n| Raspberry Pi OS     | `\u003e= 11`   |\n| Rocky Linux         | `\u003e=8`     |\n| Ubuntu              | `\u003e=20.04` |\n| WSL2                | `20.04`   |\n| Zorin OS            | `\u003e= 16`   |\n\n`rolling` as `rolling` Linux distribution which means that there is no specific version.\n\n## 🔄 Update\n\nTo update the current Open Voice OS instance, backup your `~/.config/mycroft/mycroft.conf` or `~/ovos/config/mycroft.conf` _(only if required)_ and re-run installer but answer **\"No\"** to the _\"Do you want to uninstall Open Voice OS?\"_ question.\n\n## ⚙️ Start \u0026 Stop the services\n\nWhen the `virtualenv` method as being choose _(default)_ during the installation process, few systemd unit files have being created in order to manages the different components as services.\n\n### 📋 List the systemd unit files\n\n```shell\nsystemctl --user list-units \"*ovos*\"\nsystemctl list-units \"*ovos*\"\n```\n\nOnly one service is running as `root`; `ovos-phal-admin`.\n\n### 🟢 Start Open Voice OS\n\n```shell\nsystemctl --user start ovos\nsudo systemctl start ovos-phal-admin\n```\n\n### 🔴 Stop Open Voice OS\n\n```shell\nsystemctl --user stop ovos\nsudo systemctl stop ovos-phal-admin\n```\n\n## 🤖 Automated install\n\nThe installer supports a non-interactive _(automated)_ process of installation by using a scenario file, this file must be created under the `~/.config/ovos-installer/` directory and should be named `scenario.yaml`.\n\nHere is an example of a scenario to install Open Voice OS within Docker containers on a Raspberry Pi 4B with default skills and GUI support.\n\n```shell\nmkdir -p ~/.config/ovos-installer\ncat \u003c\u003cEOF \u003e ~/.config/ovos-installer/scenario.yaml\n---\nuninstall: false\nmethod: containers\nchannel: testing\nprofile: ovos\nfeatures:\n  skills: true\n  extra_skills: false\n  gui: true\nrapsberry_pi_tuning: true\nshare_telemetry: true\nshare_usage_telemetry: true\nEOF\n```\n\nFew scenarios are available as example in the [scenarios](https://github.com/OpenVoiceOS/ovos-installer/tree/main/scenarios) directory of this repository.\n\n## ❌ Uninstall\n\nTo uninstall Open Voice OS run the installer with the `--uninstall` option _(non-interactive)_ or simply run the installer and answer **\"Yes\"** to the _\"Do you want to uninstall Open Voice OS?\"_ question.\n\n```shell\nsh -c \"curl -s https://raw.githubusercontent.com/OpenVoiceOS/ovos-installer/main/installer.sh -o installer.sh \u0026\u0026 chmod +x installer.sh \u0026\u0026 sudo ./installer.sh --uninstall \u0026\u0026 rm installer.sh\"\n```\n\n## 🖼️ Screenshots\n\n![Screenshot 1](docs/images/screenshot_1.png)\n\n![Screenshot 2](docs/images/screenshot_3.png)\n\n![Screenshot 3](docs/images/screenshot_4.png)\n\n![Screenshot 4](docs/images/screenshot_5.png)\n\n![Screenshot 5](docs/images/screenshot_6.png)\n\n![Screenshot 6](docs/images/screenshot_7.png)\n\n![Screenshot 7](docs/images/screenshot_8.png)\n","funding_links":["https://github.com/sponsors/OpenVoiceOS","https://patreon.com/openvoiceos","https://liberapay.com/OpenVoiceOS-Foundation","https://paypal.me/openvoiceos"],"categories":["Shell"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOpenVoiceOS%2Fovos-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FOpenVoiceOS%2Fovos-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOpenVoiceOS%2Fovos-installer/lists"}