Hermes-independent SOTA decision engine
  • Python 89.4%
  • HTML 10.5%
  • Shell 0.1%
Find a file
2026-06-27 13:59:57 +00:00
adr feat: SOTA Decider v2 — Enterprise Decision Engine 2026-06-16 13:24:31 +00:00
decider LLM Gate: recommended_action in steer text 2026-06-27 13:59:57 +00:00
ISSUES docs: #208 closed — all 16 issues resolved 2026-06-16 13:49:37 +00:00
tests Decider v3: 7-state formal state machine with plan-driven auto-continuation 2026-06-27 13:00:35 +00:00
.gitignore chore: gitignore decisions.db, db-journal, db-wal files 2026-06-16 15:20:57 +00:00
auth.env forward auth: cookie-based login at /login, /auth endpoint for Traefik, /logout 2026-06-16 14:58:06 +00:00
decider.conf.json Ensemble: 2 members (balanced=1.0 + creative=0.6), threshold=0.70 2026-06-23 09:25:11 +00:00
decisions.db LLM Gate: recommended_action in steer text 2026-06-27 13:59:57 +00:00
precedents.db LLM Gate: recommended_action in steer text 2026-06-27 13:59:57 +00:00
precedents.db-shm LLM Gate: recommended_action in steer text 2026-06-27 13:59:57 +00:00
principles.md Decider v3: 7-state formal state machine with plan-driven auto-continuation 2026-06-27 13:00:35 +00:00
README.md initial: decider — Hermes-independent decision engine 2026-06-16 12:50:15 +00:00
start.sh fix: route LLM calls through local proxy (port 8646) for working API keys 2026-06-16 15:05:40 +00:00
start_auth.sh forward auth: cookie-based login at /login, /auth endpoint for Traefik, /logout 2026-06-16 14:58:06 +00:00

Decider

Hermes-unabhängiger Decision Engine. Bewertet Situationen gegen abstrakte Prinzipien per externem LLM (DeepSeek).

Principles

Siehe principles.md — 5 abstrakte Regeln:

  1. Autonomy First — handeln ohne Fragen, außer bei irreversiblen Schäden
  2. Root Cause Focus — Ursachen fixen, nicht Symptome
  3. Ambiguity Escalation — nur fragen wenn Prinzipien ambig sind
  4. Execute-Report — erst machen, dann berichten
  5. Risk-Graded Autonomy — Autonomie nach Risikostufe

Usage

# Einfach
echo '{"situation": "npm package installieren?"}' | python3 decider.py

# Mit Kontext
echo '{"situation": "soll ich nginx config ändern?", "context": "Port 443 -> 8443"}' | python3 decider.py

# Interaktiv
python3 decider.py --interactive

# Custom principles
python3 decider.py --situation "..." --principles /pfad/zu/principles.md

Output

{
  "decision": "auto_approve",
  "principle": "P1",
  "reasoning": "Low-risk, reversible action. Proceed without asking.",
  "ask_question": null
}

Decisions: auto_approve | ask_user | abort

Hermes Integration

Wird von Hermes per subprocess aufgerufen, ersetzt approvals.mode: manual. Kein Hermes-Code im Decider — standalone, austauschbar.

Dependencies

  • Python 3.11+
  • httpx (pip install httpx)
  • DEEPSEEK_API_KEY in env