https://github.com/pedroh183/echo_walrus
This is a Telegram bot that can talk with you using AI (Artificial Intelligence). It uses Gemini AI to understand and answer your messages.
https://github.com/pedroh183/echo_walrus
chatbot gemini-api google python telegram webhook
Last synced: about 1 year ago
JSON representation
This is a Telegram bot that can talk with you using AI (Artificial Intelligence). It uses Gemini AI to understand and answer your messages.
- Host: GitHub
- URL: https://github.com/pedroh183/echo_walrus
- Owner: PedroH183
- Created: 2025-04-06T20:50:33.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-06T20:54:39.000Z (about 1 year ago)
- Last Synced: 2025-04-06T21:32:48.710Z (about 1 year ago)
- Topics: chatbot, gemini-api, google, python, telegram, webhook
- Language: Python
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Echo Walrus - Smart Telegram Bot
This is a Telegram bot that can talk with you using AI (Artificial Intelligence). It uses Gemini AI to understand and answer your messages.
## What This Bot Can Do
- 🤖 Talks with you using AI
- 💬 Has simple commands like /start and /help
- 🔄 Answers your messages quickly
- 🛡️ Handles errors well
- 🔌 Easy to add new AI features
## What You Need
- Python 3.13 or newer
- A Telegram Bot Token (get it from @BotFather)
- A Gemini API Key
- Docker and Docker Compose (if you want to use containers)
## How to Install
1. Get the code:
```bash
git clone https://github.com/yourusername/echo-walrus.git
cd echo-walrus
```
2. Set up your keys:
```bash
cp .env.example .env
```
Open the `.env` file and add your keys:
```
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
GEMINI_API_KEY=your_gemini_api_key
```
3. Start the bot:
```bash
docker compose up -d
```
## How to Use
After starting, the bot will be ready to talk with you. Send `/start` to begin.
## Bot Commands
- `/start` - Start talking with the bot
- `/help` - Get help information
## Files in This Project
```
echo_walrus/
├── app/
│ ├── bot/
│ │ └── telegram_bot.py
│ └── ia_models/
│ ├── base.py
│ ├── gemini.py
│ └── factory.py
├── main.py
├── setup.py
├── docker-compose.yml
├── Dockerfile
└── README.md
```
## License
This project uses the MIT License. You can use it for free.