Skip to content

Latest commit

 

History

History
72 lines (47 loc) · 5.01 KB

README.md

File metadata and controls

72 lines (47 loc) · 5.01 KB

License Unit Tests codecov PRs Welcome Chat GitHub Discussions

OVOS-core

OpenVoiceOS is an open source platform for smart speakers and other voice-centric devices.

Mycroft was a hackable, open source voice assistant by the now defunct MycroftAI. OpenVoiceOS continues that work and ovos-core (this repo) is the central component.

All Mycroft Skills and Plugins should work normally with OVOS-core, with the exception of Common Play and other media-related skills. Other Mycroft-based assistants are also believed, but not guaranteed, to be compatible.

The biggest difference between OVOS-core and Mycroft-core is that OVOS-core is fully modular. Furthermore, common components have been repackaged as plugins. That means it isn't just a great assistant on its own, but also a pretty small library!

Table of Contents

Installing OVOS

If you have an existing system that you would like to install OVOS on, we strongly suggest the ovos-installer to install OVOS and its dependencies. The full assistant requires several repositories and the installer makes it easy to install them all at once.

If you would like to install OVOS on a Raspberry Pi, we suggest using the RaspOVOS image. This image is based on Raspberry Pi OS and includes OVOS and its dependencies running in a "headless" mode (no GUI). It is designed and optimized for a Raspberry Pi 3B, so on a 4 or higher its performance is even better.

If you would like to install OVOS on embedded hardware, we suggest using ovos-buildroot. This is a buildroot configuration that can be used to build a custom Linux distribution for embedded hardware. It includes OVOS and its dependencies, and is designed to be as small and efficient as possible.

You can find detailed documentation over at the community-docs or ovos-technical-manual

This repo can be installed standalone via pip install ovos-core, which will install the bare minimum components common to all services. This is useful for developers who want to build their own custom voice assistant. For more details, please see the community docs.

Skills

OVOS is nothing without skills. There are a handful of default skills, but most need to be installed explicitly. OVOS skills are all pip-installable, and can be found on PyPI or by browsing the OVOS organization on GitHub. Most classic Mycroft skills will also work on OVOS.

Please share your own interesting work!

Getting Involved

This is an open source project. We would love your help. We have prepared a contributing guide to help you get started.

The easiest way for anyone to contribute is to help with translations! You can help without any programming knowledge via the translation portal

If this is your first PR, or you're not sure where to get started, say hi in OpenVoiceOS Chat and a team member would be happy to mentor you. Join the Discussions for questions and answers.

Credits

The OpenVoiceOS team thanks the following entities (in addition to MycroftAI) for making certain code and/or manpower resources available to us:

Links