{"id":24802935,"url":"https://github.com/ovoshatchery/ovos-launcher","last_synced_at":"2025-03-25T05:37:18.554Z","repository":{"id":196217697,"uuid":"695271196","full_name":"OVOSHatchery/ovos-launcher","owner":"OVOSHatchery","description":"what if ovos was a single application","archived":false,"fork":false,"pushed_at":"2023-10-13T18:20:07.000Z","size":29,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"dev","last_synced_at":"2025-02-08T06:35:03.579Z","etag":null,"topics":["discarded","proof-of-concept"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OVOSHatchery.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2023-09-22T18:26:45.000Z","updated_at":"2024-02-09T20:40:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"6c767b16-218c-430e-a63e-35286ef164eb","html_url":"https://github.com/OVOSHatchery/ovos-launcher","commit_stats":null,"previous_names":["openvoiceos/ovos-launcher","ovoshatchery/ovos-launcher"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OVOSHatchery%2Fovos-launcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OVOSHatchery%2Fovos-launcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OVOSHatchery%2Fovos-launcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OVOSHatchery%2Fovos-launcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OVOSHatchery","download_url":"https://codeload.github.com/OVOSHatchery/ovos-launcher/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245407759,"owners_count":20610232,"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":["discarded","proof-of-concept"],"created_at":"2025-01-30T05:16:46.745Z","updated_at":"2025-03-25T05:37:18.523Z","avatar_url":"https://github.com/OVOSHatchery.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ovos-launcher\n\nWho is this repo for?\n\nIf these questions are something you can picture yourself asking, you are in the right place!\n\n- where is the desktop icon?\n- how do i install the app?\n- I NEED start-mycroft.sh\n- where do i click to run the assistant application\n- what is the launch command\n- what is a system daemon? what is systemd?\n- I install ovos-core but nothing happpens, now what?\n\nHello newcomer! OpenVoiceOS provides a larger number of applications and packages, it is a Voice Operating System!\nThis can be overwhelming when you just want to try out and have a quick chat with a voice assistant, this repo tries to soften your introduction to ovos by providing the most accessible way to run the basic voice assistant stack\n\nIf you are a hardcore linux grey beard you probably are in the wrong place, you want each service as a [system daemon](https://github.com/OpenVoiceOS/ovos-systemd), you MUST have performance, you want to tune your config files, you want [native integration](https://github.com/OpenVoiceOS/raspbian-ovos/blob/dev/manual_user_install.sh) with your already existing OS! get out of this repo nerd!\n\n## Install\n\ninstall system libraries\n\ndebian: `sudo apt-get install -y build-essential python3-dev python3-pip python3-venv swig libssl-dev libfann-dev portaudio19-dev libpulse-dev cmake libncurses-dev pulseaudio-utils pulseaudio`\n\ninstall ovos\n\n`pip install ovos-launcher`\n\nthat's it! it's installed! Now go to [Running OVOS](#Running-OVOS)\n\n## Running OVOS\n\nby default you can only run OVOS 1 time, do not launch ovos multiple times! If you already have OVOS running as a system daemon, you are a nerd! wrong repo!\n\nin the cli type `ovos-launcher`, that's it!\n\nthe essential OVOS stack is running in a single process with each service in its own thread\n\n```bash\n$ovos-launcher --help\n\nUsage: ovos-launcher [OPTIONS]\n\nOptions:\n  -l, --listener TEXT  Choose a listener for mic input handling,\n                       dinkum/old/classic\n  --help               Show this message and exit.\n```\n\n#### Troubleshooting\n\n##### tflite_runtime failure\n\nif setup fails to install tflite_runtime in your platform, you can find wheels here https://whl.smartgic.io/ , install `tflite_runtime` first and then retry to install `ovos-launcher`\n\neg, for python 3.11 in x86\n\n`pip install https://whl.smartgic.io/tflite_runtime-2.13.0-cp311-cp311-linux_x86_64.whl`\n\n##### Audio doesn't play\n\nIssues with pipewire in Kubuntu have been observed. If you see a log similar to this:\n\n```bash\n2023-10-13 08:38:48.270 - ovos-launcher - ovos_dinkum_listener.voice_loop.voice_loop:run:222 - INFO - Wakeword detected\nstream node 39 error: no node available\nremote error: id=3 seq:7 res:-2 (No such file or directory): no node available\n```\n\nCreate or edit a file at `~/.config/mycroft/mycroft.conf` with the following data:\n\n```json\n{\n  \"play_wav_cmdline\": \"paplay %1\",\n  \"play_mp3_cmdline\": \"mpg123 %1\"\n}\n```\n\nThat will force OVOS to use PulseAudio and mpg123 instead.\n\n##### How do I install new skills???\n\nOVOS skills are all Python packages that can be pip installed. Find the skill you want, and run `pip install git+$REPO` (ex: `pip install git+https://github.com/OpenVoiceOS/ovos-skill-easter-eggs`), then re-run `ovos-launcher`. Your new skill will be picked up as OVOS loads.\n\n#### Known issues\n\nOCP (OVOS Common Play) is coupled to the OVOS GUI, which does not run with `ovos-launcher`. Work is coming soon to decouple that requirement and get music skills working in a no-GUI configuration.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovoshatchery%2Fovos-launcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fovoshatchery%2Fovos-launcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovoshatchery%2Fovos-launcher/lists"}