# Quick Start Guide

Get your News Agent running in 5 minutes!

## 1. Initial Setup

```bash
# Navigate to project directory
cd ~/news-agent

# Run setup script
./setup.sh

# This creates config.yaml and .env from templates
```

## 2. Configure Credentials

**Edit `.env` file** (no quotes needed):
```bash
nano .env
```

```env
OPENROUTER_API_KEY=sk-or-v1-your-actual-key-here
SMTP_USERNAME=your-email@yourdomain.com
SMTP_PASSWORD=your-smtp-password
```

Get OpenRouter API key: https://openrouter.ai/keys

## 3. Configure Email Settings

```bash
nano config.yaml
```

**Update these sections:**
```yaml
email:
  to: "your-email@example.com"
  from: "news-agent@yourdomain.com"
  smtp:
    host: "mail.yourdomain.com"
    port: 587
    use_tls: true
```

## 4. Install Dependencies

```bash
python3.11 -m venv .venv
source .venv/bin/activate
pip install feedparser httpx openai pydantic pydantic-settings jinja2 premailer python-dotenv pyyaml aiosqlite
```

## 5. Test Run

```bash
python -m src.main
```

**Expected output:**
```
INFO - News Agent starting...
INFO - Fetching from 14 RSS sources...
INFO - Fetched 152 articles from all sources
INFO - Processing XX new articles with AI...
INFO - Filtering articles by relevance...
INFO - Selected 10 relevant articles
INFO - Generating AI summaries...
INFO - Sending email...
INFO - Email sent successfully to your-email@example.com
INFO - Daily digest sent successfully with 10 articles!
```

**Check your email inbox!**

## 6. Set Up Daily Schedule

```bash
# Copy systemd files
mkdir -p ~/.config/systemd/user
cp systemd/news-agent.service ~/.config/systemd/user/
cp systemd/news-agent.timer ~/.config/systemd/user/

# Enable timer
systemctl --user daemon-reload
systemctl --user enable news-agent.timer
systemctl --user start news-agent.timer

# Enable lingering (run when not logged in)
sudo loginctl enable-linger $USER

# Check status
systemctl --user list-timers
```

Done! You'll receive daily digests at 07:00 Europe/Oslo time.

## Common Adjustments

### Get More Articles

Edit `config.yaml`:
```yaml
ai:
  filtering:
    min_score: 5.0  # Lower = more articles (default: 5.5)
```

### Change AI Model

Free (with rate limits):
```yaml
ai:
  model: "google/gemini-2.0-flash-exp:free"
```

Recommended (paid, ~$0.05/day):
```yaml
ai:
  model: "openai/gpt-4o-mini"
```

Best quality (~$0.10/day):
```yaml
ai:
  model: "anthropic/claude-3.5-haiku"
```

### Change Schedule Time

Edit `~/.config/systemd/user/news-agent.timer`:
```ini
[Timer]
OnCalendar=08:30  # Change to your preferred time
```

Then reload:
```bash
systemctl --user daemon-reload
systemctl --user restart news-agent.timer
```

## Troubleshooting

### Only 1-2 Articles in Email

Lower the filtering threshold in `config.yaml`:
```yaml
ai:
  filtering:
    min_score: 5.0  # Was 5.5 or 6.5
```

### Hit Rate Limit

Switch to paid model (see "Change AI Model" above)

### No Email Received

1. Check logs: `tail -f data/logs/news-agent.log`
2. Test email: `python -m src.test_email_simple`
3. See `SMTP_CONFIG.md` for detailed troubleshooting

### Model Not Found Error

Update model name in `config.yaml` - see `MODELS.md` for current names

## Next Steps

- Read `TROUBLESHOOTING.md` for solutions to common issues
- Read `MODELS.md` to choose the best AI model for your needs
- Read `SMTP_CONFIG.md` for email server configuration help
- Customize RSS feeds in `config.yaml`
- Adjust your interests in `config.yaml` for better filtering

## Cost Estimate

- **Free models**: $0/month (with rate limits)
- **GPT-4o-mini**: ~$1.50-3.00/month
- **Claude Haiku**: ~$3.00-7.50/month

Monitor costs: https://openrouter.ai/activity

Enjoy your daily tech news digests!