Se você precisa analisar o código-fonte de um projeto, mas deseja automatizar o processo e utilizar a energia local do seu computador, o utilitário Bistr pode ser uma ótima solução. Neste artigo, veremos como esse utilitário ajuda a analisar código usando o modelo de aprendizado de máquina Ollama.
O que é Bistr?
Bistr é um utilitário de análise de código-fonte que permite integrar um modelo LLM (modelo de linguagem grande) local, como Ollama, para análise e processamento de código. Com o Bistr, você pode analisar arquivos em várias linguagens de programação, como Python, C, Java, JavaScript, HTML e muito mais.
Bistr usa o modelo para verificar arquivos em relação a determinadas consultas, por exemplo, para encontrar uma resposta a uma pergunta sobre a funcionalidade do código ou parte dele. Isso fornece uma análise estruturada que auxilia no desenvolvimento, teste e manutenção de projetos.
Como funciona o Bistr?
- Carregando Estado: Ao iniciar uma análise, o utilitário verifica se o estado da análise foi salvo anteriormente. Isso ajuda você a continuar de onde parou sem precisar analisar os mesmos arquivos novamente.
- Análise de código: cada arquivo é analisado usando o modelo Ollama. O utilitário envia uma solicitação ao modelo para analisar um trecho específico de código. O modelo retorna informações sobre a relevância do código em resposta à consulta e também fornece uma explicação textual de por que um determinado fragmento é relevante para a tarefa.
- Salvar estado: depois que cada arquivo é analisado, o estado é atualizado para que você possa continuar com as informações mais recentes na próxima vez.
- Saída dos resultados: Todos os resultados da análise podem ser exportados para um arquivo HTML, que contém uma tabela com uma classificação dos arquivos por relevância, o que ajuda a entender quais partes do código são mais importantes para análises posteriores.
Instalação e inicialização
Para usar o Bistr, você deve instalar e executar o Ollama, uma plataforma que fornece modelos LLM em sua máquina local. As instruções para instalar o Ollama para macOS, Windows e Linux estão descritas abaixo.
Baixe a versão mais recente do Bistr do git:
https://github.com/demensdeum/Bistr/
Depois de instalar o Ollama e o Bistr, você pode executar a análise de código. Para fazer isso, você precisa preparar o código-fonte e especificar o caminho para o diretório que contém os arquivos a serem analisados. O utilitário permite que você continue a análise de onde parou e também oferece a capacidade de exportar resultados em formato HTML para facilitar análises posteriores.
Exemplo de comando para executar análise:
python bistr.py /path/to/code --model llama3.1:latest --output-html result.html --research "What is the purpose of this function?"
Nesta equipe:
–model especifica o modelo a ser usado para análise.
–output-html especifica o caminho para salvar os resultados da análise em um arquivo HTML.
–research permite que você faça uma pergunta que deseja responder analisando o código.
Benefícios de usar o Bistr
- Execução local: a análise é realizada no seu computador sem a necessidade de conexão com serviços em nuvem, o que agiliza o processo.
- Flexibilidade: você pode analisar código em diferentes linguagens de programação.
- Automação: todo o trabalho de revisão de código é automatizado, o que economiza tempo e esforço, especialmente ao trabalhar com projetos grandes.
