Add credits to Daniel Snor and project info
This commit is contained in:
37
README.md
37
README.md
@@ -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íť
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user