Esta página explica, en términos sencillos, cómo awesome-repositories.com decide qué mostrarte y en qué orden. No hay ninguna caja negra secreta: aquí te contamos lo que hace el sistema realmente.
Qué hay en el directorio
El directorio es una selección curada de repositorios de código abierto en GitHub. Cada uno es importado, leído y analizado por IA: el modelo procesa el README y la documentación del proyecto para entender qué es, qué problema resuelve y dónde encaja. Las páginas con poca información, los proyectos abandonados y los duplicados se descartan en lugar de añadirse para aumentar el volumen.
No indexamos todos los repositorios de GitHub. El objetivo es ofrecer un conjunto más reducido de proyectos que merezcan tu atención, descritos de forma coherente, en lugar de un espejo exhaustivo de la plataforma.
Cómo funciona la clasificación de búsqueda
Cuando realizas una búsqueda, el sistema primero recopila proyectos candidatos mediante varias pasadas paralelas: una coincidencia de palabras clave con nuestro vocabulario de etiquetas curado, una coincidencia semántica que compara el significado de tu consulta con cada proyecto (para que los términos que no escribiste también cuenten), una pasada que incluye proyectos que mencionaste directamente y una pasada que explora repositorios que aún no hemos analizado completamente. Esas listas de candidatos se combinan, por lo que se favorece a los proyectos que aparecen en más de una pasada.
Un modelo de IA lee tu consulta como lo haría una persona —determinando la intención, el tipo de herramienta que buscas y las características concretas que debería tener un buen resultado— y evalúa cada candidato uno por uno, otorgándole un veredicto de relevancia y una breve razón en lenguaje sencillo. El orden final es una combinación ponderada: el veredicto de la IA por proyecto tiene el mayor peso, mientras que la coincidencia de etiquetas, los filtros que hayas establecido y las señales de clics reales completan el resto, aplicando una penalización a cualquier resultado que coincida con un término que hayas excluido.
Si la IA no está disponible —por una interrupción, un límite de cuota o porque simplemente está desactivada—, la búsqueda no se queda en blanco. Se recurre a una clasificación determinista basada en la coincidencia de etiquetas, tus filtros y los clics, para que sigas obteniendo resultados relevantes, aunque sin el razonamiento de la IA por cada resultado.
Cómo obtienen sus descripciones y etiquetas los repositorios
La descripción corta, el resumen de una línea y las etiquetas de cada repositorio son redactados por IA a partir del propio README y la documentación del proyecto, no extraídos de una página de marketing. El mismo análisis sitúa al proyecto en una taxonomía compartida única —una estructura coherente de casos de uso, ecosistemas y madurez— para que puedas filtrar en todo el directorio en lugar de buscar entre etiquetas libres.
Los prompts, las reglas de puntuación y la forma de esa taxonomía son ajustados y revisados por nosotros, y corregidos cuando el modelo comete un error.
Qué es una búsqueda curada
Algunas búsquedas se guardan como páginas "curadas": una consulta fija como "frameworks web de Rust" con una URL estable. En esas páginas, un editor puede fijar repositorios específicos que considera relevantes. Los proyectos fijados no se fuerzan a la parte superior: se incluyen en el mismo grupo de candidatos y son evaluados por el mismo juez de IA que el resto, por lo que una selección aún debe ganarse su posición.
Actualización y reanálisis
Los repositorios se resincronizan y reanalizan con el tiempo a medida que su código y documentación cambian, para que las descripciones y etiquetas no queden obsoletas. Los proyectos recién enviados se analizan antes de aparecer en los resultados clasificados.
IA, con supervisión humana
Para ser claros: la IA hace el trabajo pesado aquí —leer proyectos, construir la taxonomía y clasificar cada búsqueda. Pero no funciona sin supervisión. Nosotros escribimos y ajustamos los prompts, las reglas de puntuación y las directrices de curación, revisamos los resultados y los corregimos cuando es necesario. El objetivo es combinar la velocidad y escala de la IA con el criterio de alguien que realmente utiliza estas herramientas.
Correcciones
¿Crees que un repositorio está mal clasificado, mal descrito o falta? Dínoslo. Envía un proyecto desde cualquier página o escríbenos a hello@awesome-repositories.com y le echaremos un vistazo.