README.md

metadata

title: Ginchiee Bot
emoji: 🌸
colorFrom: pink
colorTo: purple
sdk: gradio
app_file: app.py
app_port: 7860
pinned: false

🍎 Ginchiee — AI Diet Companion Bot

Bot Telegram yang membantu kamu menjaga pola makan melalui reminder cerdas, food logging, estimasi nutrisi, dan percakapan natural dengan AI.

✨ Fitur MVP

• 🤖 AI Conversation — Ngobrol natural tentang diet & pola makan
• 📝 Food Logging — Catat makanan dengan bahasa natural
• 📊 Nutrition Tracking — Hitung kalori, protein, karbs, lemak otomatis
• ⏰ Intelligent Reminder — Reminder makan yang personal & kontekstual
• 👤 User Profile — Setup profil & target nutrisi personal
• 🎯 Daily Progress — Pantau progress nutrisi harian

🚀 Quick Start

1. Clone & Setup

git clone <repo>
cd ginchiee-bot
python -m venv .venv
.venv\Scripts\activate        # Windows
# source .venv/bin/activate   # Linux/Mac
pip install -r requirements.txt

2. Konfigurasi

cp .env.example .env

Edit .env:

TELEGRAM_BOT_TOKEN=your_bot_token_here
GEMINI_API_KEY=your_gemini_api_key_here

Cara dapat token:

• Telegram Bot Token: Chat @BotFather di Telegram → /newbot
• Gemini API Key: https://aistudio.google.com/app/apikey

3. Jalankan

python main.py

📋 Commands

Command	Fungsi
/start	Mulai & setup profil
/profile	Lihat profil & target nutrisi
/today	Progress nutrisi hari ini
/log [makanan]	Catat makanan
/schedule	Atur jadwal makan & reminder
/reminders	Lihat jadwal makan
/help	Bantuan

🏗️ Struktur Project

ginchiee-bot/
├── main.py                       # Entry point
├── config/
│   └── settings.py               # Konfigurasi (fail-fast)
├── database/
│   ├── connection.py             # PostgreSQL pool (asyncpg)
│   ├── migrations.py             # Migrasi berversi
│   └── migrations/               # 0001_initial.sql, 0002_...
├── nutrition/
│   ├── calculator.py             # BMR/TDEE/macro calculator
│   ├── food_database.py          # Database nutrisi makanan
│   └── parser.py                 # NLP food parser
├── services/
│   ├── ai_service.py             # Gemini LLM abstraction
│   ├── personality.py            # Persona, few-shot, sanitizer
│   ├── intent_service.py          # Router intent (1 call/pesan)
│   ├── nutrition_service.py       # Food logging, koreksi & hapus
│   ├── reminder_service.py        # Reminder generation
│   ├── scheduler_service.py       # APScheduler
│   └── user_service.py            # User CRUD
├── scripts/
│   └── migrate_sqlite_to_postgres.py
├── bot/
│   ├── conversations/
│   │   └── onboarding.py         # Multi-step registration
│   └── handlers/
│       ├── activity_handler.py
│       ├── food_handler.py
│       ├── help_handler.py
│       ├── message_handler.py     # Router + konfirmasi
│       ├── photo_handler.py
│       ├── profile_handler.py
│       ├── schedule_handler.py
│       └── today_handler.py
└── tests/
    ├── test_database.py          # Migrasi, wrapper, SQL nyata
    ├── test_personality.py       # Sanitizer & gaya bicara
    ├── test_intent_router.py     # Parser intent
    └── test_huggingface_runtime.py

🔧 Stack

• Python 3.11+
• python-telegram-bot — Telegram handler
• Google Gemini — LLM (persona + JSON-mode router)
• PostgreSQL + asyncpg — Database (Neon / Supabase / lokal)
• APScheduler — Meal & activity reminder scheduler
• Migrasi berversi — database/migrations/NNN_*.sql, idempotent per boot

⚙️ Konfigurasi

Env	Wajib	Isi
TELEGRAM_BOT_TOKEN	✅	Token dari @BotFather
GEMINI_API_KEY	✅	API key Google AI Studio
DATABASE_URL	✅	Connection string Postgres
ALLOWED_USER_IDS	—	Batasi bot ke user id tertentu (koma)
AI_TEMPERATURE	—	Default 0.95
GEMINI_MODEL	—	Default gemini-flash-lite-latest

Di Hugging Face, set variabel ini di Settings → Variables and secrets, bukan memakai file .env.

⚠️ Disclaimer

Ginchiee adalah AI companion, bukan dokter atau ahli gizi. Semua estimasi nutrisi bersifat perkiraan. Konsultasikan ke profesional kesehatan untuk saran medis.