Instalace nástroje AnythingLLM

·

AnythingLLM na Windows 11: Instalace a řešení tichého pádu při startu

Krátký návod, jak nainstalovat AnythingLLM desktop verzi na Windows 11, popřípadě jak vyřešit častý problém, kdy se aplikace po spuštění jen krátce mihne v oznamovací oblasti a hned zase spadne.

Obsah článku:

Co je AnythingLLM

AnythingLLM je samostatná desktopová aplikace pro práci s AI/LLM modely. Má vlastní vestavěný backend i databázi, takže ke svému běhu nepotřebuje mít spuštěné žádné externí nástroje (např. LM Studio).

Instalace

  1. Stáhněte instalátor z oficiálních stránek AnythingLLM.
  2. Spusťte instalaci standardním způsobem (Next → Next → Install).
  3. Po instalaci najdete aplikaci ve složce s programy (viz níže).
C:\Users\<uživatel>\AppData\Local\Programs\AnythingLLM\AnythingLLM.exe

Problém: aplikace se jen mihne a zmizí

Typický příznak: po spuštění se v oznamovací oblasti u hodin krátce ukáže ikonka, poté zmizí, žádné okno se neotevře. Při vypínání počítače se navíc objeví hláška, že je potřeba potvrdit ukončení AnythingLLM — proces tedy zůstává viset na pozadí, i když navenek nic neběží.

Krok 1 – zjistit skutečnou chybu

Tichý pád v tray liště většinou znamená, že chyba se odehrává na pozadí a normální okno ji nezobrazí. Abyste chybu uviděli, spusťte aplikaci přímo z PowerShellu:

& "$env:LOCALAPPDATA\Programs\AnythingLLM\AnythingLLM.exe"

V mém případě se objevilo tohle:

[ERROR:gpu_process_host.cc(1002)] GPU process exited unexpectedly: exit_code=-1073741515
[FATAL:gpu_data_manager_impl_private.cc(449)] GPU process isn't usable. Goodbye.

Kód -1073741515 odpovídá 0xC0000005 (Access Violation) – pád při přístupu do paměti, typicky spojený s grafickým procesem nebo bezpečnostní izolací (sandboxem), kterou si Electron aplikace (na této technologii AnythingLLM běží, stejně jako třeba Discord nebo VS Code) vytváří sama.

Krok 2 – vyzkoušené postupy

Než jsem se dostal k finálnímu řešení, zkusil jsem několik věcí, které nepomohly, ale stojí za zmínku, protože jsou to legitimní kroky k prověření:

  • Aktualizace ovladačů NVIDIA – u sestav s přepínatelnou grafikou (integrovaná + dedikovaná karta, v mém případě RTX 3050) může Electron aplikace omylem naskočit na slabší integrovaný čip. Ověřit/aktualizovat ovladače lze přímo na stránkách NVIDIA bez nutnosti instalovat NVIDIA App.
  • Vynucení dedikované grafické karty ve Windows: Nastavení → Systém → Zobrazení → Grafika → přidat aplikaci → Možnosti → Vysoký výkon. Užitečné nastavení obecně (hodí se i pro náročnější software jako DaVinci Resolve), ale v tomto případě problém nevyřešilo.
  • Kontrola Windows Defenderu (Zabezpečení Windows → Ochrana před viry a hrozbami → Historie ochrany) – u někoho může antivirus blokovat soubory aplikace, u mě nic nenašel.
  • Vymazání konfigurační složky %APPDATA%\anythingllm-desktop – pro vyřešení poškozené konfigurace, v mém případě bez efektu.

Krok 3 – funkční řešení

Aplikaci se podařilo spustit spuštěním se dvěma parametry najednou:

& "$env:LOCALAPPDATA\Programs\AnythingLLM\AnythingLLM.exe" --disable-gpu --no-sandbox
  • --disable-gpu – vypne grafickou akceleraci, aplikace se vykresluje softwarově.
  • --no-sandbox – vypne bezpečnostní izolaci procesu, kterou si Chromium/Electron vytváří sám.

U mě padaly obě tyto věci současně, proto samotné --disable-gpu (běžné první doporučení) nestačilo.

Krok 4 – natrvalo do zástupce

Aby nebylo nutné aplikaci spouštět pokaždé přes PowerShell, parametry se dají zapsat přímo do zástupce:

  1. Pravý klik na zástupce AnythingLLM (na ploše nebo ve Start menu) → Vlastnosti
  2. V poli Cíl upravit hodnotu na (uvozovky kolem cesty jsou nutné, protože cesta obsahuje mezery):
"C:\Users\<uživatel>\AppData\Local\Programs\AnythingLLM\AnythingLLM.exe" --disable-gpu --no-sandbox

Poté klikněte OK. Od teď spustí aplikaci správně i běžný dvojklik na ikonu.

Shrnutí

PříznakPříčinaŘešení
Ikonka se mihne a zmizí, žádné oknoTichý pád na pozadíSpustit z PowerShellu pro zobrazení chyby
GPU process exited unexpectedlyPád grafického procesu--disable-gpu
Pád přetrvává i s –disable-gpuPád sandboxupřidat i --no-sandbox
Nutnost spouštět přes PowerShell pokaždé—parametry zapsat do zástupce (pole Cíl)

Poznámka k bezpečnosti: --no-sandbox snižuje izolaci procesu vůči systému. Pro běžné desktopové použití je to v pořádku, ale nedoporučuje se tento parametr paušálně přidávat jiným aplikacím bez důvodu.

Přesnou příčinu (konkrétní ovladač, bezpečnostní software nebo systémové omezení, které GPU procesu a sandboxu brání) se nepodařilo dohledat, ale uvedený obchvat funguje spolehlivě.