Projetos-F1

Box Box

Box Box

Reveja qualquer sessão da Fórmula 1 como se estivesse no muro dos boxes.
Mapa da pista ao vivo, tabela de tempos, telemetria, estratégia de pneus e muito mais, em português e rodando no seu computador.

Demonstração do Box Box: tela inicial, replay do GP do Canadá 2025, painel de análises e Safety Car

▶ Ver o vídeo em alta qualidade (MP4)


Por que “Box Box”?

É o chamado que todo fã conhece: quando o engenheiro quer o piloto nos boxes, ele diz pelo rádio “box, box”. O nome resume a ideia do projeto: trazer para a sua tela a visão de quem acompanha a corrida pelos dados, do pit wall. O logo segue a mesma ideia, com um balão de rádio e duas setas de entrada do pit, uma para cada “box”.

O que dá para fazer

🏁 Assistir a corrida de novo, com dados reais

🛞 Estratégia e pneus

📈 Análise de desempenho

📺 Recursos extras

Capturas de tela

   
Tela inicial com o traçado de cada circuito Replay da corrida com mapa e tabela
Temporada: cada etapa com o desenho da pista Replay: mapa, tabela e controles
Telemetria de dois pilotos Estratégia de pneus
Telemetria de pilotos selecionados Estratégia de pneus de toda a grade
Campeonato ao vivo Modelo de desgaste dos pneus
Campeonato “se a ordem ficar assim” Modelo de pneus ajustado à corrida
Safety Car simulado à frente do líder Análise de voltas de dois pilotos
Safety Car simulado no fim da corrida Análise de voltas ao lado do mapa, com telemetria ao vivo

De onde vêm os dados

O Box Box não guarda dados de ninguém nem depende de um servidor central. Cada sessão é baixada e processada uma única vez no seu computador e depois abre na hora.

Fonte Para quê Precisa de conta?
OpenF1 Voltas, posições, telemetria, pneus, pit stops e direção de prova (2023 em diante) Não
F1 TV (via FastF1) Dados direto da F1, sessões mais recentes e a transmissão Sim, assinatura F1 TV
Jolpica Classificação do campeonato Não
MultiViewer Traçado e curvas de cada circuito Não

Sem login, o app usa o OpenF1 automaticamente. As corridas mais recentes podem levar alguns dias para chegar lá; se você tiver F1 TV, é só entrar pelo botão F1 TV no topo para baixá-las direto da F1.

Como rodar

Você só precisa do Docker Desktop.

1. Baixe o projeto

git clone https://github.com/Wedrock/Projetos-F1.git
cd Projetos-F1/box-box

2. Crie o arquivo de configuração

cp .env.example .env

Abra o .env e preencha F1TV_SECRET_KEY com uma chave aleatória. É ela que protege o seu login do F1 TV, caso você use. Para gerar uma:

openssl rand -hex 32

3. Suba o app

docker compose up -d

4. Abra http://localhost:8000, escolha uma etapa e uma sessão. Na primeira vez, a sessão leva alguns minutos para baixar; depois disso, abre na hora.

App para PC (Windows)

Prefere um programa normal, sem Docker? O Box Box também roda como app de Windows: um instalador, um ícone no menu Iniciar e o app abre na própria janela.

1. Baixe o instalador BoxBox-Setup-<versão>.exe na página de Releases (ou nos Artifacts de uma execução do workflow App para Windows, na aba Actions).

2. Instale. Não pede senha de administrador. Se o Windows SmartScreen avisar que o app é desconhecido, clique em Mais informações → Executar assim mesmo (o instalador não é assinado).

3. Abra o Box Box pelo menu Iniciar ou pela área de trabalho. Ele sobe o servidor sozinho, só para este computador, e fecha junto com a janela.

Gerar o instalador você mesmo. No Windows, com Python 3.11, Node.js 20 e Inno Setup 6 instalados:

cd box-box\desktop
.\build-windows.ps1

O resultado fica em box-box\desktop\dist. Pelo GitHub, rode o workflow App para Windows na aba Actions, ou crie uma tag v* (por exemplo v2.5.1) para publicar o instalador numa Release.

Configuração

As opções ficam no .env. Todas têm um valor padrão sensato; mude só o que precisar.

Variável O que faz Padrão
PORT Porta do app no seu computador 8000
DATA_SOURCE auto usa o OpenF1 sem login e o F1 TV com login; openf1 ou f1tv forçam uma fonte auto
F1TV_SECRET_KEY Chave que criptografa o login do F1 TV salvo —
F1_USERNAME / F1_PASSWORD Login do F1 TV pelo arquivo, em vez de pela tela —
AUTO_PRECOMPUTE Baixa sessões sozinho nos fins de semana: off, race, race+qual ou all race+qual
BIND_ADDRESS Quem pode acessar a porta; 0.0.0.0 libera a rede local 127.0.0.1
ALLOWED_HOSTS Endereços aceitos pelo servidor, separados por vírgula localhost,127.0.0.1
AUTH_ENABLED / AUTH_PASSPHRASE Pede uma frase de acesso para abrir o app desligado
TEAM_RADIO_CAPTIONS / TEAM_RADIO_MODEL Legendas do rádio e o modelo Whisper usado ligado / small.en
GEMINI_API_KEY Legendas do rádio em português e inglês, pelo Gemini (chave grátis em aistudio.google.com). Também dá para colar a chave no app: Configurações → Rádio das equipes → Legendas em português (dentro de um replay) —
OPENROUTER_API_KEY Liga os recursos de IA (correção de legendas e sincronização por foto) —
STORAGE_MODE local ou r2 (Cloudflare R2) para guardar as sessões local

Privacidade e segurança

Como o projeto é organizado

box-box/
├── backend/                 API em Python (FastAPI)
│   ├── routers/             Rotas: sessões, replay, telemetria, análises, circuitos...
│   ├── services/
│   │   ├── f1_data.py       Monta o replay a partir dos dados da sessão
│   │   ├── openf1_source.py Usa o OpenF1 como fonte quando não há login
│   │   ├── tyre_model.py    Modelo bayesiano de desgaste dos pneus
│   │   ├── standings.py     Classificação do campeonato
│   │   └── circuits.py      Nomes e traçados dos circuitos
│   └── tests/               Testes automáticos
├── frontend/                Interface em Next.js, React e Tailwind
│   └── src/
│       ├── app/             Páginas: início, replay, ao vivo, recursos, sobre
│       ├── components/      Mapa, tabela, telemetria, painel de análises...
│       └── lib/             Desenho da pista, modelo de pneus, utilidades
├── desktop/                 App para PC: janela própria, PyInstaller e instalador
├── docs/media/              Vídeo e capturas deste README
├── Dockerfile               Um único contêiner com frontend e backend
└── docker-compose.yml

O frontend é compilado como site estático e servido pelo próprio backend, então tudo roda em um só contêiner e em uma só porta.

Para desenvolvedores

Rodar os testes do backend sem instalar Python, usando o Docker:

docker run --rm -v "$(pwd)/backend:/app" -w /app python:3.12-slim sh -c "pip install -q numpy httpx pytest && python -m pytest -q tests"

Checar os tipos do frontend:

cd frontend && npm ci && npx tsc --noEmit

Créditos

O Box Box nasceu da junção de dois projetos de código aberto, ambos sob a licença MIT:

Também agradecemos ao FastF1, ao OpenF1, ao Jolpica e ao MultiViewer pelos dados.

Licença

O código está sob a licença MIT. Os dados do OpenF1 seguem a licença CC BY-NC-SA 4.0, ou seja, são para uso pessoal e não comercial.

Aviso

O Box Box é um projeto independente de fãs. Não é oficial e não tem nenhuma ligação com as empresas da Fórmula 1.