AutoPaper

AI-Powered Automated Newspaper Generation Tool 🤖📰

AutoPaper is a CLI tool that automatically generates curated weekly newspapers from article URLs. 中文用户可参阅 团队使用指南 快速上手。 It uses Claude AI to extract metadata, compose editorial content, and export to multiple formats.

✨ Features

🤖 AI-Powered Curation - Smart metadata extraction and issue composition using Claude
📰 Auto-Generated Newspapers - Weekly tech/news issues with editor's insights
🏷️ Smart Tagging - Automatic tag classification and normalization
📄 Multiple Export Formats - Markdown, PDF, Obsidian vault sync, and Email delivery
📧 Email Distribution - Send issues via email with AI card, PDF attachments, and HTML rendering
🎨 AI Card Generation - Beautiful AI-style infographic cards for social sharing
🔗 Article Links Section - Quick access to all original article URLs at the bottom
⚡ High Performance - 100x faster with AI caching and concurrent downloads
🛡️ Production Ready - Robust error handling, retry logic, and comprehensive logging

📦 Quick Start

Option 1: CLI Tool (Traditional Python Package)

Prerequisites

Python 3.10+
Anthropic API key

Installation

# Clone the repository
git clone https://github.com/OldCoderIsMe/AutoPaper.git
cd AutoPaper
# Create virtual environment
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate# Install in editable mode
pip install -e .# Configure environment
cp .env.example .env
# Edit .env and add your ANTHROPIC_API_KEY

Making `autopaper` Command Available

After installation, you have two options:

Option A: Add to PATH (Recommended for frequent use)

Add this to your ~/.zshrc (or ~/.bashrc):

# AutoPaper venvexport PATH="$PATH:/path/to/AutoPaper/venv/bin"

Then reload: source ~/.zshrc

Option B: Always use with venv activated

cd /path/to/AutoPaper
source venv/bin/activate
autopaper --help

🚀 Quick Usage

Complete Workflow Example

# 1. Add articles throughout the week
autopaper add https://blog.example.com/ai-tool-review
autopaper add https://news.example.com/tech-trend-2026
# 2. View all articles
autopaper list-articles
# 3. Delete an article by ID
autopaper delete 5
# 4. Generate weekly issue
autopaper generate tech
# 4. Export to PDF (includes AI card)
autopaper export-pdf 2026-W05-tech
# 5. Send to team via email
autopaper send-email 2026-W05-tech \
--to team@company.com \
--to manager@company.com \
--to subscribers@company.com
# 6. Optionally sync to Obsidian
autopaper sync obsidian 2026-W05-tech

What You Get

Each generated issue includes:

📄 PDF Document - Professional layout with AI card and article links
📧 Email HTML - Rich formatted email with embedded AI card and clickable links
📝 Markdown Source - Plain text for version control with article links
🎨 AI Card - Shareable infographic (2400x1350px)
🔗 Article Links - All original article URLs at the bottom for quick access
🔗 Obsidian Notes - Integrated into your knowledge base

Email Sending Examples

# Send to single recipient
autopaper send-email 2026-W05-tech --to user@example.com
# Send to multiple recipients
autopaper send-email 2026-W05-tech \
--to user1@example.com \
--to user2@example.com \
--to user3@example.com
# Custom email subject
autopaper send-email 2026-W05-tech \
--to user@example.com \
--subject "本周技术精选第5期"# Send without PDF attachment
autopaper send-email 2026-W05-tech \
--to user@example.com \
--no-pdf

Commands

Command	Description
`autopaper add <url>`	Add article from URL
`autopaper list-articles`	List all articles
`autopaper delete <id>`	Delete article by ID
`autopaper generate <type>`	Generate weekly issue (tech/news)
`autopaper export-pdf <slug>`	Export issue to PDF (also saves HTML)
`autopaper export-pdf <slug> --html`	Generate HTML only, skip PDF (debug)
`autopaper send-email <slug>`	Send issue via email
`autopaper generate-card <slug>`	Generate AI summary card
`autopaper sync obsidian <slug>`	Sync to Obsidian vault

See autopaper --help for all commands and options.

📚 Documentation

Quick Start Guide - Detailed setup and usage
Team Guide (团队使用指南) - 中文快速安装与使用
Email Feature Guide - Email sending configuration and usage
Design Document - Architecture and technical details
Contributing - Contribution guidelines

🏗️ Project Structure

AutoPaper/
├── autopaper/ # Main package
│ ├── ai/ # AI integration modules
│ │ ├── compose_issue.py # Issue composition
│ │ ├── extract_article_metadata.py # Metadata extraction
│ │ ├── generate_infocard.py # AI card generation
│ │ └── normalize_tags.py # Tag normalization
│ ├── commands/ # CLI commands
│ │ ├── add.py # Add articles
│ │ ├── generate.py # Generate issues
│ │ ├── export.py # PDF export
│ │ ├── email.py # Email sending
│ │ └── sync.py # Obsidian sync
│ ├── publishers/ # Export publishers
│ │ ├── pdf.py # PDF generation
│ │ ├── obsidian.py # Obsidian sync
│ │ └── email.py # Email publisher
│ ├── scrapers/ # Web scraping
│ ├── templates/ # Jinja2 templates
│ │ ├── issue.html.j2 # PDF template
│ │ └── email.html.j2 # Email template
│ └── utils/ # Utilities
├── tests/ # Test suite
├── docs/ # Documentation
│ ├── QUICKSTART.md
│ ├── EMAIL_FEATURE.md
│ └── AutoPaper-Design.md
├── claude-skills/ # Standalone Claude Code Skills
│ ├── shared/ # Shared config, cache, retry, JSON parser
│ ├── generate-card/ # AI info card generator
│ │ ├── SKILL.md
│ │ ├── main.py # Launcher
│ │ ├── scripts/
│ │ ├── references/
│ │ └── assets/
│ └── extract-metadata/ # Article metadata extractor
│ ├── SKILL.md
│ ├── main.py
│ ├── scripts/
│ ├── references/
│ └── assets/
├── TEAM_GUIDE.md # 团队使用指南（中文）
└── issues/ # Generated issues

🧩 Standalone Claude Code Skills

AutoPaper's core AI capabilities are also available as standalone Claude Code Skills that can be used independently. Each skill follows the official layout: SKILL.md, scripts/, references/, assets/.

Available Skills

📝 Article Metadata Extractor (extract-metadata/)
- Extract structured metadata from article URLs or content
- Auto-generate summaries, tags, and key points
- Classify articles (technical vs news)
🎨 AI Info Card Generator (generate-card/)
- Generate beautiful SVG infographic cards (1200x675)
- Modern AI tech style with Chinese font support
- Perfect for blog covers, social media, presentations

Quick Start

Run from the skill root (no PYTHONPATH needed):

cd claude-skills
# Extract article metadata
python extract-metadata/main.py https://blog.example.com/article
# Generate info card
python generate-card/main.py "本周技术精选" --content article.md

Each skill's main.py is a launcher that runs scripts/main.py. See generate-card/SKILL.md and extract-metadata/SKILL.md for full usage and options.

🔧 Configuration

AutoPaper supports two modes with identical configuration features:

CLI Mode: Use autopaper command directly
Skill Mode: Use via Claude Code (/autopaper-* commands)

Both modes support full configuration through config.yaml and .env files.

Configuration Discovery

CLI Mode: Loads configuration from the current working directory.

Skill Mode: Automatically discovers project configuration by:

Searching upward for config.yaml from the current directory
Using AUTOPAPER_CONFIG_PATH environment variable (if set)
Falling back to sensible defaults

This means skills work from any directory while respecting your project configuration.

Environment Variables

Create a .env file in the project root:

# ============================================# API Configuration# ============================================# API Key - supports both ANTHROPIC_API_KEY and ANTHROPIC_AUTH_TOKEN
ANTHROPIC_API_KEY=your_api_key_here
# API Base URL (optional - for custom endpoints or proxy)# Default: https://api.anthropic.com# Example for 智谱AI (GLM-4):
ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
# Model Configuration (optional)# ANTHROPIC_MODEL - default model for all requests# ANTHROPIC_DEFAULT_SONNET_MODEL - for Sonnet-specific requests# ANTHROPIC_DEFAULT_OPUS_MODEL - for Opus-specific requests# ANTHROPIC_DEFAULT_HAIKU_MODEL - for Haiku-specific requests## Example for GLM-4 (智谱AI):
ANTHROPIC_MODEL=glm-4.7
ANTHROPIC_DEFAULT_SONNET_MODEL=glm-4.7
## Example for Claude (Anthropic):# ANTHROPIC_MODEL=claude-sonnet-4-5-20250929# ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5-20250929# ============================================# Email Configuration (SMTP)# ============================================# SMTP Server Configuration
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
EMAIL_USERNAME=your_email@gmail.com
EMAIL_PASSWORD=your_app_password
EMAIL_FROM=AutoPaper <your_email@gmail.com># Common SMTP Servers:# - Gmail: smtp.gmail.com:587# - Outlook: smtp-mail.outlook.com:587# - QQ Mail: smtp.qq.com:587# - 163 Mail: smtp.163.com:465# Note: For Gmail, use App Password instead of regular password# Get it from: Google Account > Security > 2-Step Verification > App passwords

config.yaml

Edit config.yaml to customize:

# Databasedatabase_path: data/db.sqlite# Obsidian syncobsidian:
vault_path: ~/Documents/ObsidianVaultauto_paper_folder: AutoPaper# Tag normalizationtag_normalization:
llm: [llm, large language model, gpt]kubernetes: [k8s]

🤖 AI Features

AutoPaper uses Claude AI for:

Metadata Extraction - Title, author, summary, key points
Tag Classification - Automatic categorization
Issue Composition - Editor's notes, trend analysis
Content Understanding - Intelligent article curation
AI Card Generation - Beautiful infographic cards with key highlights

AI Card

AutoPaper automatically generates AI-style infographic cards for each issue:

1200x675 landscape format (16:9)
Modern dark theme with gradient accents
Smart summary of 4 key points
Professional design for sharing on social media
Embedded in both PDF and email

Example cards

# Generate standalone card
autopaper generate-card 2026-W05-tech
# Card is automatically included in:# - PDF export# - Email HTML body (as base64 image)

📊 Performance

100x faster - AI caching for duplicate articles
10x faster - Concurrent image downloads
Automatic retry - Network resilience
Smart logging - Performance monitoring

🛠️ Development

Setup

# Install dev dependencies
pip install -e ".[dev]"# Run tests
pytest
# Code formatting
black autopaper/
isort autopaper/

Testing

# Run all tests
pytest tests/
# With coverage
pytest --cov=autopaper tests/

📝 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Built with:

Claude - AI capabilities
Typer - CLI framework
Rich - Terminal formatting
LibreOffice - PDF generation (replaces WeasyPrint for better CJK support)
Jinja2 - Template engine
aiosmtplib - Async SMTP client

📧 Email Delivery

AutoPaper supports sending generated issues via email with:

Rich HTML emails - Rendered markdown with AI card embedded
PDF attachments - High-quality PDF with AI card
Markdown attachments - Source files for archiving
Article links section - Quick access to all original article URLs
Multiple recipients - Send to unlimited recipients at once
Major providers - Gmail, Outlook, QQ Mail, 163 Mail, and more

Quick Start

# 1. Configure SMTP in .env
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
EMAIL_USERNAME=your@gmail.com
EMAIL_PASSWORD=your_app_password
EMAIL_FROM=AutoPaper <your@gmail.com># 2. Send email
autopaper send-email 2026-W05-tech --to recipient@example.com

📖 See docs/EMAIL_FEATURE.md for detailed email setup guide.

Ready to automate your newsletter workflow? 🚀

Documentation: docs/
Email Guide: docs/EMAIL_FEATURE.md
Contributing: CONTRIBUTING.md
Issues: GitHub Issues

Name		Name	Last commit message	Last commit date
Latest commit History 28 Commits
autopaper		autopaper
claude-skills		claude-skills
tests		tests
.env.example		.env.example
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
README.zh-CN.md		README.zh-CN.md
TEAM_GUIDE.md		TEAM_GUIDE.md
config.yaml		config.yaml
pyproject.toml		pyproject.toml
requirements-dev.txt		requirements-dev.txt
requirements.txt		requirements.txt

Folders and files

Latest commit

History

Repository files navigation

AutoPaper

✨ Features

📦 Quick Start

Option 1: CLI Tool (Traditional Python Package)

Prerequisites

Installation

Making autopaper Command Available

Option A: Add to PATH (Recommended for frequent use)

Option B: Always use with venv activated

🚀 Quick Usage

Complete Workflow Example

What You Get

Email Sending Examples

Commands

📚 Documentation

🏗️ Project Structure

🧩 Standalone Claude Code Skills

Available Skills

Quick Start

🔧 Configuration

Configuration Discovery

Environment Variables

config.yaml

🤖 AI Features

AI Card

Example cards

📊 Performance

🛠️ Development

Setup

Testing

📝 License

🙏 Acknowledgments

📧 Email Delivery

Quick Start

About

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Making `autopaper` Command Available