إنتقل إلى المحتوى الرئيسي

تثبيت Sweepy

تحتاج إلى ثلاثة أشياء على حاسوبك قبل تشغيل Sweepy:

  1. Python: لغة البرمجة التي يعمل بها المحرك.
  2. Git: أداة تنزّل شيفرة المحرك من الإنترنت.
  3. pip: مدير حزم يثبّت المكتبات الإضافية التي يحتاجها المحرك. تتضمن مثبّتات Windows وmacOS الرسمية برنامج pip. وتضيف توزيعات Linux برنامج pip عبر مدير حزم النظام.
ملاحظة

يشرح هذا الدليل كل خطوة لمن لم يفتح طرفية من قبل. إذا كان لديك Python 3.10+ وGit مثبّتًا، فانتقل إلى الخطوة 3.

الخطوة 1: افتح طرفيتك​

الطرفية، وتسمى أيضًا موجه الأوامر، نافذة نصية تكتب فيها الأوامر. تكتب التعليمات إلى حاسوبك هنا بدلًا من اختيار الأيقونات.

اضغط مفتاح Windows، واكتب PowerShell، ثم اختر Windows PowerShell.

الطرفية
Windows PowerShell
Copyright (C) Microsoft Corporation. All rights reserved.

PS C:\Users\YourName>

ينتهي الموجه بمؤشر وامض. يعني هذا المؤشر أن طرفيتك جاهزة لأمر.

الخطوة 2: تحقق من Python وثبّته​

يتطلب Sweepy الإصدار Python 3.10 أو أحدث. تحقق مما إذا كان مثبتًا لديك.

اكتب هذا الأمر في طرفيتك واضغط Enter:

الطرفية
python --version

على macOS وLinux، الأمر هو python3 --version.

إذا ظهر لك Python 3.10.x أو إصدار أحدث، فلديك Python بالفعل. انتقل إلى الخطوة 3.

إذا ظهرت رسالة خطأ مثل 'python' is not recognized أو إصدار أقدم من 3.10، فاتبع خطوات التثبيت أدناه.

  1. زر صفحة تنزيلات Python لنظام Windows.
  2. اختر أحدث رابط تنزيل Windows installer (64-bit).
  3. شغّل الملف الذي نزّلته.
  4. هذه الخطوة حاسمة. في الشاشة الأولى من المثبّت، حدّد خانة الاختيار "Add python.exe to PATH" في الأسفل. تضع الخانة Python على PATH حيث تجده الطرفية.
  5. اختر Install Now وانتظر انتهاء التثبيت.

ثم أكّد التثبيت في نافذة طرفية جديدة:

الطرفية
PS C:\Users\YourName> python --version
Python 3.13.1
حذر

إذا تجاهلت "Add python.exe to PATH"، فلن تتعرف طرفيتك على الأمر python. أزل تثبيت Python، ثم أعد تثبيته مع تحديد الخانة.

تنتهي تبويبات Windows وmacOS وLinux بالفحص نفسه. أغلق طرفيتك وافتحها من جديد، ثم نفّذ أمر الإصدار. رقم إصدار 3.10 أو أحدث يعني أن Python جاهز.

الخطوة 3: نزّل Sweepy​

تنزيل ملفات مصدر Sweepy

اختر طريقة واحدة. استخدم Git الموضح أدناه، أو نزّل ملف ZIP من صفحة إصدارات Sweepy.

ينسخ Git ملفات المشروع إلى حاسوبك ويسجل تاريخها. يتيح هذا السجل لـ Sweepy تحديث نفسه. تستخدم الخطوات أدناه Git.

  • نسخة Git. نفّذ sweepy --update أو استخدم محدّث Sweepy's Toolbox لجلب كل إصدار جديد.
  • نسخة ZIP. نزّل الملف وفك ضغطه، ثم نفّذ pip install -e . مرة أخرى لكل إصدار. تبقى التحديثات التلقائية معطلة، لأن ملف ZIP لا يحتوي على سجل Git للجلب منه.
  • اسم المجلد. ينشئ Git مجلدًا باسم sweepy. يُفك ضغط ملف ZIP في مجلد مثل sweepy-main، لذا عدّل أمر cd الوارد لاحقًا في هذه الخطوة.

اختر ZIP لتجربة واحدة. اختر Git إذا كنت تنوي مواصلة استخدام Sweepy.

أولًا، تحقق مما إذا كان Git مثبتًا بالفعل:

الطرفية
git --version

إذا ظهر رقم إصدار مثل git version 2.45.1، فلديك Git. إذا ظهر خطأ، فثبّت Git:

  1. زر git-scm.com/download/win.
  2. نزّل المثبّت وشغّله.
  3. اقبل كل الإعدادات الافتراضية واختر Install.
  4. أغلق طرفيتك وأعد فتحها، ثم أكّد:
الطرفية
PS C:\Users\YourName> git --version
git version 2.45.1

الآن نزّل Sweepy بتنفيذ:

الطرفية
git clone https://github.com/pvega62/sweepy.git

ينشئ هذا مجلدًا جديدًا باسم sweepy على حاسوبك. انتقل إليه:

الطرفية
cd sweepy
تلميح

يضع Git المجلد الجديد في المجلد الذي كانت طرفيتك تشير إليه عند تنفيذ الأمر. على Windows، تبدأ نافذة PowerShell جديدة في C:\Users\YourName\.

الخطوة 4: ثبّت التبعيات​

يعتمد Sweepy على مكتبات إضافية قليلة ليعمل:

  • pymupdf: يقرأ نص سيرتك الذاتية بصيغة PDF ويستخرجه.
  • python-docx: يقرأ السير الذاتية بصيغة .docx ويحوّلها.
  • python-jobspy: يستخرج بيانات منصات الوظائف بأمان دون الحاجة إلى مفتاح API.
  • beautifulsoup4: يحلل HTML من مصادر Greenhouse وLever وWorkable وBuilt In.
  • reportlab: ينشئ تقرير PDF المنسّق مع روابط قابلة للنقر.
  • requests: يرسل طلبات ويب للتحقق من أن الروابط ما زالت نشطة.
  • pyyaml وquestionary: يتوليان معالج التهيئة التفاعلي. ويوفر prompt-toolkit عناصر التحكم بلوحة المفاتيح.
  • pandas: ينظّم بيانات الوظائف المستخرجة ويبني تصديرات جداول CSV.
  • mcp وanyio: يشغّلان خادم بروتوكول سياق النموذج الاختياري الذي يربط Sweepy بمساعد ذكاء اصطناعي.
Python 3.13

إذا كنت تستخدم Python 3.13، فثبّت Microsoft C++ Build Tools أولًا واختر حمل العمل "Desktop development with C++". الإصدار Python 3.13 جديد بما يكفي لأن تُجمَّع بعض الحزم، مثل pymupdf، من المصدر وتحتاج إلى تلك الأدوات. تجاوز هذه الخطوة على Python 3.12 أو أقدم.

تغطي اختبارات Sweepy المؤتمتة Python 3.10 حتى 3.12. وتبقى تلك الإصدارات المسار الأسهل.

ثبّت كل الحزم بأمر واحد:

الطرفية
pip install -e .

يثبّت ذلك الأمر كل تبعية ويسجّل أمر sweepy في مجلد Python Scripts. أعد فتح طرفيتك مرة واحدة ليلتقط PATH المجلد الجديد. من ذلك الحين، نفّذ sweepy --run بدلًا من python swee.py --run. ونفّذ أيًا من الصيغتين من مجلد sweepy.

يمر النص أثناء تنزيل Python وتثبيت كل حزمة. وعندما يعود المؤشر يكون التثبيت مكتملًا.

تلميح

هل ظهر خطأ "command not found" للأمر pip؟ جرّب pip3 install -e . بدلًا منه. على بعض الأنظمة، يستخدم Python 3 الاسم pip3 كاسم للأمر.

تحقق من تثبيتك​

نفّذ هذا الفحص السريع لتأكيد التثبيت الصحيح لكل شيء:

الطرفية
sweepy --version

إذا لم تجد طرفيتك sweepy، فأعد فتح الطرفية أو نفّذ python swee.py --version بدلًا منه. سترى:

مخرجات الطرفية
Sweepy v3.0.0
Python 3.13.1 | pymupdf 1.28.2 | reportlab 5.0.1
Ready to sweep.

إذا ظهرت تلك الرسالة، فـ Sweepy جاهز. توقع أرقامًا مختلفة على جهازك. يطبع Sweepy الإصدار من ملف VERSION لديه، ويثبّت pip الحزم التي تطابق إصدار Python لديك.

يسرد السطر الثاني إصدارَي pymupdf وreportlab.

بعد ذلك، اضبط ملفك التعريفي المخصص للبحث عن وظيفة.