عن المشروع

Instructor هي مكتبة Python مصممة لتبسيط استخراج البيانات المهيكلة من النماذج اللغوية الكبيرة (LLMs). تدمج مع Pydantic لتقديم مخرجات آمنة النوعية ومُتحقق منها دون الحاجة إلى تحليل يدوي لـ JSON أو معالجة أخطاء. يعرف المطورون نموذج Pydantic يمثل الهيكل المطلوب للمخرجات، ثم يمررونه إلى واجهة عميل Instructor التي تتولى تلقائيًا توليد المخطط، والتحقق من المصادقة، ومنطق إعادة المحاولة في حال الفشل. تدعم المكتبة مزودي LLM متعددين بمن فيهم OpenAI وAnthropic وGoogle Gemini وOllama وGroq — جميعها عبر واجهة API متسقة. كما تقدم ميزات متقدمة مثل تدفق النتائج الجزئية أثناء التوليد، واستخراج الكائنات المتداخلة، وإعادة المحاولة التلقائية مع التغذية الراجعة للمخرجات غير الصالحة. تعتبر Instructor خفيفة الوزن مقارنة بإطارات عمل مثل LangChain أو LlamaIndex، حيث تركز حصريًا على الاستخراج المهيكلي. تُستخدم في الإنتاج من قبل أكثر من 100,000 مطور وشركة بما فيها فرق في OpenAI وGoogle وMicrosoft وAWS. يضم المشروع أكثر من 10 آلاف نجمة على GitHub وأكثر من 3 ملايين تحميل شهريًا. فرقًا عن Python، توفر Instructor تطبيقات رسمية بلغات TypeScript وRuby وGo وElixir وRust. تتوفر الوثائق والأمثلة ودعم المجتمع عبر موقعها الإلكتروني وخادم Discord. بالنسبة لسير عمل الوكلاء الأكثر تعقيدًا، يوصي الفريق بـ PydanticAI الذي يبني على أساس Instructor مع إضافة أدوات وميزات مراقبة إضافية. التثبيت سهل عبر pip أو uv أو Poetry. لا يحتاج إلى إعداد معقد — فقط عرّف نموذجك واستخرج البيانات المهيكلة بثقة من المدخلات النصية الطبيعية.