Skip to main content

Pull, don't scroll. RSS aggregator with LLM-powered summarization.

Project description

NoScroll - Pull, don't scroll

Python License CLI Sources

What is NoScroll

NoScroll is a Python CLI that pulls information from RSS feeds, web pages, and Hacker News, then uses an LLM to summarize and rank the most useful items.

It is designed for a pull-based reading workflow: define sources once, run on schedule, read only the high-signal digest.

Installation

pipx install noscroll

Skills Installation

Install the built-in noscroll skill to your target host:

# Claude Code (project scope)
noscroll skills install noscroll --host claude --scope project

# Codex (project scope)
noscroll skills install noscroll --host codex --scope project

# Claude Code (user scope)
noscroll skills install noscroll --host claude --scope user

# Codex (user scope)
noscroll skills install noscroll --host codex --scope user

# OpenClaw (workspace scope)
noscroll skills install noscroll --host openclaw --scope workspace --workdir /path/to/workspace

# OpenClaw (shared scope)
noscroll skills install noscroll --host openclaw --scope shared

Ask Command

Use natural language directly:

noscroll --env-file .env ask "Collect content from the past five days, one file per day"

This will generate daily digest files in outputs/.

Example generated text:

## AI (3)
1) Off Grid: Running text/image/vision models offline on mobile | Value: 4/5 | Type: Practice
- Conclusion: This open-source project demonstrates on-device multimodal inference on smartphones, with strong privacy and offline usability.
- Why it matters: On-device AI can reduce privacy risk and cloud inference cost, and is a good fit for offline-first products.
- Evidence links: https://github.com/alichherawalla/off-grid-mobile

## Other News (2)
4) uBlock rule: hide YouTube Shorts with one click | Value: 4/5 | Domain: Tech

## Life & Health (2)
6) AI avatars for rural healthcare support | Value: 3/5 | Domain: Health

Configuration

You can provide a config file in these places:

  1. CLI argument: --config /path/to/config.toml
  2. Environment variable: NOSCROLL_CONFIG=/path/to/config.toml
  3. Default path: ~/.noscroll/config.toml

Example config.toml:

[llm]
api_url = "https://api.openai.com/v1"
api_key = "your-api-key"
model = "gpt-4o-mini"

[paths]
subscriptions = "subscriptions/subscriptions.toml"
output_dir = "outputs"

[runtime]
debug = false

Create a starter config:

noscroll init

License

MIT. See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

noscroll-0.1.5.tar.gz (74.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

noscroll-0.1.5-py3-none-any.whl (57.2 kB view details)

Uploaded Python 3

File details

Details for the file noscroll-0.1.5.tar.gz.

File metadata

  • Download URL: noscroll-0.1.5.tar.gz
  • Upload date:
  • Size: 74.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.4

File hashes

Hashes for noscroll-0.1.5.tar.gz
Algorithm Hash digest
SHA256 61841aae22244230887a5f64b388e620c02a7f080f2060158d43499c6a60b1c6
MD5 f535907f02ed6814824999a64d998b02
BLAKE2b-256 b3165dfcd5e3fc7c2bd0cc5f704d7f299077ddea0e09bf3001c97b1a9dc3f5ab

See more details on using hashes here.

File details

Details for the file noscroll-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: noscroll-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 57.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.4

File hashes

Hashes for noscroll-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 eb7ec9ade9753340b028ed98e58921040fda4536c4c9e132531cd250ba524341
MD5 bae4b960a51719330c5d927f51b73a03
BLAKE2b-256 a1bc4ce2708dc2b045df886e032d7bd3fc238fd5b79c1e6a34ed589f2b3f1c4e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page