O núcleo Mycroft não é mais mantido e provavelmente não funcionará mais no seu computador. Open Voice OS e Neon-core são sucessores espirituais do Mycroft. (E parte do código antigo pode estar lá.)
Mycroft é um assistente de voz de código aberto hackeável.
Primeiro, obtenha o código no seu sistema! O método mais simples é via git (instruções de instalação do git):
cd ~/
git clone https://github.com/MycroftAI/mycroft-core.git
cd mycroft-core
bash dev_setup.sh
Este script configura dependências e um virtualenv. Se estiver executando em um ambiente além do Ubuntu/Debian, Arch ou Fedora, você pode precisar instalar pacotes manualmente conforme instruído por dev_setup.sh.
NOTA: O branch padrão para este repositório é ‘dev’, que deve ser considerado um trabalho em andamento. Se você deseja clonar uma versão mais estável, mude para o branch ‘master’.
Mycroft fornece start-mycroft.sh
para executar tarefas comuns. Este script usa um virtualenv criado por dev_setup.sh
. Supondo que você instalou o mycroft-core em seu diretório inicial, execute:
cd ~/mycroft-core
./start-mycroft.sh debug
O comando "debug" iniciará os serviços de segundo plano (ouvinte de microfone, habilidade, messagebus e subsistemas de áudio), bem como abrirá uma interface de linha de comando (CLI) baseada em texto que você pode usar para interagir com Mycroft e ver o conteúdo do vários registros. Alternativamente, você pode executar ./start-mycroft.sh all
para iniciar os serviços sem a interface de linha de comando. Mais tarde, você pode abrir a CLI usando ./start-mycroft.sh cli
.
Os serviços em segundo plano podem ser interrompidos como um grupo com:
./stop-mycroft.sh
Mycroft AI, Inc. mantém um sistema de gerenciamento de dispositivos e contas conhecido como Mycroft Home. Os desenvolvedores podem se inscrever em: https://home.mycroft.ai
Por padrão, mycroft-core está configurado para usar Home. Ao dizer "Ei, Mycroft, emparelhe meu dispositivo" (ou qualquer outra solicitação verbal), você será informado de que seu dispositivo precisa ser emparelhado. Mycroft falará um código de 6 dígitos que você pode inserir na página de emparelhamento do site Mycroft Home.
Uma vez emparelhada, sua unidade usará chaves API Mycroft para serviços como Speech-to-Text (STT), clima e várias outras habilidades.
Mycroft não é nada sem habilidades. Existem algumas habilidades padrão que são baixadas automaticamente para o diretório /opt/mycroft/skills
, mas a maioria precisa ser instalada explicitamente. Consulte o Skill Repo para descobrir habilidades criadas por outros. Por favor, compartilhe seu próprio trabalho interessante!
As informações de emparelhamento geradas pelo registro no Home são armazenadas em: ~/.config/mycroft/identity/identity2.json
<-- NÃO COMPARTILHE ISTO COM OUTROS!
A configuração do Mycroft consiste em 4 locais possíveis:
mycroft-core/mycroft/configuration/mycroft.conf
(padrões)/etc/mycroft/mycroft.conf
(máquina)$XDG_CONFIG_DIR/mycroft/mycroft.conf
(que é por padrão $HOME/.config/mycroft/mycroft.conf
) (USUÁRIO)Quando o carregador de configuração é iniciado, ele procura esses locais nesta ordem e carrega TODAS as configurações. As chaves que existem em vários arquivos de configuração serão substituídas pelo último arquivo que contém o valor. Esse processo resulta na gravação de uma quantidade mínima para um dispositivo e usuário específico, sem modificar os arquivos de distribuição padrão.
Se você não deseja usar o serviço Mycroft Home, antes de iniciar o Mycroft pela primeira vez, crie $HOME/.config/mycroft/mycroft.conf
com o seguinte conteúdo:
{
"skills": {
"blacklisted_skills": [
"mycroft-configuration.mycroftai",
"mycroft-pairing.mycroftai"
]
}
}
O backend Mycroft fornece acesso a uma variedade de chaves de API para serviços específicos. Sem emparelhar com o backend Mycroft, você precisará adicionar suas próprias chaves de API, instalar uma habilidade ou plug-in diferente para executar essa função ou não ter acesso a essa funcionalidade.
Estas são as chaves usadas atualmente no Mycroft Core por meio do backend do Mycroft:
Muitas escolas, universidades e locais de trabalho executam um proxy
em suas redes. Se você precisar digitar um nome de usuário e uma senha para acessar a Internet externa, provavelmente você está atrás de um proxy
.
Se você planeja usar o Mycroft atrás de um proxy, precisará realizar uma etapa de configuração adicional.
NOTA: Para concluir esta etapa, você precisará saber o hostname
e port
do servidor proxy. O administrador da rede poderá fornecer esses detalhes. O administrador da rede pode querer informações sobre o tipo de tráfego que o Mycroft usará. Usamos tráfego https
na porta 443
, principalmente para acessar APIs baseadas em ReST.
Se você estiver usando o Mycroft atrás de um proxy sem autenticação, adicione as seguintes variáveis de ambiente, alterando proxy_hostname.com
e proxy_port
para os valores da sua rede. Esses comandos são executados a partir da interface de linha de comando (CLI) do Linux.
$ 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 "
Se você estiver atrás de um proxy que requer autenticação, adicione as seguintes variáveis de ambiente, alterando proxy_hostname.com
e proxy_port
para os valores da sua rede. Esses comandos são executados a partir da interface de linha de comando (CLI) do Linux.
$ 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 "
Este é um projeto de código aberto. Adoraríamos sua ajuda. Preparamos um guia de contribuição para ajudá-lo a começar.
Se este for seu primeiro PR ou se você não tiver certeza por onde começar, diga oi no Mycroft Chat e um membro da equipe ficará feliz em orientá-lo. Participe do Fórum Mycroft para perguntas e respostas.