https://github.com/ridzimeko/celia-bot
Simple group management bot built with Grammy and MongoDB
https://github.com/ridzimeko/celia-bot
grammy mongodb telegram-bot
Last synced: 2 months ago
JSON representation
Simple group management bot built with Grammy and MongoDB
- Host: GitHub
- URL: https://github.com/ridzimeko/celia-bot
- Owner: ridzimeko
- License: gpl-3.0
- Created: 2024-07-24T15:55:22.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-08-06T11:55:13.000Z (10 months ago)
- Last Synced: 2025-01-18T16:10:58.726Z (4 months ago)
- Topics: grammy, mongodb, telegram-bot
- Language: TypeScript
- Homepage:
- Size: 102 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Celia
[](https://t.me/CeliaMekoBot) [](https://github.com/ridzimeko/celia-bot/blob/main/LICENSE) [](https://github.com/ridzimeko/celia-bot/issues)
## Description
Celia is a simple group Management bot that allows you to moderate your Telegram group. You must be an administrator to use this bot.
Can be found on Telegram at [@CeliaMekoBot](https://t.me/CeliaMekoBot)
## Features
- Promote, demote, ban, mute, and unban users
- Pin and unpin messages
- Translate messages using DeepL API
## TODO
- [ ] Clean services messages (eg. new member, pin message, forum topic etc.)
- [ ] Add support for other languages **(currently it's only Indonesian)**
- [ ] Manage groups settings in the bot
- [ ] Notes and filters in groups
## Installation
1. Clone the repository:
```bash
git clone https://github.com/ridzimeko/celia-bot.git
```
2. Install the required dependencies:
```bash
npm install
```
3. Build the code:
```bash
npm run build
```
4. Copy `.env.example` file to `.env` and set up the environment variables:
- `BOT_TOKEN`: The token for your bot.
- `MONGODB_URL`: The URL for your MongoDB database.
- `BOT_CHATID_LOG`: The chat ID for logging purposes.
- `DEEPL_API_KEY`: The API key for DeepL translation.
5. Start the bot:
```bash
npm start
```
And done! Your bot is now ready to use, type `/help` to get all the available commands.
## Contributing
Contributions are welcome! If you find any issues or have suggestions for improvements, feel free to open an issue or submit a pull request.
## License
This project is licensed under the GPL-3.0-only License. See the [LICENSE](LICENSE) file for more details.