Gladiator Telegram Bot

A Telegram bot built with TypeScript and the Grammy framework.

Features

• Custom commands with gladiator-themed responses
• Status and information commands
• Built with TypeScript for type safety
• Easy to extend and customize

Prerequisites

• Node.js (v18 or higher recommended)
• A Telegram Bot Token from @BotFather

Setup

1. Clone the repository and install dependencies:

npm install

2. Create a .env file from the example:

cp .env.example .env

3. Get your bot token:

   • Open Telegram and search for @BotFather
   • Send /newbot command
   • Follow the prompts to create your bot
   • Copy the token provided

4. Add your bot token to the .env file:

BOT_TOKEN=your_bot_token_here

Development

Run the bot in development mode with hot reload:

npm run dev

Building

Compile TypeScript to JavaScript:

npm run build

Production

Run the compiled bot:

npm start

Available Commands

• /start - Show welcome message and available commands
• /help - Get help information
• /status - Check bot status and uptime
• /info - Get bot information
• /gladiator - Get a random gladiator quote

Project Structure

gladiator_telegram_bot/
├── src/
│   └── index.ts          # Main bot code
├── dist/                 # Compiled JavaScript (generated)
├── .env                  # Environment variables (not committed)
├── .env.example          # Example environment file
├── .gitignore           # Git ignore rules
├── package.json         # Project dependencies
├── tsconfig.json        # TypeScript configuration
└── README.md            # This file

Adding New Commands

To add a new command, edit src/index.ts and add:

bot.command("yourcommand", (ctx) => {
  ctx.reply("Your response here");
});

Learn More

• Grammy Documentation
• Telegram Bot API
• TypeScript Documentation

License

ISC