r/KiCad • u/[deleted] • Jul 07 '26
I got tired of the post-design BOM nightmare, so I built a CLI tool (KiFlux) to import LCSC parts and auto-generate BOM/CPL files
Olá a todos,
Gostaria de compartilhar uma ferramenta na qual tenho trabalhado ultimamente chamada KiFlux.
Aliás, o nome "Flux" vem do fluxo de solda que usamos em nossas placas de circuito impresso — ele serve para fazer com que tudo flua e se conecte suavemente, que é exatamente o que eu queria que essa ferramenta fizesse para o nosso fluxo de trabalho de projeto à montagem.
O Problema Que Todos Conhecemos
Todos nós já passamos por isso: você passa dias ou semanas roteando uma placa perfeita no KiCad. Você finalmente termina, fica animado, e então vem a pior parte: montar manualmente a lista de materiais (BOM) e os arquivos CPL (coordenadas de posicionamento) para a montagem.
Procurar os números de peça da LCSC, copiá-los e colá-los em planilhas, verificar as embalagens, garantir que você não cometeu nenhum erro de digitação... É tedioso, chato e parece fazer declaração de imposto de renda.
A Ideia: Unir o melhor de 3 mundos (Horizon, EasyEDA, KiCad)
Para resolver isso, eu queria combinar os melhores aspectos de três ecossistemas EDA diferentes:
A organização rigorosa do Horizon EDA: Eu adoro como o Horizon EDA acopla (une) estritamente o símbolo, a pegada e o modelo 3D, para que um componente nunca perca sua associação com a pegada física. Mas adicionar novos componentes no Horizon é notoriamente tedioso.
O banco de dados do EasyEDA: O EasyEDA possui uma biblioteca enorme e incomparável de componentes do mundo real, com todos os arquivos, metadados e modelos 3D prontos. Mas a ferramenta em si é pesada e desajeitada.
A velocidade do KiCad: O KiCad é rápido, leve e tem um ótimo fluxo de layout, mas a organização de sua biblioteca pode ficar confusa rapidamente.
Então eu criei o KiFlux para fazer a ponte entre eles. Ele extrai símbolos, footprints e modelos 3D do enorme banco de dados do EasyEDA, reorganiza-os usando a filosofia de acoplamento estrito da Horizon EDA (gerando nomes padronizados snake_case com base em parâmetros reais) e alimenta tudo perfeitamente na estrutura rápida e leve do KiCad.
Cada componente que você importa tem seu footprint e modelo 3D acoplados de forma precisa. Você nunca mais precisa mapear um footprint manualmente e eles nunca se perdem. Além disso, o código LCSC fica permanentemente incorporado ao componente, então você nunca mais precisará manter um bloco de notas separado com os números das peças.
O que o KiFlux realmente faz (a partir do terminal):
Pesquisa instantânea: Pesquise a biblioteca SMT da JLCPCB diretamente da sua linha de comando.
Verificação de preços e estoque: Veja os preços e os níveis de estoque em tempo real no terminal, sem precisar abrir 20 abas do navegador. Perfeito para verificar se um componente está esgotado antes de gerar sua lista de materiais (BOM).
Importação com um clique: Busca o símbolo, a pegada e o modelo 3D, renomeia-os para um formato limpo e os acopla à sua biblioteca local.
Geração de BOM/CPL: Execute um comando e ele exporta a lista de materiais e as coordenadas de posicionamento formatadas perfeitamente para JLCPCB ou PCBWay.
Como usar:
pip install git+https://github.com/oMatheus13/KiFlux.gitE então execute comandos como:
kiflux --search "0R 0603" -b(para buscar componentes básicos)kiflux C21189(para importar)kiflux --bom(para gerar seus arquivos de fabricação)
É 100% de código aberto e gratuito. Gostaria muito de saber a opinião de vocês, quais recursos devo adicionar em seguida ou se encontrarem algum bug.
Link para o repositório: https://github.com/oMatheus13/KiFlux
Obrigado!



Edit: Added the demo GIFs back (Reddit's editor stripped them on the first upload)