Mycroft Core：人工智能平台语音助手

概述

Mycroft Core，Mycroft 人工智能平台，Mycroft 是一个可破解的开源语音助手。

入门

首先，获取系统上的代码！最简单的方法是通过 git（git 安装说明）：

cd ~/
git clone https://github.com/MycroftAI/mycroft-core.git
cd mycroft-core
bash dev_setup.sh

该脚本设置依赖项和virtualenv。如果在 Ubuntu/Debian、Arch 或 Fedora 以外的环境中运行，您可能需要按照 dev_setup.sh 的指示手动安装软件包。

注意：这个存储库的默认分支是“dev”，它应该被认为是一个正在进行的工作。如果你想克隆一个更稳定的版本，切换到“master”分支。

运行Mycroft Core

[hidecontent type="logged" desc="隐藏内容：登录后可查看"]

Mycroft 提供start-mycroft.sh执行常见任务。此脚本使用由创建的 virtualenv dev_setup.sh。假设您在主目录中安装了 mycroft-core 运行：

cd ~/mycroft-core
./start-mycroft.sh debug

“调试”命令将启动后台服务（麦克风侦听器、技能、消息总线和音频子系统），并调出一个基于文本的命令行界面 (CLI)，您可以使用它与 Mycroft 交互并查看各种日志。或者，您可以./start-mycroft.sh all在没有命令行界面的情况下运行以启动服务。稍后您可以使用./start-mycroft.sh cli.

后台服务可以作为一个组停止：

./stop-mycroft.sh

使用Mycroft Core

家庭设备和客户经理

Mycroft AI, Inc. 维护着一个名为 Mycroft Home 的设备和帐户管理系统。开发者可以在以下网址注册： https: //home.mycroft.ai

默认情况下，mycroft-core 配置为使用 Home。通过说“嘿 Mycroft，配对我的设备”（或任何其他请求口头请求），您将被告知您的设备需要配对。Mycroft 会说出一个 6 位数的代码，您可以将其输入到Mycroft Home 站点的配对页面中。

配对后，您的设备将使用 Mycroft API 密钥提供语音转文本 (STT)、天气和各种其他技能等服务。

技能

Mycroft 没有技能就一事无成。有一些默认技能会自动下载到您的/opt/mycroft/skills目录中，但大多数需要明确安装。查看Skill Repo以发现其他人制作的技能。请分享您自己的有趣作品！

其他

配对信息

通过注册 Home 生成的配对信息存储在： ~/.config/mycroft/identity/identity2.json <-- DO NOT SHARE THIS WITH OTHERS!

配置

Mycroft 的配置包括 4 个可能的位置：

mycroft-core/mycroft/configuration/mycroft.conf（默认）
Mycroft 家（远程）
/etc/mycroft/mycroft.conf（机器）
$XDG_CONFIG_DIR/mycroft/mycroft.conf（默认情况下$HOME/.config/mycroft/mycroft.conf）（用户）

当配置加载器启动时，它会按顺序查找这些位置，并加载所有配置。存在于多个配置文件中的键将被最后一个包含该值的文件覆盖。此过程会导致为特定设备和用户写入最少量的内容，而无需修改默认分发文件。

在没有家的情况下使用 Mycroft

如果您不想使用 Mycroft Home 服务，请在首次启动 Mycroft 之前，创建$HOME/.config/mycroft/mycroft.conf以下内容：

{
  "skills": {
    "blacklisted_skills": [
      "mycroft-configuration.mycroftai",
      "mycroft-pairing.mycroftai"
    ]
  }
}

API密钥服务

Mycroft 后端提供对特定服务的一系列 API 密钥的访问。如果不与 Mycroft 后端配对，您将需要添加自己的 API 密钥、安装不同的技能或插件来执行该功能，或者无法访问该功能。

这些是当前通过 Mycroft 后端在 Mycroft Core 中使用的密钥：

在代理后面使用 Mycroft

许多学校、大学和工作场所都在其网络上运行proxy。如果您需要输入用户名和密码才能访问外部互联网，那么您很可能使用了proxy.

如果您计划在代理后面使用 Mycroft，那么您将需要执行额外的配置步骤。

注意：为了完成此步骤，您需要了解代理服务器的名称hostname和名称。port您的网络管理员将能够提供这些详细信息。您的网络管理员可能需要有关 Mycroft 将使用的流量类型的信息。我们使用https端口上的流量443，主要用于访问基于 ReST 的 API。

在没有身份验证的情况下在代理后面使用 Mycroft

如果您在未经身份验证的代理后面使用 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"

在经过身份验证的代理后面使用 Mycroft

如果您在需要身份验证的代理后面，请添加以下环境变量，更改网络的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"

[/hidecontent]