https://github.com/feuerwehrhackathon2024/2026-09-fugs-ki
Ein KI-gestuetzter Stabsfuehrungsassistenttechnoligedemonstrator fuer den Feuerwehr-Einsatz. Entstanden beim Hackathon2026 der Feuerwehr Muenchen.
https://github.com/feuerwehrhackathon2024/2026-09-fugs-ki
agentic-ai einsatzplanung feuerwehr munich
Last synced: about 2 months ago
JSON representation
Ein KI-gestuetzter Stabsfuehrungsassistenttechnoligedemonstrator fuer den Feuerwehr-Einsatz. Entstanden beim Hackathon2026 der Feuerwehr Muenchen.
- Host: GitHub
- URL: https://github.com/feuerwehrhackathon2024/2026-09-fugs-ki
- Owner: FeuerwehrHackathon2024
- License: mit
- Created: 2026-04-17T14:05:51.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-21T21:13:02.000Z (about 2 months ago)
- Last Synced: 2026-04-22T01:03:18.556Z (about 2 months ago)
- Topics: agentic-ai, einsatzplanung, feuerwehr, munich
- Language: Python
- Homepage: https://www.ffw-muenchen.de/hackathon2026/
- Size: 31.7 MB
- Stars: 8
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# FUGS&KI — Fuehrungsunterstuetzungssystem & KI
Effizientere Notfallreaktion durch intelligente Automatisierung
Erstellt mit folgenden Werkzeugen und Technologien:
---
Ein KI-gestuetzter Stabsfuehrungsassistenttechnoligedemonstrator fuer den Feuerwehr-Einsatz. Entstanden beim **[Hackathon2026 der Feuerwehr Muenchen](https://www.ffw-muenchen.de/hackathon2026/)**.
FUGS&KI verbindet eine Chat-Oberflaeche mit einem grossen Sprachmodell (LLM) und gibt diesem ueber das [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) Zugriff auf Einsatzdaten, Geodaten, Wetterdaten und Nachrichtenfunktionen — so wird die KI zum Werkzeug fuer die Stabsarbeit.
## Features
- **Chat-Interface** — Streaming-Chat mit waehlbarem LLM (lokal oder remote, OpenAI-kompatibel) und Kartenansicht
- **Einsatzdaten** — Zugriff auf Einsaetze, Einsatzmittel und Alarmstichworte ueber CIMgate
- **Nachrichten** — Lesen und Senden von Einsatz-Nachrichten direkt aus dem Chat
- **Geodaten** — Entfernungsberechnung (WGS-84) und OpenStreetMap-Abfragen (Overpass API)
- **Wetterdaten** — Aktuelle Temperatur und 12h-Vorhersage vom Deutschen Wetterdienst (DWD)
### Demo
#### Waldbrand Perlacher Forst (agent)
**Videos:** [▶ CommandX](./media/demo_wildfire_perlacher_forst_Commmandx.mov) · [▶ Übergabe & Lagebild](./media/demo_wildfire_perlacherforst_handover_comprehension.mov) · [▶ Instagram-Post](./media/demo_wildfire_perlacherforst_instagram.mov) · [▶ Pressemitteilung](./media/demo_wildfire_perlacherforst_instagram_press_statement.mov)
#### TUM Einsatz (agentv2)
**Video:** [▶ Hydrants Munich Demo](./media/demo_hydrants_munich.mp4)
## Architektur
## Externe Repos (erforderlich)
Zwei MCP-Dienste werden als separate Git-Repositories eingebunden und müssen
vor dem ersten Start in das Projektverzeichnis geklont werden:
| Verzeichnis | Repository | Beschreibung |
|---|---|---|
| `wetterdienst/` | https://github.com/fschir/WetterdienstMCPServer | DWD-Wetterdaten MCP-Server |
| `db-timetable/` | https://github.com/jorekai/db-timetable-mcp | Deutsche Bahn Fahrplan MCP-Server |
```bash
# Im Wurzelverzeichnis dieses Repos:
git clone https://github.com/fschir/WetterdienstMCPServer wetterdienst
git clone https://github.com/jorekai/db-timetable-mcp db-timetable
```
> **Hinweis:** `docker compose up --build` schlägt fehl, wenn diese Verzeichnisse fehlen.
## Quick Start
### Mit Docker Compose
```bash
# Externe Repos klonen (einmalig, siehe oben)
# Konfiguration anlegen
cp agent/config.example.json agent/config.json
# config.json bearbeiten: LLM-Endpunkt und API-Keys eintragen
# Fuer CommandX: CIMgate-Zugangsdaten hinterlegen
cp commandx/.env.example commandx/.env
# .env bearbeiten
# Fuer DB-Fahrplan: API-Key hinterlegen
cp db-timetable/.env.example db-timetable/.env
# .env bearbeiten: DB_API_KEY eintragen
# Stack starten
docker compose up --build
```
Die Anwendung ist dann unter `http://localhost:3001` erreichbar.
### Manuelle Entwicklung
Voraussetzungen: [Bun](https://bun.sh), [uv](https://docs.astral.sh/uv/)
```bash
# Agent (Frontend + Backend)
cd agent && bun install && bun run dev
# Tools-Server
cd tools && uv sync && uv run python main.py
# CommandX-Server
cd commandx && uv sync && uv run python main.py
```
Ausfuehrliche Entwicklerdokumentation: [`docs/DEV-DOCS.md`](docs/DEV-DOCS.md)
## Contributors
Siehe [contributors.md](contributors.md) fuer die vollstaendige Liste aller Mitwirkenden.
## Lizenz
MIT