Rss2Newsletter/README.md

1.3 KiB

rss2newsletter

rss2newsletter is a simple tool that pulls articles from a user-provided RSS feed, summarizes the current day's content using an Ollama server, and outputs a clean HTML summary suitable for email delivery.

Features

  • 📰 Fetches all articles published today from a provided RSS feed

  • 🧠 Uses an Ollama server to generate article summaries

  • 📬 Outputs an HTML file with:

    • Article title
    • AI-generated summary
    • Original article URL

🚧 Work in Progress

This project is under active development. Features, formatting, and performance are expected to evolve. Contributions and feedback are welcome.


🔧 Requirements

  • Python 3.8+
  • uv (fast Python package manager)
  • A running Ollama server
  • Internet connection for fetching RSS content

📦 Installation

  1. Install uv if not already installed:

    curl -Ls https://astral.sh/uv/install.sh | sh
    
  2. Clone the repository and install dependencies:

    git clone https://github.com/your-username/rss2newsletter.git
    cd rss2newsletter
    uv venv
    source .venv/bin/activate
    uv pip install -e .
    

🛠 Usage

python rss2newsletter.py https://your-feed-url.com/rss