مکرون ایجنت

دستیار شخصی تو، روی سرور خودت.

کد بنویس · کارها را خودکار کن · فایل بساز · گفتگو را ادامه بده

مکرون یک عامل شخصی با Go است که روی ماشین خودت اجرا می‌شود و کار را با ابزارهای واقعی پیش می‌برد: از بررسی پروژه و اجرای تست تا ساخت سند، جستجوی وب و مدیریت سرور. مدل را خودت انتخاب می‌کنی؛ حافظه، فایل‌ها و تنظیمات در اختیار خودت هستند.

نصب و شروع

روی Linux یا macOS:

curl -fsSL https://raw.githubusercontent.com/Metixpro/Macron-Agent/main/install.sh | bash

اول نوع نصب را انتخاب کن: کاربر فعلی یا سیستمی با روت. نصب‌کننده مسیرها را نشان می‌دهد، صحت دانلود را بررسی می‌کند و مدل را تنظیم می‌کند؛ اتصال تلگرام اختیاری است و همان‌جا یا بعداً با macron telegram انجام می‌شود.

نصب کاربری به sudo نیاز ندارد. کتابخانه‌های پایتون داخل محیط خصوصی نصب می‌شوند؛ اگر Python مناسب موجود نباشد، نصب‌کننده آن را هم آماده می‌کند. ابزارهای سیستمی اختیاریِ نصب‌نشده در گزارش مشخص می‌شوند.

روی Windows فایل Macron-Setup-…exe را از آخرین نسخه بگیر و اجرا کن: یک نصب‌کننده برای همهٔ ویندوزها (۶۴ بیتی، ۳۲ بیتی یا ARM را خودش تشخیص می‌دهد؛ ربطی به اینتل یا AMD بودن پردازنده ندارد). بدون دسترسی ادمین در %LOCALAPPDATA%\Programs\Macron نصب می‌شود، برنامهٔ دسکتاپ و ترمینال را با هم نصب می‌کند، به منوی Start (و اگر بخواهی دسکتاپ و PATH) اضافه می‌کند و از «Apps» ویندوز حذف می‌شود؛ گفتگوها و تنظیمات در ~\.macron می‌مانند. چون فایل امضای دیجیتال ندارد، ویندوز ممکن است هشدار SmartScreen بدهد: More info و بعد Run anyway.

یا در PowerShell (همان پوشه، همان دو برنامه، بدون پنجرهٔ نصب):

irm https://raw.githubusercontent.com/Metixpro/Macron-Agent/main/install.ps1 | iex

برنامهٔ دسکتاپ

روی Windows از منوی Start باز کن؛ روی Linux و macOS بزن macron desktop. پنجره‌ای مستقل باز می‌شود (روی Windows با WebView2؛ اگر نبود در Edge) با همهٔ امکانات ترمینال: پاسخ زنده، قدم‌های هر کار که چندتایی‌ها زیر یک سطر جمع می‌شوند، چک‌لیست و زیرعامل‌ها حین کار، فایل‌هایی که مکرون برایت می‌فرستد (هر نوعی: عکس و ویدیو با پیش‌نمایش، بقیه با باز کردن، نشان دادن در پوشه و ذخیره)، تأیید دستورهای پرخطر، Build و Plan، انتخاب مدل، و پوشهٔ هر پروژه با گفتگوی خودش. متن فارسی و جدول‌ها راست‌به‌چپ نمایش داده می‌شوند.

بار اول برنامه چند قدم کوتاه راه‌اندازی دارد: سرویس مدل (OpenAI، Anthropic، Gemini، OpenRouter، DeepSeek، Ollama یا هر سرویس سازگار)، کلید و انتخاب مدل از فهرست خود سرویس (قبل از ذخیره امتحان می‌شود)، و پوشهٔ کار. برای کار روی سرور از منوی «This PC» یک سرور SSH اضافه کن؛ اگر مکرون آنجا نصب نباشد یا قدیمی باشد، برنامه پیشنهاد می‌دهد همان‌جا نصب یا به‌روزش کند. Ctrl+K همهٔ کارها، تم‌ها و پوشه‌ها را جست‌وجو می‌کند.

روی Windows، مکرون دستورها را با PowerShell اجرا می‌کند (PowerShell 7 اگر نصب باشد) و همان قواعد تأیید را برای فرمان‌های پرخطر ویندوزی هم دارد.

در تنظیمات برنامه effort، پنجرهٔ context و دمای مدل هم تنظیم می‌شود و دکمهٔ effort کنار نام مدل زیر کادر پیام است. سرورهای MCP و پلاگین‌ها هم از تنظیمات اضافه، روشن و خاموش می‌شوند؛ ابزارهایشان در برنامه، ترمینال و تلگرام در دسترس مکرون است.

کار روی سرور: از منوی بالای نوار کناری «Add a server…» را بزن و user@server را بده. برنامه مکرونِ نصب‌شده روی سرور را از راه SSH بالا می‌آورد و از همان اتصال رمزشده با آن حرف می‌زند؛ هیچ پورتی روی اینترنت باز نمی‌شود. بار اول اثر انگشت کلید سرور را نشان می‌دهد و در ~/.ssh/known_hosts نگه می‌دارد و اگر عوض شود اتصال را رد می‌کند. کلید SSH از ssh-agent یا ~/.ssh خوانده می‌شود؛ رمز عبور فقط برای همان جلسه نگه داشته می‌شود. مکرونِ داخل WSL هم از همین منو وصل می‌شود. روی سرور کافی است مکرون نصب و به‌روز باشد (macron update).

در ترمینال

در پوشهٔ هر پروژه فقط بزن:

macron

یک محیط ترمینالی تعاملی باز می‌شود: پاسخ‌ها زنده و با Markdown نمایش داده می‌شوند، هر قدم (دستور، خروجی آخرش، فایل نوشته‌شده، diff ویرایش) زیر هم می‌آید، چک‌لیست کار به‌روز می‌شود و دستورهای پرخطر قبل از اجرا با یک کادر تأیید از تو پرسیده می‌شوند. مکرون در همان پوشه کار می‌کند و دستورالعمل پروژه را از MACRON.md (یا AGENTS.md) می‌خواند. گفتگوی هر پوشه ماندگار است: دفعهٔ بعد که macron را آنجا بزنی، کار را با سابقهٔ دقیقش ادامه می‌دهد.

کلید یا فرمان	کار
`Enter` · `Ctrl+J`	ارسال · خط جدید
`Esc`	توقف کار جاری
`Ctrl+P`	جست‌وجوی فرمان‌ها؛ فهرست محدود و قابل پیمایش
`PageUp` · `PageDown` · `Ctrl+End`	مرور تاریخچه · برگشت به آخر گفتگو
`/provider`	انتخاب پرووایدر فعال
`Tab` · `Shift+Tab`	جابه‌جایی بین Build و Plan؛ در Plan فقط ابزارهای خواندنی فعال‌اند
`/connect` · `/connections`	اتصال مدل یا سرویس · وضعیت تنظیمات بدون نمایش رمزها
`/model` · `/approvals` · `/yolo`	تغییر مدل · شیوهٔ تأیید دستورها · اجرای بی‌سؤال تا ۳۰ دقیقه
`/effort` · `/context` · `/temperature`	میزان فکر کردن مدل (auto تا ultracode) · پنجرهٔ context · دما؛ همه برای پرووایدر فعال
`/settings`	مدل، effort، context، دما، تأیید دستورها و ظاهر در یک فهرست
`/mcp`	سرورهای MCP و پلاگین‌ها: فهرست، افزودن (`/mcp add github npx -y …`)، روشن و خاموش، حذف
`/new` · `/compact` · `/status`	گفتگوی تازه · خلاصه‌کردن سابقه · وضعیت
`/init`	نوشتن `MACRON.md` برای پروژه
`@مسیر`	اشاره به یک فایل پروژه؛ `Tab` مسیر را کامل می‌کند
`!دستور`	اجرای مستقیم یک دستور شل؛ مکرون خروجی‌اش را در پیام بعدی می‌بیند
`/copy` · `/export`	کپی آخرین جواب در کلیپ‌بورد · ذخیرهٔ گفتگو در یک فایل Markdown
`/theme`	رنگ‌ها برای ترمینال تیره یا روشن (`dark` · `light` · `auto`)
`/telegram`	اتصال و مدیریت ربات تلگرام

ورودی و نوار رنگی وضعیت در صفحهٔ گفتگو پایین ترمینال ثابت‌اند؛ تاریخچه جداگانه پیمایش می‌شود. متن فارسی در لایهٔ نمایش شکل‌دهی و راست‌به‌چپ می‌شود و متن اصلیِ ارسالی به مدل تغییر نمی‌کند. اگر فارسی برعکس دیده شد (ترمینال‌هایی که خودشان راست‌به‌چپ را می‌چینند، مثل بیشتر برنامه‌های SSH موبایل، Konsole و GNOME Terminal)، /rtl را بزن؛ انتخابت ذخیره می‌شود.

صفحهٔ شروع، مدل و حالت فعال را نشان می‌دهد و با عرض ترمینال یا موبایل هماهنگ می‌شود. برای تنظیم مدل از /connect model استفاده کن. می‌توانی در چت هم بگویی «بله را وصل کن» یا «اتصال جی‌میل را بررسی کن»؛ مکرون ابزار اتصال را پیدا می‌کند، تنظیمات موجود را بررسی می‌کند و فقط اطلاعات لازم را می‌پرسد. ذخیرهٔ توکن با تأیید اتصال فرق دارد؛ بررسی اتصال بدون ارسال پیام انجام می‌شود.

جزئیات چت و اجرای ابزار در بله و روبیکا، محدودیت ایتایار و تنظیم Gmail در راهنمای اتصال‌ها آمده است.

در تلگرام

macron telegram

مرحله‌به‌مرحله توکن ربات (از @BotFather) و آیدی تو را می‌گیرد (کافی است به ربات پیام بدهی تا خودش ببیند)، تنظیمات را ذخیره و ربات را پس‌زمینه اجرا می‌کند: با systemd یا launchd به‌صورت سرویس که خودش بالا می‌آید، و جایی که سرویس سیستم نیست، به‌صورت پردازش پس‌زمینه. دفعه‌های بعد همین فرمان وضعیت را نشان می‌دهد و گزینهٔ راه‌اندازی دوباره، توقف، لاگ و تغییر ربات را می‌دهد. macron telegram status|start|stop|restart|logs -f هم هست.

در پیوی ربات پیام بده. مکرون فقط به مالکان تنظیم‌شده پاسخ می‌دهد و در گروه و کانال کار نمی‌کند.

چه کارهایی می‌کند؟

بخش	امکانات
کد و سرور	خواندن و ویرایش پروژه، اجرای دستور و کد، تست، Git و مدیریت پردازش‌ها
فایل و داده	PDF، Word، Excel، CSV، نمودار، آرشیو و پردازش داده
وب	جستجو، خواندن صفحات، دانلود و مرورگر خودکار
حافظه و مهارت	گفتگوی ماندگار، جستجوی سابقه، مهارت‌های قابل‌ویرایش و یادگیری از اجراها
کارهای طولانی	زمان‌بندی، اجرای پس‌زمینه، برد کار و دستیارهای کمکی
مدل و افزونه	پروایدر دلخواه، مسیریابی، اجرای چندمدلی، پلاگین و MCP
ویجت تلگرام	داشبورد، فرم، ماشین‌حساب و بازی تعاملی داخل پیام، با جواب از اسکریپت‌های روی سرور خودت
بورس و بازار	قیمت، حجم، EPS، صف و نامه‌های کدال هر نماد از TSETMC، شاخص‌ها، هشدار قیمت و گزارش صبحگاهی
اسناد و رسانه	ساخت Word و PowerPoint واقعی (راست‌به‌چپ)، OCR فارسی، ترجمهٔ فایل‌های بلند، دیاگرام، مقایسهٔ اسناد، صورت‌جلسه از متن پیاده‌شده
داده و توسعه	کوئری فقط‌خواندنی روی PostgreSQL، MySQL و SQLite، کرنل پایتون ماندگار، داشبورد HTML، آمار و پیش‌بینی، فراخوانی OpenAPI، دیپلوی با بازگشت خودکار
اتصال‌ها	ایمیل، تقویم .ics، بله، ایتا، روبیکا، اسلک، دیسکورد، واتساپ، S3 و WebDAV، Notion، Trello، Todoist و GitHub؛ هر ارسالی اول از تو پرسیده می‌شود

بعضی ابزارها به پکیج، مدل یا سرویس جدا نیاز دارند. وضعیت محیط را با این فرمان بررسی کن:

macron doctor --tools-only

اجرای یک تکلیف بدون رابط

برای اسکریپت و cron:

macron exec "این پروژه را بررسی کن و تست‌هایش را اجرا کن"

آدرس مدل، نام مدل و کلید را در راه‌انداز یا متغیرهای MACRON_API_URL، MACRON_MODEL و MACRON_API_KEY تنظیم کن. هر اجرا فضای کار جداگانه دارد و مسیر آن در ترمینال نمایش داده می‌شود. از endpoint سازگار با OpenAI می‌توان استفاده کرد؛ با endpoint محلی، پردازش مدل هم روی ماشین خودت است.

کنترل از تلگرام

فرمان	کاربرد
`/start`	شروع و معرفی
`/help`	راهنما
`/queue`	کار مستقل بعدی
`/new`	گفتگوی تازه
`/memory`	حافظه و فایل‌ها
`/mode`	انتخاب حالت پاسخ
`/files`	مدیریت فایل‌ها
`/cookies`	مدیریت کوکی دانلود
`/reminders`	یادآورها و زمان‌بندی
`/tasks`	کارهای پس‌زمینه
`/search`	جستجوی گفتگوهای قبلی
`/board`	برد کارها
`/dashboard`	داشبورد وب
`/settings`	پنل مدیریت
`/update`	بروزرسانی از گیت‌هاب
`/learn`	مدیریت یادگیری
`/teach`	یاد دادن یک درس
`/moa`	رأی‌گیری چندمدلی
`/approve`	تأیید دستور منتظر
`/yolo`	تنظیم تأیید دستورات
`/language`	زبان ربات
`/id`	شناسه کاربر و گفتگو
`/me`	وضعیت حساب و مصرف
`/cancel`	توقف کار فعلی

حافظه‌ای که دست خودت است

اطلاعات نصب کاربری در ~/.macron و نصب سیستمی در /var/lib/macron نگهداری می‌شوند. مسیر دلخواه با --home قابل انتخاب است:

فایل یا پوشه	محتوا
`SOUL.md`	شخصیت و سبک پاسخ
`USER.md`	اطلاعات ماندگار مالک
`MEMORY.md`	یادداشت‌ها
`skills/`	مهارت‌ها و دستورالعمل‌ها
`workspaces/`	فایل‌ها و خروجی کارها

ساخت از سورس

به Git، Make و Go 1.26+ نیاز داری:

git clone https://github.com/Metixpro/Macron-Agent.git
cd Macron-Agent
make build
./bin/macron

برای آماده‌کردن ابزارها و مرورگر از همان سورس:

./install.sh --binary ./bin/macron --tools --browser-agent --no-setup

مدیریت و آپدیت

macron telegram status
macron telegram restart
macron update

از تلگرام هم /update یا دکمهٔ بروزرسانی پنل را بزن. نسخه از Release گیت‌هاب دریافت می‌شود؛ checksum و اجرای اولیه بررسی و باینری قبلی نگه داشته می‌شود. برای انتشار نسخهٔ تازه، شمارهٔ نسخه و تگ vX.Y.Z باید هماهنگ باشند.

حذف نصب

macron uninstall --dry-run
macron uninstall

فرمان دوم پس از تأیید، سرویس‌ها و پردازش‌های همان نصب، برنامه، تنظیمات، کلیدها، حافظه، فایل‌های کاری و محیط‌های پایتون خصوصی را حذف می‌کند. برای نگه‌داشتن داده‌ها از --keep-data و برای حذف بدون سؤال از --yes استفاده کن. پکیج‌های مشترک سیستم دست‌نخورده می‌مانند.

توسعه

make check
make audit   # تحلیل ایستا، آسیب‌پذیری‌های شناخته‌شده و race detector
make build

مکرون با دسترسی حساب اجرایی خودش کار می‌کند. توکن، کلید، کوکی و فایل پشتیبان را در مخزن عمومی قرار نده. جزئیات نصب، سرویس، وابستگی‌ها و بازیابی در راهنمای سرور آمده است.

لایسنس

MIT — استفاده، تغییر و توزیع آزاد با حفظ اعلان لایسنس.

راهنمای چت بله و روبیکا، Gmail OAuth و SMTP: اتصال پیام‌رسان و ایمیل.