Skip to content

Georgiy00987/Home-Helper-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🤖 Личный бот-ассистент

Приватный Telegram-бот для личного использования. Работает только для разрешённых администраторов из ADMIN_IDS.

Всё хранится на GitHub — никаких локальных файлов с данными.

✨ Функции

Раздел Возможности
📝 Заметки Создание, просмотр, редактирование, удаление → data/notes.json
Напоминания Напоминание на конкретное время. Бот сам пришлёт уведомление → data/reminders.json
🎂 Дни рождения Список ДР с уведомлениями за N дней → data/birthdays.json
💰 Крипто Балансы, счета, инвойсы через CryptoBot API
☀️ Утренний дайджест Каждый день в 8:00 — сводка напоминаний и предстоящих ДР

📁 Структура

assistant_bot/
├── main.py
├── requirements.txt
├── .env.example
├── bot/
│   ├── errors.py
│   ├── github_storage.py    ← всё хранилище: заметки / напоминания / ДР
│   ├── cryptobot.py
│   ├── scheduler.py
│   └── utils.py
└── handlers/
    ├── loader.py
    ├── markups.py
    └── handlers.py

🗂 Что хранится на GitHub

your-repo/
└── data/
    ├── notes.json        ← заметки
    ├── reminders.json    ← напоминания
    └── birthdays.json    ← дни рождения

Файлы создаются автоматически при первой записи.

🚀 Установка

pip install -r requirements.txt
cp .env.example .env   # заполнить все значения
python main.py

⚙️ Настройка .env

BOT_TOKEN=              # @BotFather
ADMIN_IDS=              # твой Telegram ID (@userinfobot)
GITHUB_TOKEN=           # Fine-grained token, права Contents read/write
GITHUB_NOTES_REPO=      # owner/repo — приватный репозиторий
CRYPTOBOT_TOKEN=        # @CryptoBot → создать приложение

🔔 Расписание уведомлений

Задача Когда
Напоминания каждую минуту
Дни рождения ежедневно в 9:00
Утренний дайджест ежедневно в 8:00

Часовой пояс: Europe/Moscow (менять в bot/scheduler.py)

About

Личный Telegram-ассистент для администраторов — заметки, напоминания, дни рождения и управление криптокошельком через CryptoBot. Все данные хранятся в приватном GitHub-репозитории.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages