Activity Challenge Bot

Appearance

Activity Challenge BotGuild-Based Fitness Competition Platform

A Telegram bot for tracking physical activities and fostering healthy competition among Aalto University guilds.

Getting Started
View Architecture

🏆 Guild Competition System

Real-time leaderboards tracking guild performance based on average points per member, encouraging broad participation over raw numbers.

📊 MET-Based Point System

Science-backed point calculation using Metabolic Equivalents (METs) from the 2024 Compendium of Physical Activities, ensuring fair scoring across all activity types.

🎯 Intuitive Activity Logging

Wizard-based interface guiding users through a 4-level hierarchy of 10+ activities with intensity levels, making logging quick and accurate.

📈 Comprehensive Statistics

Personal rankings, guild standings, activity history, and trend analysis with ranking history visualization.

⚡ High Performance

Built with Bun runtime and PostgreSQL, featuring intelligent caching for guild leaderboards and optimized database queries.

🔒 Privacy First

Only stores necessary data (Telegram ID, name, guild, points). No location tracking, no sensitive personal information.

What is Activity Challenge Bot? ​

Activity Challenge Bot is a Telegram-based fitness competition platform designed for Aalto University guilds. It enables guild members to log their physical activities, earn points based on scientific MET values, and compete in friendly inter-guild challenges.

Key Concepts ​

Guilds: Student organizations or teams that compete against each other. Guild rankings are calculated using average points per member to ensure fair competition regardless of guild size.

MET-Hours: The point system is based on Metabolic Equivalent of Task (MET) values multiplied by activity duration, providing a scientifically valid way to compare different types of physical activities.

Competition Periods: Time-bound challenges (e.g., Q1 2026) with defined start and end dates, allowing for seasonal competitions and fresh starts.

For Administrators ​

For Developers ​

Reference ​

Technology Stack ​

  • Runtime: Bun (fast JavaScript/TypeScript runtime)
  • Database: PostgreSQL with optimized indexing
  • Bot Framework: grammY (Telegram Bot API)
  • Deployment: Kubernetes with Talos Linux (Hetzner Cloud)
  • Web App: React + Vite + TailwindCSS

Project Status ​

This bot was built for the Aalto University community and is currently in active use. The codebase is mature and ready for deployment, with comprehensive testing and production-ready infrastructure configuration.

License ​

This project is released under the MIT License. See LICENSE for details.

Released under the MIT License.

Copyright © 2024-present