প্রকল্প সম্পর্কে

obsidian-agent হলো একটি সেলফ-হোস্টেড টেলিগ্রাম বট যা স্থানীয় Obsidian ভল্টের উপর AI এজেন্ট হিসেবে কাজ করে। উত্তর চ্যাট থ্রেড বা ক্লাউড ইনডেক্সে না রেখে, এটি ভল্টের ভিতরে মার্কডাউন, JSON এবং SQLite ফাইলে ভিত্তি করে উত্তর দেয়, যা যেকোনো সময় Obsidian-এ সম্পাদনাযোগ্য থাকে। মূল উপাদান হলো টেলিগ্রাম বট, ভল্ট এবং একটি OpenAI-সামঞ্জস্যপূর্ণ LLM (DeepSeek, OpenRouter, Groq, স্থানীয় vLLM এবং অনুরূপ হোস্ট LLM_API_KEY / LLM_BASE_URL / LLM_MODEL এর মাধ্যমে সমর্থিত)। বাকি সব ঐচ্ছিক। ক্ষমতা - ক্যাপচার: টেলিগ্রামে পাঠানো টেক্সট, ভয়েস (ASR), ছবি, PDF এবং লিংক কাঠামোবদ্ধ ভল্ট ফাইলে রূপান্তরিত হয়। অর্থ এন্ট্রি লেজারে যাওয়ার আগে চ্যাটে নিশ্চিতকরণ প্রয়োজন। - পরিকল্পনা: মার্কডাউনে সংরক্ষিত কানবান বোর্ড (কলাম, আইডি, লগ), লক্ষ্য, রুটিন, সাপ্তাহিক প্রতিফলন, ঐচ্ছিক ক্যালেন্ডার ওভারলে এবং সম্পন্ন আইটেমের মাসিক আর্কাইভিং। - জ্ঞান: বিদ্যমান কর্পাসের উপর ইনজেশন, ট্যাগ, উইকলিংক এবং RAG সার্চ, পাশাপাশি ঐচ্ছিক নির্ধারিত পুনঃপ্রকাশ এবং রক্ষণাবেক্ষণ। - অর্থ: প্রাকৃতিক ভাষায় খরচ, আয়, স্থানান্তর, ঋণ এবং পরিকল্পনা, Obsidian পেজ হিসেবে ড্যাশবোর্ড এবং স্থানীয় ডেটাবেসে তথ্য। - ক্রস-ডোমেন কোয়েরি: একটি একক বাক্য বিভিন্ন টুলে রুট করা যায়, যেমন একই সময়ে কি শিপ হয়েছে বনাম কি খরচ হয়েছে তুলনা করা। মডিউল ডিজাইন তিনটি ডোমেইন (পরিকল্পনা, জ্ঞান, অর্থ) এক প্রক্রিয়ার পিছনে চলে। একটি ক্ষমতা ম্যানিফেস্ট নির্ধারণ করে কী সক্রিয়: কোনো মডিউল নিষ্ক্রিয় করলে তা UI, টুল, প্রম্পট এবং সিঙ্ক থেকে সরিয়ে দেয়, শুধু লুকিয়ে রাখে না। ব্রোকার API, স্বাস্থ্য ডেটা পাইপ বা ডেস্কটপ সিঙ্ক স্ক্রিপ্টের মতো কানেক্টর ডিফল্টভাবে বন্ধ এবং প্রতি ব্যবহারকারী কনফিগারযোগ্য। হোস্টিং বট এবং দীর্ঘমেয়াদী কাজ VPS বা ল্যাপটপে 24/7 ক্যাপচারের জন্য চলতে পারে, যখন ভল্ট থাকে যেখানে ব্যবহারকারী সম্পাদনা করে। সিঙ্ক অপশনের মধ্যে Obsidian Sync, Syncthing বা ঐচ্ছিক ডেস্কটপ স্ক্রিপ্ট; ডকুমেন্টেশন উল্লেখ করে যে Mac প্রয়োজন নেই, এবং স্বাস্থ্য মেট্রিক্স শুধু Apple-নির্দিষ্ট API নয়, টেক্সট স্ন্যাপশট হিসেবে পরিচালিত হয়। সেটআপ অনবোর্ডিং 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।