Skip to content

Sarthib7/Kaizen

Repository files navigation

Kaizen 改善

Your daily accountability partner on Telegram.

Turn your goals into unstoppable streaks with the power of group accountability.


Why Kaizen?

Research shows that accountability increases goal completion from 10% to 95%. Kaizen makes accountability effortless:

  • ✅ Set your daily commitment (30 seconds)
  • 📱 Check in daily via Telegram
  • 👥 Your progress is shared with your accountability group
  • 🔥 Build streaks, earn ranks, achieve your goals

Kaizen (改善) = Continuous improvement, one day at a time.


Features

Core Accountability Features

🎯 Group Accountability - Add bot to existing Telegram groups, check-ins post automatically 🥋 Rank System - White Belt → Black Belt (Sensei) as you build consistency 🔥 Streak Tracking - Visual progress & milestone celebrations 🌸 Japanese Wisdom - Daily kotowaza (proverbs) for inspiration 📊 Leaderboards - Friendly competition with your group ⏰ Smart Reminders - Never miss a day

🤖 AI Assistant (NEW!)

🧠 AI Chat - Ask anything via text or voice using Groq's Llama 3.3 70B 🎙️ Voice Messages - Send voice, get transcribed and answered automatically 🔬 Deep Research - Web-grounded answers with sources via Perplexity 💬 Natural Language - Just ask questions normally in private chats ⚡ Ultra Fast - Responses in 1-2 seconds with Groq 📚 Conversation Memory - AI remembers context from recent messages

📖 Read the full AI Assistant Guide

⚙️ MCP Workflow Automation

🔬 Research Assistant - Research any topic and generate comprehensive documents 🌐 Web Scraper - Extract content from web pages and save as documents 📄 Document Creator - Create PDFs and formatted documents 📅 Calendar Integration - Manage Google Calendar events 📝 Notion Integration - Save research and notes to Notion 💾 Google Drive - Upload and organize files in Drive 🗂️ Obsidian Sync - Create and update notes in your Obsidian vault 🔄 Workflow Orchestration - Chain multiple tools for complex automation

📖 Read the full MCP Automation Guide


Quick Start

For Users

  1. Message the bot - Find @YourBotName on Telegram
  2. Set your goal - /start to set daily commitment
  3. Join a group - Add bot to group with friends/family
  4. Check in daily - /checkin privately, bot announces to group
  5. Track progress - /view, /stats, /leaderboard

For Developers

# Clone repo
git clone https://github.com/yourusername/kaizen.git
cd kaizen

# Install dependencies
npm install

# Setup environment
cp .env.example .env
# Add: BOT_TOKEN, TURSO_DATABASE_URL, TURSO_AUTH_TOKEN

# Initialize database
npm run db:push

# Run
npm run dev

Requirements: Node.js 20+, Telegram bot token, Turso database


Tech Stack

  • Runtime: Node.js + TypeScript
  • Bot Framework: grammy (Telegram bot)
  • Database: Turso (libSQL)
  • Automation: Model Context Protocol (MCP)
  • Integrations: Notion API, Google APIs, Obsidian (file system)
  • Web Scraping: Cheerio, Axios
  • Document Generation: PDFKit
  • Deploy: Railway / Any Node.js host

Commands

Accountability Commands:

  • /start - Begin your journey
  • /checkin - Daily check-in with task tracking
  • /addtask - Add a new task to track
  • /removetask - Remove a task
  • /view - Progress calendar & streaks
  • /stats - Your rank & detailed stats
  • /groups - See your accountability groups
  • /quote - Japanese wisdom

Group Commands:

  • /today - Who checked in today
  • /leaderboard - Group rankings

🤖 AI Assistant Commands (NEW):

  • /ask <question> - Ask AI anything (text chat)
  • /dr <topic> - Deep research with web sources
  • 🎙️ Voice message - Send voice, get AI response

⚙️ Automation Commands:

  • /automate - Open automation hub
  • /research - Research a topic and create documents
  • /scrape - Extract content from web pages
  • /calendar - Manage Google Calendar events
  • /help - Show all commands and features

Philosophy

"When you share your goal with someone and have regular check-ins, your chances of success increase to 95%."

Kaizen turns this research into a simple, frictionless Telegram experience.


License

MIT - Built with ☕ and continuous improvement in mind.


Start building your streak today. 改善

About

Accountability Bot

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •