PuterAi python_SDK

puterai-python_sdk

يوفر Puterai Python SDK طريقة بسيطة للتفاعل مع API AI Puter من أجل تفاعلات chatbot وتوليد النص إلى كلام (TTS). يتيح لك SDK هذا دمج وظائف chatbot و tts في تطبيقاتك الخاصة.

سمات

• تفاعل chatbot : التواصل مع chatbot مدعوم من Puter AI.
• نص إلى كلام (TTS) : قم بتحويل أي نص إلى صوت باستخدام خدمة AWS Polly TTS.

هيكل المشروع

يتكون المشروع من مكونات متعددة:

• login.py : البرنامج النصي للتعامل مع تسجيل الدخول إلى المستخدم واسترداد رمز API لمزيد من الطلبات.
• cli.py : واجهة سطر الأوامر التي تتيح للمستخدمين التفاعل مع chatbot puter أو إنشاء إخراج TTS.
• server.py : خادم API المستند إلى Flask يعرض نقاط النهاية لوظائف chatbot و TTS.
• example.html : واجهة HTML بسيطة للتفاعل مع chatbot وإنشاء TTS عبر متصفح.

متطلبات

لتشغيل هذا المشروع ، تحتاج إلى تثبيت التبعيات التالية:

• requests : للتعامل مع طلبات HTTP.
• flask : لخادم API.
• flask_cors : للتعامل مع مشاركة الموارد عبر الأصل (CORS).
• dotenv : لتحميل متغيرات البيئة من ملف .env.

يمكنك تثبيت التبعيات المطلوبة مع:

pip install -r requirements.txt

تعليمات الإعداد

1. استنساخ المستودع

git clone https://github.com/mowhn/PuterAi-python_SDK.git
cd puterAi-python_SDK

2. إعداد.

قم بإنشاء ملف .env في كل من دلائل cli و API وتضمين api_token:

 API_TOKEN = your_api_token_here

3. احصل على رمز API

للحصول على API_TOKEN بسرعة ، يجب عليك أولاً تشغيل login.py لتسجيل الدخول واسترداد الرمز المميز:

• تشغيل login.py :

   cd cli
  python login.py

  سيؤدي ذلك إلى حثك على اسم المستخدم وكلمة المرور الخاصة بك ، وإذا نجح تسجيل الدخول ، فسيتم إخراج API_TOKEN . يمكنك نسخ هذا الرمز المميز ولصقه في ملف .env في كل من مجلدات cli و API .

  ملاحظة : إذا لم يكن لديك حساب Puter AI ، فيمكنك الاشتراك في

4. تشغيل المشروع

• قم بتشغيل خادم API:

   cd API
  python server.py

  سيبدأ هذا خادم Flask API على http://localhost:5000 .

• استخدم واجهة سطر الأوامر (CLI):

  للتفاعل مع chatbot أو إنشاء TTS من سطر الأوامر ، قم بتشغيل:

   cd cli
  python cli.py

5. مثال في الواجهة الأمامية

افتح ملف example.html في متصفح للتفاعل مع chatbot puter وإنشاء TTS:

• الدردشة مع الروبوت : أدخل رسالة وتلقي استجابة من الروبوت.
• إنشاء TTS : أدخل نص للتحويل إلى خطاب ، وتشغيل الصوت الذي تم إنشاؤه.

نقاط النهاية

تكشف API Flask عن نقاط النهاية التالية:

• Post /chat : يقبل كائن JSON مع حقل message ويعيد استجابة الروبوت.

  طلب مثال:

  {
    "message" : " Hello, bot! "
  }

• Post /tts : يقبل كائن JSON مع حقل text وإرجاع صوت TTS المقابل.

  طلب مثال:

  {
    "text" : " Hello, this is a test. "
  }

رخصة

تم ترخيص هذا المشروع بموجب ترخيص معهد ماساتشوستس للتكنولوجيا - راجع ملف الترخيص للحصول على التفاصيل.

---

استمتع بالبناء مع بودر!