اکوان
مستندات اکوان
مستندات/شروع کار

نصب ایجنت اکوان

نصب یا به‌روزرسانی اکوان روی سیستم، بدون نیاز به دسترسی روت.

ایجنت اکوان برای کاربر فعلی نصب می‌شود و به دسترسی root نیاز ندارد. نصب‌کننده یک محیط خصوصی پایتون در ~/.akvan می‌سازد و فرمان akvan را در ~/.local/bin قرار می‌دهد.

پیش‌نیازها

  • Linux یا macOS
  • دسترسی به اینترنت برای دریافت سورس و وابستگی‌ها
  • یک ترمینال سازگار با shell

نصب‌کننده در صورت نیاز uv و نسخهٔ سازگار Python را نیز آماده می‌کند.

نصب پیشنهادی

فرمان زیر را در ترمینال اجرا کنید:

bash
curl -fsSL https://agent.akvan.ai/install.sh | sh

در نخستین نصب، اکوان از شما می‌خواهد provider و مدل را انتخاب کنید. اگر حساب کاربری در اکوان دارید، می‌توانید provider Akvan را انتخاب کنید و بدون کلید API جداگانه از اعتبار پلن استفاده کنید. پس از پایان نصب، یک ترمینال تازه باز کنید و از نصب صحیح فرمان مطمئن شوید:

bash
akvan --help

اگر shell فرمان akvan را پیدا نکرد، مطمئن شوید مسیر ~/.local/bin در متغیر PATH قرار دارد.

نصب از سورس

برای توسعه یا بررسی مستقیم کد، مخزن عمومی را clone کنید:

bash
git clone https://github.com/akvanai/akvan-agent.git
cd akvan-agent
./install.sh

به‌روزرسانی

همان فرمان نصب را دوباره اجرا کنید. نصب‌کننده برنامه را به‌روزرسانی می‌کند و تغییرات شخصی شما در حافظه و skills را نگه می‌دارد.

حذف اکوان

حذف برنامه با حفظ داده‌های کاربر:

bash
./install.sh --uninstall

حذف برنامه همراه با همهٔ داده‌های اکوان:

bash
./install.sh --purge

گزینهٔ --purge برگشت‌پذیر نیست؛ پیش از اجرا از skills و حافظهٔ موردنیاز نسخهٔ پشتیبان بگیرید.