Vor zwei Monaten hatte Hermes Agent das gleiche Problem wie fast jedes andere Open‑Source‑Agent‑Framework: ein Genie im Code, ein Kryptogramm in der README.
Die Architektur war sauber. Die Primitives waren richtig. Der Tool‑Layer war elegant, das Memory‑Modell durchdacht, die Provider‑Abstraktion modellagnostisch gut. Auf dem Papier eines der besten Frameworks, die ich dieses Jahr gesehen habe — und ich habe mir viele angesehen.
Nur: Du konntest den ersten Agenten nicht einfach starten. Du musstest dich durch Issues graben, Discord‑Pings lesen, einen halben Tag lang Config‑Varianten probieren — und am Ende hattest du einen Hello‑World‑Run, der zwei Mal reconnected, bevor er "hi" sagte.
Ein Framework ohne Dokumentation ist kein Framework. Es ist ein Angebot an Leute, die Zeit haben.
Was das Orange Book ändert
Das Orange Book ist ein 17‑Kapitel‑PDF, das den kompletten Pfad von Zero bis Production anleitet. Keine Marketing‑Texte, kein Case‑Study‑Theater. Einfach: installiere, konfiguriere, starte, verstehe. Kapitel für Kapitel.
- Kapitel 1–4: Setup, Umgebungen, erster Agent.
- Kapitel 5–8: Tool‑Registration, Memory‑Architektur, Provider‑Wechsel.
- Kapitel 9–12: Persistenz, State‑Recovery, Multi‑Agent‑Patterns.
- Kapitel 13–17: Production‑Deployment, Monitoring, Guard‑Rails, Custom‑Extensions.
Verfügbar auf chinesisch und englisch. Kostenlos. Repo öffnen, PDF runter, Kaffee, Nachmittag — und du hast einen autonomen Agenten, der nicht nur läuft, sondern dir gehört. Das ist der Unterschied.
Warum das ein Bodendruck‑Moment ist
In 48 Stunden hat Hermes 568 neue GitHub Stars bekommen. Inzwischen sind es 782. Das ist keine Viral‑Kurve — es ist Akkumulation von Leuten, die seit Monaten gewartet haben, dass endlich jemand erklärt, wie man das Ding benutzt.
Und das ist das Muster, das dieses Jahr immer wieder auftauchen wird: Tooling wird Commodity, Erklärung wird Moat. Wer dokumentiert, wer onboarded, wer den ehrlichen Workflow zeigt — gewinnt. Wer komplexe Features in einer README versteckt, verliert an den Nächsten, der die gleiche Idee besser verpackt.
Wie ich es selbst benutzt habe
Ich habe Hermes als Basis für den White‑Label‑Kundenbot meiner Coach‑Kundin genutzt. Telegram‑Frontend, CRM‑Anbindung, Memory auf Redis + Postgres, WordPress‑Sync für Kursinhalte. Ein Stack, den ich — ehrlich gesagt — drei Wochen gebraucht hätte, wenn ich ihn von Null hochgezogen hätte.
Mit Hermes + Orange Book waren es fünf Tage. Davon zwei Tage Dokumentation lesen und eigenen Code draufstellen, drei Tage Custom‑Tools bauen. Das ist nicht nichts — das ist ein Quartal, das ich meiner Kundin zurückgegeben habe.
Frameworks sind ein Versprechen. Dokumentation ist die Einlösung. — Notiz aus meinem Hermes‑Deploy‑Journal
Was ich empfehle
Wenn du darüber nachdenkst, einen eigenen Agenten zu bauen — egal für welchen Use‑Case — schau dir Hermes an, bevor du dir etwas Proprietäres kaufst. Es ist nicht das, was am meisten glänzt. Es ist das, was am ehrlichsten dokumentiert ist.
Die Roadmap, die ich dir empfehle:
- Repo clonen, Orange Book öffnen, Kapitel 1–4 durcharbeiten. Zwei Stunden.
- Einen trivialen Agenten für dich selbst bauen — z.B. "morgens Inbox‑Summary an mein Telegram". Einen Nachmittag.
- Das Tool‑Registry‑Kapitel lesen (Kap. 6). Dann den Agenten um ein echtes Tool erweitern, z.B. CRM‑Lookup. Einen Nachmittag.
- Kapitel 13–17 erst lesen, wenn du deployen willst. Vorher nicht — es lenkt nur ab.
Wenn du an Schritt 3 hängenbleibst, schreib mir. Ich erkläre das an einem Telefonat in 15 Minuten. Ich habe den Fehler schon sieben Mal gemacht.
Links: github.com/hermes‑agent/orange‑book · erik@lorenscheit.com für Deploys, die schneller live sollen.