Hoe promoot je een open source project?

De lanceerdag, en elke dag daarna

Een lanceerdag levert een piek aan bezoekers op, en daarna wordt het stil. De meeste mensen die je project het komende jaar gaan gebruiken, vinden het later, in threads zoals deze:

• Een self-hosted alternatief voor een notitie-app, met end-to-end-versleuteling en synchronisatie op je telefoon?
• Welke Python-library haalt tabellen uit pdf's zonder vast te lopen op gescande bestanden?
• Wordt dit project nog onderhouden? De laatste release lijkt oud.
• Mogen we een AGPL-project binnen onze SaaS draaien?
• Een open source statuspagina die op een kleine VPS draait?

De Open Source Guide van GitHub over gebruikers vinden geeft de versie voor maintainers: ga naar de plekken waar je gebruikers al samenkomen, beantwoord vragen van mensen die het probleem hebben dat jouw project oplost, noem het project alleen waar het past en reken erop dat groei maanden of jaren duurt.

Waar je post, en welke regels daar gelden

De regels die voor heel Reddit gelden, vragen je om oprecht mee te doen in communities die je belangrijk vindt, niet te spammen en mensen niet te misleiden over wie je bent. Elke subreddit stelt daarnaast eigen regels op, en open source subreddits zijn strenger dan de meeste. De tabel hieronder gebruikt een overzicht van open source plekken dat deze regels op 7 oktober 2026 vastlegde, plus de Hacker News-pagina's die we zelf hebben gelezen. Regels veranderen, dus lees de sidebar voor elke post.

Een plan voor de lanceerweek

Infisical, een open source secrets manager, schreef over zijn lancering: posts in r/opensource, r/github en r/node, een Show HN, en nieuwsbrieven zoals TLDR en Console.dev die het in de dagen daarna oppikten. De auteur raadt aan om al voor de lancering mee te doen in die communities, wat zij niet hadden gedaan. Een plan op basis daarvan:

1. Voor de lancering: maak het makkelijk om te proberen
   Een README die op het eerste scherm laat zien wat het project doet, installatiestappen die werken op een schone machine, een LICENSE-bestand en een getagde release.
2. Weken ervoor: doe mee
   Beantwoord vragen waar je gebruikers zitten, zonder het project te noemen. Volgens het verslag van Infisical is dit precies de stap die zij oversloegen.
3. Lanceerdag: één post per plek, door jou geschreven
   Twee of drie plekken die passen, met de megathread of flair die elk ervan vereist, en in je eigen woorden. Blijf bij de reacties; die laten zien wat er in de README ontbreekt.
4. Later: de vermeldingen
   Directories en samengestelde lijsten komen daarna. awesome-selfhosted wacht tot je eerste release ouder is dan vier maanden.

Antwoorden als maintainer

De vaste bron van nieuwe gebruikers is de vragenthread. Een goed antwoord helpt iemand kiezen, ook als die keuze niet op jouw project valt. Threads met toolaanbevelingen beantwoorden beschrijft de algemene aanpak; drie vragen komen in open source zo vaak voor dat je je erop kunt voorbereiden.

“Alternatief voor X?”

Noem de opties die binnen hun eisen passen, ook die je niet zelf hebt geschreven, en zeg waarin de jouwe verschilt. Hebben ze synchronisatie met hun telefoon nodig en heeft jouw project dat niet, zeg dat dan.

“Wordt het nog onderhouden?”

Antwoord met feiten die een lezer kan nagaan: de datum van de laatste release, hoe vaak je merget, hoe snel issues een reactie krijgen. De Maintained-check van OpenSSF Scorecard kijkt bijvoorbeeld naar wekelijkse commits in de afgelopen 90 dagen, geeft gearchiveerde repo's de laagste score en vindt projecten jonger dan 90 dagen te nieuw om te beoordelen.

“Mag ik het onder deze licentie gebruiken?”

Link naar de licentietekst en een samenvatting in gewone taal in plaats van juridisch advies te geven. Voor AGPL-3.0 vermeldt de samenvatting van choosealicense.com dat wanneer een aangepaste versie wordt gebruikt om een dienst via een netwerk te leveren, de volledige broncode van die aangepaste versie beschikbaar moet worden gesteld.

Die laatste zin telt ook als het project gratis is. De richtlijnen over endorsements van de FTC zeggen dat banden die je moet melden niet beperkt zijn tot geld en ook een dienstverband en mede-eigendom omvatten, en dat je werkgever op je profiel vermelden niet genoeg is. Of die richtlijnen ook voor een onbetaald hobbyproject gelden, is een juridische vraag, maar de regels van Reddit vragen je al om mensen niet te misleiden over wie je bent. De templates voor transparantie geven formuleringen die in één regel passen.

Stars komen pas als laatste

Volgens de documentatie van GitHub hangen veel van zijn repository-rankings af van stars, en een star is een manier om projecten bij te houden en de maintainer waardering te tonen, geen teken dat iemand iets heeft geïnstalleerd. Een studie die is geaccepteerd voor ICSE 2026, in 2025 herzien op arXiv, vond ongeveer zes miljoen vermoedelijk nepstars, vooral op kortlevende repo's voor phishing en malware, en stelde vast dat nepstars minder dan twee maanden helpen en daarna een last worden.

Volg de cijfers die betekenen dat iemand het project heeft gebruikt: downloads van je package, issues van mensen die je niet kent, en contributors die voor het eerst bijdragen. Label voor dat laatste beginnersissues en schrijf een CONTRIBUTING.md; de lijst good-first-issue vraagt minstens drie openstaande beginnersissues, tien contributors, documentatie voor de installatie en een open source licentie.

Waar een agent past, en waar niet

Het trage deel van dit alles is lezen: de alternatief-voor- en wordt-het-nog-onderhouden-threads vinden op Reddit en X voordat ze stilvallen. Dat deel doet Agent Agency. Je plakt de website van je project, het leest tot vijf openbare pagina's en schrijft een Product DNA dat jij goedkeurt, en de agents lezen elke community en houden zich aan daglimieten. In de Goedkeuringsmodus wacht elke reactie, post en DM op jou. Agents komen dagenlang terug in een thread om iedereen die reageert te antwoorden, en noemen het project alleen als het de vraag beantwoordt, onder een daglimiet. Hoe het werkt laat de hele flow zien.

Reddit en X zijn live en YouTube wordt getest. Met coins betaal je voor het werk, en de prijzen maken we bekend bij de eerste uitnodigingen. Is je project eerder een commerciële developer tool dan een communityproject, dan past de pagina voor developer tools beter.

Vragen

Waar post ik mijn open source project als eerste?

Waar je gebruikers al vragen stellen, in het format dat elke plek vereist. Voor een self-hosted app kan dat de wekelijkse megathread op r/selfhosted zijn; voor een Python-library de maandelijkse showcasethread op r/Python; voor iets wat mensen meteen kunnen proberen een Show HN. Kies er twee of drie, schrijf elke post zelf en blijf bij de reacties.

Moet ik melden dat ik maintainer ben van een gratis project?

Ja, zeg het. De regels van Reddit vragen je om mensen niet te misleiden over wie je bent, en volgens de richtlijnen van de FTC moet je banden zoals een dienstverband of mede-eigendom melden, ook als er geen geld in het spel is. Eén regel zoals “ik ben maintainer van deze” is genoeg, in de reactie zelf en niet alleen op je profiel.

Mag een AI-agent over mijn project posten in r/programming of op Hacker News?

Die plekken weigeren door AI geschreven tekst: r/programming verbiedt content die door een LLM is geschreven en Hacker News vraagt om geen gegenereerde of door AI bewerkte tekst. Agent Agency heeft geen agent voor Hacker News, en op Reddit schrijf je die posts het best zelf en wijs je concepten af voor elke subreddit met die regel.

Agent Agency vindt de threads waarin mensen vragen naar een project als het jouwe en schrijft concepten van antwoorden die jij goedkeurt. Op de wachtlijst staan is gratis. Zet je op de wachtlijst