explaingit

joeseesun/qiaomu-hn-reader

Analysis updated 2026-05-18

19TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A Chinese-language Hacker News reader that pre-translates and summarizes stories and comments hourly, with an offline-capable PWA.

Mindmap

mindmap
  root((Qiaomu HN Reader))
    What it does
      Pre-translates HN stories
      Summarizes discussions
      Filters sensitive posts
    Tech stack
      TypeScript
      Node.js
      DeepSeek API
    Use cases
      Read HN in Chinese
      Get discussion summaries
      Self-host the reader
    Audience
      Chinese developers
      Product builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Read Hacker News in pre-translated Chinese without waiting for live translation.

USE CASE 2

Get a quick Chinese summary of a popular Hacker News comment thread.

USE CASE 3

Self-host a Chinese-first HN reader with your own DeepSeek API key.

USE CASE 4

Track rising stories and new product launches in a dedicated radar view.

What is it built with?

TypeScriptNode.jsExpressDeepSeek API

How does it compare?

joeseesun/qiaomu-hn-reader7y-9/agentsmd-checkavacocloud/avaco-deno
Stars191919
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Runs without a DeepSeek API key, but translations and discussion summaries then fall back to cached or English content.

Free to use, modify, and share, including commercially, as long as the license and copyright notice are kept.

In plain English

Qiaomu HN Reader is a Chinese language Hacker News reader built for developers and product people who prefer reading in Chinese. Rather than translating stories on the spot when a visitor loads the page, it runs a background job every hour that pulls the latest stories from HNRSS, filters them, translates titles and summaries with the DeepSeek API, and saves the result to a local snapshot file. When someone opens the site they see an already prepared Chinese version instantly, and clicking into comments loads from a local cache rather than waiting on a live translation. Beyond the plain front page, it groups stories into sections like a rising list ranked by points, comment count, and how recently they were posted, and a product radar that pulls together Show HN and Launch HN style posts. For popular threads it prefetches and translates the top comments, generates a short Chinese summary of the discussion, and picks out a handful of the most substantive comments using simple rules such as favoring ones with concrete opinions, trade offs, or counterexamples rather than jokes or plain agreement. Favorites and read status are stored only in the visitor's browser, so no account or login is needed. The reader also applies a conservative content filter that hides posts about politics, military topics, and other sensitive social issues, and filters out plain recruiting ads while still keeping real product launches. It ships as a Node.js and Express service with a small PWA frontend that can be installed like an app and works offline using a cached snapshot. To run it yourself, you clone the repository, install dependencies with npm, copy the example environment file, build, and start the server. A DeepSeek API key is optional: without one the service still runs, but translations and discussion summaries fall back to cached or English content. The project exposes a small JSON API for its own data and is released under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through running qiaomu-hn-reader locally with npm and a DeepSeek API key.
Prompt 2
Explain how qiaomu-hn-reader picks its best comments without official HN comment scores.
Prompt 3
Show me how qiaomu-hn-reader falls back to the official Hacker News API when HNRSS fails.
Prompt 4
Help me set up qiaomu-hn-reader's environment variables for a production deployment behind Nginx.

Frequently asked questions

What is qiaomu-hn-reader?

A Chinese-language Hacker News reader that pre-translates and summarizes stories and comments hourly, with an offline-capable PWA.

What language is qiaomu-hn-reader written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Express.

What license does qiaomu-hn-reader use?

Free to use, modify, and share, including commercially, as long as the license and copyright notice are kept.

How hard is qiaomu-hn-reader to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is qiaomu-hn-reader for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.