From 5f352634f08f4e0fb39e9b6b8505048aeff47cf7 Mon Sep 17 00:00:00 2001 From: Ratatoskr Date: Tue, 7 Jul 2026 13:15:22 +0200 Subject: [PATCH] Update README mit agy und Signal-cli Details --- README.md | 25 +++++++++++++++++-------- 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index ec8d454..31a4f63 100644 --- a/README.md +++ b/README.md @@ -16,8 +16,8 @@ Ein automatisiertes Überwachungswerkzeug für Webseiten und Nachrichtenportale, ## 🛠 Technische Details - **Sprache:** Python 3 -- **Bibliotheken:** `cloudscraper`, `BeautifulSoup4`, `requests` -- **KI-Integration:** Gemini Pro via CLI +- **Bibliotheken:** `cloudscraper`, `BeautifulSoup4`, `requests`, `python-dotenv` +- **KI-Integration:** Google Antigravity CLI (`agy`) mit Modell `gemini-3.5-flash` - **Datenhaltung:** SQLite (`polit_scraper.db`) - **Konfiguration:** `urls.txt` (Ziel-URLs), `gemini_instructions.md` (KI-Regelwerk) und `.env` (Zugangsdaten & Einstellungen) @@ -25,18 +25,27 @@ Ein automatisiertes Überwachungswerkzeug für Webseiten und Nachrichtenportale, 1. **Abhängigkeiten installieren:** ```bash - pip install cloudscraper beautifulsoup4 requests --break-system-packages + pip install cloudscraper beautifulsoup4 requests python-dotenv --break-system-packages ``` -2. **Konfiguration (`.env`):** - Erstelle eine `.env`-Datei basierend auf `.env.example` und setze deine Zugangsdaten sowie `MAX_ANALYZER_WORKERS`. -3. **Ziele definieren:** +2. **Antigravity CLI (agy) & Pfad-Verlinkung:** + Installiere das `agy` CLI. Da die Worker-Hintergrundprozesse in einer eingeschränkten PATH-Umgebung laufen, muss zwingend ein globaler symbolischer Link angelegt werden: + ```bash + ln -s /root/.local/bin/agy /usr/bin/agy + ``` +3. **Signal-Bot (Standalone-Client):** + Der Notifier sendet Benachrichtigungen über `signal-cli` (registriert z. B. als Standalone-Festnetznummer). + - Um Blockaden durch geänderte Sicherheitsnummern zu verhindern, ist in `notifier.py` das Flag `--trust-new-identities always` hinterlegt. + - Da `agy` OAuth-Tokens verschlüsselt speichern möchte, muss auf Headless-Servern ein D-Bus- und GNOME-Keyring-Dienst im Hintergrund laufen. Stelle sicher, dass die entsprechenden D-Bus-Umgebungsvariablen (wie `DBUS_SESSION_BUS_ADDRESS`) in der `.env` eingetragen sind. +4. **Konfiguration (`.env`):** + Erstelle eine `.env`-Datei basierend auf `.env.example` und setze deine Zugangsdaten (ntfy, Signal-Empfänger, D-Bus) sowie `MAX_ANALYZER_WORKERS`. +5. **Ziele definieren:** URLs in die `urls.txt` eintragen (eine pro Zeile). -4. **Starten:** +6. **Starten:** Der `crawler.py` steuert automatisch die Analyzer-Worker und den Notifier: ```bash python3 crawler.py ``` -5. **Überwachung:** +7. **Überwachung:** Nutze den Live-Monitor für den Status der Abarbeitung: ```bash python3 monitor.py