Le noyau Mycroft n'est plus maintenu et ne fonctionnera probablement plus sur votre ordinateur. Open Voice OS et Neon-core sont tous deux les successeurs spirituels de Mycroft. (Et une partie de l’ancien code peut y résider.)
Mycroft est un assistant vocal open source piratable.
Tout d’abord, récupérez le code sur votre système ! La méthode la plus simple est via git (instructions d'installation de git) :
cd ~/
git clone https://github.com/MycroftAI/mycroft-core.git
cd mycroft-core
bash dev_setup.sh
Ce script configure des dépendances et un virtualenv. Si vous utilisez un environnement autre qu'Ubuntu/Debian, Arch ou Fedora, vous devrez peut-être installer manuellement les packages comme indiqué par dev_setup.sh.
REMARQUE : La branche par défaut de ce référentiel est « dev », qui doit être considérée comme un travail en cours. Si vous souhaitez cloner une version plus stable, passez à la branche 'master'.
Mycroft fournit start-mycroft.sh
pour effectuer des tâches courantes. Ce script utilise un virtualenv créé par dev_setup.sh
. En supposant que vous ayez installé mycroft-core dans votre répertoire personnel, exécutez :
cd ~/mycroft-core
./start-mycroft.sh debug
La commande "debug" démarrera les services d'arrière-plan (écouteur de microphone, compétence, bus de messages et sous-systèmes audio) ainsi qu'affichera une interface de ligne de commande (CLI) textuelle que vous pouvez utiliser pour interagir avec Mycroft et voir le contenu du divers journaux. Vous pouvez également exécuter ./start-mycroft.sh all
pour démarrer les services sans l'interface de ligne de commande. Plus tard, vous pourrez afficher la CLI en utilisant ./start-mycroft.sh cli
.
Les services d'arrière-plan peuvent être arrêtés en groupe avec :
./stop-mycroft.sh
Mycroft AI, Inc. gère un système de gestion des appareils et des comptes connu sous le nom de Mycroft Home. Les développeurs peuvent s'inscrire sur : https://home.mycroft.ai
Par défaut, mycroft-core est configuré pour utiliser Home. En disant « Hey Mycroft, associez mon appareil » (ou toute autre demande verbale), vous serez informé que votre appareil doit être couplé. Mycroft prononcera un code à 6 chiffres que vous pourrez saisir dans la page de couplage du site Mycroft Home.
Une fois couplé, votre appareil utilisera les clés API Mycroft pour des services tels que la synthèse vocale (STT), la météo et diverses autres compétences.
Mycroft n'est rien sans compétences. Il existe une poignée de compétences par défaut qui sont téléchargées automatiquement dans votre répertoire /opt/mycroft/skills
, mais la plupart doivent être installées explicitement. Consultez le Skill Repo pour découvrir les compétences créées par d’autres. S'il vous plaît, partagez votre propre travail intéressant !
Les informations de couplage générées par l'inscription sur Home sont stockées dans : ~/.config/mycroft/identity/identity2.json
<-- NE PARTAGEZ PAS CECI AVEC D'AUTRES !
La configuration de Mycroft se compose de 4 emplacements possibles :
mycroft-core/mycroft/configuration/mycroft.conf
(valeurs par défaut)/etc/mycroft/mycroft.conf
(Machine)$XDG_CONFIG_DIR/mycroft/mycroft.conf
(qui est par défaut $HOME/.config/mycroft/mycroft.conf
) (UTILISATEUR)Lorsque le chargeur de configuration démarre, il recherche ces emplacements dans cet ordre et charge TOUTES les configurations. Les clés qui existent dans plusieurs fichiers de configuration seront remplacées par le dernier fichier contenant la valeur. Ce processus entraîne l'écriture d'une quantité minimale pour un périphérique et un utilisateur spécifiques, sans modifier les fichiers de distribution par défaut.
Si vous ne souhaitez pas utiliser le service Mycroft Home, avant de démarrer Mycroft pour la première fois, créez $HOME/.config/mycroft/mycroft.conf
avec le contenu suivant :
{
"skills": {
"blacklisted_skills": [
"mycroft-configuration.mycroftai",
"mycroft-pairing.mycroftai"
]
}
}
Le backend Mycroft donne accès à une gamme de clés API pour des services spécifiques. Sans couplage avec le backend Mycroft, vous devrez ajouter vos propres clés API, installer une compétence ou un plugin différent pour exécuter cette fonction, ou ne pas avoir accès à cette fonctionnalité.
Voici les clés actuellement utilisées dans Mycroft Core via le backend Mycroft :
De nombreuses écoles, universités et lieux de travail utilisent un proxy
sur leur réseau. Si vous devez saisir un nom d'utilisateur et un mot de passe pour accéder à l'Internet externe, vous êtes probablement derrière un proxy
.
Si vous envisagez d'utiliser Mycroft derrière un proxy, vous devrez alors effectuer une étape de configuration supplémentaire.
REMARQUE : Pour terminer cette étape, vous devrez connaître le hostname
et port
du serveur proxy. Votre administrateur réseau sera en mesure de fournir ces détails. Votre administrateur réseau souhaitera peut-être des informations sur le type de trafic que Mycroft utilisera. Nous utilisons le trafic https
sur le port 443
, principalement pour accéder aux API basées sur ReST.
Si vous utilisez Mycroft derrière un proxy sans authentification, ajoutez les variables d'environnement suivantes, en modifiant proxy_hostname.com
et proxy_port
pour les valeurs de votre réseau. Ces commandes sont exécutées à partir de l'interface de ligne de commande (CLI) 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 "
Si vous êtes derrière un proxy qui nécessite une authentification, ajoutez les variables d'environnement suivantes, en modifiant proxy_hostname.com
et proxy_port
pour les valeurs de votre réseau. Ces commandes sont exécutées à partir de l'interface de ligne de commande (CLI) 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 "
Il s'agit d'un projet open source. Nous serions ravis de votre aide. Nous avons préparé un guide de contribution pour vous aider à démarrer.
S'il s'agit de votre premier PR ou si vous ne savez pas par où commencer, dites bonjour dans Mycroft Chat et un membre de l'équipe se fera un plaisir de vous encadrer. Rejoignez le forum Mycroft pour des questions et réponses.