لم يعد Mycroft core صالحًا للصيانة ومن المحتمل ألا يعمل على جهاز الكمبيوتر الخاص بك بعد الآن. يعد كل من Open Voice OS وNeon-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"، والذي يجب اعتباره عملاً قيد التقدم. إذا كنت تريد استنساخ نسخة أكثر استقرارًا، فانتقل إلى الفرع "الرئيسي".
يوفر Mycroft start-mycroft.sh
لأداء المهام الشائعة. يستخدم هذا البرنامج النصي virtualenv الذي تم إنشاؤه بواسطة dev_setup.sh
. بافتراض أنك قمت بتثبيت mycroft-core في الدليل الرئيسي الخاص بك، قم بتشغيل:
cd ~/mycroft-core
./start-mycroft.sh debug
سيبدأ أمر "debug" خدمات الخلفية (مستمع الميكروفون، والمهارة، وناقل الرسائل، والأنظمة الفرعية الصوتية) بالإضافة إلى إظهار واجهة سطر الأوامر (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 لاستخدام الصفحة الرئيسية. من خلال قول "مرحبًا Mycroft، قم بإقران جهازي" (أو أي طلب شفهي آخر) سيتم إعلامك بأن جهازك يحتاج إلى الإقران. سينطق Mycroft رمزًا مكونًا من 6 أرقام يمكنك إدخاله في صفحة الاقتران داخل موقع Mycroft Home.
بمجرد الاقتران، ستستخدم وحدتك مفاتيح Mycroft API لخدمات مثل تحويل الكلام إلى نص (STT) والطقس ومهارات أخرى متنوعة.
Mycroft لا شيء بدون مهارات. هناك عدد قليل من المهارات الافتراضية التي يتم تنزيلها تلقائيًا إلى دليل /opt/mycroft/skills
الخاص بك، ولكن يجب تثبيت معظمها بشكل صريح. راجع Skill Repo لاكتشاف المهارات التي صنعها الآخرون. يرجى مشاركة عملك المثير للاهتمام!
يتم تخزين معلومات الاقتران الناتجة عن التسجيل في الصفحة الرئيسية في: ~/.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 Home، قبل تشغيل Mycroft لأول مرة، قم بإنشاء $HOME/.config/mycroft/mycroft.conf
بالمحتويات التالية:
{
"skills": {
"blacklisted_skills": [
"mycroft-configuration.mycroftai",
"mycroft-pairing.mycroftai"
]
}
}
توفر الواجهة الخلفية لـ Mycroft إمكانية الوصول إلى مجموعة من مفاتيح واجهة برمجة التطبيقات (API) لخدمات معينة. بدون الاقتران مع واجهة Mycroft الخلفية، ستحتاج إلى إضافة مفاتيح واجهة برمجة التطبيقات (API) الخاصة بك، أو تثبيت مهارة أو مكون إضافي مختلف لأداء هذه الوظيفة، أو عدم إمكانية الوصول إلى هذه الوظيفة.
هذه هي المفاتيح المستخدمة حاليًا في Mycroft Core من خلال الواجهة الخلفية لـ Mycroft:
تقوم العديد من المدارس والجامعات وأماكن العمل بتشغيل proxy
على شبكتها. إذا كنت بحاجة إلى كتابة اسم مستخدم وكلمة مرور للوصول إلى الإنترنت الخارجي، فمن المحتمل أنك خلف proxy
.
إذا كنت تخطط لاستخدام Mycroft خلف وكيل، فستحتاج إلى القيام بخطوة تكوين إضافية.
ملاحظة: لإكمال هذه الخطوة، ستحتاج إلى معرفة hostname
port
الخاص بالخادم الوكيل. سيتمكن مسؤول الشبكة من تقديم هذه التفاصيل. قد يرغب مسؤول الشبكة لديك في الحصول على معلومات حول نوع حركة المرور التي سيستخدمها Mycroft. نحن نستخدم حركة مرور https
على المنفذ 443
، بشكل أساسي للوصول إلى واجهات برمجة التطبيقات المستندة إلى ReST.
إذا كنت تستخدم 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 "
إذا كنت خلف وكيل يتطلب مصادقة، فأضف متغيرات البيئة التالية، وقم بتغيير 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 "
هذا هو مشروع مفتوح المصدر. نحن نحب مساعدتكم. لقد قمنا بإعداد دليل مساهم لمساعدتك على البدء.
إذا كانت هذه هي علاقاتك العامة الأولى، أو لم تكن متأكدًا من أين تبدأ، فقل مرحبًا في Mycroft Chat وسيسعد أحد أعضاء الفريق بتوجيهك. انضم إلى منتدى Mycroft للأسئلة والأجوبة.