Add credits to Daniel Snor and project info

This commit is contained in:
2026-01-06 11:17:54 +01:00
parent 21930ce600
commit 433c99e377

View File

@@ -2,9 +2,15 @@
Automatický denní digest systém pro Mastodon boty používající Claude AI.
## 📖 O projektu
Automatizační nástavba pro [Zprávobot.news](https://github.com/DanielSnor/Zpravobot.news) od Daniela Snora.
Přidává AI-powered digest systém s Claude analýzou a automatickou kategorizací zpráv.
## 🎯 Co to dělá
Systém 3× denně:
1. Načte včerejší posty z CSV exportu
2. Automaticky je kategorizuje podle témat (🌍 Politika, 🏒 Sport, 🎬 Kultura...)
3. Analyzuje pomocí Claude AI
@@ -31,6 +37,7 @@ Systém 3× denně:
### 1. Připrav prostředí
V Mastodon terminalu (Cloudron):
```bash
cd /app/data
git clone https://gitea.vhsky.cz/user/zpravobot-digest.git
@@ -38,6 +45,7 @@ cd zpravobot-digest
```
### 2. Nainstaluj Ruby gem
```bash
export GEM_HOME=$HOME/.gem
export PATH=$GEM_HOME/bin:$PATH
@@ -45,17 +53,20 @@ gem install mastodon-api --user-install
```
Ověř instalaci:
```bash
ruby -e "require 'mastodon'; puts 'OK'"
```
### 3. Konfigurace
```bash
cp config.env.example config.env
nano config.env
```
Vyplň tokeny:
```bash
export ANTHROPIC_API_KEY="sk-ant-api03-..."
export ZPRAVOBOT_TOKEN="token-zde"
@@ -64,12 +75,14 @@ export SARKASTICKY_TOKEN="token-zde"
```
**Jak vytvořit Mastodon tokeny:**
1. Přihlásit se jako bot účet
2. Settings → Development → New application
3. Scopes: `read:statuses` + `write:statuses`
4. Zkopírovat "Your access token"
### 4. Spustitelné práva
```bash
chmod +x export-daily.sh publish_digest.rb run-digest.sh
chmod 600 config.env
@@ -78,6 +91,7 @@ chmod 600 config.env
## 🧪 Testování
### Dry-run (bez publikace)
```bash
source config.env
./run-digest.sh zpravobot --dry-run
@@ -86,6 +100,7 @@ source config.env
```
### Live test (skutečná publikace)
```bash
./run-digest.sh zpravobot
```
@@ -95,6 +110,7 @@ Zkontroluj na Mastodonu že se thread publikoval.
## ⏰ Automatizace (Cron)
V Cloudron UI → Mastodon app → Cron tab:
```
0 6 * * * /app/data/zpravobot-digest/export-daily.sh
30 7 * * * /app/data/zpravobot-digest/run-digest.sh zpravobot
@@ -103,12 +119,14 @@ V Cloudron UI → Mastodon app → Cron tab:
```
**Rozvrh:**
- 6:00 - Export postů z databáze
- 7:30 - Neutrální digest (@zpravobot)
- 12:00 - Pozitivní zprávy (@pozitivni)
- 19:00 - Sarkastický komentář (@sarkasticky)
## 📁 Struktura souborů
```
/app/data/
├── zpravobot-digest/
@@ -127,6 +145,7 @@ V Cloudron UI → Mastodon app → Cron tab:
## 🔧 Ruční použití
### Publikovat digest
```bash
source config.env
./run-digest.sh zpravobot # Neutrální
@@ -135,11 +154,13 @@ source config.env
```
### Použít specifické datum
```bash
./run-digest.sh zpravobot --date=2026-01-05 --dry-run
```
### Export CSV
```bash
./export-daily.sh
```
@@ -157,6 +178,7 @@ source config.env
## 📊 Monitoring
### Zkontrolovat dnešní běhy
```bash
# V logu exportu
tail -50 /app/data/logs/export.log
@@ -169,13 +191,15 @@ wc -l /app/data/posts-latest.csv
### Zkontrolovat publikace
Navštiv:
- https://zpravobot.news/@zpravobot
- https://zpravobot.news/@pozitivni
- https://zpravobot.news/@sarkasticky
- <https://zpravobot.news/@zpravobot>
- <https://zpravobot.news/@pozitivni>
- <https://zpravobot.news/@sarkasticky>
## 🐛 Troubleshooting
### "CSV file not found"
```bash
# Ověř že export běžel
ls -la /app/data/posts-latest.csv
@@ -185,6 +209,7 @@ ls -la /app/data/posts-latest.csv
```
### "Missing token"
```bash
# Ověř environment
source config.env
@@ -196,6 +221,7 @@ echo $ZPRAVOBOT_TOKEN
Token vypršel nebo je neplatný. Vygeneruj nový v Mastodon → Settings → Development.
### Ruby gem chyba
```bash
# Reinstaluj gem
export GEM_HOME=$HOME/.gem
@@ -221,8 +247,9 @@ Open source - vytvořeno pro Zprávobot.news komunitu.
## 🙏 Credits
- **Zprávobot.news** - České/Slovenské Mastodon zpravodajství
- **Anthropic Claude** - AI analýza
- **Daniel Snor** - [Zprávobot.news](https://github.com/DanielSnor/Zpravobot.news) - Původní Mastodon instance a koncept
- **Zprávobot.news komunita** - České/Slovenské Mastodon zpravodajství
- **Anthropic Claude** - AI analýza a kategorizace
- **Mastodon** - Decentralizovaná sociální síť
---