Walz 4.0 · Hackathon 2026

Schritt für Schritt mit Hermes im Walz-Repo starten

Alles hier passiert am Hackathon-Tag vor Ort — du musst nichts davon vorher erledigen. Du brauchst einen Laptop, Internet und ein GitHub-Konto. Zwei Dinge bekommst du von uns, und beide in derselben Mail: den Zugang zum Projektcode und deinen persönlichen OpenRouter-Key. Schick dafür als ersten echten Handgriff dein GitHub-Handle an Michael Bühler (Schritt 2) — und installier Hermes, während seine Antwort unterwegs ist. Sobald der Key eingetragen ist, hilft Hermes mit; ab dem Klonen übernimmt er: Du schreibst, was passieren soll, statt Befehle abzutippen.

Lieber auf Papier? Die Kurzanleitung zum Ausdrucken (PDF, ~320 KB) fasst dieselben Schritte auf einer Seite zusammen, mit QR-Code zurück auf diese Seite. Auf der Karte ist der Klon-Prompt gekürzt — hier in Schritt 6 steht er vollständig zum Kopieren.

gh auth login
git clone https://github.com/HTWG-Bauwirtschaft/walz40-hackathon.git
cd walz40-hackathon
hermes desktop --cwd ./starter

Ins WLAN

Ohne Netz geht nichts — deshalb zuerst. Es gibt zwei Wege, such dir deinen aus.

• Du gehörst einer Hochschule an, der HTWG oder einer anderen? Dann nimm eduroam mit deiner gewohnten Hochschulkennung und leg sofort los — du brauchst nichts von uns.
• Du gehörst keiner Hochschule an? Dann brauchst du einen Gastzugang fürs WLAN HTWG-GUEST. Den geben wir vor Ort aus, frag uns einfach im Raum danach. Er gilt ab der ersten Verwendung sechs Tage, und bei der Anmeldung musst du beide Teile eintragen: Voucherblock 1 und Voucherblock 2. Mit nur einem kommst du nicht rein.

Erfolgssignal: Du bist online.

GitHub-Konto anlegen und dein Handle schicken

Der Projektcode liegt in einem Repository — dem versionierten Projektordner auf GitHub. Unseres ist privat: Nur eingeladene Personen sehen es.

Das ist der einzige Schritt, den du nicht allein zu Ende bringst: Du schickst dein GitHub-Handle an Michael Bühler — und er antwortet dir persönlich. In seiner Antwort liegen zwei Dinge: die Einladung zum Projektcode und dein persönlicher OpenRouter-Key. Eine Mail hin, eine Mail zurück.

1. Melde dich bei GitHub an. Hast du noch kein Konto, leg dir eins auf github.com an — kostenlos.
2. Schick uns dein GitHub-Handle an [email protected]. Das Handle ist dein Login-Name bei GitHub.
3. Warte auf die Antwort von Michael Bühler. Er schickt dir zwei Dinge zurück: die Einladung zum Repository und deinen persönlichen OpenRouter-Key, den Code, der mit sk-or-v1- beginnt. Beides brauchst du in Schritt 4 — dort trägst du es ein.

Schick die Mail, sobald du da bist — noch bevor du irgendetwas installierst. Danach machst du mit dem nächsten Schritt weiter, während die Antwort unterwegs ist. Und keine Sorge vor dem Warten: Wir sitzen im selben Raum. Ist nach zehn Minuten nichts da, sprich uns an, statt sitzen zu bleiben.

Erfolgssignal: Deine Mail mit dem Handle ist raus — und du weißt, dass Einladung und Key als Antwort zurückkommen.

Hermes Desktop installieren

Die Mail ist raus, die Antwort braucht einen Moment — nutz ihn. Hermes Desktop ist die Oberfläche, in der du während des Hackathons mit dem KI-Assistenten arbeitest: Chat, Dateibrowser und Terminal in einem Fenster. Entwickelt wird sie von Nous Research, einem Open-Source-KI-Labor. Sie läuft auf macOS, Windows und Linux.

Diesen Schritt und den nächsten machst du selbst — solange Hermes keinen Key hat, ist niemand da, der sie dir abnehmen könnte.

Installation Schritt für Schritt

1. Öffne hermes-agent.nousresearch.com im Browser.
2. Lade die Desktop-App für dein Betriebssystem herunter — macOS, Windows oder Linux.
3. Installiere sie und starte Hermes einmal.

Erfolgssignal: Das Hermes-Chatfenster ist geöffnet.

Einladung bestätigen und OpenRouter-Key eintragen

Jetzt sollte die Antwort von Michael Bühler da sein — die Mail auf dein Handle aus Schritt 2. Sie bringt die beiden Dinge, die du hier einträgst: den Zugang zum Projektcode und den Key, mit dem Hermes arbeitet.

Erst die Einladung

1. Öffne die Einladung in deinem Postfach und bestätige sie.
2. Öffne danach github.com/HTWG-Bauwirtschaft/walz40-hackathon. Siehst du den Projektnamen, ist dein Zugriff bereit.

Dann der Key

OpenRouter ist ein Gateway — eine Zwischenstation, über die du viele KI-Modelle mit einem einzigen Zugangscode erreichst, statt bei OpenAI, Anthropic, Google, DeepSeek und MiniMax je einen eigenen Account anzulegen.

Du bekommst zu Beginn des Hackathons einen persönlichen Key mit einem Anfangsbudget von 20 US-Dollar. Wenn das Budget verbraucht ist, gib uns Bescheid.

Beantragen musst du ihn nirgends: Er steht in der Antwortmail aus Schritt 2. Der Key ist eine lange Zeichenkette und beginnt mit sk-or-v1-. Jede Anfrage wird dir zugeordnet und von deinem Budget abgezogen. Mehr als diesen einen Code brauchst du nicht.

So trägst du den Key in Hermes ein

1. Starte Hermes Desktop.
2. Öffne die Einstellungen — oben rechts das Zahnrad-Symbol oder dein Profilbild.
3. Wähle „Providers“ oder „Accounts“.
4. Füge „OpenRouter“ als Provider hinzu.
5. Füge deinen persönlichen Key ein — den Code, der mit sk-or-v1- beginnt.
6. Speichern. Hermes verbindet sich jetzt mit OpenRouter.
7. Wähle ein Modell aus der Tabelle unten. Andere Modelle sind nicht freigegeben.
8. Teste: Schreib „Hallo, antworte kurz auf Deutsch.“ Kommt eine Antwort, bist du startklar.

Freigegebene Modelle

Alternative: per Kommandozeile

hermes model
# Wähle OpenRouter, gib den Key ein, wähle ein Modell

Du hast schon einen eigenen Zugang zu einem KI-Anbieter, etwa ChatGPT Plus, Claude Pro oder Gemini? Den kannst du stattdessen in Hermes eintragen. Er läuft außerhalb der 20 Dollar und wird nicht über OpenRouter abgerechnet.

Erfolgssignal: Die Projektseite auf GitHub öffnet sich, und OpenRouter antwortet im Chatfenster.

Deinen Rechner bei GitHub anmelden

Hier bleiben erfahrungsgemäß die meisten hängen — deshalb erledigen wir es vor dem Klonen.

Die Einladung gilt für dich, nicht für deinen Rechner. Der muss sich einmalig selbst bei GitHub anmelden: Weil das Repository privat ist, fragt Git beim Klonen nach Zugangsdaten — und GitHub akzeptiert dafür seit 2021 kein Passwort mehr.

Dafür gibt es die GitHub CLI — ein Kommandozeilen-Werkzeug von GitHub, kurz gh. Ab hier kann Hermes helfen. Kopier das in den Chat:

Den Klick im Browser kann dir niemand abnehmen: Du bestätigst dort, dass dein Rechner in deinem Namen auf GitHub zugreifen darf. Das ist Absicht — und der Grund, warum dieser Schritt nicht vollständig automatisch geht.

Erfolgssignal: gh auth login meldet, dass du angemeldet bist.

Repository klonen — das übernimmt Hermes

Klonen heißt: das Repository auf deinen Rechner kopieren. Statt dafür Befehle abzutippen, sagst du es Hermes. Ein Prompt ist die Nachricht, die du an Hermes schickst — kopier diesen in den Chat:

Der Prompt erledigt vier Dinge auf einmal: klonen, notfalls anmelden, in den Projektordner wechseln, einlesen. Der letzte Satz — „Ändere noch keine Dateien“ — steht mit Absicht darin: Hermes soll sich erst orientieren, statt sofort loszuschreiben. Aus der Antwort weißt du dann, worum es geht, welche Regeln gelten und wo du anfangen kannst.

Geschafft: Im Hermes-Dateibrowser siehst du AGENTS.md sowie die Ordner context/ und specs/ — und Hermes hat dir das Projekt in fünf Punkten erklärt.

Feature-Branch anlegen

Ein Branch ist ein eigener Arbeitsstand — deine Kopie des Projekts, in der du experimentieren kannst, ohne den Hauptzweig main zu stören. Sobald du weißt, woran du arbeiten willst, leg deinen an. Auch das macht Hermes für dich:

Oder du tippst es selbst:

git checkout -b feat/dein-thema

Git-Regeln im Überblick

Zusammengeführt — gemergt — wird ausschließlich vom Organisationsteam: Oliver Fritz, Jo Wickert, Michael Bühler, Borna Kalhor.

App lokal starten (optional)

Die Web-App läuft auch auf deinem Rechner. Sie ist ein Vite-, React- und TypeScript-Projekt mit Tailwind CSS für das Design. Auch hier reicht ein Prompt:

Oder von Hand:

cd starter
npm ci
npm run doctor
npm run dev

Öffne danach http://localhost:5173. Die App läuft im Mock-Modus: ohne echte KI-Anbindung und ohne Datenbank. Zum Bauen und Testen der Oberfläche reicht das. Brauchst du das Backend, steht die Anleitung in starter/README.md.

Bevor du etwas als fertig meldest

npm run build
npm run lint

Erfolgssignal: Die App ist unter http://localhost:5173 erreichbar.

Das Terminal — falls du selbst tippen willst

Ein Terminal ist das Fenster, in dem du Befehle tippst statt zu klicken. Für die Schritte oben brauchst du es nicht — Hermes nimmt es dir ab. Wenn du trotzdem selbst tippen willst, findest du hier die Wege.

Wo du ein Terminal findest

• macOS und Linux: Die App heißt „Terminal“.
• Windows: Das Terminal heißt heute Windows Terminal, darin läuft die PowerShell. Die ältere Eingabeaufforderung (cmd) gibt es weiterhin. Am einfachsten: Startmenü öffnen, „PowerShell“ tippen, starten — das funktioniert auf Windows 10 und 11.
• Direkt in Hermes Desktop: rechts unten „show terminal“. Dann brauchst du gar kein zweites Fenster.

Zwei Oberflächen — nicht verwechseln

Hermes gibt es in zwei Ausführungen. Beide sind Hermes, aber die Befehle gehören nicht gemischt:

• hermes --tui — Hermes im Terminal. Die Textoberfläche (TUI steht für „Text User Interface“) läuft direkt im Terminalfenster, ohne eigenes App-Fenster.
• hermes desktop --cwd ./starter — die Desktop-App. Chat, Dateibrowser und Terminal nebeneinander. --cwd ./starter sagt Hermes, in welchem Ordner er arbeiten soll.

Entscheide dich für einen der beiden Wege. Die Anleitung oben geht durchgehend von Hermes Desktop aus.

Sicher arbeiten

Troubleshooting

Der schnellste Weg bleibt der Chat: Fehlermeldung hineinkopieren, dazuschreiben, was du vorhattest, fragen. Diese Tabelle ist zum Nachschlagen, wenn du lieber selbst suchst.

Über das Projekt

Walz 4.0 ist ein Interreg-Projekt (Alpenrhein-Bodensee-Hochrhein), kofinanziert von der Europäischen Union, der Schweizerischen Eidgenossenschaft und dem Fürstentum Liechtenstein. Ausgerichtet wird der Hackathon von der HTWG Konstanz.

Das Ziel: in zwei Tagen eine Web-App bauen, die Pilotaktionen im Walz-4.0-Netzwerk sichtbar macht — von der Suche nach Aktionen über die Anmeldung bis zum QR-Code-Ticket und der digitalen Teilnahme-Urkunde. Das Projekt liegt unter starter/, der Code ist in TypeScript geschrieben, das Backend ist PocketBase. Die Oberfläche folgt dem Walz-4.0-Design mit der Markenfarbe Orange #F26521.

Hilfe und Notfallkontakt

Frag zuerst Hermes — er sieht deinen Rechner. Kommst du damit nicht weiter, sprich uns direkt im Raum an. Das ist der schnellste Weg.

Notfall: Michael Bühler
E-Mail: [email protected]
Telefon: +49 151 143 144 99

Walz 4.0 — Interreg Alpenrhein-Bodensee-Hochrhein

Kofinanziert von der Europäischen Union, der Schweizerischen Eidgenossenschaft und dem Fürstentum Liechtenstein

HTWG Konstanz · [email protected]