Miniflux Summary Agent
A command-line RSS article summarization tool that fetches articles from your Miniflux RSS reader and generates concise AI-powered summaries organized by category.
Installation
Using pipx (recommended)
pipx install miniflux-summary-agent
Using uvx
uvx miniflux-summary-agent
Using pip
pip install miniflux-summary-agent
Quick Start
- Prerequisites: Ensure you have Miniflux running and Ollama installed locally
- Setup: Configure environment variables (see Configuration section)
- Run:
miniflux-summary(if installed globally)python -m miniflux-summary-agent(alternative)
Development Setup
For development setup and contribution guidelines, see the Development Guide
How It Works
The agent follows a simple workflow:
- Fetch: Retrieves articles from your Miniflux RSS reader using the API
- Enhance: Detects brief summaries and fetches full article content when possible, or if needed
- Summarize: Processes each article through Ollama to generate 2-4 sentence summaries
- Organize: Groups summaries by category and generates an HTML report
Configuration
Configure via environment variables:
MINIFLUX_URL: Your Miniflux instance URLMINIFLUX_API_KEY: API key from Miniflux settingsARTICLE_HOURS_BACK: Hours of articles to fetch (default: 6)LOG_LEVEL: Logging level (default: INFO)
Requirements
- Python ≥3.10
- Miniflux RSS reader instance
- Ollama with llama3.1:8b model
License
This project is open source. Please check the repository for license details.
1 maintainer
Metadata
1 maintainer
Release files for miniflux-summary-agent 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| miniflux_summary_agent-0.1.0.tar.gz | 72.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| miniflux_summary_agent-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 88.5 kB
Release files / miniflux_summary_agent-0.1.0.tar.gz
| Download URL | miniflux_summary_agent-0.1.0.tar.gz |
|---|---|
| Size | 72.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
776d7a721156457205121333064bf94306b10269a6808356b07352082c6c1f21
|
|
BLAKE2b-256 checksum How to use checksums |
c3b5202485e65db3316e8eeec1a55ddb4babd9e5c6dd031980776f66acd5eb2c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 22, 2025.
Transparency logRelease files / miniflux_summary_agent-0.1.0-py3-none-any.whl
| Download URL | miniflux_summary_agent-0.1.0-py3-none-any.whl |
|---|---|
| Size | 16.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
631467dcceb8cf763be11dc44ad98af9434ad1b53d437b1025f7393c60b7d613
|
|
BLAKE2b-256 checksum How to use checksums |
2f52dbbd68d16f62f86ecfab9a8ece51e28229c2cd9165d03f8eb57b4a03418f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 22, 2025.
Transparency log
