hn-launch-kit
Data-driven Show HN/Launch HN post optimization powered by 50k+ historical submissions and LLM analysis.
What is this?
hn-launch-kit analyzes your GitHub repository and generates optimized Hacker News launch posts before you submit. It uses patterns from 50k+ historical Show HN/Launch HN posts combined with LLM analysis to suggest compelling titles, identify narrative hooks, recommend optimal timing, and predict engagement scores—turning your launch into a data-informed decision instead of a guessing game.
Features
- Repository Analysis — Automatically extracts problem statement, key differentiators, and technical depth from your GitHub project
- Title Optimization — Generates 3+ title variants with predicted engagement scores based on historical HN patterns
- Post Templates — Auto-generates Show HN submission text with proven narrative structure
- Engagement Prediction — Scores your launch potential based on project maturity, GitHub metrics, and timing
- Launch Checklist — Provides a pre-submission validation checklist tailored to your project type
- A/B Testing Module — Compare title variants before posting with engagement projections
- Web Dashboard — Paste a GitHub URL and get a complete launch report with recommendations
Quick Start
Installation
pip install hn-launch-kit
CLI Usage
# Analyze a local repository
hn-launch-kit analyze ./my-project
# Output scored title variants and launch recommendations
hn-launch-kit suggest --url https://github.com/user/project
# Start the web dashboard
hn-launch-kit serve
Configuration
Create a .env file:
OPENAI_API_KEY=your_api_key_here
HN_DB_PATH=./hn_posts.db
See .env.example for all configuration options.
Usage Examples
CLI Analysis
$ hn-launch-kit analyze ./my-repo
📊 Repository Analysis
├─ Problem: Real-time data pipeline visualization
├─ Maturity: Production-ready
├─ GitHub Stars: 342
└─ Last commit: 2 days ago
🎯 Title Variants (ranked by predicted HN engagement)
1. "Show HN: Streams – Real-time data pipeline UI that scales to 100k+ events/sec" (Expected score: 287)
2. "Show HN: Streams – Visualize data pipelines in real-time without the complexity" (Expected score: 254)
3. "Show HN: We built a real-time pipeline dashboard after our startup's tool failed us" (Expected score: 216)
⏰ Timing Recommendation: Tuesday 10am ET (optimal for your project category)
Web Dashboard
$ hn-launch-kit serve
# Open http://localhost:8000
# Paste GitHub URL → Get full launch report with checklist
Tech Stack
- Backend: Python, FastAPI
- LLM Analysis: OpenAI/Claude API
- Database: SQLite (HN historical data)
- Frontend: HTML/Vanilla JS
- CLI: Click/Typer
- Testing: pytest
License
MIT
See MONETIZATION.md for pricing and distribution strategy.
Metadata
Release files for hn-launch-kit 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| hn_launch_kit-0.1.0.tar.gz | 14.4 kB | Without provenance | Details for hn_launch_kit-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hn_launch_kit-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for hn_launch_kit-0.1.0-py3-none-any.whl |
Total release size: 31.4 kB
Release files / hn_launch_kit-0.1.0.tar.gz
| Download URL | hn_launch_kit-0.1.0.tar.gz |
|---|---|
| Size | 14.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bea1a49798d55b20754f2e0ee5ee17cbf99c170e8b4ad7716682f60ab79bc9f0
|
|
BLAKE2b-256 checksum How to use checksums |
b5e021fcf0d6238839b8a8fb9151bc2c86e3b4763487c693d518ddb050a5a4d8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / hn_launch_kit-0.1.0-py3-none-any.whl
| Download URL | hn_launch_kit-0.1.0-py3-none-any.whl |
|---|---|
| Size | 17.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f7d86a332c163fc0a8e1bde751545219ae94fa63608ffe0ee9e845beae932216
|
|
BLAKE2b-256 checksum How to use checksums |
27c89202a8723b6a866896b76d00700ad8cefb5ada7f64764c1e3732e9770ff1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Security for hn-launch-kit 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.