منصوبے کے بارے میں

obsidian-agent ایک خود میزبان ٹیلی گرام بوٹ ہے جو مقامی Obsidian والٹ پر AI ایجنٹ کے طور پر کام کرتا ہے۔ جوابات کو چیٹ تھریڈ یا کلاؤڈ انڈیکس میں رکھنے کے بجائے، یہ والٹ کے اندر مارک ڈاؤن، JSON اور SQLite فائلوں پر مبنی جوابات دیتا ہے، جو کسی بھی وقت Obsidian میں قابل تدوین رہتی ہیں۔ بنیادی اجزاء ٹیلی گرام بوٹ، والٹ، اور ایک OpenAI-مطابق LLM ہیں (DeepSeek، OpenRouter، Groq، مقامی vLLM اور اسی طرح کے ہوسٹس LLM_API_KEY / LLM_BASE_URL / LLM_MODEL کے ذریعے سپورٹ ہیں)۔ باقی سب کچھ اختیاری ہے۔ صلاحیتیں - کیپچر: ٹیلی گرام کے ذریعے بھیجے گئے متن، آواز (ASR)، تصاویر، PDFs اور لنکس کو منظم والٹ فائلوں میں تبدیل کیا جاتا ہے۔ مالیاتی اندراجات لیجر تک پہنچنے سے پہلے چیٹ میں تصدیق کی ضرورت ہوتی ہیں۔ - منصوبہ بندی: مارک ڈاؤن میں محفوظ کانبان بورڈز (کالم، آئی ڈی، لاگز)، اہداف، معمولات، ہفتہ وار عکاسی، اختیاری کیلنڈر اوورلے، اور مکمل شدہ اشیاء کی ماہانہ آرکائیونگ۔ - علم: موجودہ کارپس پر انجیشن، ٹیگز، ویکی لنکس اور RAG تلاش، نیز اختیاری طے شدہ دوبارہ سرفیسنگ اور دیکھ بھال کے پاسز۔ - مالیات: قدرتی زبان میں اخراجات، آمدنی، منتقلی، قرضے اور منصوبے، Obsidian صفحات کے طور پر پیش کردہ ڈیش بورڈز اور ڈیٹا مقامی ڈیٹا بیس میں رکھا جاتا ہے۔ - کراس ڈومین سوالات: ایک جملہ مختلف ٹولز میں روٹ کیا جا سکتا ہے، مثال کے طور پر اسی مدت میں بھیجی گئی چیزوں کا خرچ سے موازنہ۔ ماڈیول ڈیزائن تین ڈومینز (منصوبہ بندی، علم، مالیات) ایک ہی عمل کے پیچھے چلتے ہیں۔ ایک صلاحیتوں کا مینی فیسٹ کنٹرول کرتا ہے کہ کیا فعال ہے: کسی ماڈیول کو غیر فعال کرنا اسے UI، ٹولز، پرامپٹس اور سنک سے ہٹا دیتا ہے، نہ کہ صرف چھپاتا ہے۔ بروکر APIs، ہیلتھ ڈیٹا پائپس یا ڈیسک ٹاپ سنک اسکرپٹس جیسے کنیکٹر بطور ڈیفالٹ بند ہیں اور فی صارف ترتیب دیے جاتے ہیں۔ ہوسٹنگ بوٹس اور طویل مدتی جابز 24/7 کیپچر کے لیے VPS یا لیپ ٹاپ پر چل سکتے ہیں، جبکہ والٹ وہاں رہتا ہے جہاں صارف ترمیم کرتا ہے۔ سنک کے اختیارات میں Obsidian Sync، Syncthing یا اختیاری ڈیسک ٹاپ اسکرپٹس شامل ہیں؛ دستاویزات نوٹ کرتی ہیں کہ میک کی ضرورت نہیں ہے، اور صحت کے میٹرکس کو Apple-only APIs کے بجائے ٹیکسٹ سنیپ شاٹس کے طور پر ہینڈل کیا جاتا ہے۔ سیٹ اپ آن بورڈنگ کو AI کوڈنگ چیٹ کے ذریعے چلانے کے لیے ڈیزائن کیا گیا ہے: Cursor میں ریپوزٹری روٹ کھول کر /setup چلائیں، یا Claude Code یا اسی طرح کے ٹولز میں اسی سکل فائل پر عمل کریں۔ scripts/onboarding_wizard.sh کے ذریعے CLI راستہ موجود ہے جس میں پلے بک کے انتخاب (منصوبہ بندی، مالیات، علم، مکمل) شامل ہیں، اس کے بعد والٹ لے آؤٹ انیشیلائزیشن اور ایک سموک ٹیسٹ۔ تقاضے Python 3.10–3.12، ایک Obsidian والٹ پاتھ، ایک ٹیلی گرام بوٹ ٹوکن اور ایک LLM API کلید ہیں۔ Docker کو بوٹ اسٹریپ کے بعد رن ٹائم آپشن کے طور پر بیان کیا گیا ہے، سیٹ اپ کے متبادل کے طور پر نہیں۔ ریپوزٹری لے آؤٹ unified_bot/ پروڈکشن ٹیلی گرام ہوسٹ رکھتا ہے، shared/ ایجنٹ پلیٹ فارم، LLM اور صلاحیتوں کی منطق پر مشتمل ہے، جس میں planning_bot/، knowledge_bot/ اور finance_bot/ ڈومین ماڈیولز ہیں۔ کنفیگریشن اور صارف کا سامنا کرنے والی کاپی YAML فائلوں میں رہتی ہے، Python کو لوکیل سے پاک رکھتے ہوئے؛ انگریزی ڈیفالٹ لوکیل ہے جس میں روسی دستیاب ہے۔ تشخیص اور جانچ eval/ کے تحت مصنوعی بازیافت سوالات کا ایک صاف شدہ عوامی گولڈ سیٹ شامل ہے، اور مینٹینر نجی لیبل شدہ رنز پر تقریباً 0.76 کا ان-ونڈو Recall@1 / MRR رپورٹ کرتا ہے۔ ٹیسٹ scripts/run_tests.sh کے ذریعے چلتے ہیں، GitHub Actions میں CI ترتیب دیا گیا ہے۔ لائسنس MIT ہے۔