🔥 آموزش نصب FreeLLMAPI
🎯 این پروژه چیه؟
پروژهی FreeLLMAPI یه سرور محلیه که بیش از ۱۲ تا ارائهدهندهی هوش مصنوعی رایگان رو پشت یه اِندپوینت واحد سازگار با OpenAI جمع میکنه. به جای اینکه با ۱۲ تا SDK مختلف و ۱۲ تا rate limit مختلف دست و پنجه نرم کنی، فقط یه کانفیگ ساده میذاری و تمام — همه چیز خودکار مدیریت میشه.
🪄 اگه همهی ارائهدهندهها رو فعال کنی، هر ماه تقریباً ۱.۳ میلیارد توکن رایگان داری.
🤖 ارائهدهندههای پشتیبانیشده
• 🔵 گوگل Gemini — نسخهی 2.5 Flash و پیشنمایشهای 3.x
• ⚡ گروق (Groq) — مدلهای Llama 3.3، Llama 4 و Qwen3
• 🧠 سربراس (Cerebras) — مدل Qwen3 235B
• 🌐 سامبانووا (SambaNova) — مدلهای DeepSeek V3 و Llama 4
• 🌊 میسترال (Mistral) — مدلهای Large 3، Medium 3.5 و Codestral
• 🔀 اوپنروتر (OpenRouter) — ۲۱ مدل رایگان
• 📦 گیتهاب مدلز (GitHub Models) — مدلهای GPT-4.1 و GPT-4o
• ☁️ کلادفلر (Cloudflare) — مدلهای Kimi K2 و Granite 4
• 🤝 کوهر (Cohere) — مدل Command R+
• 🔷 زدداتای (Z.ai) — مدلهای GLM-4.5 و GLM-4.7
🛠️ پیشنیازها — قبل از شروع
قبل از هر چیز، باید این دوتا نرمافزار روی سیستمت نصب باشه:
• 🐳 داکر دسکتاپ (Docker Desktop) — از آدرس docker.com/products/docker-desktop دانلود کن
• 🟩 نودجیاس (Node.js) نسخهی ۲۰ به بالا — از آدرس nodejs.org دانلود کن
🍎 نصب روی مک (macOS)
ترمینال رو باز کن و مرحله به مرحله بریم:
📥 مرحله ۱ — کلون کردن پروژه
📄 مرحله ۲ — ساختن فایل تنظیمات
🔑 مرحله ۳ — ساختن کلید رمزنگاری
این کلید برای ذخیرهی امن کلیدهای API روی دیسک استفاده میشه. دستور زیر خودکار کلید میسازه و به فایل اضافه میکنه:
🐳 مرحله ۴ — اجرا با داکر
داکر ایمیج رو خودکار دانلود میکنه و سرور رو در پسزمینه اجرا میکنه. اولین بار ممکنه یه دقیقه طول بکشه.
🌐 مرحله ۵ — باز کردن داشبورد
مرورگر رو باز کن و آدرس زیر رو وارد کن: http://localhost:3001
🪟 نصب روی ویندوز (Windows)
پاورشل (PowerShell) رو به عنوان ادمین باز کن و مرحله به مرحله بریم:
📥 مرحله ۱ — کلون کردن پروژه
📄 مرحله ۲ — ساختن فایل تنظیمات
🔑 مرحله ۳ — ساختن کلید رمزنگاری
این دو دستور رو پشت سر هم توی پاورشل بزن:
🐳 مرحله ۴ — اجرا با داکر
🌐 مرحله ۵ — باز کردن داشبورد
مرورگر رو باز کن و آدرس زیر رو وارد کن: http://localhost:3001
🔑 اضافه کردن کلیدهای API
وقتی داشبورد باز شد، برای فعال کردن هر ارائهدهنده باید کلید رایگانشو اضافه کنی:
۱. صفحهی Keys رو باز کن
۲. برای هر ارائهدهندهای که حساب رایگان داری، کلیدشو وارد کن
۳. از صفحهی Fallback Chain ترتیب اولویت مدلها رو تنظیم کن
۴. کلید یکپارچهی خودت (unified key) رو از بالای همون صفحه بگیر — این کلیدیه که توی کدت استفاده میکنی
🌐 لینک ثبتنام ارائهدهندهها
• 🔵 گوگل → ai.google.dev
• ⚡ گروق → groq.com
• 🧠 سربراس → cerebras.ai
• 🌐 سامبانووا → cloud.sambanova.ai
• 🌊 میسترال → mistral.ai
• 🔀 اوپنروتر → openrouter.ai
• 📦 گیتهاب مدلز → github.com/marketplace/models
• ☁️ کلادفلر → developers.cloudflare.com/workers-ai
• 🔷 زدداتای → docs.z.ai
🚀 استفاده از API
بعد از نصب، هر کلاینت سازگار با OpenAI کار میکنه. فقط کافیه آدرس base_url رو عوض کنی:
پایتون (Python):
مدل auto بهترین مدل موجود رو خودش انتخاب میکنه. اگه یه ارائهدهنده محدودیت داشت یا خطا داد، خودکار به بعدی میره — تا ۲۰ بار تلاش میکنه.
⚠️ نکات مهم
• 🔒 این سرور فقط برای استفادهی شخصی طراحی شده — آدرسشو به اینترنت باز نکن!
• 🧠 مدلهای فرانتیر مثل Claude Opus یا GPT-4.5 اینجا نیستن — اینجا فقط تیرهای رایگانه
• 🔄 هر شب نیمهشب UTC، محدودیتهای روزانه ریست میشن
• ⛔ بعضی ارائهدهندهها مثل Cohere شرایط استفاده محدودتری دارن — قبل از استفاده حتماً بخونشون
• 🐙 لینک پروژه روی گیتهاب: github.com/tashfeenahmed/freellmapi
• اگر خیلی براتون سخته بدید به کلاد کوورک براتون انجام بده