نصب و شروع

نصب AiraCode، ورود، و اجرای اولین فرمان.

پیش‌نیازها

  • macOS، Linux، یا Windows به‌صورت native از طریق PowerShell. WSL ۲ هم کار می‌کنه.
  • یک حساب آیراچت برای ورود مرورگری، یا یک کلید API برای محیط‌های headless.
  • برای مسیر نصب پیش‌فرض نیازی به Node، npm یا Bun نیست. اسکریپت نصب یک باینری مستقل دانلود می‌کنه.
  • فقط وقتی مشخصاً مسیر پکیج Bun/npm رو می‌خوای از --bun استفاده کن.

نصب

اسکریپت نصب پیش‌فرض باینری مستقل رو از airacode.ir دانلود می‌کنه:

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

فقط وقتی به رفتار package-manager مثل قفل‌کردن روی نسخهٔ مشخص نیاز داری از مسیر Bun/npm استفاده کن:

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

Windows PowerShell

این رو توی PowerShell اجرا کن. برای مسیر پیش‌فرض نیازی به Node، npm، Bun یا WSL نیست.

irm https://airacode.ir/install.ps1 | iex

برای حالت مستقیم بین‌المللی، قبل از اجرای نصب‌کنندهٔ pipe‌شده این متغیر محیطی رو ست کن:

$env:AIRA_MODE='direct'; irm https://airacode.ir/install.ps1 | iex

تأیید نصب

aira --version
# 0.1.129 (AiraCode)

aira --help

ورود

ورود مرورگری فلوی OAuth آیراچت رو باز می‌کنه، شمارهٔ موبایل و کد یک‌بارمصرفت رو می‌گیره، بعد به CLI برمی‌گرده.

aira login

برای جزئیات محیط‌های بدون مرورگر، ذخیرهٔ توکن، و خروج، صفحهٔ ورود رو بخون.

اولین اجرا

  1. با cd برو توی پروژه‌ای که می‌خوای روش کار کنی.
  2. aira رو اجرا کن تا یک نشست تعاملی توی ترمینال شروع بشه.
  3. کارت رو فارسی یا هر زبونی که تیم پروژه‌ات استفاده می‌کنه بپرس.
  4. وقتی کارت تموم شد Ctrl+C بزن.

حالت headless

# One prompt, one stdout result
aira -p "Explain what auth/router.py does."

# Use the coding lane for implementation work
aira --model aira-code -p "Refactor this function to be async."

# JSON output for scripts
aira -p "Run the tests and summarize failures." --output-format json

قدم بعدی