● Session 07

Automatisierung mit GitHub Actions

Wie ein KI-Agent automatisch läuft – mit GitHub Actions als einfachem Automatisierungsbeispiel.

technik 15 Minuten automatisierung

Überblick

Der Agent aus Session 6 läuft – aber du musst ihn noch manuell starten. Das ändern wir jetzt. Mit GitHub Actions läuft der Agent jeden Montag automatisch, aktualisiert die Trends und niemand muss einen Finger rühren. Einmal einrichten – für immer automatisch.

🟠 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 "hi@dotry.ai"
          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.