install_desktop Instalacja · Bez opłat licencyjnych & open source

Klacks u siebie — na własnej infrastrukturze.

Trzy drogi, jeden rezultat: pakiet Windows na komputer biurowy, prowadzony instalator na Państwa serwer albo stack Docker Compose dla własnej konfiguracji — bez rejestracji, bez opłat licencyjnych. Na komputerze biurowym kraj wybierają Państwo podczas instalacji; dla serwera i Docker Compose pakiet krajowy zawiera od razu święta państwowe, reguły czasu pracy i branżowe ustawienia wstępne Państwa kraju (dodatki, o ile zdefiniowano je dla danego kraju).

Pakiet krajowy

Wybór branży — opcjonalnie

Państwa wybór zostaje zapisany w profilu krajowym jako ustawienie wstępne i decyduje, które moduły branżowe będą aktywne przy pierwszym uruchomieniu. Pakiet zawsze zawiera wszystkie branże — kolejne mogą Państwo w każdej chwili aktywować w aplikacji.

computer

Na komputerze biurowym (bez Dockera)

Dla firm z jednym komputerem biurowym: plik instalacyjny dla Windows — bez Dockera i bez własnego serwera. Baza danych, Klacks i usługa aktualizacji działają jako usługi Windows w tle, aktualizacje przychodzą automatycznie, a Państwa dane pozostają na tym komputerze.

Wymagania

check_circle Windows 11 (64-bit)
check_circle Działa także w systemie Windows 10 22H2 (64-bit). Microsoft zakończył standardowe wsparcie dla Windows 10; aktualizacje zabezpieczeń są dostępne już tylko w ramach płatnego programu ESU.
check_circle Z Klacks korzysta się bezpośrednio na tym komputerze — dostęp z innych urządzeń w sieci nie jest jeszcze obsługiwany
check_circle Połączenie z internetem przy pierwszym uruchomieniu (modele AI, ok. 700 MB) oraz do aktualizacji
check_circle Uprawnienia administratora do instalacji

W trzech krokach

1

Pobranie pliku instalacyjnego Klikają Państwo „Pobierz dla Windows”. Plik „Klacks-Setup-win-x64.exe” trafia zwykle do folderu „Pobrane”.
2

Dwuklik i wybór kraju Klikają Państwo dwukrotnie plik. Jeśli Windows SmartScreen wyświetli ostrzeżenie, otwierają Państwo dodatkowe informacje i wybierają uruchomienie mimo to — plik instalacyjny nie ma jeszcze podpisu cyfrowego. Następnie potwierdzają Państwo prośbę o uprawnienia administratora. W kreatorze wybierają Państwo kraj (święta, strefa czasowa, reguły czasu pracy) i w razie potrzeby skrót na pulpicie. Kreator pokazuje postęp; instalacja trwa kilka minut.
3

Otwarcie Klacks i logowanie Na końcu wybierają Państwo otwarcie Klacks w przeglądarce. Później Klacks znajduje się w menu Start pod nazwą „Klacks” (lub pod adresem http://localhost:5180). Logują się Państwo kontem początkowym, które kreator pokazuje na końcu, i zakładają własne konto administratora. Jeśli Klacks jeszcze się uruchamia, warto odczekać kilka minut — pierwsze uruchomienie trwa nieco dłużej.

download Pobierz dla Windows

Dla 64-bitowego systemu Windows (x64). Na urządzeniach z Windows 11 i procesorem ARM (np. Snapdragon X) Klacks działa dzięki emulacji; Windows 10 na ARM nie jest obsługiwany.

Dla Maca: wkrótce.

Linux? Szczegóły poniżej: Klacks na komputerze z Linuksem.

Odinstalowanie: Klacks usuwa się jak każdy inny program Windows — otwierają Państwo Ustawienia › Aplikacje, wyszukują pozycję „Klacks” i ją odinstalowują. Deinstalator pyta, czy usunąć również bazę danych, ustawienia i kopie zapasowe. Przy odpowiedzi „nie” Państwa dane pozostają w C:\ProgramData\Klacks, a późniejsza ponowna instalacja znów z nich korzysta.

dns

Prowadzony instalator

Prowadzona droga na własny serwer: skrypt instalacyjny generuje sekrety i samopodpisany certyfikat, pobiera najnowszą opublikowaną wersję i uruchamia cały stack — na Linuksie lub Windows.

Wymagania

check_circle Docker Desktop (Windows) lub Docker Engine z wtyczką Compose (Linux)
check_circle Wychodzący dostęp do ghcr.io i github.com (obrazy i aktualizacje)
check_circle Wolne porty 80 i 443 (konfigurowalne)

Trzy kroki

1

Pobranie i rozpakowanie Pobierają Państwo plik ZIP dla swojego kraju i rozpakowują go na maszynie docelowej.
2

Uruchomienie skryptu instalacyjnego Na Linuksie uruchamiają Państwo dołączony skrypt powłoki, na Windows skrypt PowerShell. Generuje on sekrety i certyfikat, wprowadza profil krajowy i czeka, aż cały stack będzie gotowy do pracy.
3

Logowanie i zmiana hasła Logują się Państwo w przeglądarce i natychmiast zmieniają hasło początkowe podane w dołączonym pliku README.

download Pobierz pakiet instalacyjny

klacks-onprem-pl-all.zip

deployed_code

Docker Compose

Bezpośrednia droga dla zespołów, które samodzielnie zarządzają swoimi stackami kontenerowymi: docker-compose.yml, konfiguracja nginx, skrypty inicjalizacyjne, profil krajowy i przygotowany szablon .env ze wszystkimi zmiennymi — pełna kontrola pozostaje w Państwa rękach.

Wymagania

check_circle Docker Engine z wtyczką Compose (lub Docker Desktop)
check_circle Wychodzący dostęp do ghcr.io i github.com (obrazy i aktualizacje)
check_circle Doświadczenie w utrzymywaniu stacków Docker Compose

Trzy kroki

1

Pobranie i rozpakowanie Pobierają Państwo ZIP Compose dla swojego kraju i rozpakowują go — dołączony README prowadzi przez każdy krok.
2

Konfiguracja .env Kopiują Państwo szablon .env.example do .env i ustawiają nazwę serwera oraz hasła/sekrety. Ścieżka do profilu krajowego jest już wstępnie wypełniona.
3

Uruchomienie stacka Wykonują Państwo „docker compose up -d”, logują się w przeglądarce i natychmiast zmieniają hasło początkowe.

download Pobierz pakiet Compose

klacks-compose-pl-all.zip

terminal

Na komputerze z Linuksem

Prosta droga dla komputera z Linuksem, także bez wcześniejszej wiedzy: pobierają Państwo pakiet i jeden raz wpisują polecenie w terminalu — resztą zajmie się instalator. Klacks działa potem z Dockerem na tym komputerze, aktualizacje przychodzą automatycznie, a Państwa dane pozostają na tym komputerze.

Wymagania

check_circle 64-bitowy Linux z pulpitem graficznym: Ubuntu, Debian lub Fedora. Inne dystrybucje (np. Linux Mint) nie są oficjalnie obsługiwane — tam prosimy najpierw samodzielnie zainstalować Dockera.
check_circle Zalecane 16 GB pamięci RAM, ponieważ równolegle działają przeglądarka i pulpit. Poniżej ok. 8 GB instalator przerywa pracę.
check_circle Połączenie z internetem przy pierwszym uruchomieniu oraz do aktualizacji
check_circle Hasło administratora (hasło sudo) tego komputera

download Pobierz dla Linuksa

klacks-onprem-pl-all.zip

W trzech krokach

1

Pobranie pakietu i rozpakowanie do stałego folderu Pobierają Państwo plik ZIP i rozpakowują go do folderu, który pozostanie na stałe, np. do folderu „klacks” w folderze domowym — nie do folderu „Pobrane”. Automatyczne aktualizacje korzystają z tego folderu; jeśli zostanie usunięty, aktualizacje przestaną działać.
2

Otwarcie terminala i wpisanie polecenia W folderze z rozpakowanymi plikami instalacyjnymi klikają Państwo prawym przyciskiem myszy, wybierają „Otwórz w terminalu”, wpisują poniższe polecenie i potwierdzają je hasłem (podczas wpisywania nie jest ono wyświetlane). Jeśli brakuje Dockera, instalator zaproponuje jego instalację: należy odpowiedzieć „y” — trwa to kilka minut. Terminal jest potrzebny do instalacji tylko ten jeden raz; jeśli później uruchomią Państwo instalator ponownie (np. w celu naprawy), należy użyć tego samego polecenia razem z sudo.sudo bash install-pl.sh
3

Otwarcie w przeglądarce i logowanie Otwierają Państwo https://localhost w przeglądarce. Przeglądarka ostrzega przed certyfikatem — ostrzeżenie należy potwierdzić („Zaawansowane”, a następnie „Przejdź dalej” lub „Akceptuję ryzyko”). Logują się Państwo kontem początkowym z pliku README w folderze i natychmiast zmieniają hasło.

lock

O ostrzeżeniu dotyczącym certyfikatu: podczas instalacji Klacks tworzy własny certyfikat, którego Państwa przeglądarka nie zna — stąd ostrzeżenie. Połączenie jest mimo to szyfrowane.

description

Sam profil — dla istniejących instalacji

Klacks już u Państwa działa? Profil (JSON) zawiera krajowe ustawienia wstępne — święta państwowe, reguły czasu pracy, dodatki (o ile zdefiniowano je dla danego kraju) i branże — i jest wczytywany przy pierwszym uruchomieniu instalacji. To także sposób, aby później dodać kolejną branżę wraz z jej ustawieniami wstępnymi.

description Pobierz profil (JSON)

Warto wiedzieć

code

Open source (AGPL-3.0)

Kompletny kod źródłowy jest publicznie dostępny na GitHub na licencji AGPL-3.0 — bez opłat licencyjnych, bez vendor lock-in.

storage

Dane znajdują się na Państwa serwerach

Klacks działa na Państwa infrastrukturze. Dane kadrowe i grafiki znajdują się na Państwa serwerze — nie ma przymusu chmury. Tylko jeśli wybiorą Państwo zewnętrznego dostawcę AI, zapytania trafiają do niego; z modelem lokalnym żadne zapytanie AI nie trafia do zewnętrznego dostawcy.

update

Aktualizacje

Usługa aktualizacji automatycznie wdraża nowo opublikowane wersje — w Dockerze jako usługa wewnątrz stacka, na komputerze biurowym jako usługa Windows w tle.

lock

HTTPS z Dockerem

Instalator generuje samopodpisany certyfikat na start — w każdej chwili mogą Państwo przejść na własny certyfikat. Hasło początkowe należy zmienić zaraz po pierwszym logowaniu. Pakiet Windows na komputer biurowy działa bez certyfikatu pod adresem http://localhost:5180.

Najpierw wypróbować, potem zainstalować?

W Playgroundzie przetestują Państwo Klacks bezpośrednio w przeglądarce na przykładowych danych — bez instalacji i bez rejestracji. Mogą Państwo także zajrzeć do kodu źródłowego na GitHub.

code Zobacz na GitHub