rize_reader

قارئ Rize

هذا هو السيناريو Python المصاحب لفريز. يجمع البيانات من بريدك الإلكتروني ويخزنها في قاعدة بيانات Supabase.

المتطلبات الأساسية

قبل أن تبدأ ، تأكد من أن لديك ما يلي:

• Python: يتطلب البرنامج النصي تثبيت Python على جهازك. يمكنك تنزيله من python.org.
• بيانات اعتماد Gmail API: اتبع الإرشادات الواردة في دليل Gmail API Python QuickStart لإعداد مشروع Google Cloud الخاص بك والحصول على بيانات الاعتماد.
• حساب supabase: اشترك في حساب supabase لإنشاء قاعدة بيانات والحصول على SUPABASE_URL و SUPABASE_API_KEY للوصول إلى API.
• Openai API Key: احصل على مفتاح API من Openai حيث سنستخدمه لإنشاء تضمينات لبياناتنا.

تثبيت

1. استنساخ هذا المستودع على جهازك المحلي

   git clone https://github.com/rittikbasu/rize_reader.git

2. انتقل إلى دليل المشروع

    cd rize_reader

3. إنشاء بيئة افتراضية

   python3 -m venv venv

4. تثبيت التبعيات

   pip3 install -r requirements.txt

5. تنشيط البيئة الافتراضية
   • لماكوس/لينكس:

      source venv/bin/activate

   • لنظام التشغيل Windows:

     venv S cripts a ctivate

6. تصدير متغيرات البيئة المطلوبة في المحطة الخاصة بك

    export SUPABASE_URL=YOUR_SUPABASE_URL SUPABASE_API_KEY=YOUR_SUPABASE_API_KEY OPENAI_API_KEY=YOUR_OPENAI_API_KEY RIZE_MAIL_ID=YOUR_RIZE_MAIL_ID

   ملاحظة: ضع عنوان البريد الذي تستلمه رسائل البريد الإلكتروني الخاصة بك من RIZE_MAIL_ID .
7. احفظ بيانات اعتماد واجهة برمجة تطبيقات Gmail في نفس الدليل مثل main.py وقم بإعادة تسميتها إلى credentials.json .
8. تشغيل البرنامج النصي

   python3 main.py

9. سيُطلب منك تفويض البرنامج النصي للوصول إلى حساب Gmail الخاص بك. قد تحتاج إلى إضافة Redirect_uri إلى شاشة موافقة Oauth الخاصة بك. يمكنك القيام بذلك عن طريق إضافة Redirect_uri المطلوبة إلى قائمة URIs المعتمدة في شاشة موافقة OAUTH في وحدة التحكم السحابية من Google.
10. سيبدأ البرنامج النصي في جمع البيانات من بريدك الإلكتروني وتخزينه في قاعدة بيانات Supabase الخاصة بك. يمكنك عرض البيانات في لوحة معلومات Supabase الخاصة بك.

ملاحظة: إذا كنت تستخدم بالفعل Rize لفترة من الوقت ، فانتقل إلى حساب Gmail الخاص بك وابحث عن Rize والحصول على إجمالي عدد رسائل البريد الإلكتروني. ثم انتقل إلى main.py وقم بتغيير قيمة max_results إلى إجمالي عدد رسائل البريد الإلكتروني التي لديك. سيضمن ذلك أن يقوم البرنامج النصي بجمع جميع بياناتك السابقة أيضًا. بمجرد الانتهاء من تشغيل البرنامج النصي ، يمكنك تغيير قيمة max_results إلى 1.

الأتمتة

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

1. افتح المحطة الخاصة بك واكتب crontab -e لفتح طاولة الكرون.
2. احصل على المسار إلى Python3 القابل للتنفيذ في بيئتك الافتراضية عن طريق تشغيل which python3 في المحطة الخاصة بك ونسخه.
3. أضف السطر التالي إلى جدول كرون:

    00 00 * * * /path/to/venv/bin/python3 /path/to/rize_reader/main.py

   هذا سيدير ​​البرنامج النصي كل يوم في الساعة 12:00 صباحًا.
4. استخدم مسارًا مطلقًا لملف credentials.json main.py

ملحوظة

• استبدل /path/to/rize_reader بالمسار إلى دليل rize_reader و /path/to/venv/bin/python3 مع المسار إلى python3 القابل للتنفيذ في بيئتك الافتراضية.
• إذا حصلت على خطأ حيث لا يمكن العثور على متغيرات البيئة ، فقم بالإعلان عن المتغيرات في أعلى جدول CRON.

المساهمة

المساهمات دائما موضع ترحيب! لا تتردد في فتح مشكلة أو تقديم طلب سحب إذا كان لديك أي أفكار أو اقتراحات.