📡 AI Dispatch

Your daily AI intelligence briefing, delivered to your inbox.

Automatically aggregates the latest in AI, Robotics, and Agents every morning — analyzed by an LLM of your choice, delivered to your inbox. Runs entirely on GitHub Actions. No server. No subscription.

What You Get

Every email contains five structured sections:

View a sample email →

Quick Start

No terminal required — everything runs in your browser.

Prerequisites

• GitHub account (free)
• Gmail account

Step 1 — Fork this repo

Click Fork in the top right → create it under your own account.

Step 2 — Run the Setup workflow

Go to Actions → ⚙️ Setup → Run workflow and fill in the form:

The workflow updates config.yml and prints a checklist of the secrets you need to add next.

Step 3 — Add secrets

Go to Settings → Secrets and variables → Actions → New repository secret

Add these 4 secrets (the Setup workflow tells you exactly what to put in each):

Gmail App Password

Gmail requires an app-specific password, not your account password.

1. Go to myaccount.google.com/security
2. Confirm 2-Step Verification is enabled
3. Search App Passwords → open it
4. Select Mail + Mac → click Generate
5. Copy the 16-character password (shown only once, no spaces)

Step 4 — Verify

Go to Actions → ✅ Check Setup → Run workflow

── GitHub Secrets ──────────────────────────────────
  ✅  GEMINI_API_KEY     (set)
  ✅  GMAIL_USER         (set)
  ✅  GMAIL_APP_PASSWORD (set)
  ✅  RECIPIENT_EMAIL    (set)

── config.yml ──────────────────────────────────────
  ✅  config.yml found
  ✅  topics configured  (3 topics)
  ✅  news_feeds configured  (9 sources)
  ✅  blog_feeds configured  (8 blogs)

── LLM API ──────────────────────────────────────────
  ✅  API connection successful

── Gmail SMTP ───────────────────────────────────────
  ✅  Gmail login successful ([email protected])

── Test email ───────────────────────────────────────
  ✅  Test email sent (check your inbox)

══════════════════════════════════════════════════════
  🎉  All checks passed! Your daily digest starts tomorrow.
══════════════════════════════════════════════════════

Once all green, AI Dispatch runs automatically every day. The default send time targets 07:00 BST / 07:00 GMT — change it via send_hour_utc in config.yml.

Prefer the command line?

# macOS — comes pre-installed; if missing:
xcode-select --install

# Windows
winget install Git.Git

# Linux (Debian / Ubuntu)
sudo apt install git

# macOS
brew install gh

# Windows — open a new terminal after this completes
winget install GitHub.cli

# Linux (Debian / Ubuntu)
sudo apt install gh

gh auth login

# macOS / Linux
gh repo fork Yifannnnnnnnw/ai-dispatch --clone
cd ai-dispatch        # use the folder name printed by gh above
python3 setup.py

# Windows
gh repo fork Yifannnnnnnnw/ai-dispatch --clone
cd ai-dispatch        # use the folder name printed by gh above
python setup.py

Cost

GitHub Actions is always free. The only potential cost is the LLM API call, depending on which provider you use.

Default (Gemini — free):

Optional (Anthropic — paid):

To switch providers, update provider and digest.model in config.yml.

File Structure

ai-dispatch/
├── config.yml              ← Your personalization (the only file to edit)
├── setup.py                ← Interactive setup wizard
├── fetch_news.py           ← Main pipeline
├── check_setup.py          ← Setup verification script
├── requirements.txt
├── sent_history.json       ← Auto-maintained dedup log (do not edit manually)
└── .github/workflows/
    ├── daily_news.yml      ← Daily cron job
    ├── setup.yml           ← First-time setup wizard (browser-based)
    └── check_setup.yml     ← One-click setup check

FAQ

Q: Test email arrived but no daily digest? Check Actions → AI Dispatch for errors. GitHub Actions cron can occasionally delay 15–30 minutes.

Q: Gmail login fails (SMTPAuthenticationError)? Make sure you're using the 16-character app password, not your Gmail account password.

Q: How do I change the output language? Edit output_language in config.yml. Default is English — change it to 中文 for Chinese output. The setup wizard also lets you choose during initial setup.

Q: How do I add my own RSS sources? Add a line under news_feeds or blog_feeds in config.yml: Source Name: https://rss-url.

Q: Blog picks keep repeating? sent_history.json tracks all previously sent URLs. To reset, clear the urls array in that file.

📡 AI Dispatch（中文）

每天早上，AI 驱动的深度简报，自动聚合分析，发到你的邮箱。

全程运行在 GitHub Actions 上，不需要服务器，不需要订阅费，Fork 即用。

效果预览

每封邮件包含五个固定板块：

查看示例邮件 →

快速开始

前置条件

• GitHub 账号（免费）
• Gmail 账号

全程在浏览器完成，无需安装任何软件。

第一步：Fork 仓库

点击右上角 Fork → 创建到你自己的账号下。

第二步：运行 Setup workflow

进入仓库 → Actions → ⚙️ Setup → Run workflow，填写表单：

workflow 运行完成后会自动更新 config.yml，并在日志中打印需要添加的 Secrets 清单。

第三步：添加 Secrets

进入仓库 → Settings → Secrets and variables → Actions → New repository secret

按 Setup workflow 日志中的提示，添加以下 4 个 Secrets：

Gmail 应用密码

Gmail 不允许直接用账号密码，需要生成专用的「应用密码」。

1. 打开 myaccount.google.com/security
2. 确认两步验证已开启（未开启则先开启）
3. 搜索框输入 App Passwords → 进入
4. 选择「邮件」+「Mac」→ 点击生成
5. 复制显示的 16 位密码（只显示一次，去掉空格填入）

第四步：验证配置

进入仓库 → Actions → ✅ Check Setup → Run workflow

── GitHub Secrets ──────────────────────────────────
  ✅  GEMINI_API_KEY     (已设置)
  ✅  GMAIL_USER         (已设置)
  ✅  GMAIL_APP_PASSWORD (已设置)
  ✅  RECIPIENT_EMAIL    (已设置)

── config.yml ──────────────────────────────────────
  ✅  config.yml 存在
  ✅  topics 已配置      (3 个主题)
  ✅  news_feeds 已配置  (9 个来源)
  ✅  blog_feeds 已配置  (8 个博客)

── LLM API ──────────────────────────────────────────
  ✅  API 连接成功

── Gmail SMTP ───────────────────────────────────────
  ✅  Gmail 登录成功 ([email protected])

── 测试邮件 ─────────────────────────────────────────
  ✅  测试邮件已发送 (请检查收件箱)

══════════════════════════════════════════════════════
  🎉  所有检查通过！查收测试邮件后即可等待每日简报。
══════════════════════════════════════════════════════

全部绿色后每天自动运行，默认目标到达时间为 BST 07:00 / GMT 07:00。

偏好命令行？

# macOS — 一般已预装；如果没有：
xcode-select --install

# Windows
winget install Git.Git

# Linux（Debian / Ubuntu）
sudo apt install git

# macOS
brew install gh

# Windows — 安装完成后需要重新打开终端
winget install GitHub.cli

# Linux（Debian / Ubuntu）
sudo apt install gh

gh auth login

# macOS / Linux
gh repo fork Yifannnnnnnnw/ai-dispatch --clone
cd ai-dispatch        # 用 gh 输出的文件夹名，通常就是 ai-dispatch
python3 setup.py

# Windows
gh repo fork Yifannnnnnnnw/ai-dispatch --clone
cd ai-dispatch        # 用 gh 输出的文件夹名，通常就是 ai-dispatch
python setup.py

费用参考

GitHub Actions 完全免费。唯一的可能成本是 LLM API 调用（取决于你选择的 provider）。

Gemini（默认，免费）：

Anthropic（付费，可选）：

切换 provider 只需改 config.yml 中的 provider 和 digest.model 字段。

文件说明

ai-dispatch/
├── config.yml              ← 你的个性化配置（唯一需要编辑的文件）
├── setup.py                ← 交互式配置向导
├── fetch_news.py           ← 主程序
├── check_setup.py          ← 配置验证脚本
├── requirements.txt
├── sent_history.json       ← 已推送博客记录（自动维护，请勿手动编辑）
└── .github/workflows/
    ├── daily_news.yml      ← 每日定时任务
    └── check_setup.yml     ← 一键验证配置

常见问题

Q: 测试邮件收到了但每日邮件没来？ 检查 Actions → AI Dispatch 里有没有报错。GitHub Actions 的 cron 有时会延迟 15–30 分钟。

Q: Gmail 登录失败 (SMTPAuthenticationError)？ 确认用的是「应用专用密码」（16位）而不是 Gmail 账号密码本身。

Q: 如何切换输出语言？ 修改 config.yml 中的 output_language 字段。默认为 English，改为 中文 即输出中文。配置向导中也可以在初始设置时选择。

Q: 如何添加自己的 RSS 源？ 在 config.yml 的 news_feeds 或 blog_feeds 下新增一行：名称: RSS链接。

Q: 推荐博客一直重复？ sent_history.json 记录已推送内容，如需重置，清空该文件的 urls 数组即可。