https://github.com/jenarvaezg/cunhaobot
Small Telegram bot that returns brother-in-law-like phrases like ¿Que pasa, maquina?
https://github.com/jenarvaezg/cunhaobot
chatbot google-cloud python telegram telegram-bot
Last synced: 4 months ago
JSON representation
Small Telegram bot that returns brother-in-law-like phrases like ¿Que pasa, maquina?
- Host: GitHub
- URL: https://github.com/jenarvaezg/cunhaobot
- Owner: jenarvaezg
- Created: 2019-02-13T12:46:17.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2026-01-01T16:55:15.000Z (6 months ago)
- Last Synced: 2026-01-01T20:52:09.035Z (6 months ago)
- Topics: chatbot, google-cloud, python, telegram, telegram-bot
- Language: Python
- Size: 9.96 MB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# cunhaobot
Small Telegram bot that returns brother-in-law-like phrases like ¿Que pasa, maquina?
Puedes consultar el archivo de la sabiduría cuñadil en [https://cunhaobot.nw.r.appspot.com/](https://cunhaobot.nw.r.appspot.com/)
## Características y Comandos
El bot es una parodia afectuosa del típico "cuñado" español. Ofrece:
* **IA Conversacional:** Menciona al bot o háblale por privado y te responderá sentando cátedra sobre cualquier tema.
* **Gestión de Comunidad:** Sistema de puntos, ranking y medallas.
### Comandos Principales
* `/cuñao [texto]`: Devuelve una frase aleatoria o filtrada.
* `/sticker [texto]`: Envía un sticker.
* `/saludo [nombre]`: Genera un saludo personalizado (ej: "¿Qué pasa, fiera?").
* `/proponer [texto]`: Propone nuevas frases para el repertorio.
* `/perfil`: Muestra tus estadísticas y medallas.
### Fusión de Cuentas (/link)
Si usas el bot en varias plataformas (Telegram y Slack), puedes unificar tu perfil:
1. En la cuenta que quieras **abandonar** (origen), escribe `/link`. El bot te dará un código.
2. En tu cuenta **principal** (destino), escribe `/link `.
3. Tus puntos y medallas se transferirán a la cuenta principal y la de origen se borrará.
## Desarrollo Local
Para probar el bot en local sin depender de GCP:
1. **Configura el entorno:** Copia el archivo de ejemplo y rellena tus tokens:
```bash
cp .env.example .env
```
2. **Arranca el emulador y la app:** El script `dev.sh` se encarga de levantar el emulador de Datastore mediante Docker y arrancar el servidor Litestar:
```bash
./dev.sh
```
### Requisitos
- Docker y Docker Compose
- [uv](https://github.com/astral-sh/uv)
- Python 3.14