Rss2Newsletter/README.md

58 lines
1.3 KiB
Markdown

# rss2newsletter
**rss2newsletter** is a simple tool that pulls articles from a user-provided RSS feed, summarizes the current day's content using an [Ollama](https://ollama.com) 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`](https://github.com/astral-sh/uv) (fast Python package manager)
* A running [Ollama](https://ollama.com) server
* Internet connection for fetching RSS content
---
### 📦 Installation
1. **Install `uv` if not already installed:**
```bash
curl -Ls https://astral.sh/uv/install.sh | sh
```
2. **Clone the repository and install dependencies:**
```bash
git clone https://github.com/your-username/rss2newsletter.git
cd rss2newsletter
uv venv
source .venv/bin/activate
uv pip install -e .
```
---
### 🛠 Usage
```bash
python rss2newsletter.py https://your-feed-url.com/rss
```
---