O Licitarium espelha, no computador do órgão, tudo o que o município publica no PNCP — Portal Nacional de Contratações Públicas: contratações (editais e avisos), contratos, atas de registro de preços, o Plano de Contratações Anual (PCA) e os itens de cada compra, com o preço unitário pago e o fornecedor vencedor. O acervo fica pesquisável, offline e permanente.
O problema que ele resolve: consultar o próprio histórico de compras no portal exige navegar processo a processo, uma consulta de cada vez, e o acervo não fica pesquisável nem disponível offline. O Licitarium baixa esse histórico uma vez, mantém atualizado sozinho e responde em milissegundos — inclusive quando o portal está fora do ar.
É um programa de computador, não um site: instalação por executável único, sem servidor, sem porta de rede, sem banco a configurar. Serve a qualquer prefeitura brasileira — nada é fixo no código quanto ao município. O piloto roda em Orindiúva-SP.
Licitarium — do latim licitatio (lance, leilão) + -arium (lugar que guarda): o lugar que guarda as licitações. SVB · HASTA · PVBLICA.
Cinco abas, todas com busca, filtros (ano, modalidade, situação, órgão), ordenação por clique, colunas ajustáveis com o mouse e exportação em planilha (.xlsx):
| Aba | Conteúdo |
|---|---|
| Contratações | Editais e avisos: pregões, dispensas, inexigibilidades e demais modalidades da Lei 14.133 |
| Contratos | Contratos firmados, com fornecedor, valor global e vigência, com selo de situação (vigente / vence em 60 dias / encerrado) |
| Atas | Atas de registro de preços, com objeto e vigência, com o mesmo selo de situação |
| PCA | Itens do Plano de Contratações Anual de cada órgão |
| Preços | Pesquisa de preços praticados (art. 23, Lei 14.133): busca por item, resumo estatístico (mediana, quartis, alerta de outlier), seleção e descarte com motivo, e municípios de referência para dar base de comparação |
Clicar em qualquer linha abre o detalhe completo, incluindo o registro integral em JSON exatamente como consta no PNCP, e um link direto para a página oficial do processo no portal.
Na tela inicial, três indicadores clicáveis (total de contratações, valor homologado no ano, contratos vigentes) e alertas de vencimento em 60 dias e de propostas em aberto.
Usa o histórico de itens já contratados para sugerir o Plano de Contratações Anual do exercício seguinte:
- agrupa itens semelhantes por radical da descrição, descartando prefixo burocrático ("AQUISIÇÃO DE", "CONTRATAÇÃO DE EMPRESA PARA"), e funde grupos de radical diferente cuja descrição se sobrepõe muito (mesma técnica de similaridade do Alerta de Fracionamento);
- traz os preços a valor de hoje pela série do IPCA (Banco Central) antes de projetar — comparar reais de anos diferentes sem corrigir subestima o próximo exercício;
- projeta o quantitativo (média dos anos disponíveis, último, maior, soma ou tendência por regressão linear, para item em consumo crescente);
- estima o preço (mediana, média, mais recente ou menor);
- aplica margem de segurança — padrão de 10%, editável por item;
- classifica em curva ABC e agrupa por família (PNEU, FILTRO, FRALDA…);
- sinaliza unidade divergente, ocorrência única, preço disperso, item já coberto por ata de registro de preços vigente e a variação de valor contra o plano do exercício anterior;
- permite mesclar e dividir grupos, com preço ponderado pelo volume.
A lista é editável e os ajustes manuais sobrevivem a uma nova geração. A entrega é uma minuta para revisão, não um arquivo de importação: os itens do PNCP não trazem código de catálogo, então a conferência humana é necessária.
Oito relatórios em HTML timbrado (prontos para imprimir em PDF) e, quando faz sentido, também em planilha (.xlsx):
| Relatório | Uso |
|---|---|
| Relação de Contratações | Listagem para o Tribunal de Contas, com amparo legal e deságio |
| Relação de Contratos | Contratos do período, por órgão |
| Relação de Atas | Atas de registro de preços e vigências |
| Resumo Executivo Anual | Visão consolidada do exercício |
| Alerta de Fracionamento | Autocontrole: agrupa dispensas por similaridade de objeto e acompanha os limites do art. 75, com janela por exercício ou período móvel |
| Minuta do PCA | Plano sugerido, para revisão |
| Pesquisa de Preços | Levantamento de preços homologados por termo, com estatística, dispersão e comparativo por município — subsídio ao art. 23 |
Os relatórios seguem o tema escolhido na tela, mas a impressão sai sempre clara, para não gastar tinta nem prejudicar a leitura em papel.
- Na primeira execução você escolhe o município (tabela IBGE embutida, 5.571 municípios) e o Licitarium baixa todo o histórico publicado desde 2021.
- A cada abertura, sincroniza só o que mudou — respeitando um intervalo de 10 minutos desde a última coleta, porque nada muda no PNCP nesse tempo e repetir a busca só sobrecarrega o portal. O botão Sincronizar coleta sempre. A interface fica utilizável durante a sincronização.
- Os órgãos do município (prefeitura, câmara, fundos…) são descobertos sozinhos a partir das contratações; você pode acrescentar outros por CNPJ.
- Tudo num banco SQLite local, em
%LOCALAPPDATA%\Licitarium. O banco é cache reconstruível: se corromper, uma nova carga resolve. - Sem internet, o programa abre normalmente com os dados locais e avisa que não conseguiu atualizar.
Desempenho da sincronização (acervo real de Orindiúva-SP, atualização depois de uma semana sem abrir): 33 segundos, 69 consultas ao portal. As três fases baixam em paralelo e, dentro de cada contratação, só os itens que mudaram são reconsultados.
Quando o portal falha, quase sempre é lentidão, não recusa: num dia de medição no acervo do piloto, os 20 erros registrados eram todos tempo de resposta esgotado — nenhum bloqueio, nenhum erro de servidor. O cliente tenta cinco vezes, esperando mais a cada tentativa (30 a 90 s), sorteia o intervalo entre elas para as conexões não voltarem em bloco e reduz o número de conexões simultâneas ao perceber o portal sobrecarregado. O que falha fica registrado e é refeito na coleta seguinte.
Desempenho do Painel: a consulta que alimenta as quatro visões custa ~120 ms num acervo de 114 MB (3.360 contratações, 25 mil itens); montar e desenhar os gráficos, ~2 ms. A compactação do banco, que bloqueia leituras, só roda quando há mais de 5% do arquivo em espaço ocioso.
O Licitarium apenas lê dados públicos do PNCP. Nada do seu computador é
enviado a lugar nenhum, não há telemetria, não há conta de usuário e o programa
não abre porta de rede. As únicas conexões de saída são para pncp.gov.br e,
para checar se saiu versão nova, para a API pública do GitHub.
Executável (recomendado): baixe o Licitarium.vX.Y.Z.exe da página de
releases e execute. Não precisa instalar nada, nem ter Python,
nem direitos de administrador.
Aviso do SmartScreen: por ser um executável novo e não assinado, o Windows pode exibir "aplicativo não reconhecido". Clique em Mais informações → Executar assim mesmo. O código é aberto — você pode auditar e compilar você mesmo.
Windows 11 com Smart App Control: essa proteção bloqueia binários sem assinatura digital. Com ela ativa, a atualização automática fica desligada (o aviso de versão nova leva ao download manual) e o próprio primeiro download pode ser barrado. Alternativas: rodar a partir do código-fonte, desligar o Smart App Control, ou aguardar uma versão assinada.
A partir do código:
pip install -r requirements.txt
python licitarium.pyRequisitos: Windows 10/11 com WebView2 (já incluído no Windows 11; no Windows 10,
instale o runtime).
Três dependências externas: pywebview (janela), openpyxl (exportação em
.xlsx) e motor_pncp (HTTP resiliente contra o portal — retry, paralelismo
adaptativo, disjuntor —, compartilhado com Licitarium Pro e Pretiarium Free)
— todo o resto é biblioteca padrão do Python.
Python: use 3.12. É a versão que o CI exercita e a que empacota o exe. O código não usa sintaxe posterior ao 3.8, então versões mais antigas provavelmente rodam — mas ninguém testa, então não são suportadas.
Manual completo do usuário: MANUAL.html (abra no navegador; o botão 🖨 gera o PDF).
Um processo só: janela pywebview (WebView2)
conversando com o Python por uma ponte js_api — sem servidor HTTP, sem porta,
sem firewall. Os dados vêm da API de consulta pública do PNCP; o JSON bruto de
cada registro é guardado como fonte da verdade, e as colunas do banco são
projeção dele (campo novo na interface não exige baixar tudo de novo).
licitarium.py entry: janela + classe Api (ponte com o JS)
pncp.py cliente da API do PNCP + motor de sincronização
pca_builder.py motor da minuta do PCA (agrupamento, ABC, projeções)
relatorios.py geração dos relatórios em HTML/XLSX
ui/index.html marcação
ui/estilo.css quatro temas por data-theme + fontes vendorizadas
ui/fonts/ EB Garamond, Public Sans, Lato (woff2, sem CDN)
ui/app.js lógica da interface
tests/ pytest — motor de sync com HTTP mockado
tests-e2e/ Playwright — interface com a ponte mockada
Decisões de projeto e os fatos da API que as motivaram: DESIGN.md. Identidade visual e as notas históricas por trás dela (epigrafia romana, tabula ansata, a divisa sub hasta publica): design/IDENTIDADE.md.
pip install -r requirements.txt -r requirements-dev.txt
python -m pytest tests/ # motor de sync, API e relatórios
python -m pytest tests/ --cov=. --cov-report=term-missing # cobertura
npm install && npx playwright test # interface (Chromium)
pyinstaller --clean Licitarium.spec # gera dist/"Licitarium vX.Y.Z.exe"A cada push, o CI roda os testes de Python e de interface no Windows; ao marcar
uma tag v*, compila o executável e o anexa à release.
A tela inicial resume o exercício em gráficos, em quatro visões — Execução (como está o ano), Análise (o que mudou e onde concentra), Vigilância (o que precisa de ação) e Economia (quanto foi economizado, por modalidade, família de item e categoria). Os alertas ficam acima das quatro e levam à lista já filtrada.
Os gráficos são SVG desenhado pelo próprio programa — sem biblioteca e sem rede —, seguem um método com paleta validada para daltonismo e contraste, e saem em A3 paisagem pelo botão de impressão. As decisões estão em design/DASHBOARD.md.
Os gráficos são desenhados na largura real do cartão e redesenhados quando a janela muda de tamanho; trocar de visão não vai ao banco de novo.
O banco é um espelho reconstruível do PNCP, mas baixar todo o histórico desde
2021 leva alguns minutos. Em Configurações, Salvar cópia… guarda o acervo
inteiro num .zip e Restaurar cópia… o devolve, conferindo o arquivo antes
e preservando o banco anterior.
Cada versão recebe um DOI no Zenodo. O DOI acima resolve sempre para a versão mais recente; a página do Zenodo lista o DOI específico de cada uma.
SILVA, T. R. M. Licitarium: repositório municipal de contratações públicas do PNCP. Zenodo. https://doi.org/10.5281/zenodo.21682535
MIT — © 2026 Túlio Ribeiro de Moura e Silva.
Os dados exibidos são públicos, originários do Portal Nacional de Contratações Públicas (PNCP), nos termos da Lei 14.133/2021 e da Lei de Acesso à Informação. O Licitarium não é um produto oficial do PNCP nem do Governo Federal.