agentic-studio/network-poc

Kipinä Agentic Network PoC (WebGPU Edition)

Tämä on hajautetun tekoälylaskennan (Agentic Compute) kokeilulaboratorio. Projekti koostuu Rust-pohjaisesta keskuksesta (Hub) ja selainpohjaisista työntekijöistä (Nodet), jotka suorittavat tekoälytensoreiden matriisilaskentaa WebGPU-rajapintaa ja Burn AI -koneoppimiskirjastoa hyödyntäen.

Normaalin keskitetyn palvelimen sijaan tämä kokeilu hyödyntää selaimeen kytkettyjen lukemattomien laitteiden vapaana olevaa tehokapasiteettia hajautetusti P2P-tyylillä.

Kuinka käynnistää projekti paikallisesti

1. Rakenna solmun WebAssembly-binääri Paketoi Rust WebAssemblyksi (vaatii wasm-pack-työkalun):

cd node
wasm-pack build --target web --out-dir ../static/pkg

2. Käynnistä Hub-Keskuspalvelin

cd hub
cargo run

Palvelin lähtee pyörimään ja tarjoamaan sekä WebSocket-reititintä että staattista Dashboard-sivustoa lokaalisti portissa 3000.

---

⚠️ WebGPU Ota-Käyttöön -ohjeet (Linux / Mac / Win)

Selainvalmistajat rajoittavat tällä hetkellä uuden WebGPU-rajapinnan hardware-yhteyttä (fyysiseen näytönohjaimeen) turvallisuus- ja vakaussyistä, erityisesti Linuxin Wayland-ympäristöissä (kuten Pop!_OS, Ubuntu).

Päästäksesi hyödyntämään solmun laskentatehoa selaimesi ja tietokoneesi näytönohjaimen läpi, joudut todennäköisesti pakottamaan sen käyntiin.

Chromium-pohjaiset selaimet (Google Chrome, Brave, Chromium)

Vaihtoehto 1: Käynnistys lipuilla (Suositeltu Linuxille ja Waylandille) Jos Chromesi tuottaa Wasm-kaatumisia tai väittää ettei adapteria löydy, laitteesi Wayland-palvelin estää Vulkan-rajapinnan oletuksena. Käynnistä selaimesi komentoriviltä pakottamalla vanha X11-ikkunointi ja Vulkan:

# Google Chrome
google-chrome --enable-unsafe-webgpu --enable-features=Vulkan --ignore-gpu-blocklist --use-angle=vulkan --ozone-platform=x11

# Brave Browser
brave-browser --enable-unsafe-webgpu --enable-features=Vulkan --ignore-gpu-blocklist --use-angle=vulkan --ozone-platform=x11

# Chromium
chromium-browser --enable-unsafe-webgpu --enable-features=Vulkan --ignore-gpu-blocklist --use-angle=vulkan --ozone-platform=x11

(Voit halutessasi testata puhdasta testi-ikkunaa erillisen profiilin kera, lisäämällä perään --user-data-dir=/tmp/kipin-webgpu-test jottei asetus sotke tai ohjaudu vanhaan auki olevaan sessioosi).

Vaihtoehto 2: Sisäänrakennetun Flagin kääntö (Windows / Mac / Osittain Linux)

1. Kirjoita selaimen osoiteriville chrome://flags (tai brave://flags)
2. Etsi hakusanalla WebGPU (Unsafe WebGPU / WebGPU Developer Features) ja vaihda tilaksi Enabled
3. Etsi hakusanalla Vulkan ja vaihda tilaan Enabled
4. Uudelleenkäynnistä selain pienen napin kautta.

---

Mozilla Firefox

Firefox tukee WebGPU:ta toistaiseksi vahvasti vain Nightly-versioissa, mutta sitä voi yrittää aktivoida Config-asetuksista.

1. Kirjoita osoiteriville about:config ja ymmärrä riskit.
2. Etsi dom.webgpu.enabled ja tuplaklikkaa arvoksi true.
3. Etsi gfx.webrender.all ja aseta se true.
4. Uudelleenkäynnistä Firefox.

(Huomio Linux-käyttäjille: Firefox saattaa edellyttää MOZ_ENABLE_WAYLAND ympäristömuuttujaa).

---

Apple Safari (Mac)

Apple käyttää konepellin alla vahvaa omaa Metal-rajapintaansa ja tukee WebGPU:ta uudemmissa Safari-versioissa kehittäjäasetusten takaa:

1. Varmista ensin Safarin asetuksista (Preferences -> Advanced) , että ruutu on ruksittu kohdasta "Show Develop menu in menu bar".
2. Valitse yläpalkista avautuva Develop-valikko -> Feature Flags.
3. Etsi listalta WebGPU ja laita siihen täppä pelastamaan tilanne.
4. Päivitä Dashboard-sivu.