BikeScout
O BikeScout foi projetado para ciclistas e mountain bikers. Ele fornece recomendações inteligentes de trilhas ao combinar dados de mapas do mundo real com análise avançada de rotas.
Documentação
BikeScout
Planejador de rotas de ciclismo com IA de código aberto para MTB, gravel, estrada e e-bikes
O BikeScout é um motor de IA especializado em planejamento de missões para MTB, Estrada, E-Bike e Gravel. Ele transforma dados brutos de mapas em Inteligência Tática, prevendo condições de terreno e perigos em trilhas. O sistema fornece recomendações precisas de configuração, adaptando seu equipamento às exigências da rota específica, identificando desafios técnicos e riscos ambientais antes mesmo de você sair da garagem.
Início Rápido
Como usar o BikeScout
- instrução, usando a Interface Gráfica do BikeScout
- instrução, usando seu cliente de agente MCP favorito: Claude Desktop, Cursor, Codex, Google Antigravity, Windsurf
🎥 Clique para assistir à Interface Gráfica do BikeScout
🎥 Clique para assistir a uma Demonstração
Explore o BikeScout
-
Guia do Usuário Referências detalhadas de API e guias passo a passo para implantar o BikeScout.
-
Site Explore a análise visual da Lógica de Lama, a classificação de terreno S-Scale e como transformamos dados brutos do OSM em inteligência pronta para missão. Confira os relatórios mais recentes de análise de corridas das rotas lendárias.
Ama o BikeScout? ⭐ Dê uma estrela neste repositório para apoiar o desenvolvimento do primeiro motor tático de ciclismo de código aberto.
Encontrou um bug? Abra uma Issue. Quer adicionar uma habilidade local? Pull requests são bem-vindos!
Exemplos de Consultas
Você pode fazer solicitações complexas e de múltiplas etapas ao BikeScout. Ele combina dados em tempo real com inteligência técnica de ciclismo para fornecer respostas de nível especialista.
🗺️ Planejamento Avançado (Multi-Ferramenta)
- "Estou no Monte Cavo com minha bike de MTB (pneus 29). Planeje um loop de 25km para mim. Verifique se o terreno é compatível com minha bike, confirme a probabilidade de chuva à tarde e sugira uma 'Fraschetta' para o final. Use o guia Castelli Romani."
⚙️ Configuração da Bike e Inteligência de Superfície
- "Verifique esta rota do centro de Barcelona até El Prat. Estou em uma bike de estrada com pneus de 25mm. É compatível? Dê-me a porcentagem exata de gravel versus asfalto."
📈 Análise Visual de Elevação e Gradiente
- "Planeje uma rota de 40km começando em Bormio. Preciso do Perfil Visual de Elevação para ver os gradientes exatos da subida do Stelvio. Destaque trechos acima de 12% para que eu possa gerenciar meu ritmo."
🏔️ Expertise Local
- "Use o guia local de Derby para planejar uma rota de ciclismo de estrada começando em Derby. Preciso de pelo menos 800m de ganho de elevação. Além disso, recomende a pressão correta dos pneus para descidas em alta altitude."
🛠️ Verificações Técnicas Rápidas
- "Dê-me a lista de verificação de segurança e calcule a pressão dos pneus para um ciclista de 90kg em pneus tubeless de 2,3" para um passeio enlameado."
🏁 Análise Pós-Passeio e Verdade do Terreno
- "Analise meu passeio de 2026-04-12. Compare minha velocidade média com o Risco de Lama naquele momento e diga-me se as condições do terreno foram o motivo do meu ritmo lento."
Por que o BikeScout?
Enquanto outros produtos focam em para onde ir, o BikeScout foca em como você pode prosperar naquele passeio específico, agora.
| Plataforma | O que eles oferecem | Por que o BikeScout é superior |
|---|---|---|
| Komoot | Mapas estáticos | Adicionamos contexto de risco ao vivo |
| Strava | Histórico/Social | Adicionamos segurança preditiva |
| Trailforks | Bancos de dados | Adicionamos inteligência personalizada |
| IA Genérica | Teoria | Adicionamos telemetria do mundo real |
🤝 Contribuindo
As contribuições são o que tornam a comunidade de código aberto um lugar tão incrível para aprender, inspirar e criar. Qualquer contribuição que você fizer ao BikeScout será muito apreciada.
Como Contribuir
- Reporte Bugs: Encontrou um problema? Abra uma Issue com uma descrição detalhada e etapas para reproduzir.
- Solicitações de Recursos: Tem uma ideia para melhorar o BikeScout? Abra uma issue para discutir!
- Pull Requests:
- Faça um Fork do Projeto.
- Crie sua Branch de Recurso (
git checkout -b feature/AmazingFeature). - Faça commit das suas alterações (
git commit -m 'Add some AmazingFeature'). - Envie para a Branch (
git checkout origin feature/AmazingFeature). - Abra um Pull Request.
Padrões de Codificação
- Siga o PEP 8 para código Python.
- Garanta que todas as novas ferramentas estejam documentadas no
README.md. - Mantenha os comentários em inglês para colaboração internacional.
Ao contribuir, você concorda que suas contribuições serão licenciadas sob a Licença AGPLv3 do projeto.
Licença e Atribuições de Dados
Licença de Software
Este projeto é licenciado sob a GNU Affero General Public License v3.0 (AGPL-3.0) - consulte o arquivo LICENSE para detalhes.
Por que AGPLv3?
O BikeScout contém lógica tática de nível proprietário (como o Modelo de Reservatório de Lama TAEL®). A AGPLv3 garante que:
- Transparência: Qualquer versão modificada do BikeScout usada para fornecer um serviço pela rede (SaaS/Nuvem) deve disponibilizar seu código-fonte completo à comunidade.
- Integridade: A inteligência tática central permanece aberta e colaborativa, impedindo o sequestro comercial de "código fechado" dos algoritmos exclusivos da plataforma.
Fontes de Dados e Créditos
O BikeScout agrega dados de vários provedores abertos. Os usuários deste servidor devem aderir aos seus respectivos termos:
- Dados de Roteamento e Mapas: Fornecidos pelo OpenRouteService da HeiGIT.
- Dados Geoespaciais e de Geocodificação: © OpenStreetMap contribuidores. Os dados estão disponíveis sob a Open Database License (ODbL). Serviço de geocodificação fornecido pelo Nominatim.
- Previsões Meteorológicas: Fornecidas pelo Open-Meteo. Os dados são licenciados sob CC BY 4.0.