KOAI v2026.08.03.2

Windows telepítés

A KOAI-Setup-...-Windows.exe a KOAI alkalmazás telepítője. Elindítod, végigmegy,
és utána a Start menüből (kérésre az asztalról is) indul a KOAI. Alapból csak a
saját felhasználódnak telepít, így nem kér rendszergazdai jogot; a telepítő első
lapján váltható gépszintű telepítésre.

A következő kiadás telepítője felismeri a meglévő telepítést, és a helyére kerül —
nem marad ott két kicsomagolt másolat. Az adataid (adatbázis, letöltött modellek,
böngészőprofilok) a felhasználói mappádban maradnak, ezekhez sem a frissítés, sem az
eltávolítás nem nyúl. Ha hiányzik a WebView2 futtatókörnyezet, a telepítő felajánlja,
hogy letölti a Microsofttól.

A KOAI-MAUI-...-Windows.zip továbbra is megmarad annak, aki telepítés nélkül,
kicsomagolva szeretné futtatni.

Cowork relay telepítők

A relay az, amin keresztül a KOAI-eszközeid megtalálják egymást és átadják a munkát —
akkor is, ha a másik gép éppen ki van kapcsolva. Mostantól mindhárom rendszerhez jár
telepítő, és mindegyik magában hordozza a relayt, tehát egyetlen fájlt kell letölteni:

Rendszer	Fájl
Windows	KOAI-Relay-Setup-v2026.08.03.2-Windows.exe
Linux (Intel/AMD)	KOAI-Relay-Setup-v2026.08.03.2-Linux-x64.sh
Linux (ARM, pl. Raspberry Pi)	KOAI-Relay-Setup-v2026.08.03.2-Linux-arm64.sh
macOS (Apple Silicon)	KOAI-Relay-Setup-v2026.08.03.2-macOS-arm64.sh
macOS (Intel)	KOAI-Relay-Setup-v2026.08.03.2-macOS-x64.sh

Windowson dupla kattintás: varázsló kérdezi végig a portot, az eszközök által használt
címet, a HTTPS módot (nincs / önaláírt / Let's Encrypt) és azt, ki jelentkezhet be.
Ezután regisztrálja a KoaiRelay szolgáltatást, megnyitja a tűzfalportot, kiteszi a
vezérlőpultot a tálcára, és megvárja, amíg a relay válaszol a /health címen.

Linuxon és macOS-en ugyanezek a kérdések a terminálban:

chmod +x KOAI-Relay-Setup-*.sh
sudo ./KOAI-Relay-Setup-*.sh

A telepítő kicsomagolja magát, systemd- (Linux) vagy launchd- (macOS) szolgáltatást
készít, és ellenőrzi, hogy fut-e. A --dry-run megmutatja a beállításokat anélkül,
hogy bármit módosítana; a --help felsorolja a kapcsolókat a felügyelet nélküli
telepítéshez.

Ez a relay csak a tiéd

A kiadásban szereplő telepítők nem tudnak publikus, bárki által használható relayt
csinálni — és nem csak a telepítő tiltja: maga a relay program sincs úgy lefordítva,
hogy létezzen benne nyitott üzemmód. Ha utólag beírod a konfigurációs fájlba, a relay
nem indul el, hanem megmondja, miért. A relayre kizárólag te lépsz be: az
általad megadott GitHub-fiókkal, vagy e-mail cím és jelszó párossal, amit a KOAI appból
hozol létre rajta (az első létrehozott fiók lesz a tulajdonos, utána csak meghívókóddal
lehet továbbiakat regisztrálni). A --public kapcsolót a telepítő hibaüzenettel
utasítja vissza, nem csendben hagyja figyelmen kívül.

Az újrafuttatás frissítés: az adatbázis, a tanúsítvány és a beléptetett eszközök
érintetlenek maradnak, így az appba bemásolt önaláírt ujjlenyomat is érvényes marad.

macOS telepítés Developer ID nélkül

Ez a build jelenleg nincs Apple Developer ID-val aláírva és nincs notarizálva. Ez szándékos a jelenlegi fejlesztői/preview terjesztési modellben.

Első indításkor macOS Gatekeeper figyelmeztetés jelenhet meg.

Ajánlott megnyitás:

1. Másold a KOAI.app alkalmazást az Applications mappába.
2. Control-click / jobb klikk az alkalmazáson.
3. Válaszd az Open / Megnyitás opciót.
4. A megjelenő ablakban válaszd újra az Open / Megnyitás lehetőséget.

Alternatíva:
System Settings → Privacy & Security → Open Anyway

Ha továbbra is blokkolja:
xattr -dr com.apple.quarantine /Applications/KOAI.app

Csak akkor futtasd ezt, ha megbízol a letöltött buildben.

Local HTTPS certificate

A KOAI helyi böngésző/bridge tanúsítványa nem azonos az app aláírásával. Ha a böngészőintegrációhoz külön tanúsítvány telepítése szükséges, azt a KOAI beállításain belül vagy a mellékelt INSTALL_MACOS_UNSIGNED.md alapján kell jóváhagyni.

App signing steps

1. This build is ad-hoc signed only, not Apple Developer ID signed.
2. It is not notarized by Apple, so Gatekeeper can block the first launch.
3. Move KOAI.app to Applications before opening it.
4. Use Control-click -> Open, then confirm Open again in the macOS dialog.
5. If Gatekeeper still blocks launch, use System Settings -> Privacy & Security -> Open Anyway.
6. Use xattr -dr com.apple.quarantine /Applications/KOAI.app only if you trust the downloaded build.
7. Treat local HTTPS certificate approval as separate from app signing.