x_nava for Python — Termux

مكتبة Python للتعامل مع WhatsApp عبر Baileys. هذه النسخة مناسبة لـ Termux على Android: لا تستخدم Node.js المضمّن الخاص بسطح المكتب، بل تعتمد على Node.js الذي يثبّته Termux.

غير تابعة لـ WhatsApp أو Meta. استخدمها وفق القوانين وشروط الخدمة، ولا تستخدمها للسبام.

التثبيت على Termux

pkg update -y
pkg install -y python nodejs-lts unzip
unzip x_nava-1.0.0-termux.zip
cd x_nava-1.0.0-termux
python -m pip install --upgrade pip
python -m pip install .

في أول تشغيل ستثبت المكتبة تلقائياً اعتماد Baileys داخل ~/.x_nava_runtime. للتثبيت اليدوي:

cd ~/.x_nava_runtime
npm install --no-audit --no-fund --save-exact

مثال سريع

import asyncio
from x_nava import MoXstarClient

async def main():
    client = MoXstarClient(auth_dir='./auth')
    client.on('qr', lambda code: print('QR:', code))
    client.on('ready', lambda _: print('x_nava جاهزة'))
    await client.start()
    await client.wait_until_ready()
    await client.wait_closed()

asyncio.run(main())

يمكن تحديد مسار Node يدوياً عبر متغير البيئة NAVAPRO_NODE، لكن الوضع الافتراضي يستخدم node الموجود في Termux.

ملاحظات Android/Termux

• استخدم nodejs-lts وليس نسخة Node مكتبية مضمّنة.
• يفضّل تعطيل تحسين البطارية لتطبيق Termux حتى لا ينقطع الاتصال في الخلفية.
• الاتصال الحي يحتاج QR أو Pairing Code ورقم WhatsApp حقيقي.
• اختبارات Python المحلية لا تتصل بواتساب.