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

টোকেন খরচ ড্যাশবোর্ড হলো AI Agent ব্যবহারকারীদের জন্য একটি লোকাল ব্যবহার বিশ্লেষণ টুল। এটি সরাসরি লোকাল সেশন লগ পড়ে, WorkBuddy, Claude Code, Codex, Cursor, Gemini CLI সহ ১২ ধরনের লগ উৎস স্বয়ংক্রিয়ভাবে শনাক্ত করে, রিকোয়েস্ট সংখ্যা, ইনপুট/আউটপুট টোকেন, ক্যাশ হিট, রিজনিং টোকেন এবং খরচের অনুমান একত্রিত করে এবং একটি একক-ফাইল HTML ড্যাশবোর্ডে প্রদর্শন করে। টুলটি সম্পূর্ণ অফলাইনে চলে, কোনো নেটওয়ার্ক রিকোয়েস্ট পাঠায় না, ডেটা লোকাল মেশিনের বাইরে যায় না। এটি শুধুমাত্র Python স্ট্যান্ডার্ড লাইব্রেরির উপর নির্ভর করে, pip দিয়ে অতিরিক্ত প্যাকেজ ইনস্টল করার প্রয়োজন নেই, Python 3.8 এবং তার উপরের সংস্করণ সমর্থন করে। চালু হলে একটি বিল্ট-ইন লোকাল HTTP সার্ভিস চালু হয়, পেজ প্রতি ১৫ সেকেন্ডে স্বয়ংক্রিয়ভাবে রিফ্রেশ হয়, শেয়ার বা আর্কাইভের জন্য স্ট্যাটিক স্ন্যাপশটও তৈরি করা যায়। ড্যাশবোর্ডে সামগ্রিক দৃশ্য, উৎস তুলনা, মডেল বিতরণ, দৈনিক প্রবণতা এবং সেশন টপ ২০ সহ একাধিক ভিউ রয়েছে, এবং স্ক্রিপ্ট ইন্টিগ্রেশনের সুবিধার জন্য /api/data JSON ইন্টারফেস প্রদান করে। ইন্টারফেসে প্লাম পার্পল ও কোরাল পিংক রঙ ব্যবহার করা হয়েছে, রেসপন্সিভ লেআউট, সিস্টেম অনুসরণকারী ডার্ক মোড এবং prefers-reduced-motion-এর অধীনে অ্যানিমেশন ডিগ্রেডেশন সমর্থন করে। খরচের অনুমান প্রকাশ্য ইউনিট মূল্যের উপর ভিত্তি করে, কনফিগারেশন ফাইলের মাধ্যমে মূল্য তালিকা ওভাররাইড করা যায়। প্রজেক্টের কাঠামো পরিষ্কার, নতুন Agent যোগ করতে শুধু sources.py-তে একটি কনফিগারেশন যোগ করলেই হয়, পার্সার ক্যান্ডিডেট কী নাম ও রিকার্সিভ ড্রিল-ডাউন কৌশল ব্যবহার করে, যা সাধারণ টোকেন ফিল্ড নাম স্বয়ংক্রিয়ভাবে শনাক্ত করতে পারে।