https://github.com/sazumivicky/tbot

This Telegram bot is built using Telethon and is designed to handle various commands. The bot has a modular structure, where each command is defined in a separate Python file in the src/cmd directory.
https://github.com/sazumivicky/tbot

sazumi sazumiviki telegram telegram-bot telethon telethon-bot

Last synced: about 1 month ago
JSON representation

This Telegram bot is built using Telethon and is designed to handle various commands. The bot has a modular structure, where each command is defined in a separate Python file in the src/cmd directory.

• Host: GitHub
• URL: https://github.com/sazumivicky/tbot
• Owner: SazumiVicky
• Created: 2024-02-17T08:01:01.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-02-17T08:21:27.000Z (11 months ago)
• Last Synced: 2024-04-14T14:14:44.476Z (9 months ago)
• Topics: sazumi, sazumiviki, telegram, telegram-bot, telethon, telethon-bot
• Language: Python
• Homepage: https://sazumi.moe
• Size: 8.79 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.MD

Awesome Lists containing this project

README

        
This Telegram bot is built using Telethon and is designed to handle various commands. The bot has a modular structure, where each command is defined in a separate Python file in the `src/cmd` directory.

### Commands

Here's a list of available commands:

- `/menu`: Displays a list of all available commands. The bot will greet the user and provide a list of commands in an easy-to-read format.

- `/ping`: The bot will respond with a message "Pong!".

### Setup and Usage

1. Copy the `.env.example` file to a new file named `.env`.

2. Fill in `API_ID` and `API_HASH` in the `.env` file with your Telegram API details.

3. Run the bot with the command `python main.py`.

### Adding New Commands

To add a new command, follow these steps:

1. Create a new Python file in the `src/cmd` directory. For example, `src/cmd/hello.py`.

2. Inside this file, define a `handle` function that will be called when the command is received. This function should take two arguments: `event` and `client`.

3. Inside the `handle` function, you can write the logic to handle the command.

4. Define a `cmd_info` dictionary that contains details about the command. This should include a `cmd` key that specifies the command text, and can also include other keys such as `help` and `category`.

Here's an example of a new command:

```python

async def handle(event, client):

    await client.send_message(event.message.to_id, "Hello, world!")

cmd_info = {

    "cmd": "/hello",

    "help": "Sends a 'Hello, world!' message",

    "category": "main",

}

```

### Contributor 

- [Sazumi Viki](https://instagram.com/moe.sazumiviki)