نصب و شروع
کمتر از ۳۰ ثانیه: نصب، ورود، اولین پرسش.
پیشنیازها
- سیستمعامل: macOS، Linux، یا WSL ۲ روی Windows.
- یه شمارهٔ موبایل ایرانی برای ورود به آیراچت (یا کلید API headless).
- اینترنت داخل ایران کافیه — نیازی به VPN نیست.
- Bun ۱.۳ به بالا. اگه نداری اسکریپت نصب خودش برات نصب میکنه.
نصب یکخطی
اسکریپت نصب رسمی، با پیشفرض میرور Runflare برای دسترسی از ایران:
curl -fsSL https://airachat.ir/install.sh | bash
اگه دسترسی بینالمللی داری و میخوای مستقیم از npmjs.com بکشی:
curl -fsSL https://airachat.ir/install.sh | bash -s -- --direct
تأیید نصب
aira --version # AiraCode 0.1.0 (build 2026-05-17) aira --help
ورود
مرورگرت رو باز میکنه و فلوی OAuth رو روی airachat.ir اجرا میکنه — شمارهٔ موبایلت، کد یکبارمصرف، تموم.
aira login
برای جزئیات بیشتر دربارهٔ اینکه پشت پرده چه اتفاقی میفته: ورود با شمارهٔ موبایل.
اولین اجرا
- توی دایرکتوری پروژهای که میخوای روش کار کنی
cdکن. airaرو اجرا کن — نشست تعاملی شروع میشه.- سؤالت رو فارسی یا انگلیسی بپرس. مثال: «این کدبیس رو خلاصه کن».
- برای خروج Ctrl+C دوتایی.
حالت یکبارمصرف (headless)
# یک پرامپت، یک خروجی روی stdout aira -p "این فایل auth/router.py چیکار میکنه؟" # با مدل بهتر برای کارهای پیچیده aira --model aira-pro -p "این تابع رو refactor کن تا async باشه" # خروجی JSON برای اسکریپتنویسی aira -p "تستها رو اجرا کن" --output-format json
قدم بعدی
- انتخاب مدل — کدوم alias برای چی مناسبه.
- حافظهٔ CogX — چطور AiraCode از پروژههات یاد میگیره.
- فرمانها — تمام slash commandهای موجود.