suki-9/yuuka

Yuuka is a Discord bot paired with a web-based admin dashboard, built around Google's Gemini AI. The bot takes on the personality of Yuuka Hasegawa, a character from the mobile game Blue Archive, and acts as a personal secretary: managing your tasks, schedule, and household budget through ordinary chat messages. The README is written in Japanese, and the project is presented as a fan-made, non-commercial creation inspired by that game. On the Discord side, you can add tasks with due dates and priority levels by describing them in plain conversation, and the bot records and tracks them. For scheduling, it syncs events to Google Calendar automatically. It also handles quick reminders that stay local to Discord, for cases where you just want a mention in a few minutes without cluttering your calendar. For budgeting, typing something like "spent 1200 yen on groceries" is enough for the bot to extract the amount, assign it a category from a list of nine, and log it. You can then ask for monthly summaries or a breakdown by category. If you take a photo of a receipt and drop it into Discord, Gemini reads the image, identifies each item, and records the expenses automatically. The web dashboard runs alongside the bot and gives you a browser interface to view and manage all your data in one place. It has a login system with rate limiting to prevent unauthorized access, charts for recent spending and scheduled events, and the ability to upload receipt images directly from the browser. You can also manage which Google Calendars the bot syncs to from this dashboard, and switch between multiple user profiles. Setup requires a Discord bot token, a Redis instance, and optionally Google OAuth credentials for calendar sync. The code is released under the MIT license, while the character and game-related creative elements belong to Nexon Games and Yostar.