OpenMuse یک برنامه ایجنت شخصی متنباز است که مرورگر، ترمینال، فایل و اجرای کارهای چندمرحلهای را در یک رابط وب و موبایل کنار هم میآورد. کاربر نتیجه موردنظر را میگوید، برنامه یک Plan قابل مشاهده میسازد و انجام کار را با توقف، ادامه، لغو، تکرار و تأیید عملیات حساس مدیریت میکند.
موضوع این راهنما مخزن CopilotKit/OpenMuse است. آن را با سرویس موزیکویدئوی OpenMuse، پروژه قدیمی تصویرسازی Hugging Face یا مخزن دیگری با همین نام اشتباه نگیرید. پروژه فعلی با مجوز MIT منتشر شده، اما هنوز Alpha است و خود سازنده آن را برای Self-hosting و توسعه بیشتر معرفی میکند.
OpenMuse دقیقاً چه کاری انجام میدهد؟
OpenMuse یک چتبات ساده نیست. سرور API، Task Worker و Browser Worker دارد. مرورگر Chromium میتواند Profile ماندگار نگه دارد، صفحه عمومی را باز کند و در صورت نیاز کنترل همان Session را به کاربر بدهد. محیط اختیاری Linux نیز فرمانها را در کانتینر بدون دسترسی مستقیم به پوشههای میزبان اجرا میکند. فایل، PDF، Gmail و Calendar هم در گردشکارهای نمونه حضور دارند.
| بخش | کارکرد | نکته عملی |
|---|---|---|
| API و رابط | چت، Plan، نتیجه غنی و مدیریت کار | یک نمونه API توصیه شده است. |
| Task Worker | اجرای ماندگار و بازیابی کار قطعشده | Workerها با SQL Lease هماهنگ میشوند. |
| Browser Worker | Chromium ماندگار و تحویل کنترل مرورگر | Token مشترک و Profile خصوصی لازم دارد. |
| Computer اختیاری | ترمینال و Workspace لینوکسی محدود | به Docker Engine نیاز دارد و VM کامل نیست. |
| ذخیرهسازی | PGlite یا PostgreSQL، فایل و Profile مرورگر | داده باید روی Volume خصوصی و پشتیبانگیریشده بماند. |
پیشنیازهای نصب OpenMuse
راهنمای رسمی فعلی Node.js 24 LTS، pnpm 11.19.0 و یک کلید Server-only برای CopilotKit Intelligence را لازم میداند. نمونه محلی بدون مدل و حساب گوگل بالا میآید، اما Threadهای ماندگار در همه حالتها به Intelligence وابستهاند؛ این سرویس جدا از کد MIT مخزن است.
- Node.js 24 LTS و pnpm 11.19.0
- کلید CopilotKit Intelligence فقط در سمت سرور
- PostgreSQL برای جداکردن Workerها و استقرار پایدار
- Volume خصوصی برای فایلها و Profile مرورگر
- Docker فقط برای Browser Worker مبتنی بر Compose و Computer اختیاری
نصب محلی OpenMuse
git clone https://github.com/CopilotKit/OpenMuse.git openmuse
cd openmuse
pnpm install --frozen-lockfile
cp .env.example .env
npx copilotkit@latest login
npx copilotkit@latest project select
pnpm devکلید تولیدشده را در CPK_INTELLIGENCE_API_KEY قرار دهید و در Terminal دیگری pnpm dev:web را اجرا کنید. رابط وب روی پورت ۸۰۸۱ و Health API طبق مستندات روی پورت ۸۷۸۷ در دسترس است. پیش از افزودن مدل، ابتدا جریانهای نمونه و ذخیره Thread را بررسی کنید.
راهاندازی Browser Worker
برای مرور وب واقعی، یک WORKER_TOKEN تصادفی با حداقل ۳۲ کاراکتر بسازید و BROWSER_WORKER_URL را تنظیم کنید. سپس Chromium را نصب و Worker را اجرا کنید:
pnpm --dir apps/worker exec playwright install chromium
pnpm dev:browserمسیر جایگزین رسمی، Compose موجود در مخزن است. API و Worker باید Token یکسان داشته باشند، اما این Token نباید وارد Log، کد یا متغیر عمومی Frontend شود. Profile مرورگر شامل Sessionهای حساس است؛ آن را مانند Credential محافظت کنید.