Added walkthrough guide

This commit is contained in:
2026-01-16 09:56:17 +03:00
commit 03c66a50a4
7 changed files with 1946 additions and 0 deletions

BIN
jokes-bot-v3.0/.DS_Store vendored Normal file

Binary file not shown.

45
jokes-bot-v3.0/README.md Normal file
View File

@@ -0,0 +1,45 @@
# Telegram Joke Bot
A simple Telegram bot that tells jokes when you send it the `/joke` command.
## Setup Instructions
1. **Install required packages**
```bash
pip install -r requirements.txt
```
2. **Get a bot token**
- Talk to [@BotFather](https://t.me/BotFather) on Telegram
- Create a new bot with `/newbot`
- Copy the token provided by BotFather
3. **Set your bot token**
You can set your bot token in two ways:
Option A: Set as environment variable
```bash
export BOT_TOKEN="your_token_here"
```
Option B: Replace "YOUR_BOT_TOKEN_HERE" in jokes.py with your actual token
4. **Run the bot**
```bash
python jokes.py
```
## Bot Commands
- `/start` - Start the bot and get welcome message
- `/joke` - Get a random joke
- `/help` - Show help message
## Features
- Sends random jokes from a predefined list
- Easy to add more jokes to the collection
- Simple and lightweight implementation

29
jokes-bot-v3.0/app.py Normal file
View File

@@ -0,0 +1,29 @@
from telegram import Update
from telegram.ext import Application, CommandHandler, ContextTypes
import random
JOKE_LIST = [
"Why did the robot go to school? To recharge his brain! 🔋",
"Knock knock!\\nWho's there?\\nLettuce!\\nLettuce who?\\nLettuce in!",
"Why don't eggs tell jokes? They'd crack each other up! 🥚"
]
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
await update.message.reply_text("Hi! Type /joke for a funny joke! 😄")
async def send_joke(update: Update, context: ContextTypes.DEFAULT_TYPE):
joke = random.choice(JOKE_LIST)
await update.message.reply_text(joke)
def main():
# Using the provided bot token
BOT_TOKEN = ""
app = Application.builder().token(BOT_TOKEN).build()
app.add_handler(CommandHandler("start", start))
app.add_handler(CommandHandler("joke", send_joke))
print("Bot is running... Press Ctrl+C to stop.")
app.run_polling()
if __name__ == "__main__":
main()

View File

@@ -0,0 +1 @@
python-telegram-bot