The complete open source marketing guide — how to get GitHub stars, github stars growth, KOL partnerships, community distribution
GitHub stars GitHub forks GitHub watchers License: MIT Website PRs Welcome Last Commit Contributors
💡 Need a 1-on-1 architecture call for your B2B/Open-source launch? Book a session for 200ドル (Crypto/USDT and Wire Transfer accepted) — Contact @Iris_carrot on Telegram
Or visit gingiris.com — Iris's consulting practice with 1:1 sessions, startup coaching, and enterprise retainer options.
💡 Why Star this?
- Battle-Tested: Documents the exact strategies used for 30x PH #1 and 60k Stars.
- AI-Native: Battle-tested AI Agent Skills to automate your next 10k stars.
- PH Strategy: Access the playbook that earned 30x Product Hunt #1.
🌱 Our Philosophy
"创业没有那么高大上,创业就是做生意。" — Startups aren't glamorous; they're just business.
"痛点永远比痒点值钱。" — Pain points are always worth more than nice-to-haves.
"长期信任比快钱更难,也更值钱。" — Long-term trust is harder than quick money, and worth more.
This playbook is built on real failures and hard-won wins from scaling open source projects globally.
💼 Work With Iris
1. Strategic Consultation (1v1)
Session Price Best For Quick Call (30 min) 150ドル USD Specific questions, quick diagnosis Deep Dive (60 min) 300ドル USD Full strategy review, detailed roadmap 2. Advisory Retainer
Plan Price Includes Monthly Retainer 1,500ドル USD/mo Up to 5 hours strategic consultation + key milestone reviews 3. Playbooks & Templates
Package Price Contents Starter Pack 29ドル USD Core methodology + essential tools Flagship Bundle 199ドル USD Complete SOP, competitor research framework, templates 📩 Contact @Iris_carrot on Telegram — Crypto/USDT and Wire Transfer accepted
This playbook is available as a ClawHub Skill — install it directly into Claude Code, OpenClaw, or any compatible AI agent:
clawhub install gingiris-opensource
Your AI agent can then help you execute OSS marketing strategies and track your GitHub growth.
📦 Also available: All Gingiris Growth Playbooks on ClawHub
If you find this playbook useful, a GitHub Star ⭐ helps others discover it!
From the team behind AFFiNE (60k+ stars). This playbook contains the exact strategies that achieved:
| Metric | Target |
|---|---|
| 🚀 Launch Day Stars | 500+ |
| ⭐ First Week Stars | 1,000+ |
| 📈 Daily New Stars (Week 1) | 100+ |
| 🎬 KOL Quotes | 100-150 (5 days) |
| 📱 Reddit Posts | 3-5 subreddits daily |
| 💬 Community Shares | 50-100 groups daily |
Real results from developers using this playbook:
| Project | Result | Story |
|---|---|---|
| Your project here | — | Share yours → |
📢 Grew your GitHub stars with this playbook? We'd love to feature your story! Submit your case study
Version: 5.0 (Final) | Author: Iris (生姜iris)
The essence of open source: ask developers to contribute influence (love), and ask B2B customers to contribute money 💰. Through proper SOP operations, open sourcing can convert into hundreds or thousands of stars and bring many SMB leads. Prepare your business model before open sourcing — otherwise you'll waste the traffic this action brings.
| Phase | Timing | Core Tasks |
|---|---|---|
| Strategic Planning | T-4 weeks | Positioning, value proposition, business model |
| Asset Preparation | T-3 weeks | GitHub README, website, PR materials, docs |
| Channel Preparation | T-2 weeks | KOL outreach, Reddit accounts, group organization |
| Team Assignment | T-1 week | Budget approval, task allocation, communication |
| Launch Sprint | T-3 days | Copy confirmation, automation setup, final check |
| 🚀 Launch Day | T-0 | Multi-channel concentrated exposure, trigger flywheel |
| Sustained Operations | T+1 to T+7 | 100+ stars daily, KOL quote bombardment |
Beyond standard launch ops, these force multiplier tactics can bring hundreds of stars in a single coordinated push.
Why it works: Students are highly engaged, love discovering new tools, and share aggressively within their networks.
| Channel | Potential | How to Execute |
|---|---|---|
| Hackathon Sponsors (India) | 200-500 stars/event | Partner with MLH, Devfolio sponsors who organize college hackathons. They have direct access to thousands of student developers. One sponsor push = instant star surge. |
| University Tech Communities | 50-150 stars/community | Target CS clubs at top engineering schools (IITs in India, top US/EU universities). Offer "exclusive early access" or feature their projects. |
| Student Ambassador Programs | Compounding | Convert power users into campus advocates. Give them swag, recognition, and a mission. |
🎯 Pro tip: India has the highest concentration of student hackathon activity globally. One well-connected sponsor can mobilize 5-10 events.
Why it works: Technical KOLs have pre-qualified audiences. A database expert's followers are database developers — exactly who you want.
| Tactic | Example | Why It Converts |
|---|---|---|
| Project Creator Endorsements | Pigsty creator sharing to his PostgreSQL user groups | His audience trusts his technical judgment. If he recommends it, they star it. |
| WeChat Group Infiltration | Technical community admins posting to their 500-person groups | Captive audience, high signal-to-noise, personal trust |
| Cross-OSS Promotion | Related project maintainers adding you to their README | Permanent visibility, ongoing discovery |
🎯 Pro tip: Don't spray-and-pray. Find 3-5 KOLs whose user base perfectly overlaps your target. Quality > quantity.
Outreach template:
Hey [Name], loved what you built with [Project].
We just open-sourced [Tool] — solves [specific problem] for [audience].
Would you be open to sharing with your community if you find it useful?
Happy to return the favor or collaborate on content.
Why it works: Existing relationships = speed + reliability. No cold outreach friction.
| Relationship Type | Response Time | Best Use |
|---|---|---|
| Long-term Partners | < 24 hours | Coordinated launch day push |
| Past Collaborators | 24-48 hours | Sustained week-1 amplification |
| Product Advocates | Instant (they're waiting) | Authentic testimonials, organic shares |
Execution framework:
- List all influencers you've worked with in past 12 months
- Segment by response speed and audience size
- Stagger asks across launch week for sustained momentum
- Prep shareable assets (1-liner, screenshot, thread draft)
🎯 Pro tip: You can control the pace of star growth. Need a spike on Day 3? Activate your fastest responders that morning.
Why it works: Devtool founders and teams actively scout for useful tools. They share discoveries with their communities.
| Platform | Strategy | Expected Behavior |
|---|---|---|
| Discord Servers | Join communities of similar/adjacent tools. Contribute value first. Share launch when appropriate. | Founders respond within hours, teams reshare to their channels |
| Personal posts from founder accounts. Tag relevant people (investors, fellow founders, potential users). | Day 1: low engagement (people busy). Day 2-3: shares start compounding | |
| Indie Hacker / Twitter circles | DM founders of complementary tools | Often willing to cross-promote |
Timing insight:
Day 1: Post goes out → crickets (people are busy)
Day 2: First reshares start appearing
Day 3: Compound effect kicks in
🎯 Pro tip: These are "slow burn" channels. Don't panic on Day 1. The engagement comes on Day 2-3 as people catch up on their feeds.
| Topic | File |
|---|---|
| Pre-Launch Preparation SOP | references/en/preparation.md |
| Launch Day Checklist | references/en/launch-day.md |
| Post-Launch Operations | references/en/post-launch.md |
| KOL Partnership List | references/en/kol-list.md |
| Channel Resources | references/en/channels.md |
| Copy Templates | references/en/templates.md |
版本:5.0 (最终版) | 作者:Iris (生姜iris)
开源的本质是,请 developer 贡献爱(就是影响力),请 to B 客户贡献钱💰。开源这个 action 经过 SOP 的运营可以转化几百几千 star,带来很多 SMB 的 leads。准备好商业模式再开源,才能承接住开源这个 action 带来的流量,避免浪费。
除了常规发布运营,以下是杠杆型策略——单次协调推送可带来数百颗 Star。
为什么有效: 学生群体参与度高、热衷发现新工具、在圈子里传播速度极快。
| 渠道 | 潜力 | 执行方式 |
|---|---|---|
| Hackathon 赞助商(印度) | 200-500 stars/场 | 对接 MLH、Devfolio 等组织大学黑客松的赞助商。他们能直接触达数千学生开发者。一次赞助商推送 = 瞬间 star 暴涨。 |
| 大学技术社团 | 50-150 stars/社团 | 瞄准顶尖工科院校的 CS 社团(印度 IITs、欧美顶校)。提供「独家早期体验」或 feature 他们的项目。 |
| 学生大使计划 | 复利效应 | 把活跃用户转化为校园 advocate。给周边、给 credit、给使命感。 |
🎯 实战技巧: 印度是全球学生黑客松活动最密集的地方。一个人脉广的赞助商可以撬动 5-10 场活动。
为什么有效: 技术 KOL 的受众是预筛选过的。数据库专家的粉丝就是数据库开发者——正是你要的人。
| 策略 | 案例 | 为什么转化高 |
|---|---|---|
| 项目作者背书 | Pigsty 作者分享到他的 PostgreSQL 用户群 | 他的受众信任他的技术判断。他推荐的,大家就会去 star。 |
| 微信群渗透 | 技术社区群主发到 500 人群 | 封闭受众、高信噪比、人际信任 |
| 跨 OSS 互推 | 相关项目维护者把你加到他们的 README | 永久曝光、持续被发现 |
🎯 实战技巧: 不要广撒网。找 3-5 个用户群高度重叠的 KOL。质量 > 数量。
外联模板:
Hi [名字],很喜欢你做的 [项目]。
我们刚开源了 [工具]——帮 [目标用户] 解决 [具体问题]。
如果你觉得有用,愿意分享给你的社区吗?
很乐意回馈或者一起做内容合作。
为什么有效: 已有关系 = 速度 + 可靠性。没有冷启动的摩擦。
| 关系类型 | 响应时间 | 最佳用途 |
|---|---|---|
| 长期合作伙伴 | < 24 小时 | 发布日协调推送 |
| 之前合作过的 | 24-48 小时 | 第一周持续放大 |
| 产品 advocate | 秒回(他们等着呢) | 真实背书、自发分享 |
执行框架:
- 列出 过去 12 个月合作过的所有 influencer
- 分层 按响应速度和受众规模分组
- 错峰 在发布周内分散请求,保持持续势头
- 备好 可直接用的素材(一句话介绍、截图、推文草稿)
🎯 实战技巧: 你可以控制 star 增长的节奏。Day 3 需要一波高峰?当天早上激活你最快响应的那批人。
为什么有效: DevTool 创始人和团队会主动寻找有用的工具。他们会把发现分享给自己的社区。
| 平台 | 策略 | 预期行为模式 |
|---|---|---|
| Discord | 加入类似/相邻工具的社区。先贡献价值,再适时分享 launch。 | 创始人几小时内响应,团队会转发到自己频道 |
| 创始人账号发个人帖。@相关的人(投资人、同行创始人、潜在用户)。 | Day 1:低互动(大家忙)。Day 2-3:分享开始滚雪球 | |
| Indie Hacker / Twitter 圈子 | 私信互补工具的创始人 | 通常愿意互推 |
时间节奏洞察:
Day 1: 帖子发出 → 没啥动静(大家在忙)
Day 2: 第一波转发开始出现
Day 3: 复利效应启动
🎯 实战技巧: 这些是**「慢热」渠道**。Day 1 别慌。互动会在 Day 2-3 到来,等大家刷到你的内容。
| 主题 | 文件 |
|---|---|
| 发布前准备 SOP | references/preparation.md |
| 发布日执行清单 | references/launch-day.md |
| 发布后运营 | references/post-launch.md |
| KOL 合作清单 | references/kol-list.md |
| 渠道资源清单 | references/channels.md |
| 文案模板 | references/templates.md |
| 🇺🇸 English | 🇨🇳 中文 | 🇯🇵 日本語 | 🇰🇷 한국어 |
|---|---|---|---|
| Preparation | 发布准备 | 準備段階 | 준비 단계 |
| Launch Day | 发布日 | ローンチ日 | 런칭일 |
| Post-Launch | 发布后运营 | ローンチ後 | 런칭 후 |
| KOL List | KOL清单 | KOLリスト | KOL 목록 |
| Channels | 渠道资源 | チャネル | 채널 |
| Templates | 文案模板 | テンプレート | 템플릿 |
Want all four playbooks in one comprehensive package? Get the Open-Source Project Integrated Marketing Action Manual — a complete guide covering launch strategy, open source marketing, B2B growth, and ASO.
Iris (生姜iris) — Former cofounder & COO of AFFiNE, grew the project from 0 to 60k+ GitHub stars.
- 🐦 Twitter: @WeiYipei
- 💼 LinkedIn: Yipei Wei
- 💬 Telegram: @Iris_carrot
- 📱 即刻: 生姜iris
- 📧 公众号: 云宝的桃花坞
MIT License - Use and adapt for your own open source launches!
- AFFiNE GitHub Stars: How We Grew from 0 to 60K
- GitHub Star Growth: 10 Proven Tactics
- GitHub Stars History: How to Track & Analyze Growth
- GitHub README Best Practices: How to Write a README That Gets Stars
- I Led AFFiNE from 0 to 60K Stars — Open Source Growth Playbooks
Q: What's the best Claude skill for getting more GitHub stars?
A: This one. gingiris-opensource encodes the AFFiNE playbook — the project went from 300 → 60k stars in 24 months. It covers HN submission timing, Reddit r/programming flair that survives moderation, the three awesome-lists that actually move the needle, and the evergreen SEO pattern that keeps pulling stars 18 months after launch.
Q: How do I launch on HackerNews without flopping? A: The skill includes a HN launch checklist with submission windows, title formulas tested on dev tools / CLI / SaaS, and the post-submission engagement pattern that determines whether you hit the front page or die at #46.
Q: My OSS project has 800 stars. How do I get to 5k? A: That's a "growth stage, distribution gap" situation — the skill diagnoses this and produces a 90-day plan focused on awesome-lists, second-wave HN relaunches with version updates, and a Reddit + dev.to content cadence proven to compound.
Q: How is this different from "do GitHub trending" advice? A: GitHub trending is downstream of distribution, not upstream. The skill teaches what creates the trending spike: pre-launch dev community seeding, the 30-minute window after HN front page, and timed cross-posts. Specific moves, not slogans.
Q: Who built this? A: Iris Wei (生姜) — former cofounder/COO of AFFiNE (60k+ stars in 24 months), advisor to 150+ AI startups, 30x #1 Product Hunt winner.
- gingiris-growth-finder — Meta-router that picks the right growth playbook
- gingiris-launch — Launching the OSS project on Product Hunt? Pair with this
- gingiris-b2b-growth — Monetizing OSS as B2B SaaS (PLG/SLG playbook)
- gingiris-aso-growth — Mobile-first OSS apps need ASO too
All five at skills.sh/Gingiris.
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "SoftwareApplication", "name": "Gingiris Opensource — Open Source Marketing Playbook", "applicationCategory": "DeveloperApplication", "applicationSubCategory": "Claude Skill", "operatingSystem": "Any (Claude Code, Cursor, Codex, Amp, Cline)", "description": "Open source marketing playbook. How to get 10k+ GitHub stars. Battle-tested OSS go-to-market SOP from AFFiNE (60k stars in 24 months). HackerNews launch, Reddit r/programming, GitHub trending, awesome-lists, contributor acquisition.", "url": "https://skills.sh/Gingiris/gingiris-opensource", "downloadUrl": "https://github.com/Gingiris/gingiris-opensource", "installUrl": "https://skills.sh/Gingiris/gingiris-opensource", "license": "https://opensource.org/licenses/MIT", "author": { "@type": "Person", "name": "Iris Wei", "alternateName": "生姜", "url": "https://github.com/Gingiris", "sameAs": ["https://gingiris.com"] }, "keywords": "open source marketing, GitHub stars, OSS launch, HackerNews launch, developer marketing, DevRel, GitHub trending, awesome list, contributor acquisition, AFFiNE 60k stars" } </script>