Agent2API ابتدائی رہنما: ڈیسک ٹاپ AI لاگ اِن اسٹیٹس کو OpenAI سے ہم آہنگ گیٹ وے سے جوڑیں

Agent2API کیا ہے

Agent2API ایک مقامی AI API گیٹ وے ہے، جو متعدد AI ڈیسک ٹاپ کلائنٹس میں پہلے سے لاگ اِن اکاؤنٹس کو یکجا کرتا ہے اور متحدہ OpenAI-مطابق انٹرفیس کے ذریعے ماڈل کال کرنے کی سہولت فراہم کرتا ہے۔ اگر کلائنٹ حسبِ ضرورت base_url کی حمایت کرتا ہو تو اسے http://127.0.0.1:3065/v1 سے منسلک کیا جا سکتا ہے۔ عموماً اپ اسٹریم API Key یا کلائنٹ میں ترمیم کی ضرورت نہیں ہوتی۔

پروجیکٹ Chat، Responses اور Messages تینوں پروٹوکولز کی حمایت کرتا ہے، اور /v1/models ماڈل فہرست کا انٹرفیس فراہم کرتا ہے۔ گیٹ وے آپ کے مقامی کمپیوٹر یا تعینات کردہ سرور پر چلتا ہے، جبکہ اکاؤنٹ کا کوٹہ متعلقہ اکاؤنٹ ہی سے آتا ہے۔

بنیادی خصوصیات کا جائزہ

• OpenAI-مطابق انٹرفیس: /v1/chat/completions، /v1/responses اور /v1/messages کی حمایت؛ Messages میں count_tokens بھی شامل ہے۔
• متعدد فراہم کنندگان: WorkBuddy، 小浣熊، CatPaw، Qoder، Trae سمیت متعدد فراہم کنندگان پہلے سے شامل ہیں، اور حسبِ ضرورت فراہم کنندگان بھی ترتیب دیے جا سکتے ہیں۔
• اکاؤنٹ گردش: اکاؤنٹس ترجیح کے مطابق قطار میں رکھے جاتے ہیں۔ 429 آنے پر اکاؤنٹ تبدیل کیا جا سکتا ہے، جبکہ حدِ استعمال کی کول ڈاؤن مدت میں موجود اکاؤنٹس دوبارہ استعمال نہیں ہوتے۔
• اسناد کی دیکھ بھال: کچھ فراہم کنندگان Token کی خودکار تجدید، قریب المنقضی اسناد کی بیچ ریفریش اور ماڈل کیٹلاگ ریفریش کی حمایت کرتے ہیں۔
• نیٹ ورک اور سکیورٹی: اکاؤنٹس کے لیے الگ الگ آؤٹ باؤنڈ پراکسی اور متعدد گیٹ وے Keys کے ذریعے اجازتوں کی تقسیم کی سہولت۔
• آپریشنل انتظام: درخواستوں کی تعداد، کامیابی کی شرح، Token خرچ، کیش ہٹ ریٹ اور طویل مدتی ہیٹ میپ سمیت رپورٹس۔
• شیڈول شدہ کام: خودکار چیک اِن، اسناد کی دیکھ بھال اور ماڈل کیٹلاگ ریفریش کے کاموں کا انتظام۔

تعیناتی کا طریقہ منتخب کریں

Agent2API تین شکلوں میں دستیاب ہے۔ ڈیسک ٹاپ ورژن ذاتی کمپیوٹر کے لیے موزوں ہے، Windows، macOS اور Linux کی حمایت کرتا ہے اور سسٹم ٹرے میں مستقل چل سکتا ہے؛ سرور ورژن گرافیکل انٹرفیس کے بغیر Windows Server یا Linux ماحول کے لیے موزوں ہے؛ Docker پہلے سے کنٹینر ماحول رکھنے والے صارفین کے لیے موزوں ہے۔ تینوں طریقوں میں رن ٹائم کے دوران Node.js نصب کرنے کی ضرورت نہیں ہوتی۔

• ڈیسک ٹاپ: انسٹالر کے ذریعے ایپلیکیشن شروع کریں؛ گیٹ وے ایپلیکیشن کے عمل میں چلتا ہے۔
• سرور: اسے سسٹم سروس کے طور پر نصب کریں، براؤزر سے انتظامی پینل کھولیں، اور سسٹم شروع ہونے پر خودکار اجرا کی حمایت حاصل کریں۔
• Docker: aimodcc/agent2api:latest امیج استعمال کریں؛ amd64 اور arm64 کی حمایت حاصل ہے۔

تنصیب اور پہلی ترتیب

طریقہ اول: ڈیسک ٹاپ

پروجیکٹ کی تازہ ترین ریلیزز سے اپنے سسٹم کے لیے موزوں انسٹالر ڈاؤن لوڈ کریں۔ شروع کرنے کے بعد “اکاؤنٹس” صفحے پر جائیں اور ایک یا زیادہ فراہم کنندگان کے اکاؤنٹس شامل کریں۔ ڈیسک ٹاپ گیٹ وے پہلے سے مقامی مشین کے 3065 پورٹ پر سن رہا ہوتا ہے۔

طریقہ دوم: Linux سرور

tar -xzf agent2api-server-linux-amd64.tar.gz && cd agent2api-server-linux-amd64 && sudo bash install.sh

تنصیب مکمل ہونے کے بعد براؤزر سے http://127.0.0.1:3065/ کھولیں۔ اگر سروس ریموٹ میزبان پر چل رہی ہو تو پتے میں موجود میزبان نام کو سرور کے IP یا ڈومین نام سے تبدیل کریں۔

طریقہ سوم: Windows Server

Expand-Archive agent2api-server-windows-amd64.zip -DestinationPath C:\agent2api-pkg
cd C:\agent2api-pkg
.\install-service.ps1

مندرجہ بالا کمانڈز ایڈمنسٹریٹر PowerShell میں چلائیں۔ انسٹالیشن اسکرپٹ سروس کو سسٹم میں رجسٹر کر دے گا۔

طریقہ چہارم: Docker

docker run -d --name agent2api --restart unless-stopped -p 3065:3065 -v ./data:/data aimodcc/agent2api:latest

یہاں ./data:/data ترتیب اور اکاؤنٹ کے ڈیٹا کو مستقل رکھنے کے لیے استعمال ہوتا ہے۔ کنٹینر شروع ہونے کے بعد ابتدائی ترتیب مکمل کرنے کے لیے http://127.0.0.1:3065/ کھولیں۔

ایڈمنسٹریٹر اور گیٹ وے Key کی ابتدائی ترتیب

1. انتظامی پینل کھولیں اور ایڈمنسٹریٹر اکاؤنٹ رجسٹر کریں۔
2. “گیٹ وے Key” صفحے پر جائیں اور کلائنٹ کالز کے لیے ایک Key بنائیں۔
3. “اکاؤنٹس” صفحے پر جائیں، فراہم کنندہ اور ورژن منتخب کریں، پھر صفحے کے مراحل کے مطابق ویب لاگ اِن مکمل کریں یا لاگ اِن سیشن درآمد کریں۔
4. تصدیق کریں کہ اکاؤنٹ کی حالت، میعاد اور بیلنس کی معلومات درست ہیں۔
5. “ماڈل انتظام” صفحے پر دستیاب ماڈلز اور ماڈل میپنگ چیک کریں۔

اگر گیٹ وے Key ترتیب نہ دی گئی ہو تو پروجیکٹ پہلے سے API درخواستوں کو مسترد کرتا ہے۔ گیٹ وے Key کو عوامی کوڈ، لاگز یا غیر معتبر کلائنٹس میں ظاہر نہ کریں۔

اکاؤنٹس اور ماڈلز ترتیب دیں

اکاؤنٹ انتظامی صفحے پر اکاؤنٹ کی میعاد، بیلنس، عالمی قطار اور ماڈل کے لحاظ سے حدِ استعمال کی کول ڈاؤن حالت دیکھی جا سکتی ہے۔ متعدد اکاؤنٹس شامل کرنے کے بعد سسٹم ترجیح کے مطابق شیڈول کرتا ہے؛ جب کوئی اکاؤنٹ 429 کا سامنا کرے یا کول ڈاؤن حالت میں داخل ہو جائے تو دوسرے دستیاب اکاؤنٹ پر منتقل کیا جا سکتا ہے۔

ماڈل انتظامی صفحہ فراہم کنندہ کے لحاظ سے ماڈل فہرست، ملٹی پلائر، کانٹیکسٹ کی معلومات اور میپنگ تعلقات دکھاتا ہے۔ جو فراہم کنندگان ماڈل فہرست آن لائن خودکار طور پر حاصل کرنے کی حمایت کرتے ہیں، ان کی فہرست باقاعدگی سے ریفریش ہوتی ہے؛ بعض پلیٹ فارمز متبادل کے طور پر اندرونی جامد جدول بھی فراہم کرتے ہیں۔

پہلی API کال

حسبِ ضرورت API ایڈریس کی حمایت کرنے والے کلائنٹ میں Base URL کو اس قدر پر سیٹ کریں:

http://127.0.0.1:3065/v1

API Key میں ابھی بنائی گئی گیٹ وے Key درج کریں۔ مثال کے طور پر sk-local کو نمونہ قدر کے طور پر استعمال کیا جا سکتا ہے، لیکن حقیقی کال کے وقت پینل میں تیار کردہ Key استعمال کریں۔

پہلے گیٹ وے کی صحت کی حالت چیک کریں:

curl http://127.0.0.1:3065/health

پھر ماڈل فہرست دیکھیں:

curl http://127.0.0.1:3065/v1/models \
  -H "Authorization: Bearer YOUR_GATEWAY_KEY"

Chat Completions انٹرفیس کال کرنے کی مثال:

curl http://127.0.0.1:3065/v1/chat/completions \
  -H "Authorization: Bearer YOUR_GATEWAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "ہیلو، براہِ کرم اپنا تعارف کرائیں۔"}
    ]
  }'

YOUR_GATEWAY_KEY کو گیٹ وے Key سے اور YOUR_MODEL_ID کو /v1/models سے واپس آنے والی ماڈل ID سے تبدیل کریں۔ Responses اور Messages پروٹوکول بھی یہی گیٹ وے ایڈریس استعمال کرتے ہیں؛ مخصوص درخواست کے فیلڈز متعلقہ کلائنٹ یا پروٹوکول کے فارمیٹ کے مطابق ہونے چاہییں۔

متعدد اکاؤنٹس، پراکسی اور شیڈول شدہ کام

متعدد اکاؤنٹس کی گردش

ایک ہی فراہم کنندہ کے لیے متعدد اکاؤنٹس شامل کرنے کے بعد عالمی ترجیحی قطار اور 429 ڈاؤن گریڈ میکانزم سے دستیابی بہتر بنائی جا سکتی ہے۔ اکاؤنٹ کے کوٹے، میعاد اور استعمال کے منظرنامے کے مطابق مناسب ترجیح مقرر کرنے اور کول ڈاؤن میں موجود اکاؤنٹس کی باقاعدہ جانچ کی سفارش کی جاتی ہے۔

آؤٹ باؤنڈ پراکسی

پروجیکٹ ہر اکاؤنٹ کے لیے الگ ایگزٹ ترتیب دینے کی حمایت کرتا ہے۔ یہ خصوصیت ان حالات کے لیے موزوں ہے جہاں مختلف اکاؤنٹس کے آؤٹ باؤنڈ نیٹ ورک کو الگ الگ منظم کرنا ہو، تاہم پراکسی کی دستیابی، تعمیل اور اکاؤنٹ کے رسک کنٹرول سے متعلق خطرات کا جائزہ صارف کو خود لینا ہوگا۔

شیڈول شدہ کام

کاموں کے انتظامی صفحے پر خودکار چیک اِن، اسناد کی دیکھ بھال اور ماڈل کیٹلاگ ریفریش کو یکجا طور پر منظم کیا جا سکتا ہے، اور کام کے سوئچ اور عمل درآمد کا وقفہ مقرر کیا جا سکتا ہے۔ یاد رکھیں کہ مختلف فراہم کنندگان کی حمایت کردہ صلاحیتیں مختلف ہوتی ہیں؛ مثال کے طور پر کچھ پلیٹ فارمز Token کی تجدید، چیک اِن یا بیلنس استفسار کی حمایت نہیں کرتے۔

رپورٹس اور استعمال دیکھیں

رپورٹس کے صفحے پر درخواستوں کی تعداد، کامیابی کی شرح، کل Token، مقبول ماڈلز اور اکاؤنٹ رینکنگ دیکھی جا سکتی ہے، اور فراہم کنندگان کے استعمال کی تقسیم بھی دیکھی جا سکتی ہے۔ رجحانات کا صفحہ 24 گھنٹے کا کیش ہٹ ریٹ، Token خرچ اور روزانہ کے حساب سے مرتب کردہ ڈیٹا دکھاتا ہے۔

اگر فراہم کنندہ بیلنس یا استعمال کے استفسار کی حمایت کرتا ہو تو متعلقہ معلومات اکاؤنٹ صفحے پر براہِ راست دیکھی جا سکتی ہیں۔ چیک اِن مرکز چیک اِن کے جائزے اور روزانہ چیک اِن گروپس دیکھنے کے لیے استعمال ہوتا ہے۔

ترقی اور بلڈ کے نکات

اگر سورس کوڈ سے ڈیسک ٹاپ ورژن بنانا ہو تو ماحول کے لیے Rust 1.77 یا اس سے نیا ورژن، Tauri 2 ٹول چین اور Node.js 18.17 یا اس سے نیا ورژن درکار ہے۔ Node.js صرف فرنٹ اینڈ بلڈ اور Tauri اسکرپٹس کے لیے استعمال ہوتا ہے؛ پیک کیے گئے ڈیسک ٹاپ ورژن کے رن ٹائم میں Node.js کی ضرورت نہیں ہوتی۔

npm run tauri:install
npm run tauri:dev
npm run tauri:build
npm run build:icon

اس میں، tauri:dev کو ڈیولپمنٹ موڈ اور ہاٹ ری لوڈ کے لیے، جبکہ tauri:build کو ڈیسک ٹاپ انسٹالیشن پیکیج بنانے کے لیے استعمال کیا جاتا ہے۔ macOS کی DMG صرف macOS پر بنائی جا سکتی ہے، Windows سے کراس کمپائل نہیں کی جا سکتی؛ حتمی بلڈ پروجیکٹ کے CI ورک فلو کے ذریعے تیار کی جاتی ہے۔

اسناد کی حفاظت اور استعمال کی حدود

Agent2API صرف سیکھنے اور تبادلے کے لیے ہے۔ یہ غیر سرکاری کلائنٹ کی صورت میں آپ کے اپنے اکاؤنٹ کی لاگ اِن حالت کو دوبارہ استعمال کرتا ہے، جو ممکن ہے کہ upstream سروس کی شرائطِ استعمال سے مطابقت نہ رکھتا ہو۔ اکاؤنٹ پر شرح کی پابندی، رسک کنٹرول، منجمد کیے جانے یا پابندی عائد ہونے سمیت دیگر خطرات کی ذمہ داری صارف پر ہے۔

پروجیکٹ accessToken، refreshToken اور دیگر اکاؤنٹ اسناد کو مقامی کنفیگریشن ڈائریکٹری میں سادہ متن کی صورت میں محفوظ کرتا ہے، جس کا طے شدہ مقام ~/.agent2api/ ہے۔ برآمد کی گئی فائلوں میں بھی سادہ متن کی اسناد شامل ہو سکتی ہیں، اس لیے کنفیگریشن کو عوامی ریپوزٹری میں جمع نہ کریں، کلاؤڈ ڈرائیو پر اپ لوڈ نہ کریں اور دوسروں کے ساتھ شیئر نہ کریں۔

README میں واضح طور پر پروجیکٹ کو تجارتی مقاصد، دوبارہ تقسیم کے ذریعے منافع کمانے، بڑی تعداد میں اکاؤنٹس چلانے، upstream کی فیس یا کوٹے کی پابندیوں سے بچنے، یا قوانین و ضوابط کی خلاف ورزی کرنے والی دیگر سرگرمیوں کے لیے استعمال کرنے سے منع کیا گیا ہے۔ پیداواری یا تجارتی ماحول میں upstream کے سرکاری ذرائع اور سرکاری API استعمال کیے جانے چاہییں۔ استعمال سے پہلے LICENSE اور استعمال کا بیان پڑھیں۔

اختتامیہ

Agent2API متعدد ڈیسک ٹاپ کلائنٹس کے اکاؤنٹس کو ایک مقامی OpenAI سے مطابقت رکھنے والے گیٹ وے میں یکجا کرتا ہے۔ تعیناتی مکمل کرنے، اکاؤنٹس شامل کرنے اور گیٹ وے Key بنانے کے بعد، آپ base_url کے ذریعے ایسے ٹولز سے جڑ سکتے ہیں جو حسبِ ضرورت API ایڈریس کی معاونت کرتے ہیں؛ متعدد اکاؤنٹس کی باری باری گردش، ماڈل مینجمنٹ، پراکسی، شیڈول شدہ کام اور رپورٹس مزید مقامی انتظامی ضروریات کے لیے موزوں ہیں۔ استعمال کے دوران اسناد کی مناسب حفاظت کریں اور upstream سروس کی شرائط و ضوابط اور پروجیکٹ کے اضافی استعمال کے بیان کی سختی سے پابندی کریں۔