پرش به مطلب اصلی

اتصال Aider به چابکان

Aider چیست؟​

Aider یک ابزار pair programming مبتنی بر هوش مصنوعی در ترمینال است. این ابزار برای کار مستقیم روی repositoryهای Git طراحی شده و می‌تواند فایل‌های مشخص را وارد گفتگو کند، نقشه فشرده‌ای از codebase بسازد، تغییرات کد تولید کند و نتیجه را با diff و commit قابل پیگیری نگه دارد. Aider علاوه بر حالت ویرایش، حالت ask و architect نیز دارد تا ابتدا درباره مسئله گفتگو یا برنامه‌ریزی کنید.

اتصال Aider به چابکان از مسیر OpenAI-compatible انجام می‌شود. این انتخاب برای توسعه‌دهندگانی مناسب است که محیط ترمینال، کنترل دقیق فایل‌های واردشده به context و workflow مبتنی بر Git را ترجیح می‌دهند.

کاربردهای رایج Aider​

  • رفع bug در چند فایل مرتبط؛
  • refactor کنترل‌شده همراه با diff؛
  • تولید تست و اجرای lint یا test؛
  • ساخت قابلیت از روی specification؛
  • پرسش درباره repository بدون ویرایش در حالت ask.

فقط فایل‌های لازم را به گفتگو اضافه کنید. context بزرگ‌تر همیشه نتیجه بهتر نمی‌دهد و می‌تواند هزینه و احتمال سردرگمی مدل را افزایش دهد.

۱. نصب Aider​

python -m pip install aider-install
aider-install
aider --version

۲. تنظیم endpoint و کلید​

macOS، Linux و WSL:

export OPENAI_API_BASE="https://ai.chabokan.net/v1"
export OPENAI_API_KEY="sk-chbk-کلید-واقعی-شما"

PowerShell:

$env:OPENAI_API_BASE = "https://ai.chabokan.net/v1"
$env:OPENAI_API_KEY = "sk-chbk-کلید-واقعی-شما"

۳. اجرای Aider در پروژه​

cd /path/to/your/project
aider --model "openai/openai/gpt-4o-mini"

در این دستور:

  • openai/ اول به Aider می‌گوید از provider سازگار با OpenAI استفاده کند.
  • openai/gpt-4o-mini شناسه نمونه مدل در چابکان است.

بنابراین اگر شناسه پنل شما vendor/model-name است، دستور به صورت openai/vendor/model-name خواهد بود.

۴. اولین آزمون​

در محیط Aider بنویسید:

ساختار پروژه را توضیح بده و هیچ فایلی را تغییر نده.

اگر Aider درباره ناشناخته‌بودن metadata مدل هشدار داد اما اتصال برقرار بود، شناسه را دوباره بررسی کنید. مدل‌های جدید ممکن است هنوز در فهرست داخلی Aider شناخته نشده باشند.

تنظیم اختیاری پروژه​

می‌توانید فایل .aider.conf.yml را در ریشه پروژه بسازید:

model: openai/openai/gpt-4o-mini
openai-api-base: https://ai.chabokan.net/v1

کلید را در این فایل ننویسید؛ آن را در متغیر OPENAI_API_KEY نگه دارید.

منبع: OpenAI-compatible APIs در مستندات Aider