الانتقال إلى المحتوى الرئيسي
Aider هو أداة برمجة زوجية بالذكاء الاصطناعي تحرّر مستودع git المحلي الخاص بك من الـ terminal. يعمل Venice عبر دعم Aider لـ API المتوافقة مع OpenAI — عيّن base URL الخاص بـ Venice ومفتاح API، ثم أضف البادئة openai/ لمعرّف النموذج.

البرمجة الزوجية في الـ Terminal

حرّر مستودع git الخاص بك بنماذج Venice من CLI

متوافق مع OpenAI

يستخدم endpoint /chat/completions الخاص بـ Venice

أي نموذج نصي

استبدل بأي معرّف نموذج نصي من Venice

​
المتطلبات

  • مفتاح Venice API من venice.ai/settings/api
  • Python 3.9+ متوفّر على جهازك
  • مستودع git للعمل فيه

​
الإعداد

1

ثبّت Aider

ثبّت Aider باستخدام المثبِّت الرسمي:
راجع وثائق تثبيت Aider إذا كنت تفضّل طريقة تثبيت أخرى.
2

اضبط Venice كـ endpoint خاص بـ OpenAI

وجّه Aider إلى Venice بتعيين base URL المتوافق مع OpenAI ومفتاح Venice API الخاص بك.Mac / Linux:
Windows (PowerShell):
Windows (Command Prompt، بشكل دائم):
أعد تشغيل الـ terminal بعد setx لتصبح المتغيرات الجديدة متاحة.
3

ابدأ Aider بنموذج Venice

من دليل مشروعك، أضف البادئة openai/ لمعرّف نموذج Venice:
نماذج بداية جيدة أخرى:
تصفّح جميع معرّفات النماذج النصية في كتالوج النماذج.

​
احفظ التكوين بشكل دائم باستخدام .env

للإعداد الخاص بالمشروع، أنشئ ملف .env في جذر مستودع git الخاص بك:
ثم ابدأ Aider بشكل طبيعي:
يقرأ Aider أيضًا .env من الدليل الرئيسي الخاص بك. تحظى قيم جذر المستودع بالأولوية على قيم الدليل الرئيسي. أبقِ هذا الملف خارج git — أضف .env إلى .gitignore إذا لم يكن مُتجاهَلًا بالفعل.
يمكنك أيضًا تعيين AIDER_OPENAI_API_BASE وAIDER_OPENAI_API_KEY. لا تزال وثائق Aider الرسمية توثّق OPENAI_API_BASE وOPENAI_API_KEY للموفّرين المتوافقين مع OpenAI.

​
احفظ التكوين بشكل دائم باستخدام YAML

يمكنك تخزين نفس الإعدادات في .aider.conf.yml في جذر المستودع أو في الدليل الرئيسي:
ثم شغّل:

​
التحقق من الإعداد

بعد بدء Aider، اطلب منه شيئًا صغيرًا يُثبت أن النموذج قابل للوصول:
إذا كان الـ endpoint والمفتاح صحيحين، سيقوم Aider بـ stream للاستجابة من نموذج Venice المختار. يمكنك أيضًا تأكيد مفتاح API خارج Aider:

​
اختيار النماذج

أضف دائمًا البادئة openai/ لمعرّفات نماذج Venice عند تشغيل Aider. بدون هذه البادئة، لن يوجّه Aider الطلب عبر مسار الموفّر المتوافق مع OpenAI. اكتشف معرّفات النماذج الحالية في وقت التشغيل:
أو راجع GET /models/traits للحصول على الافتراضيات مثل text:default.

​
ملاحظات التكوين

  • احتفظ بـ OPENAI_API_BASE مُعيَّنًا إلى https://api.venice.ai/api/v1. لا تُلحق /chat/completions؛ يضيف Aider مسار المحادثة بنفسه.
  • استخدم مفتاح Venice API في OPENAI_API_KEY. لا تستخدم مفتاح OpenAI مع base URL الخاص بـ Venice.
  • قد يحذّر Aider من أن النموذج يحتوي على نافذة سياق أو تكلفة غير معروفة. هذا التحذير متوقع للعديد من معرّفات نماذج Venice وعادةً ما يكون آمنًا تجاهله. راجع تحذيرات نماذج Aider.
  • فضّل نماذج البرمجة/الاستدلال القادرة للتعديلات متعددة الملفات. قد تواجه النماذج الأصغر أو غير المخصصة للبرمجة صعوبة مع تنسيقات تحرير Aider.
تعيين OPENAI_API_BASE وOPENAI_API_KEY في shell الخاص بك يؤثّر أيضًا على الأدوات الأخرى التي تقرأ هذه المتغيرات. فضّل .env خاص بالمشروع أو .aider.conf.yml إذا كنت تستخدم OpenAI في مكان آخر ضمن نفس البيئة.

​
استكشاف الأخطاء وإصلاحها

تأكّد من أن OPENAI_API_KEY هو مفتاح Venice من venice.ai/settings/api، بدون أي مسافات بيضاء إضافية. على Windows بعد setx، أعد تشغيل الـ terminal.
تأكّد من أن معرّف النموذج موجود في كتالوج النماذج النصية وأنك بدأت Aider بالبادئة openai/، على سبيل المثال openai/zai-org-glm-5-1.
تحقق من أن OPENAI_API_BASE هو تمامًا https://api.venice.ai/api/v1 في نفس جلسة shell. اطبعه باستخدام echo $OPENAI_API_BASE (أو $env:OPENAI_API_BASE في PowerShell).
متوقع للعديد من نماذج Venice. يعود Aider إلى افتراضيات معقولة. لإسكاته، أضف بيانات وصفية للنموذج كما هو موضح في الإعدادات المتقدمة لنموذج Aider.

​
الموارد

نماذج Venice النصية

تصفّح معرّفات نماذج Venice المتاحة

وثائق Aider المتوافقة مع OpenAI

إعداد الموفّر الرسمي لـ Aider

تكوين Aider مع .env

احفظ بشكل دائم مفاتيح API وإعدادات النموذج

مرجع Venice API

توثيق endpoint والمعاملات الكامل