navax 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 navax-1.0.0-termux.zip
cd navax-1.0.0-termux
python -m pip install --upgrade pip
python -m pip install .

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

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

مثال سريع

import asyncio
from navax import MoXstarClient

async def main():
    client = MoXstarClient(auth_dir='./auth')
    client.on('qr', lambda code: print('QR:', code))
    client.on('ready', lambda _: print('navax جاهزة'))
    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 المحلية لا تتصل بواتساب.