hnterminal-sdk

Python SDK for HNTerminal — a high-information-density Hacker News reader.

This is the minimal early release (v0.0.1). It fetches public Hacker News data with zero dependencies (stdlib only). Computed signals (velocity, heat, controversy) from the HNTerminal intelligence layer land in later releases.

Looking for the terminal client? npx hnterminal.

Install

pip install hnterminal-sdk

Requires Python 3.9+.

Usage

import hnterminal_sdk as hn

for story in hn.stories("top", limit=10):
    print(story["score"], story["title"])

hn.stories("show")        # Show HN
hn.item(8863)             # one item by id
hn.user("pg")             # user profile

Sections: top (default), new, best, ask, show, job.

License

MIT