Konfiguration

Pia speichert seine Konfiguration in %APPDATA%\Pia\settings.json. Eigenschaftsnamen sind camelCase, und Enum-Werte werden als ihre Namen geschrieben ("Dark", "Parakeet").

Um Einstellungen stattdessen auf verwaltete Geräte zu verteilen, nutze die Enterprise-Richtlinie — sie verwendet dieselben Eigenschaftsnamen.

Erscheinungsbild und Sprache

Einstellung	Typ	Standard	Beschreibung
`theme`	`"System"` \| `"Dark"` \| `"Light"`	`"System"`	UI-Design
`uiLanguage`	`"EN"` \| `"DE"` \| `"FR"`	`"EN"`	Sprache der Oberfläche
`targetLanguage`	`"EN"` \| `"DE"` \| `"FR"`	unset	Standard-Ausgabesprache für Optimieren
`targetSpeechLanguage`	`"Auto"` \| `"EN"` \| `"DE"` \| `"FR"`	`"Auto"`	Spracherkennungs-Sprache

Start und Fenster

Einstellung	Typ	Standard	Beschreibung
`launchAtStartup`	bool	`true`	Pia mit Windows starten
`startMinimized`	bool	`false`	Minimiert im Infobereich starten
`autoCaptureSelectedText`	bool	`true`	Markierten Text per Hotkey automatisch übernehmen
`defaultWindowMode`	`"Optimize"` \| `"Assistant"`	`"Optimize"`	Modus, den die Schaltfläche Neues Fenster verwendet
`autoUpdateEnabled`	bool	`true`	Automatische Aktualisierung beim Start zulassen

Optimieren

Einstellung	Typ	Standard	Beschreibung
`defaultOutputAction`	`"CopyToClipboard"` \| `"AutoType"` \| `"PasteToPreviousWindow"`	`"CopyToClipboard"`	Was nach dem Optimieren passiert
`autoTypeDelayMs`	integer	`10`	Verzögerung beim Auto-Tippen in Millisekunden
`defaultTemplateId`	GUID	unset	Standardvorlage für die Optimierung

Sprache

Einstellung	Typ	Standard	Beschreibung
`sttBackend`	`"Parakeet"` \| `"Whisper"`	`"Parakeet"`	Spracherkennungs-Engine
`whisperModel`	`"Tiny"` \| `"Base"` \| `"Small"` \| `"Medium"` \| `"Large"`	`"Base"`	Whisper-Modellgröße (von Parakeet ignoriert)
`ttsEnabled`	bool	`false`	Sprachsynthese aktivieren
`ttsVoiceModelKey`	string	`"en_US-lessac-medium"`	TTS-Stimmen-ID

Anbieter und Personas

Einstellung	Typ	Standard	Beschreibung
`defaultProviderId`	GUID	unset	Anbieter, der verwendet wird, wenn kein modusspezifischer Standard festgelegt ist
`useSameProviderForAllModes`	bool	`true`	Einen KI-Anbieter für Optimieren und Assistent verwenden
`modeProviderDefaults`	object	`{}`	Fenstermodus → Anbieter-GUID
`modePersonaDefaults`	object	`{}`	Fenstermodus → Persona-GUID

Assistent und Dateien

Einstellung	Typ	Standard	Beschreibung
`assistantFilesFolder`	string	unset	Der einzige Ordner, auf den der Assistent zugreifen darf. Leer ⇒ kein Dateizugriff
`assistantDefaultWorkingDirectory`	string	`"Playground"`	Unterordner, in dem neue Chats starten. Leer ⇒ das Stammverzeichnis des Ordners
`assistantFileToolsEnabled`	bool	`true`	Lesen und Schreiben von Dateien in diesem Ordner erlauben
`assistantGitToolsEnabled`	bool	`true`	Erlaubt Git-Befehle in diesem Ordner
`assistantSuggestionsEnabled`	bool	`false`	Vorgeschlagene Prompts bei leerem Chat anzeigen
`assistantAgentModeDefault`	bool	`false`	Startet neue Chats mit dem Chat \| Agent-Schalter auf Agent (keine UI)
`alwaysAllowedTools`	array	`[]`	Dauerhafte Tool-Berechtigungen. Wird auf der Einstellungsseite verwaltet

Chatverlauf

Einstellung	Typ	Standard	Beschreibung
`chatHistoryRetentionDays`	integer	`180`	Löscht Chats, die so viele Tage nicht geöffnet wurden (1–730). Ein favorisierter Chat ist ausgenommen
`chatAutoTitleEnabled`	bool	`false`	Erzeugt einen kurzen Titel pro Chat (kostet einen zusätzlichen Aufruf)

Agentenläufe

Was jedes Limit bedeutet, steht in der Anleitung Agentenläufe.

Einstellung	Typ	Standard	Beschreibung
`agentMaxSteps`	integer	`24`	Maximale Schritte in einem interaktiven Lauf
`maxToolRoundsPerStep`	integer	`24`	Maximale Tool-Runden innerhalb eines Schritts
`agentWallClockMinutes`	integer	`20`	Zeitlimit für einen interaktiven Lauf
`agentMaxReplans`	integer	`2`	Erlaubte Neuplanungen, nachdem ein Schritt fehlschlägt
`agentPlanReasoningTurnEnabled`	bool	`false`	Fügt vor der Planung einen werkzeugfreien Denkschritt hinzu
`agentRunAutoApproveBuiltInWrites`	bool	`false`	Überspringt die Genehmigung für Pias eigene Schreib-Tools in Agentenläufen und im Sprachmodus
`agentPersonaRoster`	object	`{}`	Betriebsmodus → Persona-GUIDs, die der Planer Schritten zuweisen darf
`scheduledMaxSteps`	integer	`24`	Maximale Schritte in einem Hintergrund- oder geplanten Lauf
`scheduledWallClockMinutes`	integer	`45`	Zeitlimit für einen Hintergrund- oder geplanten Lauf
`scheduledMaxReplans`	integer	`2`	Erlaubte Neuplanungen in einem Hintergrund- oder geplanten Lauf
`maxParallelBackgroundRuns`	integer	`2`	Gleichzeitige Hintergrundläufe; weitere reihen sich ein
`maxParallelRequestsPerProvider`	integer	`4`	Gleichzeitige Anfragen, die Pia an einen Anbieter stellt (keine UI)

Meetings und Transkription

Einstellung	Typ	Standard	Beschreibung
`meetingAttendeeDisplayName`	string	unset	Name, der anderen Teilnehmern angezeigt wird. Leer ⇒ „‹dein Name›s Assistent“
`meetingTranscriptFolder`	string	unset	Ordner, in dem sich der Speichern…-Dialog öffnet
`meetingBrowserSelection`	`"BundledChromium"` \| `"SystemChrome"` \| `"SystemEdge"` \| `"SystemDefault"`	`"BundledChromium"`	Welchen Browser Pia steuert
`meetingAttendeeShowBrowserWindow`	bool	`false`	Zeigt das Browserfenster an, statt versteckt beizutreten
`enableMeetingDiarization`	bool	`true`	Teilt das Transkript nach Sprechern auf
`meetingSmartSpeakerDetection`	bool	`true`	Lässt Pia die Sprecherzuordnung selbst abstimmen und korrigieren
`speakerEmbeddingThreshold`	float	`0.50`	Empfindlichkeit der Stimmerkennung (bei ausgeschalteter intelligenter Erkennung)
`meetingMaxSpeakers`	integer	`0`	Obergrenze für unterschiedliche Sprecher. `0` ⇒ kein Limit
`meetingMinSpeechSeconds`	float	`1.5`	Sprechdauer, die nötig ist, bevor ein Sprecher erkannt wird
`meetingAttendeeRosterSnapshotMinutes`	integer	`2`	Wie oft die Teilnehmerliste neu eingelesen wird (keine UI)

Gedächtnis und Datenschutz

Einstellung	Typ	Standard	Beschreibung
`autoIngestSources`	bool	`true`	Nimmt Dokumente, die im `sources`-Ordner des Vaults abgelegt werden, ins Gedächtnis auf
`privacy.tokenizationEnabled`	bool	`true`	Persönliche Daten durch Tokens ersetzen, bevor Text an einen Anbieter gesendet wird
`privacy.piiKeywords`	array	`[]`	Eigene private Schlüsselwörter

Sync und Server

Einstellung	Typ	Standard	Beschreibung
`syncEnabled`	bool	`false`	Pia Cloud Sync aktivieren
`serverUrl`	string	unset	Server-URL, für Self-Hosting
`trustSelfSignedCertificates`	bool	`false`	Selbstsignierte TLS-Zertifikate akzeptieren

Schlüssel, die Pia selbst verwaltet

settings.json enthält außerdem Zustand, der keine Einstellung ist: Anmeldedaten, Verschlüsselungs-Schlüsselmaterial und Geräte-IDs, Sync-Zeitstempel und ETags, Fenstergeometrie, Entwurfstexte, Spaltenbreiten und Schema-Versionsmarker. Lass diese unangetastet — sie zu bearbeiten kann dich abmelden oder, im Fall der Verschlüsselungsschlüssel, dich von deinen eigenen Daten aussperren.