ดาวน์โหลด mycroft core - ดาวน์โหลด mycroft core ซอร์สโค้ด

mycroft core

ซอร์สโค้ดอื่น ๆ

21.2.2

ดาวน์โหลด

โปรเจ็กต์นี้ไม่ได้รับการบำรุงรักษาอีกต่อไป

Mycroft core ไม่ได้รับการดูแลรักษาอีกต่อไป และอาจจะไม่ทำงานบนคอมพิวเตอร์ของคุณอีกต่อไป Open Voice OS และ Neon-core ต่างก็เป็นผู้สืบทอดทางจิตวิญญาณของ Mycroft (และโค้ดเก่าบางส่วนอาจยังอยู่ที่นั่น)

Readme เก่า

Mycroft เป็นผู้ช่วยเสียงแบบโอเพ่นซอร์สที่สามารถแฮ็กได้

สารบัญ

เริ่มต้นใช้งาน
วิ่งมายครอฟท์
การใช้งานไมครอฟท์
- ผู้จัดการอุปกรณ์ ในบ้าน และบัญชี
- ทักษะ
เบื้องหลัง
- ข้อมูลการจับคู่
- การกำหนดค่า
- การใช้ Mycroft โดยไม่มีบ้าน
- บริการคีย์ API
- การใช้ Mycroft หลังพรอกซี
  - การใช้ 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' ซึ่งควรถือเป็นงานระหว่างดำเนินการ หากคุณต้องการโคลนเวอร์ชันที่เสถียรกว่านี้ ให้สลับไปที่สาขา 'ต้นแบบ'

วิ่งมายครอฟท์

Mycroft จัดให้มี start-mycroft.sh เพื่อดำเนินงานทั่วไป สคริปต์นี้ใช้ virtualenv ที่สร้างโดย dev_setup.sh สมมติว่าคุณติดตั้ง mycroft-core ในโฮมไดเร็กตอรี่ของคุณ:

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

คำสั่ง "debug" จะเริ่มบริการเบื้องหลัง (ตัวฟังไมโครโฟน ทักษะ เมสเสจบัส และระบบย่อยเสียง) รวมถึงการแสดง Command Line Interface (CLI) แบบข้อความที่คุณสามารถใช้เพื่อโต้ตอบกับ Mycroft และดูเนื้อหาของ บันทึกต่างๆ หรือคุณสามารถเรียกใช้ ./start-mycroft.sh all เพื่อเริ่มบริการโดยไม่ต้องใช้อินเทอร์เฟซบรรทัดคำสั่ง หลังจากนั้นคุณสามารถเรียก CLI ขึ้นมาได้โดยใช้ ./start-mycroft.sh cli

บริการพื้นหลังสามารถหยุดได้เป็นกลุ่มด้วย:

./stop-mycroft.sh

การใช้งานไมครอฟท์

ผู้จัดการอุปกรณ์ ในบ้าน และบัญชี

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 <-- อย่าแชร์สิ่งนี้กับผู้อื่น!

การกำหนดค่า

การกำหนดค่าของ Mycroft ประกอบด้วย 4 ตำแหน่งที่เป็นไปได้:

mycroft-core/mycroft/configuration/mycroft.conf (ค่าเริ่มต้น)
มายครอฟท์โฮม (ระยะไกล)
/etc/mycroft/mycroft.conf (เครื่อง)
$XDG_CONFIG_DIR/mycroft/mycroft.conf (ซึ่งเป็นค่าเริ่มต้น $HOME/.config/mycroft/mycroft.conf ) (USER)

เมื่อตัวโหลดการกำหนดค่าเริ่มทำงาน มันจะค้นหาในตำแหน่งเหล่านี้ตามลำดับนี้ และโหลดการกำหนดค่าทั้งหมด คีย์ที่มีอยู่ในไฟล์การกำหนดค่าหลายไฟล์จะถูกแทนที่โดยไฟล์สุดท้ายเพื่อให้มีค่า กระบวนการนี้ส่งผลให้มีการเขียนจำนวนขั้นต่ำสำหรับอุปกรณ์และผู้ใช้เฉพาะ โดยไม่ต้องแก้ไขไฟล์การแจกจ่ายเริ่มต้น

การใช้ Mycroft โดยไม่มีบ้าน

หากคุณไม่ต้องการใช้บริการ Mycroft Home ก่อนที่จะเริ่ม Mycroft เป็นครั้งแรก ให้สร้าง $HOME/.config/mycroft/mycroft.conf โดยมีเนื้อหาดังต่อไปนี้:

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

บริการคีย์ API

แบ็คเอนด์ Mycroft ให้การเข้าถึงคีย์ API ที่หลากหลายสำหรับบริการเฉพาะ หากไม่จับคู่กับแบ็กเอนด์ Mycroft คุณจะต้องเพิ่มคีย์ API ของคุณเอง ติดตั้งทักษะหรือปลั๊กอินอื่นเพื่อใช้งานฟังก์ชันนั้น หรือไม่สามารถเข้าถึงฟังก์ชันดังกล่าวได้

นี่คือคีย์ที่ใช้ใน Mycroft Core ผ่านทางแบ็กเอนด์ Mycroft:

STT API, Google STT, Google Cloud Speech
- มีบริการ STT มากมายสำหรับใช้กับ Mycroft
API ทักษะสภาพอากาศ, OpenWeatherMap
ทักษะวุลแฟรม-อัลฟ่า

การใช้ Mycroft หลังพรอกซี

โรงเรียน มหาวิทยาลัย และสถานที่ทำงานหลายแห่งใช้ proxy บนเครือข่ายของตน หากคุณต้องการพิมพ์ชื่อผู้ใช้และรหัสผ่านเพื่อเข้าถึงอินเทอร์เน็ตภายนอก เป็นไปได้ว่าคุณอยู่หลัง proxy

หากคุณวางแผนที่จะใช้ Mycroft หลังพร็อกซี คุณจะต้องดำเนินการขั้นตอนการกำหนดค่าเพิ่มเติม

หมายเหตุ: เพื่อดำเนินการขั้นตอนนี้ให้เสร็จสิ้น คุณจะต้องทราบ hostname และ port สำหรับพร็อกซีเซิร์ฟเวอร์ ผู้ดูแลระบบเครือข่ายของคุณจะสามารถให้รายละเอียดเหล่านี้ได้ ผู้ดูแลระบบเครือข่ายของคุณอาจต้องการข้อมูลเกี่ยวกับประเภทการรับส่งข้อมูลที่ Mycroft จะใช้ เราใช้การรับส่งข้อมูล https บนพอร์ต 443 เพื่อการเข้าถึง API ที่ใช้ ReST เป็นหลัก

การใช้ Mycroft หลังพร็อกซีโดยไม่มีการตรวจสอบสิทธิ์

หากคุณใช้ Mycroft หลังพร็อกซีโดยไม่มีการตรวจสอบสิทธิ์ ให้เพิ่มตัวแปรสภาพแวดล้อมต่อไปนี้ โดยเปลี่ยน proxy_hostname.com และ proxy_port สำหรับค่าสำหรับเครือข่ายของคุณ คำสั่งเหล่านี้ดำเนินการจากอินเทอร์เฟซบรรทัดคำสั่ง (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 "

การใช้ Mycroft หลังพร็อกซีที่ได้รับการรับรองความถูกต้อง

หากคุณอยู่หลังพร็อกซีที่ต้องมีการรับรองความถูกต้อง ให้เพิ่มตัวแปรสภาพแวดล้อมต่อไปนี้ โดยเปลี่ยน proxy_hostname.com และ proxy_port สำหรับค่าสำหรับเครือข่ายของคุณ คำสั่งเหล่านี้ดำเนินการจากอินเทอร์เฟซบรรทัดคำสั่ง (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 "

การมีส่วนร่วม

นี่เป็นโครงการโอเพ่นซอร์ส เราชอบความช่วยเหลือของคุณ เราได้เตรียมคำแนะนำที่เป็นประโยชน์เพื่อช่วยคุณในการเริ่มต้น

หากนี่เป็นการประชาสัมพันธ์ครั้งแรกของคุณ หรือคุณไม่แน่ใจว่าจะเริ่มต้นจากตรงไหน ให้ทักทายใน Mycroft Chat และสมาชิกในทีมยินดีที่จะให้คำปรึกษาแก่คุณ เข้าร่วมฟอรัม Mycroft เพื่อถามคำถามและคำตอบ