Github: https://github.com/MycroftAI/mycroft-core
マイクロフト
Mycroftは、ハッキング可能なオープンソースの音声アシスタントです。
目次
入門
まず、システム上でコードを入手してください! 最も簡単な方法はgit経由です( gitのインストール手順 )。
cd ~/
git clone --depth=1 https://github.com/MycroftAI/mycroft-core.git
cd mycroft-core
bash dev_setup.sh
このスクリプトは依存関係とvirtualenvを設定します。 Ubuntu / Debian、Arch、Fedora以外の環境で実行している場合は、dev_setup.shの指示に従って手動でパッケージをインストールする必要があります。
注意:このリポジトリのデフォルトのブランチは ‘dev’です。これは作業中であるとみなされます。 より安定したバージョンを複製したい場合は、 ‘master’ブランチに切り替えます。 注:このプロジェクトに貢献したい場合は、リポジトリ全体を
-
git clone https://github.com/MycroftAI/mycroft-core.git
代わりに -
git clone --depth=1 https://github.com/MycroftAI/mycroft-core.git
これは上記のとおりです。
マイクロフトを走らせる
Mycroftは、共通のタスクを実行するためにstart-mycroft.sh
を提供します。 このスクリプトは、dev_setup.shによって作成されたdev_setup.sh
使用しdev_setup.sh
。 あなたのホームディレクトリにmycroft-coreをインストールしたとします:
cd ~/mycroft-core
./start-mycroft.sh debug
“debug”コマンドは、バックグラウンドサービス(マイクリスナー、スキル、メッセージバス、およびオーディオサブシステム)を開始するだけでなく、Mycroftと対話するためのテキストベースのコマンドラインインターフェイス(CLI)を起動し、さまざまなログ。 あるいは、. ./start-mycroft.sh all
を実行して、コマンドラインインターフェイスなしでサービスを開始することもできます。 後で./start-mycroft.sh cli
を使用してCLIを./start-mycroft.sh cli
することができます。
バックグラウンドサービスは、次のものを持つグループとして停止することができます。
./stop-mycroft.sh
Mycroftの使用
ホームデバイスとアカウントマネージャ
Mycroft AI、Inc.は、Mycroft Homeと呼ばれるデバイスとアカウント管理システムを管理しています。 開発者はhttps://home.mycroft.aiにサインアップすることができます
デフォルトでは、mycroft-coreはHomeを使用するように設定されています。 「こんにちはMycroft、私のデバイスをペアにする」と言って、あなたのデバイスがペアリングする必要があることを知らされます。 Mycroftは6桁のコードを発声し、 Mycroftホームサイトのペアリングページに入力することができます 。
ペアになると、あなたのユニットはSpeech-to-Text(STT)、天気などのサービスにMycroft APIキーを使用します。
技能
Mycroftはスキルなしでは何もありません。 /opt/mycroft/skills
ディレクトリに自動的にダウンロードされるいくつかのデフォルトスキルがありますが、ほとんどは明示的にインストールする必要があります。 他の人のスキルを発見するには、 スキルレポを参照してください。 そしてあなた自身の興味深い仕事を共有してください!
舞台裏
ペアリング情報
~/.mycroft/identity/identity2.json
< – これを ~/.mycroft/identity/identity2.json
ないでください!
構成
Mycroft構成は、4つの可能な場所から構成されています。
-
mycroft-core/mycroft/configuration/mycroft.conf
(デフォルト) - マイクロフトホーム (リモート)
-
/etc/mycroft/mycroft.conf
(マシン) -
$HOME/.mycroft/mycroft.conf
(ユーザー)
コンフィギュレーションローダが起動すると、この順にこれらの場所が検索され、すべての設定がロードされます。 複数の構成ファイルに存在するキーは、値を格納する最後のファイルによって上書きされます。 このプロセスにより、デフォルトの配布ファイルを変更することなく、特定のデバイスとユーザーに対して書かれる量が最小限に抑えられます。
ホームなしでMycroftを使用する
Mycroft Homeサービスを使用したくない場合は、以下の設定ファイルに独自のAPIキーを挿入して設定することができます 。
APIキーを挿入する場所は、次のようになります。
[WeatherSkill]
api_key = ""
関連するキーを引用符で囲み、mycroft-coreはキーをすぐに使用し始めます。
APIキーサービス
Mycroft Coreで現在使用されているキーは次のとおりです。
プロキシの背後でMycroftを使用する
多くの学校、大学、職場では、ネットワーク上でproxy
を実行しています。 外部インターネットにアクセスするためにユーザー名とパスワードを入力する必要がある場合は、 proxy
背後にある可能性があります。
プロキシの背後でMycroftを使用する予定の場合は、追加の設定手順を実行する必要があります。
注:この手順を完了するためには、プロキシサーバーのhostname
とport
を知る必要があります。 ネットワーク管理者はこれらの詳細を提供できます。 ネットワーク管理者は、Mycroftが使用するトラフィックの種類についての情報が必要な場合があります。 主にReSTベースのAPIにアクセスするために、ポート443
でhttps
トラフィックを使用します。
認証なしでプロキシの後ろに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"
参加する
これはオープンソースプロジェクトであり、私たちはあなたのご協力をお待ちしております。 私たちは、あなたが始めるための寄付ガイドを用意しました。
これが初めてのPRである場合、またはどこから始めたらいいのかわからない場合は、 Mycroft Chatの hiと言ってください。チームメンバーがあなたを指導してくれるでしょう。 Mycroftフォーラムに参加して質問と回答を求めてください。