Hiciste público un repositorio y casi nadie lo usa. La mayoría de los consejos para promocionar un proyecto de código abierto son una lista de sitios donde publicar y trucos para conseguir más estrellas en GitHub, escritos hace unos años. Desde entonces, las estrellas se han vuelto fáciles de falsificar: un estudio presentado en ICSE 2026 estimó seis millones de estrellas presuntamente falsas en GitHub y encontró que la popularidad comprada se desvanece en unos dos meses. Esta guía cubre qué promocionar en lugar de estrellas, con qué audiencia empezar, una checklist del repositorio con los límites del propio GitHub, qué canal encaja con cada tipo de proyecto, la promoción que sale mal, un plan de 30 días, un registro semanal del lanzamiento que puedes copiar y cómo los usuarios se convierten en clientes si el proyecto forma parte de una startup. Es útil sin una cuenta de Soloop.
La respuesta breve
Para promocionar un proyecto de código abierto, escribe para un tipo de usuario con un problema, haz que el README y el quickstart lleven a esa persona a un resultado que funcione en minutos, y lanza en un sitio donde esos usuarios ya conversan. Después habla con quienes lo prueban, corrige lo que los frenó y vuelve a lanzar en otro sitio.
Mide personas, no estrellas. GitHub prohíbe las estrellas automatizadas y la interacción pagada, y una investigación presentada en ICSE 2026 encontró que las estrellas falsas dan a un proyecto un impulso breve seguido de un daño duradero. Registra quién visita, quién clona o instala, quién abre un issue y quién vuelve, y guarda los 14 días de tráfico que te muestra GitHub antes de que desaparezcan.
Por qué las estrellas son un objetivo débil en 2026
Una estrella es un marcador. Cuesta un clic, no dice nada sobre si la persona usó el proyecto y se puede comprar. Un equipo de investigación encabezado por Hao He estimó unos seis millones de estrellas presuntamente falsas entre 2019 y 2024, con un fuerte aumento en 2024. La mayoría promocionaban repositorios de malware de vida corta; el resto promocionaba sobre todo proyectos de IA y LLM, blockchain, herramientas y tutoriales. El efecto de la promoción duraba menos de unos dos meses, y después las estrellas falsas se convertían en un lastre.
Las estrellas siguen importando como señal pública. Los inversores y las listas las vigilan: el ROSS Index de Runa Capital clasifica startups de código abierto por el crecimiento de estrellas, y en el tercer trimestre de 2026 casi todos los proyectos de la lista eran herramientas de IA o de agentes. Trata las estrellas como un resultado tardío de que la gente encuentre útil el proyecto, nunca como el objetivo que optimizas.
Unos seis millones de estrellas presuntamente falsas de 2019 a 2024, con un repunte en 2024; la mayoría promocionan repositorios de malware de vida corta, y el resto sobre todo repositorios de IA/LLM, blockchain, herramientas y tutoriales; el efecto de la promoción dura menos de unos dos meses y después se convierte en un lastre.
He et al., Six Million (Suspected) Fake Stars in GitHub (ICSE 2026)Prohíbe las interacciones no auténticas, el abuso de clasificación como dar estrellas o seguir de forma automatizada, la interacción incentivada con recompensas como airdrops y los mercados secundarios de actividad no auténtica.
GitHub Acceptable Use Policies, sección 4El ROSS Index del Q3 2026 clasifica startups de código abierto por el crecimiento de estrellas en GitHub; casi las 20 entradas son proyectos de IA o de agentes.
Runa Capital: ROSS Index Q3 2026Decide primero a quién te diriges
Un proyecto de código abierto tiene tres audiencias posibles, y cada una necesita cosas distintas. El panel de maintainers de GitHub lo resumió así: haz crecer primero los usuarios, porque el uso visible es lo que atrae a los contribuidores. Si el proyecto pertenece a una empresa, los compradores llegan aún más tarde, de entre los usuarios que dependen de él en el trabajo.
| Dimensión | Lo que necesitan de ti | Primer paso |
|---|---|---|
| Usuarios | Una explicación clara del problema que resuelve, un quickstart que funcione y pruebas de que se mantiene. | Reescribe la primera pantalla del README para un usuario y un problema, con una demo de 10–20 segundos. |
| Contribuidores | Pautas de contribución, una hoja de ruta, issues para empezar etiquetados y maintainers que respondan con amabilidad. | Añade CONTRIBUTING, una hoja de ruta breve y algunos issues bien descritos, y agradece cada primer reporte. |
| Compradores (si vendes algo) | Un motivo para pagar que no rompa el proyecto gratuito: alojamiento, soporte, funciones para equipos o cumplimiento normativo. | Pregunta a quienes lo usan en el trabajo qué no querrían operar ellos mismos. |
Nombra un problema y un beneficio concretos; apunta a un nicho; comparte demos de 10–20 segundos; mantén el README centrado en el problema del usuario; los contribuidores llegan tras la adopción orgánica por parte de usuarios y necesitan pautas, una hoja de ruta y maintainers receptivos y amables; mide el impacto a largo plazo en lugar de las descargas o las estrellas.
GitHub Blog: Marketing for maintainers (jul. 2022)Checklist del repositorio antes de promocionar nada
Todos los canales envían a la gente a la misma página. Si el repositorio no se explica en la primera pantalla, la promoción solo hace que se vaya más gente. Revisa primero cada punto.
- Descripción y primera línea del README: para quién es y qué hace, en palabras sencillas, sin detalles de implementación.
- Una demo cerca del principio: un GIF o un vídeo corto de 10–20 segundos que muestre el primer resultado útil.
- Quickstart: instalación para copiar y pegar y un comando o fragmento que funcione en una máquina limpia. Pruébalo desde cero antes del lanzamiento.
- Topics: hasta 20, con letras minúsculas, números y guiones, de 50 caracteres cada uno. Usa las palabras que la gente busca, como el lenguaje, el framework y el problema.
- Imagen de vista previa social: al menos 640×320, idealmente 1280×640, en PNG, JPG o GIF de menos de 1 MB, para que los enlaces compartidos en X, Slack o Reddit se vean cuidados.
- Un archivo de licencia, para que las empresas sepan si pueden usarlo.
- CONTRIBUTING, una hoja de ruta breve y algunos issues etiquetados para recién llegados con contexto suficiente para empezar.
- Señales de vida: una release reciente, issues respondidos y un changelog. Los visitantes comprueban si hay alguien al otro lado.
- Quién lo usa: usuarios o empresas reales, nombrados solo con su permiso.
- Un enlace a la documentación o a un sitio web si existe, y cómo pedir ayuda.
Letras minúsculas, números y guiones; 50 caracteres o menos; no más de 20 por repositorio; las páginas de topics y la búsqueda ayudan a la gente a descubrir repositorios.
GitHub Docs: Classifying your repository with topicsMínimo de 640×320 píxeles, 1280×640 para la mejor visualización; PNG, JPG o GIF de menos de 1 MB.
GitHub Docs: Customizing your repository's social media previewElige un canal de lanzamiento según lo que sea el proyecto
Elige el sitio donde ya se reúne la gente con el problema, muestra el proyecto resolviéndolo y quédate a responder preguntas. Un segundo canal puede esperar hasta que el primero te haya enseñado qué entiende mal la gente.
| Dimensión | Dónde están los primeros usuarios | Primer paso |
|---|---|---|
| Librería o SDK | La comunidad del framework, su issue tracker y sus discusiones, y las preguntas de Stack Overflow que tu librería responde. | Responde preguntas existentes donde la librería ayude de verdad, y publica un ejemplo breve que resuelva una tarea habitual. |
| CLI o herramienta para desarrolladores | Hacker News, subreddits de desarrolladores y cuentas de X que comparten herramientas. | Un Show HN que la gente pueda probar sin registrarse, contigo en los comentarios durante las primeras horas. |
| Alternativa autoalojada a un producto de pago | Gente que se queja del precio, los límites o la privacidad del producto de pago, y comunidades de autoalojamiento. | Una comparación clara de lo que sustituye, lo que todavía no hace y cómo ejecutarlo. |
| Herramienta de agentes de IA, servidor MCP o plugin | Builders en X y GitHub, comunidades de frameworks de agentes y directorios de asistentes de IA. | Una demo de una tarea que el agente no podía hacer antes, y una ficha en el directorio correspondiente si existe. |
| Startup open-core | Equipos que ya usan el proyecto en el trabajo. | Habla con las personas detrás de los issues y de las instalaciones desde dominios de empresa antes de anunciar un plan de pago. |
La promoción que sale mal
Estas tácticas o incumplen las normas de una plataforma o producen cifras que te engañan. Contrasta tu plan con la lista antes de la semana del lanzamiento.
- Comprar estrellas, intercambiar estrellas con otros maintainers o usar herramientas que dan estrellas automáticamente.
- Dar recompensas, airdrops o sorteos a cambio de estrellas, seguidores u otra interacción.
- Pedir a amigos o compañeros que voten o comenten tu Show HN.
- Publicar una landing page, una lista de espera o un formulario de registro como Show HN en lugar de algo que la gente pueda probar.
- Anunciarte en los issues de otros proyectos, o publicar la misma promoción en muchos repositorios.
- Extraer perfiles de GitHub para enviar emails no solicitados sobre tu proyecto.
- Publicar el mismo enlace en muchos subreddits o grupos sin leer sus normas de autopromoción.
La sección 4 prohíbe la actividad no auténtica, el abuso de clasificación como las estrellas automatizadas, la interacción incentivada con recompensas y la actividad no auténtica coordinada; la sección 7 prohíbe usar información de GitHub para spam como el email no solicitado; la sección 10 prohíbe el contenido masivo monetizado o excesivo en issues.
GitHub Acceptable Use PoliciesPara algo con lo que la gente pueda jugar; no entradas de blog, páginas de registro, newsletters ni listas; ni landing pages ni campañas de recaudación; no pidas a tus amigos que voten o comenten; haz que sea fácil de probar sin registrarse.
Hacker News: Show HN guidelinesUn plan de lanzamiento de 30 días
- Días 1–3: escribe una frase que nombre al usuario, el problema y el resultado. Reescribe a partir de ella la descripción del repositorio, el primer párrafo del README y la demo.
- Días 4–7: repasa la checklist del repositorio de arriba. Pide a dos personas que nunca hayan visto el proyecto que sigan el quickstart mientras las observas, y corrige cada punto donde se atasquen.
- Días 8–14: encuentra 20 conversaciones existentes en las que alguien tenga el problema, como issues, hilos de foros o publicaciones. Responde solo donde el proyecto ayude de verdad, y di que lo hiciste tú.
- Días 15–21: haz un lanzamiento público en el canal donde ocurrieron esas conversaciones, como un Show HN o una publicación con demo. Quédate en los comentarios y anota cada pregunta y objeción.
- Días 22–30: corrige la objeción más común, publica una release que explique qué cambió, agradece a quienes reportaron problemas y compara el registro de este periodo con el primero.
Copia el registro semanal del lanzamiento
GitHub muestra los visitantes, los clones, los principales referentes y el contenido popular solo de los últimos 14 días, y solo a quienes tienen acceso de push. La REST API devuelve los mismos 14 días, así que copia las cifras cada semana o las perderás. Los registros de paquetes guardan más historial: la API de descargas de npm responde para periodos como la última semana o un rango de fechas dentro de 18 meses, y PyPI publica las descargas en un dataset público de BigQuery.
Las descargas cuentan instalaciones, incluidas las automatizadas, no personas. Léelas como una tendencia junto a las señales humanas del registro: issues de desconocidos, primeras contribuciones y conversaciones con personas que usan el proyecto para trabajo real.
Clones completos, visitantes de los últimos 14 días, sitios de referencia y contenido popular; visible para cualquiera con acceso de push.
GitHub Docs: Viewing traffic to a repositoryVistas y clones por día o por semana, los 10 principales referentes y rutas, de los últimos 14 días; requiere acceso de escritura.
GitHub REST API: Repository trafficEndpoints de punto y de rango para el último día, la última semana, el último mes, el último año o un rango de fechas; consultas limitadas a 18 meses de datos.
Registro de npm: download countsLos eventos de descarga se transmiten a la tabla pública de BigQuery bigquery-public-data.pypi.file_downloads.
PyPI Docs: BigQuery datasetsLee las cifras en conjunto
Ejemplo ilustrativo, no una referencia: en los 14 días alrededor de un Show HN, un repositorio recibe 2.400 visitantes únicos y 180 clonadores únicos, así que el 7,5 % de los visitantes lo clonó (180 ÷ 2.400). También gana 150 estrellas, unas 6 por cada 100 visitantes, y 12 issues de personas ajenas al equipo. Tras reescribir el README en torno a la pregunta más común, los 14 días siguientes traen menos visitantes, 2.000, pero 200 clonadores únicos, o el 10 % (200 ÷ 2.000). Llegó menos gente, pero más de ella lo probó: la reescritura funcionó, aunque las estrellas crecieron más despacio.
Lee las estrellas en ese contexto. Un salto de estrellas sin cambios en clonadores, instalaciones o issues suele significar atención sin uso. Que crezcan los issues de desconocidos suele significar uso real, aunque sean reportes de bugs.
De usuarios a clientes
Si el proyecto forma parte de una startup, los primeros clientes suelen estar ya en tu issue tracker. Busca a quienes lo usan en el trabajo, pregúntales qué preferirían no operar ellos mismos y prueba con ellos una oferta de pago, como alojamiento, soporte, funciones para equipos o ayuda con el cumplimiento normativo, antes de construir una página de precios.
Mantén el proyecto gratuito realmente útil. Poner el quickstart detrás de un registro o quitar funciones de las que dependen los usuarios rompe la confianza que los trajo, y en Hacker News un muro de registro descalifica un Show HN.
Dónde encaja Soloop
Soloop no da estrellas a repositorios, no publica paquetes ni gestiona tu proyecto de GitHub. Ayuda con la difusión en torno a él, y puedes empezar desde un repositorio. Según el manual de Soloop, puede investigar dónde se habla de un problema y devolver fuentes, publicar en X después de que lo conectes con OAuth, preparar publicaciones de Reddit para que las publiques tú mismo, enviar emails en frío a través de una cuenta de Gmail conectada y preparar Google Search Ads para que los revises y pagues. Las acciones esperan tu aprobación de forma predeterminada.
Una primera solicitud acotada: Mi proyecto de código abierto [URL del repositorio] ayuda a [usuario] a [conseguir un resultado]. Encuentra 20 conversaciones recientes en las que [usuario] describa [problema], con fuentes, sugiere un canal para un lanzamiento y redacta un título de Show HN y un primer comentario dentro de las normas de HN. No publiques ni envíes nada.
Fuentes, limitaciones y actualización
El estudio sobre estrellas falsas, las Acceptable Use Policies de GitHub, la documentación de tráfico, topics y vista previa social, la REST API de tráfico, las directrices de Show HN, la documentación de descargas de npm y PyPI, el panel de marketing para maintainers de GitHub y el ROSS Index del Q3 2026 de Runa Capital se leyeron el 2 de noviembre de 2026. GitHub no publica cómo clasifican los repositorios Trending ni la búsqueda, y las cifras de descargas incluyen instalaciones automatizadas. Las tablas de audiencias y canales, las checklists, el plan y el registro son orientación editorial; el ejemplo del embudo es ilustrativo. Nada de esto garantiza estrellas, usuarios ni clientes.
Esta guía se revisará antes del 2 de febrero de 2027, o antes si GitHub cambia sus normas sobre estrellas, tráfico o Trending.
El manual de Soloop describe investigación con fuentes, publicación en X con OAuth, preparación para Reddit con publicación manual, emails en frío a través de Gmail y Google Search Ads tras la revisión y el pago; la aprobación va primero de forma predeterminada. No gestiona repositorios de GitHub, estrellas ni releases de paquetes.
Manual del producto Soloop