بدّل الـ model دون أن تخسر الـ context

مرحبًا! 👋 إليك ما وعدتك به:

في كل مرة تصل فيها إلى حدود Claude وتنتقل إلى model آخر، تجد نفسك تشرح مشروعك من الصفر. FreeLLMAPI يحلّ هذه المشكلة.

FreeLLMAPI — router مجاني ومفتوح المصدر (MIT) يربط Claude Code بـ models مجانية كثيرة — Gemini وGLM وMistral وQwen وغيرها — في setup واحد. عندما يصل model إلى حدّه، ينتقل إلى الـ model التالي وحده، فتستمر الـ session.

الفرق: الـ handoff note. قبل التبديل، يضيف note قصيرة للـ model الجديد — "أنت تستلم مهمة جارية، لا تبدأها من جديد" مع ملخص لآخر المحادثة — فيفهم أين توقفت دون أن تعيد شرح أي شيء. ⚠️ هذه الميزة غير مفعّلة افتراضيًا: فعّلها في ملف .env:

FREELLMAPI_CONTEXT_HANDOFF=on_model_switch

الـ setup

1. ثبّته. على Windows، أسهل طريقة هي الـ installer بصيغة .exe من صفحة Releases:

على macOS/Linux (يحتاج Docker):

curl -fsSL https://freellmapi.co/install.sh | bash

2. افتح الـ dashboard وأضف الـ API keys المجانية للـ providers الذين تريدهم (Google، Mistral، OpenRouter، NVIDIA…).
3. اربط Claude Code بالـ unified key الموجود في الـ dashboard:

npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>

كن صريحًا مع نفسك

• "المجاني" يعتمد على free tiers لأطراف ثالثة: كل provider يحدد حدوده ويمكنه تغييرها أو إيقافها في أي وقت.
• المشروع نفسه يقول إنه للتجربة الشخصية والتعلّم، لا للـ production — لا frontier models، سرعة متغيّرة، ولا SLA.
• يحفظ الـ API keys الخاصة بك (مشفّرة) — اقرأ الـ repo قبل أن تثق به، وشروط كل provider التي وافقت عليها تبقى سارية.
• الـ router مجاني؛ والـ plan المدفوع "Premium" يعطيك فقط الـ models الجديدة في القائمة بشكل أسرع.