Como divulgar um projeto open source
Lance uma vez nos canais que combinam com o seu projeto, seguindo as regras de cada um sobre idade do projeto, arquivo de licença, megathreads e texto escrito por IA. Depois faça o trabalho lento que segue trazendo usuários: responda às perguntas sobre alternativas, qual biblioteca usar e se o projeto segue mantido, diga claramente que você é o mantenedor e meça instalações, issues e novos contribuidores antes das estrelas.
Publicado em · Atualizado em
O dia do lançamento e todos os dias depois dele
O dia do lançamento traz um pico de visitas e depois silêncio. A maioria das pessoas que vai adotar o projeto ao longo do próximo ano chega até ele mais tarde, em threads como estas:
- Alguma alternativa self-hosted a um app de notas, com criptografia de ponta a ponta e sincronização no celular?
- Qual biblioteca Python extrai tabelas de PDFs sem quebrar com arquivos escaneados?
- Esse projeto ainda é mantido? A última release parece antiga.
- Podemos rodar um projeto AGPL dentro do nosso SaaS?
- Uma status page open source que rode numa VPS pequena?
O Open Source Guide do GitHub sobre como encontrar usuários dá a versão de quem mantém projetos: vá aonde os seus usuários já se reúnem, responda a quem tem o problema que o seu projeto resolve, mencione o projeto só quando fizer sentido e conte com um crescimento que leva meses ou anos.
Onde postar e as regras de cada canal
As regras gerais do Reddit pedem que você participe de forma autêntica das comunidades que lhe interessam, não faça spam e não engane ninguém sobre quem você é. Cada subreddit define ainda as próprias regras, e os subreddits de open source são mais rígidos que a maioria. A tabela abaixo usa um diretório de canais para open source que registrou essas regras em 7 de outubro de 2026, mais as páginas do Hacker News que nós mesmos lemos. As regras mudam, então leia a barra lateral antes de cada post.
| Canal | O que exige de um post sobre projeto | Fonte |
|---|---|---|
| r/selfhosted | Projetos com menos de três meses vão só para a New Project Megathread semanal; posts avulsos sobre eles são removidos | Diretório, consultado em 07/10/2026 |
| r/opensource | Flair de promoção, um repositório linkado com arquivo LICENSE aprovado pela OSI, e conteúdo gerado por IA tratado como motivo de banimento | Diretório, consultado em 07/10/2026 |
| r/programming | Nada de posts do tipo “eu fiz isto”; um texto técnico sobre um problema difícil é aceito; texto escrito por LLM, inclusive traduções, não | Diretório, consultado em 07/10/2026 |
| r/Python | Projetos vão para uma thread mensal de showcase e precisam ser comparados com o que as pessoas já usam | Diretório, consultado em 07/10/2026 |
| r/golang, r/rust | Os moderadores podem remover posts que pareçam gerados por IA | Diretório, consultado em 07/10/2026 |
| Show HN | Algo que você fez e sobre o qual pode conversar, que as pessoas possam testar já, de preferência sem cadastro nem e-mail no caminho; nada de projetos gerados às pressas; não peça a amigos que impulsionem ou comentem | Regras do Show HN |
| Hacker News em geral | Nada de texto gerado ou editado por IA em posts ou comentários, nada de postagem automática, e promoção só de vez em quando | Diretrizes do HN |
| awesome-selfhosted | Uma primeira release com tag publicada há mais de quatro meses; bibliotecas e SDKs não entram; contribuições geradas por LLM levam a banimento | CONTRIBUTING.md |
Um plano para a semana de lançamento
O Infisical, um gerenciador de segredos open source, contou como foi o seu lançamento: posts no r/opensource, no r/github e no r/node, um Show HN e newsletters como TLDR e Console.dev falando do projeto nos dias seguintes. O autor recomenda participar dessas comunidades antes do lançamento, coisa que eles não tinham feito. Um plano a partir disso:
- Antes do lançamento: facilite o teste
Um README que mostre o que o projeto faz logo na primeira tela, passos de instalação que funcionem numa máquina limpa, um arquivo LICENSE e uma release com tag. - Semanas antes: participe
Responda perguntas onde os seus usuários estão, sem mencionar o projeto. O relato do Infisical aponta essa como a etapa que eles pularam. - Dia do lançamento: um post por canal, escrito por você
Dois ou três canais que façam sentido, a megathread ou o flair que cada um exige, e as suas próprias palavras. Fique para os comentários; eles mostram o que falta no README. - Depois: as listagens
Diretórios e listas curadas vêm depois. O awesome-selfhosted espera até a sua primeira release ter mais de quatro meses.
Respondendo como mantenedor
A fonte constante de novos usuários é a thread de perguntas. Uma boa resposta ajuda a pessoa a escolher, mesmo quando a escolha não é o seu projeto. Responder threads de recomendação de ferramentas mostra o formato geral; três perguntas aparecem com frequência suficiente no open source para valer um plano.
“Alternativa ao X?”
Cite as opções que atendem às restrições da pessoa, inclusive as que não são suas, e diga em que a sua é diferente. Se ela precisa de sincronização no celular e o seu projeto não tem, diga isso.
“Ainda é mantido?”
Responda com fatos que o leitor possa conferir: a data da última release, com que frequência você faz merge, em quanto tempo as issues recebem resposta. O check Maintained do OpenSSF Scorecard, por exemplo, procura commits semanais nos últimos 90 dias, dá a nota mais baixa a repositórios arquivados e considera projetos com menos de 90 dias novos demais para avaliar.
“Posso usar sob esta licença?”
Mande o link do texto da licença e de um resumo simples em vez de dar conselho jurídico. Sobre a AGPL-3.0, o resumo do choosealicense.com observa que, quando uma versão modificada é usada para oferecer um serviço pela rede, o código-fonte completo dessa versão modificada precisa ser disponibilizado.
Essa última frase importa mesmo quando o projeto é gratuito. As orientações da FTC sobre endossos dizem que os vínculos que precisam ser declarados não se limitam a dinheiro e incluem emprego e sociedade, e que colocar o empregador no perfil não basta. Se essas orientações alcançam um projeto pessoal não remunerado é uma questão jurídica, mas as regras do Reddit já pedem que você não engane ninguém sobre quem você é. Os modelos de divulgação trazem frases que cabem em uma linha.
Estrelas vêm por último
A documentação do GitHub diz que muitos rankings de repositórios dependem de estrelas e descreve a estrela como um jeito de acompanhar projetos e mostrar apreço ao mantenedor, não como sinal de que alguém instalou alguma coisa. Um estudo aceito no ICSE 2026, revisado no arXiv em 2025, encontrou cerca de seis milhões de estrelas suspeitas de serem falsas, a maioria em repositórios de phishing e malware de vida curta, e concluiu que estrelas falsas ajudam por menos de dois meses e depois viram um peso.
Acompanhe os números que indicam que alguém usou o projeto: downloads do pacote, issues abertas por pessoas que você não conhece e contribuidores de primeira viagem. Para este último, marque issues para iniciantes e escreva um CONTRIBUTING.md; a listagem good-first-issue pede pelo menos três issues abertas para iniciantes, dez contribuidores, documentação de setup e uma licença open source.
Onde um agente ajuda e onde não ajuda
A parte lenta de tudo isso é a leitura: encontrar as threads de alternativas e de projeto ainda mantido no Reddit e no X antes que esfriem. A Agent Agency faz essa parte. Você cola o site do projeto, ela lê até cinco páginas públicas e escreve um Product DNA que você aprova, e os agentes leem cada comunidade e respeitam limites diários. No modo Aprovação, cada comentário, post e DM espera o seu OK. Os agentes voltam à thread por vários dias para responder a quem comentar e só mencionam o projeto quando ele responde à pergunta, dentro de um limite diário. Como funciona mostra o fluxo completo.
| Tarefa | Quem faz |
|---|---|
| Show HN, Lobsters, listas awesome, diretórios, newsletters | Você. A Agent Agency não tem agente para esses canais. |
| Posts em canais que proíbem texto escrito por IA, como r/programming e r/opensource | Você, com as suas palavras. No modo Aprovação, recuse os rascunhos do agente para essas comunidades. |
| Encontrar threads de perguntas no Reddit e no X | O agente |
| Rascunhar respostas e acompanhamentos | O agente, para você editar e aprovar |
| Decidir como declarar que você mantém o projeto | Você. As regras da plataforma e a lei exigem declarar vínculos relevantes. |
O Reddit e o X estão disponíveis, e o YouTube está em teste. As moedas pagam o trabalho, e os preços saem junto com os primeiros convites. Se o seu projeto é uma ferramenta comercial para desenvolvedores, e não um projeto comunitário, a página para ferramentas de desenvolvedor se encaixa melhor.
Perguntas
Onde devo postar meu projeto open source primeiro?
Onde os seus usuários já fazem perguntas, no formato que cada canal exige. Para um app self-hosted, pode ser a megathread semanal do r/selfhosted; para uma biblioteca Python, a thread mensal de showcase do r/Python; para algo que as pessoas possam testar na hora, um Show HN. Escolha dois ou três, escreva cada post você mesmo e fique para os comentários.
Preciso declarar que mantenho um projeto gratuito?
Sim, diga. As regras do Reddit pedem que você não engane ninguém sobre quem você é, e as orientações da FTC dizem que vínculos como emprego ou sociedade precisam ser declarados mesmo quando não há dinheiro envolvido. Uma linha como “eu mantenho este projeto” basta, colocada no próprio comentário e não só no seu perfil.
Um agente de IA pode postar sobre o meu projeto no r/programming ou no Hacker News?
Esses canais rejeitam texto escrito por IA: o r/programming proíbe conteúdo escrito por LLM e o Hacker News pede que não haja texto gerado ou editado por IA. A Agent Agency não tem agente para o Hacker News, e no Reddit você deve escrever esses posts você mesmo e recusar rascunhos para qualquer subreddit com essa regra.
A Agent Agency encontra as threads em que as pessoas procuram um projeto como o seu e rascunha respostas para você aprovar. Entrar na lista de espera é grátis. Entrar na lista de espera
Fontes
- Reddit Rules, acessado em
- Where to promote open-source projects (SaaSCity directory, venue rules as checked 2026-10-07), acessado em
- Show HN guidelines (Hacker News), acessado em
- Hacker News guidelines, acessado em
- Finding Users for Your Project (Open Source Guides, GitHub), acessado em
- awesome-selfhosted-data: CONTRIBUTING.md, acessado em
- Saving repositories with stars (GitHub Docs), acessado em
- He et al., Six Million (Suspected) Fake Stars in GitHub (arXiv:2412.13459, v2 2025-09-06), acessado em
- OpenSSF Scorecard checks: Maintained, acessado em
- FTC's Endorsement Guides: What People Are Asking, acessado em
- GNU Affero General Public License v3.0 (choosealicense.com), acessado em
- good-first-issue: criteria for adding a project, acessado em
- How we got to 3000 GitHub stars in 2 months? (Infisical blog, 2023-01-16), acessado em
Comunidades onde se pergunta
Relacionados
- Reddit Self-Promotion Rules: What Reddit Actually Says EN
- How to Answer 'What Tool Do You Use?' Threads on Reddit EN
- How to Disclose Your Affiliation on Reddit EN
- Marketing para empresas de ferramentas de desenvolvedor
- Alternativas ao GummySearch: o que usar antes de 1º de dezembro de 2026
- Alternativas aos Reddit Ads, e quando o anúncio ainda é a melhor escolha