Homka Bot is a full automation bot for the Homka Telegram Miniapp.
It handles the complete cycle: signing each account in, claiming the daily streak bonus, refilling the energy bar with the boost, draining the whole energy bar through tap batches, spending the balance on the cheapest affordable upgrade and level, then reporting the referral and leaderboard position, all running automatically across multiple accounts with proxy support and a live countdown between cycles.
Built and distributed by Yuurisandesu.

• Requirements
• Installation
• Configuration
• Running the Bot
• Features
• File Structure
• Disclaimer

• Python 3.12+
• Git

Clone the repository:

git clone https://github.com/Yuurisan-N1/Homka-Miniapp.git
cd Homka-Miniapp

Install dependencies:

pip install aiohttp yuurisan

Fill data.txt with Telegram WebApp initData for each account, one per line:

user=%7B%22id%22...&hash=abc123
user=%7B%22id%22...&hash=def456

initData can be obtained from the browser DevTools when opening Homka on Telegram Web.

Fill proxy.txt with proxies, one per line (optional, leave empty to run without proxy):

host:port
host:port:user:pass
http://user:pass@host:port

Proxies are assigned to accounts by index in round-robin order.

sleep_seconds controls how many seconds the bot waits between cycles. If config.json is missing or unreadable, the bot falls back to a default of 3600 seconds.

python bot.py

Press Ctrl+C at any time to stop the bot cleanly.

The bot reads the account state, takes the current tap power and the remaining energy, and charges the largest tap batch the server will accept. The credited tap count and the coin amount are read from that same server answer and logged per batch. When the energy bar drops below the tap cost, the phase reports that tapping has stopped and hands over to the next phase.

The bot asks the server for the daily bonus on every cycle. A freshly paid streak logs the coin amount and the streak day straight from the answer, and a streak that was already collected today logs one line saying so instead of failing.

The bot requests the energy boost, which refills the bar to the maximum. While the boost is on cooldown, the bot logs the remaining wait as a HH:MM:SS countdown taken from the account's own next available timestamp.

With the tapped balance available, the bot walks the upgrade and level options from the cheapest to the most expensive, buys the first one the server accepts, and logs the purchase with the coin amount read from the balance difference the server reports. The walk repeats until the server refuses every remaining option as insufficient funds, which is logged as a single line.

Every cycle the bot reads the referral summary and the leaderboard, then logs the number of invited friends, how many of them are active, and the account's own leaderboard position with the coins earned so far.

All accounts in data.txt are processed sequentially within every cycle. Username, balance, and referral count are logged at the start of each account, and the cycle closes with the balance the server reports.

Proxies are loaded from proxy.txt and assigned to accounts by position in round-robin order. Proxy credentials are masked in log output. Running without proxies is fully supported.

After all accounts complete a cycle, the bot displays a live HH:MM:SS countdown until the next cycle starts.

Homka-Miniapp/
├── bot.py          # Main bot, full cycle automation
├── config.json     # Sleep duration between cycles
├── data.txt        # Account initData, one per line
├── proxy.txt       # Proxy list, one per line (optional)
├── LICENSE         # License file
└── utils/
    └── banner.py   # Banner using yuurisan module

This tool is built for educational and technical exploration purposes. Use it wisely and at your own responsibility.