Inti Mycroft tidak lagi dipertahankan dan kemungkinan besar tidak berfungsi lagi di komputer Anda. Open Voice OS dan Neon-core keduanya merupakan penerus spiritual Mycroft. (Dan beberapa kode lama mungkin tetap ada di sana.)
Mycroft adalah asisten suara sumber terbuka yang dapat diretas.
Pertama, dapatkan kode di sistem Anda! Metode paling sederhana adalah melalui git (petunjuk instalasi git):
cd ~/
git clone https://github.com/MycroftAI/mycroft-core.git
cd mycroft-core
bash dev_setup.sh
Skrip ini menyiapkan dependensi dan virtualenv. Jika berjalan di lingkungan selain Ubuntu/Debian, Arch atau Fedora, Anda mungkin perlu menginstal paket secara manual seperti yang diinstruksikan oleh dev_setup.sh.
CATATAN: Cabang default untuk repositori ini adalah 'dev', yang dianggap sebagai pekerjaan dalam proses. Jika Anda ingin mengkloning versi yang lebih stabil, beralihlah ke cabang 'master'.
Mycroft menyediakan start-mycroft.sh
untuk melakukan tugas-tugas umum. Skrip ini menggunakan virtualenv yang dibuat oleh dev_setup.sh
. Dengan asumsi Anda menginstal mycroft-core di direktori home Anda, jalankan:
cd ~/mycroft-core
./start-mycroft.sh debug
Perintah "debug" akan memulai layanan latar belakang (pendengar mikrofon, keterampilan, bus pesan, dan subsistem audio) serta memunculkan Antarmuka Baris Perintah (CLI) berbasis teks yang dapat Anda gunakan untuk berinteraksi dengan Mycroft dan melihat konten dari berbagai log. Alternatifnya, Anda dapat menjalankan ./start-mycroft.sh all
untuk memulai layanan tanpa antarmuka baris perintah. Nanti Anda bisa memunculkan CLI menggunakan ./start-mycroft.sh cli
.
Layanan latar belakang dapat dihentikan secara berkelompok dengan:
./stop-mycroft.sh
Mycroft AI, Inc. mengelola sistem manajemen perangkat dan akun yang dikenal sebagai Mycroft Home. Pengembang dapat mendaftar di: https://home.mycroft.ai
Secara default, mycroft-core dikonfigurasi untuk menggunakan Beranda. Dengan mengucapkan "Hai Mycroft, pasangkan perangkat saya" (atau permintaan lisan lainnya), Anda akan diberi tahu bahwa perangkat Anda perlu dipasangkan. Mycroft akan mengucapkan kode 6 digit yang dapat Anda masukkan ke halaman pemasangan di situs Beranda Mycroft.
Setelah dipasangkan, unit Anda akan menggunakan kunci API Mycroft untuk layanan seperti Speech-to-Text (STT), cuaca, dan berbagai keterampilan lainnya.
Mycroft tidak ada artinya tanpa keterampilan. Ada beberapa keterampilan default yang diunduh secara otomatis ke direktori /opt/mycroft/skills
Anda, namun sebagian besar perlu diinstal secara eksplisit. Lihat Repo Keterampilan untuk menemukan keterampilan yang dibuat oleh orang lain. Silakan bagikan karya menarik Anda sendiri!
Informasi pemasangan yang dihasilkan dengan mendaftar dengan Home disimpan di: ~/.config/mycroft/identity/identity2.json
<-- JANGAN BAGIKAN INI DENGAN ORANG LAIN!
Konfigurasi Mycroft terdiri dari 4 kemungkinan lokasi:
mycroft-core/mycroft/configuration/mycroft.conf
(Default)/etc/mycroft/mycroft.conf
(Mesin)$XDG_CONFIG_DIR/mycroft/mycroft.conf
(yang secara default adalah $HOME/.config/mycroft/mycroft.conf
) (USER)Saat pemuat konfigurasi dimulai, pemuat konfigurasi akan mencari lokasi-lokasi ini dalam urutan ini, dan memuat SEMUA konfigurasi. Kunci yang ada di beberapa file konfigurasi akan ditimpa oleh file terakhir yang berisi nilai tersebut. Proses ini menghasilkan jumlah minimal yang ditulis untuk perangkat dan pengguna tertentu, tanpa mengubah file distribusi default.
Jika Anda tidak ingin menggunakan layanan Mycroft Home, sebelum memulai Mycroft untuk pertama kali, buatlah $HOME/.config/mycroft/mycroft.conf
dengan isi sebagai berikut:
{
"skills": {
"blacklisted_skills": [
"mycroft-configuration.mycroftai",
"mycroft-pairing.mycroftai"
]
}
}
Backend Mycroft menyediakan akses ke berbagai kunci API untuk layanan tertentu. Tanpa memasangkan dengan backend Mycroft, Anda perlu menambahkan kunci API Anda sendiri, menginstal Keterampilan atau Plugin lain untuk menjalankan fungsi tersebut, atau tidak memiliki akses ke fungsi tersebut.
Ini adalah kunci yang saat ini digunakan di Mycroft Core melalui backend Mycroft:
Banyak sekolah, universitas, dan tempat kerja menjalankan proxy
di jaringan mereka. Jika Anda perlu mengetikkan nama pengguna dan kata sandi untuk mengakses internet eksternal, kemungkinan besar Anda menggunakan proxy
.
Jika Anda berencana menggunakan Mycroft di belakang proxy, Anda perlu melakukan langkah konfigurasi tambahan.
CATATAN: Untuk menyelesaikan langkah ini, Anda perlu mengetahui hostname
dan port
untuk server proxy. Administrator jaringan Anda akan dapat memberikan rincian ini. Administrator jaringan Anda mungkin menginginkan informasi tentang jenis lalu lintas yang akan digunakan Mycroft. Kami menggunakan lalu lintas https
pada port 443
, terutama untuk mengakses API berbasis ReST.
Jika Anda menggunakan Mycroft di belakang proxy tanpa autentikasi, tambahkan variabel lingkungan berikut, ubah proxy_hostname.com
dan proxy_port
untuk nilai jaringan Anda. Perintah-perintah ini dijalankan dari antarmuka baris perintah 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 "
Jika Anda menggunakan proxy yang memerlukan autentikasi, tambahkan variabel lingkungan berikut, ubah proxy_hostname.com
dan proxy_port
untuk nilai jaringan Anda. Perintah-perintah ini dijalankan dari antarmuka baris perintah 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 "
Ini adalah proyek sumber terbuka. Kami akan sangat senang dengan bantuan Anda. Kami telah menyiapkan panduan berkontribusi untuk membantu Anda memulai.
Jika ini adalah PR pertama Anda, atau Anda tidak yakin harus mulai dari mana, sapalah di Mycroft Chat dan seorang anggota tim akan dengan senang hati membimbing Anda. Bergabunglah dengan Forum Mycroft untuk tanya jawab.