Como o RepoPicks Radar avalia os projetos do GitHub

Antes de você baixar qualquer coisa, o RepoPicks Radar tenta responder três perguntas sobre cada projeto do GitHub: o que ele faz, quão fácil é instalar no seu computador e se apareceu algo que merece atenção. As respostas ficam numa ficha, com notas, rótulos e selos que se leem em poucos segundos.

Este guia explica o que cada um deles quer dizer e como as fichas são feitas, para você saber quanto confiar em cada informação e onde olhar com mais cuidado.

Uma rotina que roda todo dia

Todo dia, uma rotina automática lê os dados públicos do GitHub e encontra os projetos de código aberto que mais estão crescendo: os que ganham estrelas mais depressa, os mais baixados e os que acabaram de começar a chamar atenção. Estrela, no GitHub, é como um “favorito”: quando muita gente marca um projeto em pouco tempo, é sinal de que ele está sendo descoberto.

Cada projeto novo passa por checagens automáticas, que procuram sinais de risco conhecidos e guardam a evidência de tudo o que encontram. Depois, uma IA lê o que o próprio projeto publica no GitHub, como a apresentação, as versões publicadas, a licença e as instruções de instalação, e escreve a ficha em linguagem simples, seguindo as regras do Radar.

Em seguida, uma segunda IA, separada da que escreveu, revisa a ficha comparando cada afirmação com as evidências. A ficha só aparece no site depois dessa revisão. Os números do GitHub, como estrelas, downloads e crescimento, são atualizados todos os dias, e as fichas já publicadas voltam a passar pelas checagens com frequência.

As fichas são escritas em inglês e traduzidas para o espanhol, o português e o chinês. As evidências, como trechos do README, aparecem no idioma original, para você ver exatamente o que o projeto diz.

Facilidade de instalação: de A a E

A facilidade diz quanto trabalho dá colocar o programa para funcionar no seu computador, seguindo o instalador e os passos que o próprio projeto documenta. Quanto mais perto do A, menos você precisa saber de tecnologia.

• A · baixe e abra. O projeto oferece um instalador ou um programa pronto. Você baixa, abre e usa, como qualquer programa comum.
• B · instalador e um ajuste simples. Instala como um programa comum, mas pede um passo a mais antes do primeiro uso, como baixar um modelo de IA dentro do próprio app ou informar uma chave de acesso.
• C · instalar 1 ou 2 ferramentas. Antes do programa, você precisa instalar uma ou duas ferramentas, como o Python, e digitar alguns comandos seguindo as instruções.
• D · terminal, várias ferramentas ou placa específica. Pede o terminal e várias ferramentas, o Docker ou uma placa de vídeo de um tipo específico.
• E · só para quem programa. É preciso compilar o código, configurar serviços ou o projeto nem tem instruções de instalação para quem só quer usar.

Se você não programa, os projetos A são o caminho mais tranquilo, e os B costumam funcionar bem com um pouco de paciência. Do C em diante, vale ler as instruções antes de começar. O guia Como baixar e instalar um programa do GitHub sem saber programar mostra o passo a passo.

A nota muda de sistema para sistema

Um mesmo programa pode ser simples no Mac e trabalhoso no Windows. Por isso a facilidade é dada separadamente para Windows, macOS, Linux e Web, que é quando existe uma versão que roda direto no navegador. Um sistema sem nota é um sistema em que o projeto não roda; isso não baixa a nota dos outros.

Na lista de programas, a etiqueta mostra a nota do sistema em que o projeto instala mais fácil. Se você escolher um sistema no filtro “Sistema”, a etiqueta passa a mostrar a nota daquele sistema. Na ficha, a seção “Facilidade de instalação” mostra a nota de cada sistema lado a lado, com uma frase que explica o motivo.

Sinais de risco

Um sinal de risco é algo encontrado no projeto que merece atenção antes de instalar. Cada sinal vem com a evidência, como um trecho do README, um arquivo ou um dado do GitHub, para você conferir com os próprios olhos em vez de confiar só na nota.

Os sinais têm três níveis:

• Info: um fato útil, que em geral não impede o uso, mas é bom saber.
• Atenção: vale ler a evidência e entender o que ela quer dizer antes de instalar.
• Alto: um sinal forte, que pede muito cuidado.

Alguns exemplos do que pode aparecer: o projeto não tem licença, o repositório foi arquivado e não recebe mais atualizações, o comando de instalação roda um script baixado da internet, as dependências têm vulnerabilidades conhecidas ou os links de download levam para sites de arquivos fora do GitHub. O próprio sinal explica o que foi encontrado.

Na página inicial, a opção “Só com poucos sinais de risco” mostra apenas os projetos sem sinais de Atenção ou Alto. Uma ficha sem sinais quer dizer que as checagens não encontraram nada, e não que o programa esteja livre de problemas.

Projetos em alerta

Quando aparecem sinais fortes de risco, o projeto fica marcado como “Alerta”. Ele continua visível, com uma faixa no alto da ficha e todas as evidências, para você ler e decidir, mas sai dos rankings e das recomendações. Na página inicial, os projetos em alerta só aparecem quando você escolhe “Todos” em “Mostrar”.

Quando o uso principal de um projeto envolve driblar a proteção, a licença ou os termos de outra empresa, a ficha diz isso com clareza num sinal de risco, com a evidência do próprio repositório.

Tipo de projeto: prontos, quase prontos e os outros

O GitHub tem de tudo: programas prontos, ferramentas para programadores, bibliotecas e até listas de links. Cada ficha diz o tipo do projeto:

• App pronto: um programa para usar no dia a dia. É o que aparece em “Prontos para usar”.
• Precisa montar: funciona como programa, mas pede algumas etapas de instalação. É o que aparece em “Quase prontos”.
• Ferramenta de dev, Framework e Conteúdo: projetos para quem programa ou coleções de material. Aparecem em “Todos”.

Custo e programas pagos que ele substitui

O custo diz quanto você paga para usar o programa:

• Grátis: tudo o que o programa faz está disponível sem pagar.
• Grátis, a API é paga: o programa é grátis, mas parte do que ele faz depende de um serviço pago, como uma chave de uma IA.
• Freemium: há uma versão grátis e um plano pago com mais recursos.
• Pago: é preciso pagar para usar.

Quando um projeto faz um trabalho parecido com o de um programa pago conhecido, a ficha mostra isso em “Pode substituir”. Isso quer dizer que ele resolve o mesmo tipo de tarefa, não que seja uma cópia ou que tenha todos os recursos do programa pago. Os nomes dos programas pagos aparecem só para você reconhecer a tarefa; nenhum fabricante paga para entrar ou sair dessas comparações. O guia Como trocar um programa pago por um grátis mostra como testar a troca sem perder seus arquivos.

Os selos de revisão

Toda ficha publicada passou pela revisão por IA e leva o selo “Revisado por IA”. Quando o responsável pelo Radar confere a ficha pessoalmente, ela ganha o selo “Revisado pelo Radar”. Os dois selos dizem quem conferiu o texto, e não que o programa seja recomendado.

O que o Radar não conseguiu verificar

Nem tudo dá para confirmar só com o que está publicado no GitHub. Quando alguma coisa ficou sem confirmação, como se o instalador funciona numa versão específica do sistema, a ficha diz isso na seção “O que o Radar não conseguiu verificar”. Leia essa parte antes de decidir: ela mostra os limites daquela ficha.

Os números do GitHub

A ficha também mostra os números públicos do projeto, atualizados todo dia:

• Estrelas: quantas pessoas marcaram o projeto no GitHub, com o histórico em “Estrelas ao longo do tempo”.
• Crescimento: quantas estrelas ele ganhou nos últimos dias.
• Downloads: quantas vezes os arquivos das versões publicadas no GitHub foram baixados. Projetos distribuídos por lojas de apps ou pelo próprio site aparecem com menos downloads do que têm de verdade.
• Última atualização: quando o código mudou pela última vez. Um projeto parado há muito tempo pode não funcionar nas versões novas do sistema.

Desses números saem os rankings da seção “Em alta”: “Crescendo mais rápido”, “Mais baixados na semana” e “Novos no Radar”.

O que uma ficha não é

Uma ficha é uma ajuda para decidir, não uma garantia nem uma ordem para instalar. Ela junta o que os dados e as evidências mostram, num formato fácil de ler, mas a decisão é sempre sua. Ninguém paga para aparecer no Radar, e não existe posição comprada nos rankings.

Achou um dado errado? No fim de cada ficha há o link “Algo errado nesta ficha? Peça uma correção”, que leva para a página de pedido de correção. Para saber mais sobre quem faz o site, veja a página Sobre.