tianoklein/t.i.a-da-limpeza

T.I.A da Limpeza is an operational assistant for people who manage short term rental apartments listed on Airbnb, built to keep cleaning staff informed about check-ins and check-outs without the host having to message them manually every time a booking changes. The README is written in Portuguese and describes the tool as aimed at small and medium hosts and property managers running a lean operation. The system connects to each apartment's Airbnb calendar using the iCal link that Airbnb provides in its calendar settings. It watches that calendar for new bookings or changes to existing ones and sends real time notifications to the cleaning staff's Telegram accounts, so a schedule change reaches the right person automatically instead of depending on the host remembering to forward it. Beyond the notifications, the project includes a conversational bot on Telegram powered by a locally running language model through Ollama. Cleaning staff can ask the bot common questions, like what time a check-in or check-out is, or what the specific cleaning instructions are for a given apartment, and the bot answers using a FAQ file that is generated automatically for each property. The README states the whole system is designed to run entirely locally, with no subscription fees and no dependence on paid external APIs, so that personal data stays on the host's own machine. Setup involves Python 3.10 or newer, installing dependencies from a requirements file, and filling in a JSON file with each apartment's details, calendar link, and Telegram chat ID, along with a separate environment file for the Telegram bot token and Ollama configuration. A Streamlit dashboard is included for managing apartment settings and viewing all the schedules in one place.