git_alhan/hermes-session-cleaner
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: installation guide, SKILL.md for hermes skills install

Browse Source
This commit is contained in:
git_alhan
2026-06-12 20:32:07 +00:00
parent 223e90222f
commit b70e0e914b
2 changed files with 91 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

71
README.md
View File

@@ -2,10 +2,35 @@
Hermes Agent session temizlik aracı: kısa konuşmaları sil, başlıksız session'lara title üret.
## Kurulum
### Yöntem 1: Hermes Skill olarak (önerilen)
```bash
hermes skills install https://git.softmediadesign.com/git_alhan/hermes-session-cleaner/raw/branch/main/SKILL.md
```
Skill yüklendikten sonra Hermes içinde "temizlik yap" veya "clean sessions" dediğinde otomatik çalışır.
### Yöntem 2: Manuel (git clone)
```bash
git clone https://git.softmediadesign.com/git_alhan/hermes-session-cleaner.git
cd hermes-session-cleaner
python3 hermes_cleaner.py --dry-run
```
### Yöntem 3: Tek komut (curl + run)
```bash
curl -O https://git.softmediadesign.com/git_alhan/hermes-session-cleaner/raw/branch/main/hermes_cleaner.py
python3 hermes_cleaner.py --dry-run
```
## Kullanım
```bash
# Neler olacağını gör (dry-run)
# Neler olacağını gör (her zaman önce bunu çalıştır)
python3 hermes_cleaner.py --dry-run
# Gerçek temizlik
@@ -23,12 +48,44 @@ python3 hermes_cleaner.py --no-delete --max-titles 50
## Nasıl Çalışır
1. Tüm session'ları tarar
2. `< N` mesajlı session'ları siler (default: 5)
3. `>= N` mesajlı ama başlıksız session'lara title üretir (hermes3:latest ile)
1. Tüm session'ları tarar (`~/.hermes/state.db`)
2. `< N` mesajlı session'ları **siler** (default: 5)
3. `>= N` mesajlı ama başlıksız session'lara **title üretir**
## Gereksinimler
- Hermes Agent kurulu olmalı
- Ollama'da `hermes3:latest` modeli (env ile değiştirilebilir)
- `HERMES_CLEANER_MODEL` ve `HERMES_CLEANER_ENDPOINT` env override'ları
- Hermes Agent kurulu olmalı (hermes_state modülü için)
- Title üretimi için Ollama'da `hermes3:latest` modeli
## Yapılandırma (Env Vars)
| Değişken | Varsayılan | Açıklama |
|---|---|---|
| `HERMES_CLEANER_MODEL` | `hermes3:latest` | Title üretimi için model |
| `HERMES_CLEANER_ENDPOINT` | `http://100.83.239.61:11434/v1/chat/completions` | Ollama API adresi |
```bash
# DeepSeek API ile kullanmak istersen:
export HERMES_CLEANER_ENDPOINT="https://api.deepseek.com/v1/chat/completions"
export HERMES_CLEANER_MODEL="deepseek-chat"
export HERMES_CLEANER_API_KEY="sk-..."
```
## Cron ile Otomatik Çalıştırma
```bash
# Hermes içinde:
/cron "her hafta pazar 03:00'te session temizliği yap"
# Veya manuel cron:
0 3 * * 0 cd /path/to/hermes-session-cleaner && python3 hermes_cleaner.py
```
## Projeler
Bu proje `hermes-session-ending` ile birlikte çalışır:
| Proje | Amaç | Ne zaman? |
|---|---|---|
| [session-ending](https://git.softmediadesign.com/git_alhan/hermes-session-ending) | Oturum sonu: title + save + reset | Her oturum sonunda ("ending") |
| session-cleaner (bu proje) | Toplu temizlik: sil + title | Haftalık bakım |

27
SKILL.md Normal file
View File

@@ -0,0 +1,27 @@
---
name: session-cleaner
description: "Clean Hermes session DB: delete short conversations, generate missing titles."
version: 1.0.0
---
# Session Cleaner
Scans the Hermes session DB and:
1. Deletes sessions with fewer than 5 messages (configurable)
2. Generates titles for sessions that don't have one
Uses local Ollama (hermes3:latest) for title generation.
## Usage
```bash
python3 hermes_cleaner.py --dry-run # Preview
python3 hermes_cleaner.py # Full clean
python3 hermes_cleaner.py --no-delete # Titles only
python3 hermes_cleaner.py --min-messages 3 # Custom threshold
```
## Requirements
- Hermes Agent installed (for hermes_state module)
- Ollama with hermes3:latest model (env-configurable)