Open source

Run, inspect, or adapt mymood.

mymood is an MIT-licensed Telegram mood tracker built with Firebase and the Telegram Bot API. This page is for developers, self-hosters, and teams evaluating the project internals.

What is inside the project.

The repository contains the bot logic, Firebase deployment setup, reminder scheduling, mood entry storage, and basic privacy controls.

Telegram bot flow

Inline mood buttons, commands, optional notes, history views, and user preference handling.

Firebase backend

Functions, Firestore, scheduler jobs, environment examples, and deployable project configuration.

Customizable base

MIT licensing and a small data model make it practical to adapt for personal or community use.

Setup

Clone the repo and configure your Firebase project.

Use the included example config files, add your Telegram bot credentials, install dependencies, then build and deploy through Firebase.

Firebase Functions, Firestore, Cloud Scheduler, and the Telegram Bot API.
User records, mood entries, reminder preferences, and delete flow support.
Setup and customization docs live in the repository.
git clone https://github.com/joshmeadixo/mymood.git
cd mymood

cp .firebaserc.example .firebaserc
cp functions/.env.example functions/.env
cp functions/.secret.local.example functions/.secret.local

cd functions
npm install
npm run build