Installationsanleitung¶

Vollständige Installations- und Konfigurationsreferenz für DeskAgent.

Installationsort¶

DeskAgent kann an jedem beliebigen Ort installiert werden. Der Standard-Installationsordner ist:

C:\DeskAgent\

Ordnerstruktur¶

Nach der Installation erstellt DeskAgent folgende Ordnerstruktur:

[Installationsverzeichnis]\
├── deskagent\              ← Anwendungscode (nicht ändern)
│   ├── scripts\            ← Python-Module
│   ├── templates\          ← System-Templates
│   ├── mcp\                ← MCP-Server-Module
│   ├── static\             ← Web-Interface-Dateien
│   ├── server.py           ← Hauptanwendung
│   ├── start.bat           ← Startskript
│   ├── stop.bat            ← Stoppskript
│   └── update.bat          ← Update-Skript
│
├── python\                 ← Eingebettetes Python (nicht ändern)
│
├── config\                 ← Deine Konfiguration
│   ├── backends.json       ← AI-Anbieter-API-Keys
│   ├── apis.json           ← Externe Dienste-Zugangsdaten
│   ├── system.json         ← UI- und Verhaltenseinstellungen
│   └── agents.json         ← Agent-Definitionen
│
├── agents\                 ← Deine benutzerdefinierten Agents
│   └── *.md                ← Agent-Definitionsdateien
│
├── knowledge\              ← Deine Wissensbasis
│   ├── company.md          ← Firmeninformationen
│   ├── products.md         ← Produkte und Preise
│   └── *.md                ← Benutzerdefinierte Wissensdateien
│
└── workspace\              ← Laufzeitdateien
    ├── .logs\              ← Log-Dateien
    │   ├── system.log      ← Server-Aktivitätslog
    │   └── agent_*.txt     ← Agent-Ausführungslogs
    ├── .temp\              ← Temporäre Dateien
    └── exports\            ← Generierte Exporte (PDFs, etc.)

Benutzer-änderbare Ordner¶

Systemordner (nicht ändern)¶

Startbefehle¶

Batch-Skripte verwenden¶

Der einfachste Weg, DeskAgent zu starten:

# DeskAgent starten
.\deskagent\start.bat

# DeskAgent stoppen
.\deskagent\stop.bat

# Auf neueste Version aktualisieren
.\deskagent\update.bat

PowerShell direkt verwenden¶

Für mehr Kontrolle oder Debugging:

# Zum Installationsordner navigieren
cd C:\DeskAgent

# Mit sichtbarer Konsole starten (für Debugging)
python deskagent\server.py

# Im Hintergrund starten (kein Konsolenfenster)
pythonw deskagent\server.py

Kommandozeilenargumente¶

Konfigurationsdateien¶

backends.json - AI-Anbieter-Konfiguration¶

{
  "claude_sdk": {
    "type": "claude_agent_sdk",
    "api_key": "sk-ant-api03-DEIN-KEY-HIER",
    "model": "claude-sonnet-4-20250514",
    "use_anonymization_proxy": true
  }
}

apis.json - Externe Dienste¶

{
  "billomat": {
    "enabled": true,
    "id": "deine-account-id",
    "api_key": "dein-api-key"
  },
  "userecho": {
    "enabled": true,
    "subdomain": "deine-subdomain",
    "api_key": "dein-api-key"
  }
}

system.json - Systemeinstellungen¶

{
  "ui": {
    "title": "DeskAgent",
    "use_webview": true,
    "webview_width": 450,
    "webview_height": 800,
    "theme": "light"
  },
  "agent_logging": {
    "enabled": true,
    "max_files": 20
  }
}

Umgebungsvariablen¶

DeskAgent verwendet folgende Umgebungsvariablen:

Umgebungsvariablen setzen¶

$env:DESKAGENT_PORT = "8080"
python deskagent\server.py

Autostart-Konfiguration¶

Windows Aufgabenplanung¶

1. Öffne Aufgabenplanung (taskschd.msc)
2. Klicke auf Einfache Aufgabe erstellen
3. Konfiguriere:
4. Trigger: Bei Anmeldung
5. Aktion: Programm starten
6. Programm: pythonw.exe
7. Argumente: deskagent\server.py
8. Starten in: C:\DeskAgent

Autostart-Ordner¶

1. Drücke Win+R und tippe shell:startup
2. Erstelle eine Verknüpfung zu start.bat

Netzwerk-Konfiguration¶

Standard-Ports¶

Firewall-Regeln¶

DeskAgent lauscht standardmäßig nur auf localhost. Für lokale Nutzung sind keine Firewall-Regeln nötig.

Für Fernzugriff (nicht empfohlen):

# Eingehend auf Port 5005 erlauben
New-NetFirewallRule -DisplayName "DeskAgent" -Direction Inbound -Port 5005 -Protocol TCP -Action Allow

Fehlerbehebung bei der Installation¶

Port bereits in Verwendung¶

# Prozess finden, der Port 5005 verwendet
netstat -ano | findstr :5005

# Prozess per PID beenden
Stop-Process -Id <PID>

Python nicht gefunden¶

Wenn du "python nicht erkannt" siehst:

1. Stelle sicher, dass eingebettetes Python existiert: C:\DeskAgent\python\python.exe
2. Verwende den vollständigen Pfad: .\python\python.exe deskagent\server.py

Berechtigungsfehler¶

Führe PowerShell als Administrator aus und prüfe:

# Ordnerberechtigungen prüfen
icacls C:\DeskAgent

DeskAgent aktualisieren¶

Automatisches Update¶

.\deskagent\update.bat

Dies zieht die neuesten Änderungen von GitHub.

Manuelles Update¶

1. Sichere deine config/, agents/ und knowledge/-Ordner
2. Lade neue Version herunter
3. Extrahiere, behalte deine gesicherten Ordner
4. Starte DeskAgent neu

Deinstallation¶

1. Stoppe DeskAgent: .\deskagent\stop.bat
2. Lösche den Installationsordner
3. (Optional) Entferne Autostart-Einträge

Es werden keine Registry-Einträge oder Systemdateien außerhalb des Installationsordners geändert.