Ядро Mycroft больше не поддерживается и, вероятно, больше не будет работать на вашем компьютере. Open Voice OS и Neon-core являются духовными преемниками Mycroft. (И часть старого кода может остаться там.)
Mycroft — взломанный голосовой помощник с открытым исходным кодом.
Сначала установите код в свою систему! Самый простой способ — через git (инструкция по установке git):
cd ~/
git clone https://github.com/MycroftAI/mycroft-core.git
cd mycroft-core
bash dev_setup.sh
Этот скрипт устанавливает зависимости и виртуальную среду. Если вы работаете в среде, отличной от Ubuntu/Debian, Arch или Fedora, вам может потребоваться вручную установить пакеты, как указано в dev_setup.sh.
ПРИМЕЧАНИЕ. Веткой по умолчанию для этого репозитория является «dev», которую следует рассматривать как незавершенную работу. Если вы хотите клонировать более стабильную версию, переключитесь на ветку «master».
Mycroft предоставляет start-mycroft.sh
для выполнения распространенных задач. Этот скрипт использует virtualenv, созданный dev_setup.sh
. Предполагая, что вы установили mycroft-core в свой домашний каталог, выполните:
cd ~/mycroft-core
./start-mycroft.sh debug
Команда «отладка» запустит фоновые службы (подсистемы прослушивания микрофона, навыков, шины сообщений и аудио), а также вызовет текстовый интерфейс командной строки (CLI), который вы можете использовать для взаимодействия с Mycroft и просмотра содержимого различные журналы. Альтернативно вы можете запустить ./start-mycroft.sh all
, чтобы запустить службы без интерфейса командной строки. Позже вы можете вызвать CLI, используя ./start-mycroft.sh cli
.
Фоновые службы можно остановить как группу с помощью:
./stop-mycroft.sh
Mycroft AI, Inc. поддерживает систему управления устройствами и учетными записями, известную как Mycroft Home. Разработчики могут зарегистрироваться по адресу: https://home.mycroft.ai.
По умолчанию mycroft-core настроен на использование Home. Сказав «Привет, Майкрофт, подключи мое устройство» (или любой другой устный запрос), вы будете проинформированы о том, что ваше устройство необходимо подключить. Майкрофт произнесет 6-значный код, который вы можете ввести на странице сопряжения на домашнем сайте Mycroft.
После сопряжения ваше устройство будет использовать ключи API Mycroft для таких сервисов, как преобразование речи в текст (STT), погода и других функций.
Майкрофт — ничто без навыков. Существует несколько навыков по умолчанию, которые автоматически загружаются в ваш каталог /opt/mycroft/skills
, но большинство из них необходимо установить явно. См. репозиторий навыков, чтобы узнать о навыках, созданных другими. Поделитесь, пожалуйста, своими интересными работами!
Информация о сопряжении, созданная при регистрации в Home, хранится в: ~/.config/mycroft/identity/identity2.json
<-- НЕ ПОДЕЛИТЕСЬ ЭТОЙ С ДРУГИМИ!
Конфигурация Майкрофта состоит из 4 возможных мест:
mycroft-core/mycroft/configuration/mycroft.conf
(по умолчанию)/etc/mycroft/mycroft.conf
(Машина)$XDG_CONFIG_DIR/mycroft/mycroft.conf
(по умолчанию $HOME/.config/mycroft/mycroft.conf
) (ПОЛЬЗОВАТЕЛЬ)Когда загрузчик конфигурации запускается, он просматривает эти места в указанном порядке и загружает ВСЕ конфигурации. Ключи, существующие в нескольких файлах конфигурации, будут переопределены последним файлом, содержащим это значение. В результате этого процесса для конкретного устройства и пользователя записывается минимальный объем без изменения файлов дистрибутива по умолчанию.
Если вы не хотите использовать службу Mycroft Home, перед первым запуском Mycroft создайте $HOME/.config/mycroft/mycroft.conf
со следующим содержимым:
{
"skills": {
"blacklisted_skills": [
"mycroft-configuration.mycroftai",
"mycroft-pairing.mycroftai"
]
}
}
Серверная часть Mycroft обеспечивает доступ к ряду ключей API для определенных сервисов. Без сопряжения с серверной частью Mycroft вам потребуется добавить свои собственные ключи API, установить другой навык или плагин для выполнения этой функции или не иметь доступа к этой функции.
Это ключи, которые в настоящее время используются в Mycroft Core через серверную часть Mycroft:
Многие школы, университеты и рабочие места используют proxy
в своей сети. Если вам нужно ввести имя пользователя и пароль для доступа к внешнему Интернету, то, скорее всего, вы используете proxy
.
Если вы планируете использовать Mycroft через прокси, вам потребуется выполнить дополнительный шаг настройки.
ПРИМЕЧАНИЕ. Для выполнения этого шага вам необходимо знать hostname
и port
прокси-сервера. Ваш сетевой администратор сможет предоставить эти данные. Вашему сетевому администратору может потребоваться информация о том, какой тип трафика будет использовать Майкрофт. Мы используем https
трафик на порту 443
, в первую очередь для доступа к API на основе ReST.
Если вы используете Mycroft за прокси-сервером без аутентификации, добавьте следующие переменные среды, изменив proxy_hostname.com
и proxy_port
на значения для вашей сети. Эти команды выполняются из интерфейса командной строки Linux (CLI).
$ export http_proxy=http://proxy_hostname.com:proxy_port
$ export https_port=http://proxy_hostname.com:proxy_port
$ export no_proxy= " localhost,127.0.0.1,localaddress,.localdomain.com,0.0.0.0,::1 "
Если вы используете прокси-сервер, требующий аутентификации, добавьте следующие переменные среды, изменив proxy_hostname.com
и proxy_port
на значения для вашей сети. Эти команды выполняются из интерфейса командной строки Linux (CLI).
$ export http_proxy=http://user:password@proxy_hostname.com:proxy_port
$ export https_port=http://user:password@proxy_hostname.com:proxy_port
$ export no_proxy= " localhost,127.0.0.1,localaddress,.localdomain.com,0.0.0.0,::1 "
Это проект с открытым исходным кодом. Мы будем рады вашей помощи. Мы подготовили руководство, которое поможет вам начать работу.
Если это ваш первый пиар или вы не знаете, с чего начать, поздоровайтесь в чате Mycroft, и член команды будет рад вас наставить. Присоединяйтесь к форуму Майкрофта, чтобы получать вопросы и ответы.