Contest Pulse

Features

Reliable Contest Tracking

Fetches contests from multiple sources to ensure complete coverage of Codeforces and AtCoder.

Smart Reminder System

Sends contest reminders at 1 day, 6 hours, and 30 minutes before each contest.

Timezone Support

Configure your local timezone for displaying contest times accurately.

Optimized Performance

Reduced API calls with smart caching and fallback mechanisms for API failures.

Bot Commands

!contests

Shows all upcoming contests within the configured timeframe

!today

Shows contests happening today with time until start

!tomorrow

Shows contests happening tomorrow

!setup-reminders

Manually refreshes contest data and reschedules reminders

!health

Performs a health check on the contest APIs

!help

Shows a list of available commands

Setup Guide

Create a Discord Bot

Go to the Discord Developer Portal, create a new application, and add a bot to it.

Get Clist.by API Credentials

Create an account on Clist.by and get your API key for reliable AtCoder contest data.

Configure Environment Variables

Set up your .env file with Discord credentials, Clist.by API key, and optional settings.

Deploy the Bot

Deploy the bot using Railway, Heroku, or run it on your own server.

Environment Variables Example

# Required Discord Bot Configuration
DISCORD_TOKEN=your_discord_bot_token
DISCORD_CHANNEL_ID=your_discord_channel_id

# Clist.by API Credentials
CLIST_USERNAME=your_clist_username
CLIST_API_KEY=your_clist_api_key

# Optional Settings
TIMEZONE=Asia/Dhaka
CONTEST_DAYS_AHEAD=7

Deployment Options

Local Deployment Railway Deployment

For complete documentation and advanced configuration options, read the full README.md on GitHub.

Never Miss a Coding Contest Again