نصب و شروع

کمتر از ۳۰ ثانیه: نصب، ورود، اولین پرسش.

پیش‌نیازها

  • سیستم‌عامل: 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

برای جزئیات بیشتر دربارهٔ اینکه پشت پرده چه اتفاقی میفته: ورود با شمارهٔ موبایل.

اولین اجرا

  1. توی دایرکتوری پروژه‌ای که می‌خوای روش کار کنی cd کن.
  2. aira رو اجرا کن — نشست تعاملی شروع می‌شه.
  3. سؤالت رو فارسی یا انگلیسی بپرس. مثال: «این کدبیس رو خلاصه کن».
  4. برای خروج Ctrl+C دوتایی.

حالت یک‌بارمصرف (headless)

# یک پرامپت، یک خروجی روی stdout
aira -p "این فایل auth/router.py چیکار می‌کنه؟"

# با مدل بهتر برای کارهای پیچیده
aira --model aira-pro -p "این تابع رو refactor کن تا async باشه"

# خروجی JSON برای اسکریپت‌نویسی
aira -p "تست‌ها رو اجرا کن" --output-format json

قدم بعدی