یک ایجنت هوش مصنوعی شخصی و خودآموز در سبک Hermes Agent، ساختهشده با LangChain و LangGraph و با رابط وب. روی کامپیوتر یا سرور خودتان اجرا میشود، دستور اجرا میکند، فایل میخواند و مینویسد، در وب جستجو میکند و از کارهایی که انجام داده «حافظه» و «مهارت» میسازد.
| قابلیت | توضیح |
|---|---|
| مدلهای متعدد | Anthropic Claude، OpenRouter، OpenAI و هر سرویس سازگار با OpenAI (با base_url)، Ollama (لوکال). در رابط وب برای هر گفتگو انتخاب میشود. |
| ابزارها | ترمینال (PowerShell روی ویندوز، bash روی لینوکس)، خواندن/نوشتن/ویرایش فایل، اجرای پایتون، جستجوی وب، خواندن صفحه. |
| تأیید انسانی | پیش از دستورهای خطرناک (یا همیشه، یا هرگز) از شما اجازه میگیرد؛ میتوانید دستور را ویرایش کنید. |
| حافظهٔ پایدار | دو فایل کوچک و سقفدار (MEMORY.md، USER.md) که در ابتدای هر گفتگو به ایجنت داده میشوند. |
| مهارتهای خودآموز | روشهای کارآمد به شکل SKILL.md ذخیره میشوند؛ یک «مرورگر» پسزمینه بعد از کارهای سنگین تصمیم میگیرد چیزی ذخیره شود یا نه. |
| جستجوی گفتگوهای قبلی | جستجوی متنی (FTS5) روی همهٔ گفتگوها، چه توسط شما چه توسط ایجنت. |
| سابایجنت | تا ۳ کار مستقل را موازی به دستیارهای جداگانه میسپارد و فقط نتیجه برمیگردد. |
| ماندگاری | گفتگوها با checkpoint SQLite ذخیره میشوند؛ حتی تأیید نیمهتمام بعد از بستن صفحه یا ریاستارت سرور برمیگردد. |
آگاهانه خارج از نسخهٔ اول است: کارهای زمانبندیشده (cron)، ربات تلگرام و MCP.
نیاز: Python 3.11+ و uv.
uv sync
uv run dastyar init # ساخت ~/.dastyar با config.yaml و .env نمونهکلید API را در ~/.dastyar/.env بگذارید (در ویندوز: C:\Users\<شما>\.dastyar\.env):
ANTHROPIC_API_KEY=sk-ant-...
# یا OPENROUTER_API_KEY / OPENAI_API_KEY
uv run dastyar serveسپس http://localhost:8765 را در مرورگر باز کنید. بدون هیچ کلیدی هم میتوانید رابط را امتحان کنید:
uv run dastyar serve --fake # مدل آزمایشی؛ مثلاً بنویسید: !sh echo helloاگر
files.pythonhosted.orgاز شبکهٔ شما بسته است،uvرا با یک آینهٔ PyPI اجرا کنید، مثلاًUV_DEFAULT_INDEX=https://pypi.tuna.tsinghua.edu.cn/simple/ uv sync. (آینه شخص ثالث است؛ فقط در صورت اعتماد استفاده کنید.) این تنظیم عمداً داخلpyproject.tomlنیست.
فایل ~/.dastyar/config.yaml (نمونه: config.example.yaml):
models: پروفایلها. هر مدلprovider(anthropic|openai|openrouter|ollama)،model،api_key_envو در صورت نیازbase_urlدارد. برای هر endpoint سازگار با OpenAI ازprovider: openaiوbase_urlاستفاده کنید.default_modelوcheap_model: مدل گفتگوهای جدید، و مدل ارزانتر برای عنوانگذاری، خلاصهسازی و مرور پسزمینه (اگر کلیدش نباشد از مدل گفتگو استفاده میشود).approval_mode:dangerous(پیشفرض) |always|never— از رابط هم قابل تغییر است.reviewer: کنترل مرور پسزمینه (min_tool_calls،every_n_turns).search.provider:ddgs(بدون کلید) |tavily|searxng.HTTPS_PROXYدر.envبرای دسترسی به API از پشت پروکسی.
دادهٔ شما در ~/.dastyar (یا DASTYAR_HOME): memories/، skills/، workspace/، sessions.db، state.db.
این برنامه به یک مدل زبانی اجازهٔ اجرای دستور روی ماشین شما را میدهد. محتوای صفحههای وب و فایلها میتواند سعی کند مدل را فریب دهد (prompt injection).
- پیشفرض فقط روی
127.0.0.1گوش میدهد. اگرhostغیرلوکال باشد، بدونDASTYAR_TOKENسرور بالا نمیآید. توکن:uv run dastyar token. - Host و Origin هر درخواست بررسی میشود (جلوگیری از DNS rebinding و ربودن WebSocket از صفحههای دیگر)؛ هدرهای
X-Frame-Optionsو CSP سختگیرانه فعال است و رابط هیچ کتابخانهٔ خارجی ندارد. - حالت
dangerousفقط یک تشخیص ساده است (حذف بازگشتی، نصب بسته،git push --force، نوشتن بیرون از workspace و…)، نه مرز امنیتی. برای کار با محتوای ناشناس ازalwaysاستفاده کنید. حالتneverفقط برای محیطهای ایزوله است. - کلیدهای API و توکن به پردازههای فرزند (دستورهایی که ایجنت اجرا میکند) داده نمیشوند و ابزارهای فایل به
~/.dastyar/.envدسترسی ندارند. ولی ایجنت همچنان با دسترسی کاربر شما کار میکند؛ برای سرور از یک کاربر کمدسترسی یا کانتینر استفاده کنید. - سابایجنتها نمیتوانند تأیید بگیرند؛ کار پرریسک را رد میکنند و به ایجنت اصلی گزارش میدهند.
همان کد بدون تغییر اجرا میشود. دو راه:
Docker (ساده و ایزوله — ایجنت فقط داخل کانتینر دسترسی دارد):
cp .env.example .env # ANTHROPIC_API_KEY و DASTYAR_TOKEN را پر کنید
docker compose up -d --buildsystemd: نمونه در deploy/dastyar.service. برنامه را روی 127.0.0.1 نگه دارید و از SSH tunnel (ssh -L 8765:127.0.0.1:8765 server) یا یک reverse proxy با HTTPS (مثلاً Caddy: agent.example.com { reverse_proxy 127.0.0.1:8765 }) استفاده کنید. پشت proxy حتماً DASTYAR_TOKEN بگذارید.
مرورگر ──WebSocket──► FastAPI ──► create_agent (LangGraph)
│ ├─ middleware: پرامپت پویا + حافظه/مهارت، تأیید انسانی (interrupt)،
│ │ خلاصهسازی، برنامهریزی (todo)، سقف ابزار
│ ├─ tools: terminal, files, python, web, memory, skills,
│ │ session_search, delegate_task (سابایجنت)
│ └─ checkpointer: AsyncSqliteSaver (state.db)
├─ sessions.db (تاریخچهٔ رابط + FTS5)
└─ reviewer پسزمینه ──► فقط ابزارهای memory و skill_manage
ساختار کد: src/dastyar/{agent,tools,store,env,server,web}.
uv run pytest # همهٔ تستها بدون شبکه و بدون کلید (مدل جعلی)
uv run ruff check srcتستها شامل جریان کامل ایجنت (تأیید/رد/ویرایش، سابایجنت، مرور پسزمینه)، WebSocket، امنیت و ابزارها هستند. فایل .env و uv.lock عمداً در git نیستند.