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.4.tar.gz (71.2 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.4-py3-none-any.whl (54.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: noscroll-0.1.4.tar.gz
  • Upload date:
  • Size: 71.2 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.4.tar.gz
Algorithm Hash digest
SHA256 8f036cd9a3b8c3e5b67042f756432dae093c71b1af6b94fdd213c3817fafba63
MD5 1d59d2805955c77bd652922b9fd29bfb
BLAKE2b-256 5cdc8043615eaf99f290f34ee0ee8e55f0a1b0b2ff55097a422ca07f755eb513

See more details on using hashes here.

File details

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

File metadata

  • Download URL: noscroll-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 54.4 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 edff3023d146d9dd7a74d74184998394d255956524376576f8bf626780f91643
MD5 c4fc7139cfc11b355da37b6a6c56bb0d
BLAKE2b-256 c36ef5457519d8f7c20e7f74dca2584235de7d0f38409dc3becba0b9a2175bd2

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