{"id":49077252,"url":"https://github.com/s00inx/aiogram-simple-todo-bot","last_synced_at":"2026-04-20T10:33:08.239Z","repository":{"id":311212508,"uuid":"1042274141","full_name":"s00inx/aiogram-simple-todo-bot","owner":"s00inx","description":"asynchronous to-do-list bot with reminders, using python, postgresql, sqlite. ","archived":false,"fork":false,"pushed_at":"2025-08-22T19:50:27.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-21T23:28:57.293Z","etag":null,"topics":["aiogram","postgres","postgresql","python","sqlite","telegrambot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/s00inx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-21T18:49:27.000Z","updated_at":"2026-02-05T16:26:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"14ea8828-9db1-4b14-899e-bb240eb321a5","html_url":"https://github.com/s00inx/aiogram-simple-todo-bot","commit_stats":null,"previous_names":["kfcemployee/aiogram-simple-todo-bot","s00inx/aiogram-simple-todo-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/s00inx/aiogram-simple-todo-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s00inx%2Faiogram-simple-todo-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s00inx%2Faiogram-simple-todo-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s00inx%2Faiogram-simple-todo-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s00inx%2Faiogram-simple-todo-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/s00inx","download_url":"https://codeload.github.com/s00inx/aiogram-simple-todo-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s00inx%2Faiogram-simple-todo-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32043056,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"online","status_checked_at":"2026-04-20T02:00:06.527Z","response_time":94,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aiogram","postgres","postgresql","python","sqlite","telegrambot"],"created_at":"2026-04-20T10:33:07.593Z","updated_at":"2026-04-20T10:33:08.231Z","avatar_url":"https://github.com/s00inx.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🗓️ Aiogram Simple Todo Bot\n\n![Python Version](https://img.shields.io/badge/python-3.11%2B-blue)\n![Aiogram](https://img.shields.io/badge/aiogram-3.22%2B-green)\n\nПростой и эффективный телеграм-бот для управления задачами.\n\n## Возможности\n- удобное управление задачами через интерфейс телеграм-бота\n- управление напоминаниями\n- приоритизация: пометка важных задач приоритетом\n\n## Особенности\n- быстрая работа благодаря ассинхронной архитектуре\n- интеграция с СУБД postgres и sqlite и возможность выбора между ними\n- безопасность: защита данных и аккуратная обработка ошибок\n- работа с чистым sql без orm\n- удобный вывод логов в консоль (пока только для основной программы)\n\n## В разработке\n- админ-панель\n- докер контейнер для быстрого запуска и деплоя\n- экспорт данных в csv\n\n## Технологический стек\nPython 3.11+, PostgreSQL/SQLite, asyncpg/aiosqlite, aiogram 3.22+\n\n## Пререквизиты\n- Python 3.11+\n- Telegram bot token (можно получить у @BotFather)\n- PostgreSQL (опционально)\n\n## Установка (локально на ваше устройство)\n\nWindows:\n### 1. Клонируйте репозиторий\n``` bash\ngit clone https://github.com/kfcemployee/aiogram-simple-todo-bot.git\ncd aiogram-simple-todo-bot\n```\n### 2. Настройте виртуальное окружение\n``` bash\npython -m venv .venv\nvenv\\Scripts\\activate \n```\n### 3. Установите зависимости\n``` bash\npip install -r requirements.txt\n```\n### 4. Настройте переменные окружения\nСоздайте .env файл в корне проекта\n``` env\nBOT_TOKEN=ваш токен, полученный у @BotFather\n```\nЕсли собираетесь использовать sqlite (подойдёт для быстрого старта и локальной работы):\n``` env\nDB_TYPE=SQLITE\nSQLITE_PATH=путь у уже существующей бд, если она есть\n```\nЕсли собираетесь использовать postgres:\n``` env\nDB_TYPE=POSTGRES\nDB_USER=ваш суперюзер, чтобы создать новую БД \nDB_PASSWORD=ваш пароль суперюзера\nDB_NAME=todo_db\nDB_HOST=localhost\nDB_PORT=5432\n```\n### 5. Инициализируйте базу данных\nЕсли у вас нет готовой бд, этот скрипт ни на что не повлияет, он создаст бд в зависимости от переменной DB_TYPE, которую вы указали в предыдущем шаге. \n``` bash\npython -m bot.database.init_db\n```\nНовая база данных создастся в каталоге проекта под именем todo_db.db, если вы используете sql, или на localhost:5432, если используете postgres.\n### 6. Запустите бота локально\nВсе таблицы создадутся сами, если их не было.\n```\npython -m bot.main\n```\nГотово✅\n\n## Использование \nСписок команд:\n- /start - запуск или перезапуск бота\n- /list - список всех заданий\n- /listuncompleted - список невыполненных заданий\n- /reminders - список напоминаний\n- /add - добавить напоминание\n\n## В будущем:\n- деплой на сервер\n- докер-контейнер для быстрого развёртывания\n- админ-панель\n- более насыщенный и подробный README\n- ещё много всего\n\nЭтот бот будет обновляться, можете предложить свою идею, улучшение, зарепортить ошибку. Хорошего пользования!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs00inx%2Faiogram-simple-todo-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fs00inx%2Faiogram-simple-todo-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs00inx%2Faiogram-simple-todo-bot/lists"}