Adventurebot
Adventurebot es un bot privado de Telegram para autogestionar AdventureLog, permitiendo navegar por viajes, ubicaciones y listas de verificación, encontrar lugares cercanos mediante recomendaciones de Google Places y recibir recordatorios diarios de itinerarios.
Ficha actualizada 28 sept 2026, 19:25 · upstream 28 sept 2026, 18:50 · release sin release detectada
Qué es Adventurebot
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Adventurebot es un bot de Telegram diseñado para interactuar con instancias autoalojadas de AdventureLog. Permite a los usuarios explorar sus viajes guardados, visualizar detalles de ubicaciones, gestionar listas de verificación, descubrir lugares cercanos y recibir recordatorios diarios de planes de viaje.
El bot funciona mediante polling largo (sin webhooks), autenticándose en AdventureLog con credenciales de usuario y manteniendo una sesión persistente. Soporta recomendaciones de Google Places alrededor de ubicaciones guardadas o la posición actual del usuario en Telegram, con filtros por categoría y radio configurable.
La configuración se realiza exclusivamente mediante variables de entorno: TELEGRAM_TOKEN para el token del bot, AL_URL/AL_USERNAME/AL_PASSWORD para las credenciales de AdventureLog, ALLOWED_IDS para restringir el acceso a chats específicos, y opciones para schedulers y zona horaria. Incluye soporte nativo para Docker Compose y docker run.
- Acceder al contenido de un viaje autoalojado desde Telegram sin abrir el navegador
- Buscar lugares cercanos (comida, alojamiento, turismo) alrededor de una ubicación guardada o la posición actual en Telegram
- Gestionar listas de verificación de viajes: marcar ítems, añadir nuevos elementos y eliminarlos
- Recibir recordatorios diarios automáticos de tareas pendientes y resúmenes nocturnos del itinerario del día siguiente
- Consultar qué ubicación se visitaba en una fecha específica mediante búsqueda por fecha
- No requiere puertos entrantes ni webhooks: usa polling largo con python-telegram-bot
- Recomendaciones de Google Places integradas con filtros por categoría y radio configurable (5, 10, 20 o 50 km)
- Acceso restringible mediante allowlist de IDs de chat de Telegram para uso privado
- Schedulers persistentes en archivo JSON local con recordatorios diarios y resúmenes nocturnos configurables
- Manejo automático de expiración de sesión en AdventureLog con reautenticación transparente
- Reporte claro de errores de autenticación en el chat en lugar de resultados vacíos
- Requiere una instancia de AdventureLog v0.11 o superior con soporte para recomendaciones de Google Places
- Las recomendaciones cercanas dependen de la configuración de AdventureLog (posible necesidad de API key de Google Maps)
- Los schedulers en Docker requieren permisos correctos en el volumen montado para persistir la configuración
- Variables de entorno obligatorias: TELEGRAM_TOKEN, AL_URL, AL_USERNAME y AL_PASSWORD; sin ellas el bot no inicia
- SCHEDULER_CONFIG debe ser variable de entorno real (no solo en .env) porque se lee antes de cargar el archivo
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Recomendado ejecutar con Docker Compose. Crear archivo .env con TELEGRAM_TOKEN, AL_URL, AL_USERNAME, AL_PASSWORD y ALLOWED_IDS opcional. Montar carpeta local para persistencia de schedulers en /app/data. Para Docker run: usar -v "$(pwd)/data:/app/data" y pasar todas las variables como entorno. Verificar que AdventureLog tenga habilitadas las recomendaciones con sources=google.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.