سورس‌کد

سورس ربات دستیار هوش مصنوعی تلگرام با Python

دستیار فارسی با حافظه، شخصیت‌های مختلف، نمایش تدریجی و سیستم اعتبار

  • سازگار با هر API شبیه OpenAI با آدرس قابل تنظیم
  • حافظهٔ گفتگو و ۵ شخصیت قابل ویرایش
  • نمایش تدریجی پاسخ با ویرایش پیام
  • سهمیهٔ روزانه، اعتبار و آمار مدیر
  • polling و webhook، با Docker و systemd
  • تست خودکار بدون نیاز به کلید API

این سورس برای کسی است که می‌خواهد دستیار هوش مصنوعی فارسی خودش را در تلگرام داشته باشد، برای خودش، تیمش یا کاربرانش. کافی است آدرس پایه، کلید و نام مدل را بدهید. ربات با OpenAI و با سرویس‌های واسطی مثل AvalAI و هر سرویس سازگار با chat completions کار می‌کند.

چه مشکلی را حل می‌کند

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

داخل بسته چه هست

  • سورس Python با ۱۰ فایل برنامه و ۲ فایل تست، روی aiogram 3 و aiosqlite
  • حافظهٔ گفتگو برای هر چت و دستورهای /reset، /mode و /usage
  • ۵ شخصیت آماده در یک فایل JSON که قابل ویرایش است
  • سهمیهٔ روزانه، اعتبار با دستور /grant، آمار مدیر و محدودیت سرعت
  • حالت long polling و webhook با بررسی secret_token
  • فایل‌های requirements.txt، Dockerfile و سرویس systemd
  • راهنمای PDF فارسی برای نصب، مدیریت هزینه و شخصی‌سازی

چطور استفاده می‌شود

بسته را روی یک سرور لینوکس باز می‌کنید، کتابخانه‌ها را نصب می‌کنید، فایل .env را پر می‌کنید و main.py را اجرا می‌کنید. برای اجرای دائمی، راهنما روش systemd و Docker را قدم‌به‌قدم توضیح می‌دهد.

نکته‌های مهم: سرور باید خارج از ایران باشد، چون API تلگرام از داخل ایران در دسترس نیست. هزینهٔ API جداست و با سرویس‌دهنده حساب می‌شود. درگاه پرداخت در این بسته نیست و اعتبار را مدیر دستی اضافه می‌کند. این محصول متن و کد است و ویدئو ندارد.

داخل بسته چیست؟

  • سورس Python با ۱۲ فایل (۱۰ فایل برنامه و ۲ فایل تست)
  • ۵ شخصیت آماده در personas.json
  • فایل‌های .env.example، requirements.txt و Dockerfile
  • فایل سرویس systemd
  • راهنمای PDF فارسی با ۴ فصل

پیش‌نیازها

  • سرور لینوکس خارج از ایران با Python 3.10 یا بالاتر
  • کلید API از یک سرویس سازگار با OpenAI (هزینه‌اش جداست)
  • یک ربات از BotFather
  • برای حالت webhook، دامنه با HTTPS
  • آشنایی ساده با خط فرمان لینوکس

مجوز استفاده و منبع

با خرید، مجوز استفاده و تغییر کد در پروژه‌های شخصی و تجاری خودتان و مشتریانتان را می‌گیرید. فروش یا انتشار خود سورس مجاز نیست. کتابخانه‌های Python همراه بسته نیستند و با pip نصب می‌شوند و لایسنس خودشان را دارند. این محصول مستقل و غیررسمی است و هیچ وابستگی‌ای به Telegram، OpenAI یا AvalAI ندارد.

پرسش‌های این محصول

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

با هر مدلی که سرویس‌دهنده‌اش از endpoint استاندارد chat/completions با استریم پشتیبانی کند. نام مدل را در تنظیمات می‌نویسید و در کد ثابت نیست.

روی هاست اشتراکی cPanel اجرا می‌شود؟

این سورس برای سرور مجازی طراحی شده، چون یک برنامهٔ Python همیشه‌روشن است. روی هاست اشتراکی معمولی پیشنهاد نمی‌شود.

کاربران می‌توانند خودشان اعتبار بخرند؟

در این نسخه خیر. درگاه پرداخت همراه بسته نیست و اعتبار را مدیر با دستور /grant اضافه می‌کند.

هزینهٔ API جزو قیمت است؟

خیر. مصرف API را مستقیماً به سرویس‌دهنده‌ای که انتخاب می‌کنید پرداخت می‌کنید. قیمت فعلی را از سایت همان سرویس ببینید.

در گروه هم کار می‌کند؟

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

محصولات مرتبط