minigist
AI-powered summaries for your Miniflux feeds.
Turn your long Miniflux articles into clear, concise summaries.
🤘 Features
- Automatic summarization of unread Miniflux entries
- Configurable filters to target specific feeds
- Notification support via Apprise for various messaging services
- Dry-run mode to preview changes without modifying entries
- Structured logging for better debugging and monitoring
🚀 Installation
Install minigist using pip:
pip install minigist
Install minigist using uv:
uv tool install minigist
📄 Usage
Configuration
Create a configuration file at ~/.config/minigist/config.yaml:
miniflux:
url: "https://your-miniflux-instance.com"
api_key: "your-miniflux-api-key"
llm:
api_key: "your-ai-service-api-key"
base_url: "https://openrouter.ai/api/v1" # Default
model: "google/gemini-2.0-flash-lite-001" # Default
prompts:
- id: "default"
system_prompt: "Generate an executive summary of the provided article."
- id: "deep-dive"
system_prompt: "Extract the nuanced arguments and counterpoints."
# Optional: when no targets are defined, this prompt is used for all unread entries
# If omitted, the first prompt in the list is used.
default_prompt_id: "default"
targets:
# When targets are defined, only these feeds/categories are processed; overlaps across targets are errors.
- prompt_id: "default"
feed_ids: [1, 2]
- prompt_id: "deep-dive"
category_ids: [5]
use_pure: true # Prefer pure.md for this target
scraping:
pure_api_token: "optional-pure-md-token"
# Always route matching URLs through pure.md.
pure_base_urls:
- "https://text.npr.org/"
fetch:
limit: 50 # Default
notifications:
urls: # Apprise notification URLs (optional)
- "discord://webhook_id/webhook_token"
- "telegram://bot_token/chat_id"
See Apprise documentation for all supported notification services.
Basic Commands
Run minigist to process unread entries:
minigist run
Run in dry-run mode to see what would happen without making changes:
minigist run --dry-run
Increase logging verbosity:
minigist run --log-level DEBUG
Use a different configuration file:
minigist run --config-file /path/to/config.yaml
Metadata
Release files for minigist 0.6.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| minigist-0.6.1.tar.gz | 25.4 kB | Without provenance | Details for minigist-0.6.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| minigist-0.6.1-py3-none-any.whl | Python 3 | none | any | Details for minigist-0.6.1-py3-none-any.whl |
Total release size: 47.2 kB
Release files / minigist-0.6.1.tar.gz
| Download URL | minigist-0.6.1.tar.gz |
|---|---|
| Size | 25.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
84a891d19d382201eb402050693ef724183cf478b1cd5526871ba53c49268293
|
|
BLAKE2b-256 checksum How to use checksums |
b06d12a0143930b7adeecb3f84835320f9e60716d53cd5fdbb32749e1283a726
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / minigist-0.6.1-py3-none-any.whl
| Download URL | minigist-0.6.1-py3-none-any.whl |
|---|---|
| Size | 21.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5c416a20cfeb1abdc4e51751ca6c4e72ba847f4a7c4859217c2f84a7d6975db4
|
|
BLAKE2b-256 checksum How to use checksums |
2474a4f520c3e34024a8c23a9bdc068036e64d3361fd6e21f2f0fee39c71794c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for minigist 0.6.1
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.