عیب‌یابی

نصب

«aira: command not found» بعد از نصب پیش‌فرض

نصب‌کنندهٔ پیش‌فرضِ باینری مستقل، باینری رو در ~/.airacode/binقرار می‌ده. اگه shell فعلیت PATH رو refresh نکرده، دستی اضافه‌ش کن:

export PATH="$HOME/.airacode/bin:$PATH"

# Persist it in ~/.zshrc or ~/.bashrc:
echo 'export PATH="$HOME/.airacode/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

«bun: command not found» بعد از نصب با --bun

مسیر Bun/npm فقط وقتی استفاده می‌شه که --bun رو پاس بدی یا مسیر باینری مستقل fallback بشه. توی اون حالت، Bun معمولاً در~/.bun/bin قرار داره.

export PATH="$HOME/.bun/bin:$PATH"

# Persist it in ~/.zshrc or ~/.bashrc:
echo 'export PATH="$HOME/.bun/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

«401 Unauthorized» روی @airachat/airacode

میرور npm منطقه‌ای ممکنه چند ثانیه عقب باشه. اگه عمداً مسیر Bun/npm رو می‌خوای، انتخاب میرور رو دور بزن و مستقیم به npm بزن:

curl -fsSL https://airacode.ir/install.sh | bash -s -- --bun --direct

ورود

کد پیامک نمی‌رسه

• شماره رو با فرمت 09xxxxxxxxx یا +989xxxxxxxxx وارد کن.
• بعضی اپراتورها پیامک‌های سرویسی رو فیلتر می‌کنن. اگه کد اصلاً نرسید، یک شمارهٔ دیگه امتحان کن.
• flow ورود rate-limit داره. صبر کن، یا برای اجراهای headless از AIRA_API_KEY استفاده کن.

مرورگر روی SSH، WSL یا Docker باز نمی‌شه

aira login مبتنی بر مرورگر به یک محیط دسکتاپ تعاملی نیاز داره. برای محیط‌های headless، از آیراچت یک توکن بساز و export کن:

export AIRA_API_KEY=ey...

«invalid_grant» موقع refresh

refresh token منقضی شده. دوباره aira login رو اجرا کن، یا برای اتوماسیون headless یک AIRA_API_KEY تازه ست کن.

Gateway / شبکه

«502 Bad Gateway» روی هر درخواست

مدل upstream انتخاب‌شده از Gateway در دسترس نیست. معمولاً یک مشکل موقتِ upstream یا routing‌ست.

• وضعیت رو از airachat.ir/status چک کن.
• برای bypass موقت، AIRA_GATEWAY_BASE_URL رو روی یک Gateway سازگار با Messages که خودت کنترل می‌کنی تنظیم کن.

«model_not_allowed»

مدلی که درخواست کردی داخل allowlist‌ Gateway نیست.

# List allowed models:
curl -H "Authorization: Bearer $AIRA_API_KEY" \
  https://app.airachat.ir/api/airacode/gateway/v1/models

# Server operators can add a temporary model without a deploy:
export AIRACODE_GW_EXTRA_MODELS=new-provider/new-model

از ایران بدون VPN کار می‌کنه؟

بله. مسیر نصب پیش‌فرض (دانلود باینری از airacode.ir) و استفاده از Gateway، از داخل ایران بدون VPN کار می‌کنن: airacode.ir و app.airachat.ir از ایران در دسترسن، و ارتباط تحریمی با provider سمت سرور انجام می‌شه، نه روی دستگاه تو.

• اگه درخواست‌ها خطا می‌دن، اول در دسترس‌بودن app.airachat.ir رو چک کن.
• تنها جایی که ممکنه VPN لازم بشه، مسیر نصبِ fallback با --directست (که Bun رو از bun.sh بین‌المللی می‌گیره). حالت پیش‌فرض از میرورِ داخلی استفاده می‌کنه و نیازی نداره — پس اگه نصب گیر کرد، به‌جای --direct از باینری پیش‌فرض یا --iran استفاده کن.

اعتبار کافی نیست (402)

اعتبار AiraCredit‌ت تموم شده. با airacode.ir/console/topup شارژ کن یا اشتراکت رو ارتقا بده. کارت درخواستی از دست نمی‌ره — بعد از شارژ دوباره اجرا کن. جزئیات پلن‌ها و تیر رایگان در قیمت‌گذاری و اعتبار.

حافظه

حافظهٔ راه‌دور CogX پاسخ نمی‌ده

• AIRA_REMOTE_MEMORY به‌صورت پیش‌فرض فعاله. مطمئن شو روی 0، false، off، no یا مقدار خالی ست نشده باشه.
• احراز هویت رو با aira whoami چک کن. حافظهٔ راه‌دور به aira login یا AIRA_API_KEY نیاز داره.
• وقتی API راه‌دور در دسترس نباشه، AiraCode به حافظهٔ فایل‌سیستم local برمی‌گرده؛ پس کارکردن CLI هنوز می‌تونه یعنی سرور حافظه موقتاً down شده.

حافظه‌ها بین دستگاه‌ها sync نمی‌شن

مطمئن شو هر دو دستگاه از یک حساب و یک slug پروژه استفاده می‌کنن. اگه اسم پوشهٔ مخزن فرق داره، قبل از ساختن حافظه‌های جدید روی هر دستگاه همونAIRA_PROJECT_SLUG رو ست کن.

نسخه و آپدیت

مسیر auto-updater به‌صورت opt-in‌ست. فرمان‌های آپدیت دستی:

bun update -g @airachat/airacode --registry https://registry.npmmirror.com
# or
curl -fsSL https://airacode.ir/install.sh | bash

گزارش باگ