🟠 Technik-Track · Python & GitHub Grundkenntnisse hilfreich
💡
Phase 1 · Impuls

Manuell vs. automatisch – der Unterschied

Bisher sieht dein wöchentlicher Workflow so aus: Terminal öffnen, API Key setzen, Script starten, trends.json hochladen, Cloudflare deployen. Das sind 5 manuelle Schritte – jede Woche.

😓 Jetzt – manuell
Jeden Montag: Terminal öffnen → API Key setzen → python3 run_agent.py → trends.json kopieren → auf Cloudflare hochladen. 5 Schritte, ~10 Minuten.
✅ Nach dieser Lektion
GitHub Actions startet jeden Montag um 8:00 Uhr automatisch. Du wachst auf – die neuen Trends sind bereits online. 0 Schritte, 0 Minuten.

💡 Was ist GitHub Actions? Ein kostenloser Service von GitHub der Code automatisch ausführt – nach einem Zeitplan, bei einem Commit oder auf Knopfdruck. Perfekt für wiederkehrende Aufgaben wie unseren Agent.

📋
Phase 2 · Nachmachen

So funktioniert der automatische Ablauf

GitHub Actions führt jeden Montag diese Schritte automatisch aus:

Montag 8:00
Cron startet
🐍
Python läuft
run_agent.py
🧠
Claude analysiert
API Call
📄
trends.json
wird gespeichert
🌐
Live online
Cloudflare Pages

Schritt 1 – GitHub Repository einrichten

  • 1
    github.com öffnen → Account erstellen falls noch nicht vorhanden → kostenlos
  • 2
    "New Repository" klicken → Name: dotry-agent → Private → Create
  • 3
    Alle Agent-Dateien hochladen: run_agent.py, fetch_sources.py, analyze_trends.py

Schritt 2 – API Key als Secret speichern

Der API Key darf nie in einer Datei stehen. GitHub bietet dafür "Secrets" – verschlüsselte Variablen die nur der Workflow lesen kann:

  • 1
    Im Repository: Settings → Secrets and variables → Actions → New repository secret
  • 2
    Name: ANTHROPIC_API_KEY · Value: deinen API Key einfügen → Save

⚠️ Wichtig: Den API Key niemals direkt in eine Datei schreiben. Immer als Secret speichern – dann ist er verschlüsselt und sicher.

Schritt 3 – Workflow Datei erstellen

Das Herzstück der Automatisierung. Erstelle diese Datei in deinem Repository unter .github/workflows/agent.yml:

.github/workflows/agent.yml
name: dotry.ai Food Trend Agent

on:
  schedule:
    # Jeden Montag um 8:00 Uhr (UTC)
    - cron: '0 8 * * 1'
  workflow_dispatch:  # Auch manuell startbar

jobs:
  run-agent:
    runs-on: ubuntu-latest

    steps:
      - name: Code auschecken
        uses: actions/checkout@v4

      - name: Python einrichten
        uses: actions/setup-python@v5
        with:
          python-version: '3.11'

      - name: Abhängigkeiten installieren
        run: pip install feedparser anthropic

      - name: Agent starten
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: python3 run_agent.py

      - name: trends.json committen
        run: |
          git config user.name "dotry-agent"
          git config user.email "[email protected]"
          git add trends.json
          git diff --staged --quiet || git commit -m "🤖 Weekly trends update $(date +'%Y-%m-%d')"
          git push

💡 Cron erklärt: '0 8 * * 1' bedeutet: Minute 0, Stunde 8, jeder Tag des Monats, jeder Monat, Wochentag 1 (Montag). Willst du täglich? '0 8 * * *'

Schritt 4 – Cloudflare mit GitHub verbinden

Damit Cloudflare Pages automatisch die neue trends.json lädt sobald GitHub sie aktualisiert:

  • 1
    Cloudflare Dashboard → Workers & Pages → deine dotry.ai Page → Settings → Builds & Deployments
  • 2
    "Connect to Git" → GitHub verbinden → dotry-agent Repository auswählen
  • 3
    Branch: main · Build command: leer lassen · Root: / → Save

Ab jetzt: Wenn GitHub Actions die trends.json committed → Cloudflare erkennt den Push → deployed automatisch → dotry.ai zeigt die neuen Trends. Vollautomatisch.

🚀
Phase 3 · Anwenden

Deine Checkliste zum Abhaken

  • GitHub Account erstellen auf github.com
  • Neues Repository dotry-agent erstellen (Private)
  • Agent-Dateien hochladen: run_agent.py, fetch_sources.py, analyze_trends.py
  • API Key als Secret speichern: Settings → Secrets → ANTHROPIC_API_KEY
  • Workflow-Datei erstellen: .github/workflows/agent.yml
  • Workflow manuell testen: Actions → "dotry.ai Food Trend Agent" → Run workflow
  • Cloudflare mit GitHub verbinden → automatisches Deployment einrichten
  • Nächsten Montag abwarten – und die automatisch aktualisierten Trends auf dotry.ai bewundern 🎉

🎯 Tipp: Workflow manuell testen – Du musst nicht bis Montag warten. Im GitHub Repository unter Actions → "dotry.ai Food Trend Agent" → "Run workflow" kannst du den Agent sofort manuell starten und schauen ob alles funktioniert.