{"id":19605251,"url":"https://github.com/macket/inspector_habit_tamtam","last_synced_at":"2026-05-16T19:02:25.398Z","repository":{"id":41910988,"uuid":"217379388","full_name":"Macket/inspector_habit_tamtam","owner":"Macket","description":"Inspector Habit helps people to develop good habits and break bad ones. Users can also plan their day and create reminders via voice messages.","archived":false,"fork":false,"pushed_at":"2022-04-22T23:30:34.000Z","size":627,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-09T08:46:41.942Z","etag":null,"topics":["python","tamtambot"],"latest_commit_sha":null,"homepage":"https://tt.me/inspector_habit","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/Macket.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}},"created_at":"2019-10-24T19:30:37.000Z","updated_at":"2021-01-22T17:02:53.000Z","dependencies_parsed_at":"2022-08-11T21:01:08.324Z","dependency_job_id":null,"html_url":"https://github.com/Macket/inspector_habit_tamtam","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Macket%2Finspector_habit_tamtam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Macket%2Finspector_habit_tamtam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Macket%2Finspector_habit_tamtam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Macket%2Finspector_habit_tamtam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Macket","download_url":"https://codeload.github.com/Macket/inspector_habit_tamtam/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240888745,"owners_count":19873691,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["python","tamtambot"],"created_at":"2024-11-11T09:42:04.261Z","updated_at":"2026-05-16T19:02:25.322Z","avatar_url":"https://github.com/Macket.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Inspector Habit — 🏆 [The Winner](https://tamtam.chat/botapichannel/AW5LroptDXs) of TamTam [bot developers contest](https://blog.tamtam.chat/ru/2019/08/02/)\n\nInspector Habit is a [TamTam](https://tamtam.chat/) bot which helps people to develop good habits and break bad ones. Users can also plan their day and create reminders via voice messages.\n\n\n## Getting Started\n\nInspector Habit bot requires Python 3.7 and packages specified in ```requirements.txt```.\n\nYou can install them with\n\n```\npip install -r requirements.txt\n```\n\nBefore you start Inspector Habit it is necessary to create ```.env``` file:\n\n```\ntouch .env\n```\n\nand fill in this file according to the example below:\n\n```\nDEBUG = True\n\nTT_BOT_API_TOKEN = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\nADMIN_ID = XXXXXXXXXXX\n\nDATABASE_URL = postgres://XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\n\nDB_NAME = inspector_habit_db\nDB_USER = user\nDB_PASSWORD = XXXXXXXXXXX\nDB_HOST = localhost\n```\n\n```DEBUG``` should be **False** in prod\n\n```TT_BOT_API_TOKEN``` is the token got from [PrimeBot](https://tt.me/primebot)\n\n```ADMIN_ID``` is the TamTam id of the admin\n\n```DATABASE_URL``` is used to access the database in prod\n\n```DB_NAME```, ```DB_USER```, ```DB_PASSWORD``` and  ```DB_HOST```  are used to access the database in dev\n\nThen you can start Inspector Habit with this command:\n\n```\npython main.py\n```\n\n## Use case\n\nThere are three main functions in the menu: **🗓 Habits**, **📝 Plans** and **🔔 Reminders**.\n\n![1](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/1.png)\n\n### 🗓 Habits\n\n![2](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/2.png)\n\nLet's see current active habits.\n\n![3](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/3.png)\n\nAnd let's create a new one.\n\n![4](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/4.png)\n\n![5](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/5.png)\n\nWhen check time is coming, we will get the following message from Inspector Habit.\n\n![6](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/6.png)\n\nSuppose we kept our promise and tap **✅ Yes**.\n\n![7](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/7.png)\n\n### 📝 Plans\n\n![8](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/8.png)\n\nLet's create today plan.\n\n![9](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/9.png)\n\nOk, plan is ready.\n\n![10](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/10.png)\n\nNow we can report.\n\n![11](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/11.png)\n\nSuppose that we have done README.\n\n![12](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/12.png)\n\nWhen report is ended we will see the following.\n\n![13](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/13.png)\n\nAnd can create tomorrow plan.\n\n### **🔔 Reminders**\n\n![14](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/14.png)\n\nHow to create reminders?\n\n![15](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/15.png)\n\nOk, we don't have any reminders, so let's create the first one.\n\n![16](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/16.png)\n\nAnd we get a reminder in time.\n\n![17](https://raw.githubusercontent.com/Macket/inspector_habit_tamtam/master/img/readme/17.png)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacket%2Finspector_habit_tamtam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmacket%2Finspector_habit_tamtam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacket%2Finspector_habit_tamtam/lists"}