عن المشروع

OpenAI Harmony هي مكتبة للعمل مع تنسيق استجابة harmony، وهو بنية المحادثة التي تم تدريب نماذج gpt-oss مفتوحة الوزن من OpenAI عليها. وفقًا لملف README، لا ينبغي استخدام gpt-oss بدون تنسيق harmony، لأنه لن يعمل بشكل صحيح. المستخدمون الذين يصلون إلى gpt-oss عبر واجهة برمجة تطبيقات أو موفري خدمات مثل HuggingFace أو Ollama أو vLLM لا يحتاجون إلى التعامل مع التنسيق بأنفسهم، لأن حل الاستدلال يقوم بذلك. تستهدف المكتبة المطورين الذين يبنون حلول الاستدلال الخاصة بهم. صُمم التنسيق لمحاكاة واجهة برمجة تطبيقات الاستجابات من OpenAI ويدعم قنوات إخراج متعددة لسلسلة التفكير، ومقدمات استدعاء الأدوات، والاستجابات العادية، ومساحات أسماء الأدوات، والمخرجات المنظمة، وتسلسل هرمي للتعليمات. يتضمن ملف README مثالًا على موجه يعرض رسائل النظام والمطور والمستخدم مع تعريفات الأدوات. الميزات الرئيسية المذكورة: - تنسيق متسق: تنفيذ مشترك للعرض والتحليل يحافظ على تسلسلات الرموز دون فقدان. - الأداء: يتم تنفيذ العمل الثقيل في Rust. - دعم Python: قابل للتثبيت عبر pip، مع تلميحات أنواع واختبارات متكافئة مع مجموعة اختبارات Rust. يحتوي المستودع على حزمة Rust (هياكل بيانات الدردشة، الترميز/العرض والتحليل، سجل الترميز المدمج، الاختبارات، وروابط PyO3) بالإضافة إلى غلاف Python نقي يعرض فئات البيانات وواجهة برمجة تطبيقات مساعدة. تثبيت Python يتم عبر `pip install openai-harmony` أو `uv pip install openai-harmony`؛ استخدام Rust يضيف الحزمة كاعتماد git في Cargo.toml. تُظهر الأمثلة تحميل ترميز HARMONY_GPT_OSS، وبناء محادثة من الرسائل، وعرضها للإكمال، وتحليل الرسائل من رموز الإكمال. للتطوير المحلي، المتطلبات الأساسية هي سلسلة أدوات Rust مستقرة، وPython 3.8+ مع بيئة افتراضية، وmaturin. يستخدم سير العمل `maturin develop --release` لتجميع حزمة Rust وتثبيت حزمة Python في الوضع القابل للتحرير. تُشغَّل الاختبارات باستخدام `cargo test` لـ Rust و`pytest` لـ Python، مع وصف مجموعة اختبارات Python بأنها نقل مباشر لاختبارات Rust. تشمل الأدوات الاختيارية mypy لفحص الأنواع، وruff للتدقيق اللغوي، وcargo fmt للتنسيق.