Přeskočit obsah

Řešení problémů

Tato stránka obsahuje diagnostiku a opravy nejčastějších technických problémů. Pro otázky o použití viz FAQ.

Launcher se nespouští

Příznak

Dvojklik na avax-launcher2.exe → nic se nestane, nebo crash window.

Diagnostika

  1. Antivirus — některé antiviry (ESET, Bitdefender) blokují PyInstaller .exe.

    • Otevřete antivirus log, podívejte se zda blokoval avax-launcher2.exe.
    • Přidejte do výjimek.

  2. Missing DLL — Windows 10 vyžaduje Visual C++ Redistributable.

  3. Permission denied — pokud máte launcher v C:\Program Files\, vyžaduje admin práva.

    • Pravý klik → Spustit jako správce.
    • Nebo přesuňte do C:\Users\<vy>\Avaxis\.

Console log (advanced)

Otevřete launcher z příkazové řádky:

cd C:\Users\<vy>\Avaxis
.\avax-launcher2.exe --console

Uvidíte stack trace pokud nějaký.

Nemohu se přihlásit

„Špatné heslo" — ale heslo je správně

  • Caps Lock? — zkontrolujte.
  • 3× špatně = účet zamknut na 15 minut. Počkejte.
  • Reset hesla — odkaz „Zapomenuté heslo" pošle email.

„Server nedostupný"

  1. Zkontrolujte síť — otevřete v prohlížeči https://api.avaxis.cz/health → mělo by vrátit JSON {"status":"ok"}.
  2. Pokud ano: launcher má špatnou backend URL → Předvolby → Síť → reset na default.
  3. Pokud ne: AVAX server má problém. Status na status.avaxis.cz (zatím TBD).

„Email není ověřen"

Po registraci jste neaktivovali email. Email s odkazem dorazil? Spam? Pokud ne, kontaktujte support@avaxis.cz s IČO.

Synchronizace se zasekla

Příznak

Status bar ukazuje ⟳ Synchronizace: nahráno X / staženo Y ale počty se nemění.

Diagnostika

  1. Síť — ping s3.avaxis.cz — funguje?
  2. Volné místo na S3 — Předvolby → Zálohování → Statistiky → vidíte limit?
  3. Velké soubory — sync souboru > 1 GB může trvat hodiny při pomalé síti.

Restart synchronizace

Předvolby → Synchronizace → Restart agent → zastaví worker thread a znovu spustí.

Nebo zcela reset: zavřete launcher → smažte %LOCALAPPDATA%\Avaxis\sync-state.db → spusťte launcher znovu. Pozor: znovu se přepočítá hash všech souborů (může trvat hodiny pro velké složky).

Konflikt blokuje sync

Pokud sync čeká na manuální resolution kolize:

  • Sekce Synchronizace → kolize s ⚠ ikonou → klik → vyberte verzi.

Aplikace neběží

Příznak

Klik Spustit na aplikaci → nic se nestane / chybové okno.

Diagnostika

  1. Update čeká — Sidebar Aplikace → karta aplikace → vidíte „Aktualizace dostupná"? Klikněte.
  2. Backend offline — aplikace volá svůj backend container. Pokud gateway / container nedostupný, klient zobrazí chybu.
  3. Lokální cache poškozený — pravý klik na aplikaci → Resetovat cache.

Backend status

Otevřete v prohlížeči:

https://api.avaxis.cz/apps/<slug>/health

Příklad pro Zákony: https://api.avaxis.cz/apps/app-legal/health → mělo by vrátit {"status":"ok"}.

Pokud ne, kontaktujte support.

Chat nefunguje

Příznak

V chatu zprávy zůstávají na ⏳ Posílá se a nedojdou.

Diagnostika

  1. Online status — zelená tečka u top bar — jste online? Pokud ne, problém s sítí.
  2. WebSocket — chat používá long-poll fallback pokud WS selže. Předvolby → Síť → vypněte WS preference.

Hovor selže (no audio / video)

  1. Mikrofon / kamera — Windows Nastavení → Soukromí → Mikrofon → AVAX Launcher povolen?
  2. Firewall — povolte UDP 49152–65535 (WebRTC).
  3. NAT traversal — pokud jste za striktním firewall, AVAX použije TURN fallback. Předvolby → Síť → Force TURN.

AI asistent neodpovídá

Příznak

V Podpoře → AI → odeslání dotazu → status zustává ⏳ Píšu… indefinitely.

Diagnostika

  1. LLM server offline — AVAX Admin → 🤖 AI → Servery → Ping na server. Pokud failed, server je down.
  2. Timeout — pokud LLM odpovídá pomalu (velký model + dlouhý prompt), může trvat 30+ s. Počkejte.
  3. Žádný asistent — možná default asistent neexistuje. AVAX Admin → AI → Asistenti → vytvořte alespoň jeden s is_active=true.

Asistent halucinuje (nesprávné odpovědi)

LLM má cutoff date modelu a občas vymyslí. Vždy ověřte:

  • 🔗 Sources — pokud RAG citace neexistují / nesouhlasí, odpověď je halucinace.
  • Pro fakty verifikujte přes oficiální zdroj.

Tray ikona zmizela

Příznak

Launcher běží (Task Manager ho vidí), ale tray ikona není viditelná.

Oprava

  • Klikněte ▲ vpravo v Windows tray → drag and drop ikonu AVAX ven.
  • Nebo restart Explorer: Task Manager → Windows Explorer → Restart.

Lokální data jsou poškozená

Příznak

Aplikace nečte data, padá s „database is locked" / „corruption detected".

Oprava

  1. Zálohu hned — kopírujte %LOCALAPPDATA%\Avaxis\apps\<slug>\data\ mimo (záloha).
  2. Reset cache — pravý klik na aplikaci v katalogu → Resetovat cache.
  3. Pokud nepomáhá, odeberte a znovu nainstalujte aplikaci. Data v cloudu zůstávají, lokálně se znovu stáhnou.

Pomalý launcher

Diagnostika

  1. Příliš mnoho synchronizovaných souborů — počet souborů v sledovaných složkách. Pokud > 100k, sync přetěžuje.
  2. Antivirus skenuje sync — přidejte %LOCALAPPDATA%\Avaxis\ do výjimek antiviru.
  3. Stará verze launcheru — Předvolby → O AVAX → zkontrolujte verzi, aktualizujte.

Performance log

Předvolby → Pokročilé → Performance metrics → ukáže CPU/RAM usage launcheru per komponenta.

Reset všechno

Pokud nic nepomáhá:

  1. Předvolby → Pokročilé → Export logů → zip soubor pro support.
  2. Předvolby → Pokročilé → Resetovat všechny předvolby.
  3. Pokud stále problém, přeinstalujte launcher:
    • Smažte %LOCALAPPDATA%\Avaxis\ (lokální data se ztratí, ale cloud zůstává).
    • Odhlaste se ze všech zařízení (Předvolby → Účet → Odhlásit ze všech zařízení).
    • Stáhněte fresh launcher z avaxis.cz/download.

Kontakt support

  • Email: support@avaxis.cz
  • Telefon: TBD (Q3 2026)
  • AI asistent: Sidebar → 🎧 Podpora → AI sekce.

Při kontaktu support přiložte:

  • Verze launcheru (Předvolby → O AVAX).
  • Windows verze (Win+R → winver).
  • IČO firmy.
  • Stručný popis problému + co jste zkusili.
  • Export logů (Předvolby → Pokročilé → Export logů).

Hardware / OS bugy

„Aplikace přestala fungovat"

Windows crash log:

# Event Viewer → Windows Logs → Application → Error level
# Hledejte „avax-launcher2.exe"

Pošlete stack trace na support.

„Není dostatek paměti"

Launcher používá ~150-300 MB RAM. Pokud máte 4 GB RAM, může to být úzké. Zavřete jiné aplikace nebo upgradujte RAM.

„Windows Defender blokuje launcher"

# Add-MpPreference -ExclusionPath "C:\Users\<vy>\Avaxis\"

Spustit jako admin v PowerShell. Přidá launcher do výjimek Windows Defender.