Metadata-Version: 2.4
Name: minizen
Version: 0.1.0
Summary: A quieter way to stay informed
Author: Hieu Dao
Author-email: Hieu Dao <106801182+HieuDao-code@users.noreply.github.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: News/Diary
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Dist: miniflux>=1.1.6,<2.0.0
Requires-Dist: mistune>=3.2.0,<4.0.0
Requires-Dist: pydantic>=2.13.1,<3.0.0
Requires-Dist: pydantic-ai-slim[anthropic,openai]>=1.84.0,<2.0.0
Requires-Dist: python-dotenv>=1.1.0,<2.0.0
Requires-Dist: tomli-w>=1.0.0,<2.0.0
Requires-Dist: typer>=0.24.1,<0.25.0
Requires-Python: >=3.14
Project-URL: Homepage, https://github.com/hieudao-code/minizen
Project-URL: Documentation, https://hieudao-code.github.io/minizen/
Project-URL: Repository, https://github.com/hieudao-code/minizen
Project-URL: Issues, https://github.com/hieudao-code/minizen/issues
Project-URL: Changelog, https://github.com/hieudao-code/minizen/releases
Description-Content-Type: text/markdown

<h1 align="center">
  <p align="center">
    <span style="font-size: 80px; font-weight: bold;">mini</span>
    <span style="font-size: 80px; font-weight: bold; color: #F27D3E;">zen</span>
  </p>
</h1>
<p align="center">A quieter way to stay informed.</p>
<p align="center">
  <a href="https://hieudao-code.github.io/minizen/">Documentation</a> | <a href="https://hieudao-code.github.io/minizen/getting_started/">Getting Started</a> | <a href="https://hieudao-code.github.io/minizen/configuration/">Configuration</a>
</p>

## About

**minizen** fetches your unread RSS articles from [Miniflux](https://miniflux.app),
uses AI to curate and summarise the most interesting ones, and emails you a clean daily digest.

### Features

- **Curated, not firehosed** — the AI picks your top N articles and writes a cohesive
  narrative, not a bullet dump
- **Runs on a schedule** — ships with a GitHub Actions workflow for a hands-free daily digest,
  no server required
- **Dry-run friendly** — preview the digest in your terminal before a single email is sent
- **Pluggable AI** — works with Anthropic Claude or OpenAI models via
  [pydantic-ai](https://ai.pydantic.dev/)

## Quick start

```bash
uv tool install minizen
minizen setup            # interactive wizard — configure Miniflux, AI, and email
minizen digest preview   # preview today's digest in your terminal
minizen run              # fetch → summarise → send
```
