Skip to content

Latest commit

 

History

613 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

O logo do marola: uma onda quebrando sobre o mar, desenhada só com equações no Desmos

marola

DOI 10.5281/zenodo.23224155 version CI tests Scala version JDK version Scala lines of code in tools/ tempo de leitura: ~4 min

🇬🇧 English · 🗺️ marola.dev · 📚 docs.marola.dev

O que é

O marola diz qual é o melhor horário para nadar perto de você, e por quê. Ele junta ondas, vento, maré, temperatura da água e a balneabilidade oficial numa nota de 0 a 100. O mapa está em marola.dev, com praias de Florianópolis, do Rio de Janeiro e de Salvador.

marola.dev no Rio de Janeiro: Ipanema e Copacabana com a nota do melhor horário, as gotas de balneabilidade do INEA e o cartão da Praia do Forte com mar, maré, água-viva e baleias

  • Nunca inventa. Todo número vem de dados públicos (OpenStreetMap, Open-Meteo, IMA/SC, INEA, INEMA). O veto de segurança é uma regra que qualquer pessoa lê, nunca o palpite de uma IA.
  • Avisa quando não sabe. "Sem dados" aparece como "sem dados".
  • É aberto e gratuito. Roda no seu computador, sem conta e sem chave de API.

Rodar

git clone --recurse-submodules https://github.com/marola-dev/marola && cd marola/marola-app
# in a marola-app checkout
nix develop
just run -- --brief --lat -27.6733 --lon -48.4700

O passo a passo está em RUN-LOCALLY.

Este repositório

Este é o guarda-chuva do marola (MIP-0070). Ele não tem código de produto. Guarda as MIPs, a lista de fases, o jeito de trabalhar, o site de documentação e cada repositório de código como um submódulo. As automações dele são o marola-tools, em Scala 3 em tools/ (scripts/marola-tools --help). Quem publica e quem fixa o quê está em REPOS.

Os repositórios do marola em três faixas: no produto, o marola-corpus entrega um tarball ao marola-app, cuja imagem monta o marola-site, que vira o mapa do marola.dev; nos modelos, dados e ferramentas, o marola-ml lê o corpus e devolve um prompt compilado ao app, e o marola-oods guarda os dados abertos do oceano; no guarda-chuva, o marola-devkit é fixado por tag, e este repositório, com as MIPs e o marola-tools em Scala 3, gera o docs.marola.dev.

Como ler esta figura

Em uma frase. Cada repositório faz uma coisa, e o que um entrega o outro fixa por versão.

Como ler. Da esquerda para a direita. A faixa de cima é o caminho até o mapa; a do meio, o que alimenta o app; a de baixo, este repositório e as ferramentas. A borda laranja marca o que uma pessoa abre: o mapa e a documentação.

Fora da figura. O marola-skills, o marola-agents e o marola-research, que só leem os outros.

Evidência. docs/archify/repos.json, a fonte da figura, desenhada pelo Archify com just figure.

Agentes de IA: leiam primeiro o AGENTS.md. Para contribuir, veja o guia.

Como citar

Cite o DOI conceitual 10.5281/zenodo.23224155, que sempre aponta para a versão mais recente.

BibTeX:

@software{hoffmann_2026_marola,
  author    = {Hoffmann, Matheus and Valério, Bruno and Soares da Silva Junior, Rob Kler and Oliveira, Elisa and Almeida, Leonardo Ramos and Ribeiro, Pablo},
  title     = {{marola: an open, non-profit platform for sea conditions and bathing-water quality at Brazilian beaches, built on public data}},
  year      = {2026},
  publisher = {Zenodo},
  doi       = {10.5281/zenodo.23224155},
  url       = {https://github.com/marola-dev/marola}
}

APA:

Hoffmann, M., Valério, B., Soares da Silva Junior, R. K., Oliveira, E., Almeida, L. R., & Ribeiro, P. (2026). marola: an open, non-profit platform for sea conditions and bathing-water quality at Brazilian beaches, built on public data [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.23224155

ABNT (NBR 6023):

HOFFMANN, Matheus; VALÉRIO, Bruno; SOARES DA SILVA JUNIOR, Rob Kler; OLIVEIRA, Elisa; ALMEIDA, Leonardo Ramos; RIBEIRO, Pablo. marola: an open, non-profit platform for sea conditions and bathing-water quality at Brazilian beaches, built on public data. [S. l.]: Zenodo, 2026. DOI 10.5281/zenodo.23224155.

Contato e licença

Escreva para admin@marola.dev; vulnerabilidades vão pela política de segurança. A documentação é CC BY 4.0 e o código é AGPL-3.0-only; cada arquivo diz a sua em REUSE.toml. Os parceiros estão em PARTNERS.

Tempo de leitura

O selo vem do marola-tools reading-time (just reading-time), a 181 palavras por minuto.