BikeScout

BikeScout está diseñado para ciclistas y ciclistas de montaña. Proporciona recomendaciones inteligentes de rutas combinando datos cartográficos del mundo real con análisis avanzados de trazado.

GitHub
22

Documentación

BikeScout

Planificador de rutas ciclistas de IA de código abierto para MTB, gravel, carretera y bicicletas eléctricas

License: AGPL v3 Version Python PRs Welcome

BikeScout es un motor de IA especializado para la planificación de misiones de MTB, carretera, bicicletas eléctricas y gravel. Transforma datos cartográficos en bruto en Inteligencia Táctica, prediciendo las condiciones del terreno y los peligros de los senderos. El sistema proporciona consejos de configuración precisos, adaptando tu equipo a las exigencias de la ruta específica, identificando desafíos técnicos y riesgos ambientales antes de que siquiera salgas del garaje.

Inicio rápido

Cómo usar BikeScout

🎥 Haz clic para ver la GUI de BikeScout

🎥 Haz clic para ver una demostración

Explora BikeScout

  • Guía de usuario Referencias detalladas de la API y guías paso a paso para implementar BikeScout.

  • Sitio web Explora el desglose visual de Mud Logic, la clasificación de terreno S-Scale y cómo transformamos los datos brutos de OSM en inteligencia lista para la misión. Consulta los últimos informes de análisis de carreras de las rutas legendarias.

¿Te encanta BikeScout? ⭐ Marca este repositorio con una estrella para apoyar el desarrollo del primer motor táctico de ciclismo de código abierto.

¿Encontraste un error? Abre un Issue. ¿Quieres añadir una habilidad local? ¡Las solicitudes de extracción (PRs) son bienvenidas!

Consultas de ejemplo

Puedes hacer a BikeScout solicitudes complejas de varios pasos. Combina datos en tiempo real con inteligencia técnica de ciclismo para proporcionar respuestas de nivel experto.

🗺️ Planificación avanzada (multiherramienta)

  • "Estoy en Monte Cavo con mi bicicleta de MTB (neumáticos de 29). Planifica un bucle de 25 km para mí. Comprueba si el terreno es compatible con mi bicicleta, verifica la probabilidad de lluvia por la tarde y sugiere una 'Fraschetta' para el final. Usa la guía de Castelli Romani."

⚙️ Configuración de la bicicleta e inteligencia de superficie

  • "Comprueba esta ruta desde el centro de Barcelona hasta El Prat. Voy en una bicicleta de carretera con neumáticos de 25 mm. ¿Es compatible? Dame el porcentaje exacto de gravel frente a asfalto."

📈 Análisis visual de elevación y pendiente

  • "Planifica una ruta de 40 km que comience en Bormio. Necesito el Perfil Visual de Elevación para ver las pendientes exactas del ascenso al Stelvio. Resalta las secciones superiores al 12% para poder gestionar mi ritmo."

🏔️ Experiencia local

  • "Usa la guía local de Derby para planificar una ruta de carretera que comience en Derby. Necesito al menos 800 m de desnivel positivo. Además, recomienda la presión de neumáticos correcta para descensos a gran altitud."

🛠️ Verificaciones técnicas rápidas

  • "Dame la lista de verificación de seguridad y calcula la presión de neumáticos para un ciclista de 90 kg con neumáticos tubeless de 2.3" para un paseo embarrado."

🏁 Análisis posterior al paseo y verdad del terreno

  • "Analiza mi paseo del 2026-04-12. Compara mi velocidad media con el Riesgo de Barro en ese momento y dime si las condiciones del terreno fueron la razón de mi ritmo lento."

¿Por qué BikeScout?

Mientras que otros productos se centran en a dónde ir, BikeScout se centra en cómo puedes prosperar en ese paseo específico, ahora mismo.

PlataformaLo que ofrecenPor qué BikeScout es superior
KomootMapas estáticosAñadimos contexto de riesgo en vivo
StravaHistorial/Red socialAñadimos seguridad predictiva
TrailforksBases de datosAñadimos inteligencia personalizada
IA genéricaTeoríaAñadimos telemetría del mundo real

🤝 Contribuciones

Las contribuciones son lo que hacen de la comunidad de código abierto un lugar tan increíble para aprender, inspirar y crear. Cualquier contribución que hagas a BikeScout es muy apreciada.

Cómo contribuir

  1. Reportar errores: ¿Encontraste un fallo? Abre un Issue con una descripción detallada y los pasos para reproducirlo.
  2. Solicitudes de funciones: ¿Tienes una idea para mejorar BikeScout? ¡Abre un issue para discutirla!
  3. Solicitudes de extracción (Pull Requests):
    • Haz un fork del Proyecto.
    • Crea tu rama de funciones (git checkout -b feature/AmazingFeature).
    • Haz commit de tus cambios (git commit -m 'Add some AmazingFeature').
    • Haz push a la rama (git checkout origin feature/AmazingFeature).
    • Abre una solicitud de extracción.

Estándares de codificación

  • Sigue PEP 8 para el código Python.
  • Asegúrate de que todas las nuevas herramientas estén documentadas en el README.md.
  • Mantén los comentarios en inglés para la colaboración internacional.

Al contribuir, aceptas que tus contribuciones se licenciarán bajo la Licencia AGPLv3 del proyecto.

Licencia y atribuciones de datos

Licencia de software

Este proyecto está licenciado bajo la GNU Affero General Public License v3.0 (AGPL-3.0) - consulta el archivo LICENSE para más detalles.

¿Por qué AGPLv3?

BikeScout contiene lógica táctica de nivel propietario (como el Modelo de Reserva de Barro TAEL®). La AGPLv3 garantiza que:

  • Transparencia: cualquier versión modificada de BikeScout utilizada para proporcionar un servicio a través de una red (SaaS/Nube) debe poner su código fuente completo a disposición de la comunidad.
  • Integridad: la inteligencia táctica central permanece abierta y colaborativa, evitando el secuestro comercial de "código cerrado" de los algoritmos únicos de la plataforma.

Fuentes de datos y créditos

BikeScout agrega datos de varios proveedores abiertos. Los usuarios de este servidor deben cumplir con sus respectivos términos: