Cómo evalúa RepoPicks Radar los proyectos de GitHub
Antes de que descargues algo, RepoPicks Radar intenta responder tres preguntas sobre cada proyecto de GitHub: qué hace, qué tan fácil es instalarlo en tu computadora y si apareció algo que merece atención. Las respuestas quedan en una ficha, con notas, etiquetas y sellos que se leen en pocos segundos.
Esta guía explica qué significa cada uno y cómo se hacen las fichas, para que sepas cuánto confiar en cada dato y dónde mirar con más cuidado.
Una rutina que corre todos los días
Todos los días, una rutina automática lee los datos públicos de GitHub y encuentra los proyectos de código abierto que más están creciendo: los que ganan estrellas más rápido, los más descargados y los que acaban de empezar a llamar la atención. Una estrella, en GitHub, es como un “favorito”: cuando mucha gente marca un proyecto en poco tiempo, es señal de que se está descubriendo.
Cada proyecto nuevo pasa por comprobaciones automáticas, que buscan señales de riesgo conocidas y guardan la evidencia de todo lo que encuentran. Después, una IA lee lo que el propio proyecto publica en GitHub, como la presentación, las versiones publicadas, la licencia y las instrucciones de instalación, y escribe la ficha en lenguaje simple, siguiendo las reglas de Radar.
A continuación, una segunda IA, distinta de la que escribió, revisa la ficha comparando cada afirmación con las evidencias. La ficha solo aparece en el sitio después de esa revisión. Los números de GitHub, como estrellas, descargas y crecimiento, se actualizan todos los días, y las fichas ya publicadas vuelven a pasar por las comprobaciones con frecuencia.
Las fichas se escriben en inglés y se traducen al español, el portugués y el chino. Las evidencias, como fragmentos del README, aparecen en el idioma original, para que veas exactamente lo que dice el proyecto.
Facilidad de instalación: de la A a la E
La facilidad indica cuánto trabajo cuesta poner el programa a funcionar en tu computadora, siguiendo el instalador y los pasos que documenta el propio proyecto. Cuanto más cerca de la A, menos necesitas saber de tecnología.
- A · descarga y abre. El proyecto ofrece un instalador o un programa listo. Lo descargas, lo abres y lo usas, como cualquier programa común.
- B · instalador y un paso simple. Se instala como un programa común, pero pide un paso más antes del primer uso, como descargar un modelo de IA dentro de la propia app o ingresar una clave de acceso.
- C · instalar 1 o 2 herramientas. Antes del programa, necesitas instalar una o dos herramientas, como Python, y escribir algunos comandos siguiendo las instrucciones.
- D · terminal, varias herramientas o tarjeta específica. Pide la terminal y varias herramientas, Docker o una tarjeta de video de un tipo específico.
- E · solo para quien programa. Hay que compilar el código, configurar servicios, o el proyecto ni siquiera trae instrucciones de instalación para quien solo quiere usarlo.
Si no programas, los proyectos A son el camino más tranquilo, y los B suelen funcionar bien con un poco de paciencia. Desde la C, conviene leer las instrucciones antes de empezar. La guía Cómo descargar e instalar un programa de GitHub sin saber programar muestra el paso a paso.
La nota cambia de un sistema a otro
Un mismo programa puede ser simple en Mac y trabajoso en Windows. Por eso la facilidad se da por separado para Windows, macOS, Linux y Web, que es cuando existe una versión que corre directo en el navegador. Un sistema sin nota es un sistema donde el proyecto no corre; eso no baja la nota de los demás.
En la lista de programas, la etiqueta muestra la nota del sistema donde el proyecto se instala con más facilidad. Si eliges un sistema en el filtro “Sistema”, la etiqueta pasa a mostrar la nota de ese sistema. En la ficha, la sección “Facilidad de instalación” muestra la nota de cada sistema lado a lado, con una frase que explica el motivo.
Señales de riesgo
Una señal de riesgo es algo encontrado en el proyecto que merece atención antes de instalar. Cada señal viene con la evidencia, como un fragmento del README, un archivo o un dato de GitHub, para que lo compruebes con tus propios ojos en lugar de confiar solo en la nota.
Las señales tienen tres niveles:
- Info: un dato útil, que en general no impide el uso, pero conviene conocer.
- Atención: conviene leer la evidencia y entender qué significa antes de instalar.
- Alto: una señal fuerte, que pide mucho cuidado.
Algunos ejemplos de lo que puede aparecer: el proyecto no tiene licencia, el repositorio fue archivado y ya no recibe actualizaciones, el comando de instalación ejecuta un script descargado de internet, las dependencias tienen vulnerabilidades conocidas o los enlaces de descarga llevan a sitios de archivos fuera de GitHub. La propia señal explica lo que se encontró.
En la página de inicio, la opción “Solo con pocas señales de riesgo” muestra únicamente los proyectos sin señales de Atención ni Alto. Una ficha sin señales quiere decir que las comprobaciones no encontraron nada, y no que el programa esté libre de problemas.
Proyectos en alerta
Cuando aparecen señales fuertes de riesgo, el proyecto queda marcado como “Alerta”. Sigue visible, con una franja en la parte de arriba de la ficha y todas las evidencias, para que leas y decidas, pero sale de los rankings y de las recomendaciones. En la página de inicio, los proyectos en alerta solo aparecen cuando eliges “Todos” en “Mostrar”.
Cuando el uso principal de un proyecto implica eludir la protección, la licencia o los términos de otra empresa, la ficha lo dice con claridad en una señal de riesgo, con la evidencia del propio repositorio.
Tipo de proyecto: listos, casi listos y los demás
GitHub tiene de todo: programas listos, herramientas para programadores, bibliotecas y hasta listas de enlaces. Cada ficha indica el tipo del proyecto:
- App lista: un programa para usar en el día a día. Es lo que aparece en “Listos para usar”.
- Requiere preparación: funciona como programa, pero pide algunos pasos de instalación. Es lo que aparece en “Casi listos”.
- Herramienta de desarrollo, Framework y Contenido: proyectos para quien programa o colecciones de material. Aparecen en “Todos”.
Costo y programas de pago que reemplaza
El costo indica cuánto pagas por usar el programa:
- Gratis: todo lo que hace el programa está disponible sin pagar.
- Gratis, la API se paga: el programa es gratis, pero parte de lo que hace depende de un servicio de pago, como una clave de una IA.
- Freemium: hay una versión gratis y un plan de pago con más funciones.
- De pago: hay que pagar para usarlo.
Cuando un proyecto hace un trabajo parecido al de un programa de pago conocido, la ficha lo muestra en “Puede reemplazar”. Eso quiere decir que resuelve el mismo tipo de tarea, no que sea una copia ni que tenga todas las funciones del programa de pago. Los nombres de los programas de pago aparecen solo para que reconozcas la tarea; ningún fabricante paga por entrar o salir de esas comparaciones. La guía Cómo cambiar un programa de pago por uno gratis muestra cómo probar el cambio sin perder tus archivos.
Los sellos de revisión
Toda ficha publicada pasó por la revisión de IA y lleva el sello “Revisado por IA”. Cuando el responsable de Radar revisa la ficha personalmente, recibe el sello “Revisado por Radar”. Los dos sellos dicen quién revisó el texto, y no que el programa esté recomendado.
Lo que Radar no pudo verificar
No todo se puede confirmar solo con lo que está publicado en GitHub. Cuando algo quedó sin confirmar, como si el instalador funciona en una versión específica del sistema, la ficha lo dice en la sección “Lo que Radar no pudo verificar”. Lee esa parte antes de decidir: muestra los límites de esa ficha.
Los números de GitHub
La ficha también muestra los números públicos del proyecto, actualizados todos los días:
- Estrellas: cuántas personas marcaron el proyecto en GitHub, con el historial en “Estrellas a lo largo del tiempo”.
- Crecimiento: cuántas estrellas ganó en los últimos días.
- Descargas: cuántas veces se descargaron los archivos de las versiones publicadas en GitHub. Los proyectos distribuidos por tiendas de apps o por su propio sitio aparecen con menos descargas de las que tienen en realidad.
- Última actualización: cuándo cambió el código por última vez. Un proyecto detenido hace mucho tiempo puede no funcionar en las versiones nuevas del sistema.
De esos números salen los rankings de la sección “En alza”: “Creciendo más rápido”, “Más descargados de la semana” y “Nuevos en Radar”.
Lo que una ficha no es
Una ficha es una ayuda para decidir, no una garantía ni una orden de instalar. Reúne lo que muestran los datos y las evidencias, en un formato fácil de leer, pero la decisión siempre es tuya. Nadie paga por aparecer en Radar, y no existe posición comprada en los rankings.
¿Encontraste un dato incorrecto? Al final de cada ficha está el enlace “¿Algo está mal en esta ficha? Pide una corrección”, que lleva a la página de solicitud de corrección. Para saber más sobre quién hace el sitio, mira la página Acerca de.