Instalacja Mike lokalnie — Kompletny przewodnik

Ponieważ chciałem uruchomić Mike całkowicie lokalnie tzn. na moim komputerze, w dodatku z bazą danych i modelem działającymi także na moim komputerze, musiałem nieco zmodyfikować instrukcję Mike dostępną tutaj. Instrukcja jest w dodatku bardzo lakoniczna, dlatego uzupełniłem ją nieco.

Na bazie mojego czatu z Claude, który poprowadził mnie przez cały proces, przygotowałem instrukcję lokalnej instalacji krok po kroku.

Takiej instrukcji brakuje w oficjalnych materiałach Mike, więc udostępniam ją jako odrębny dokument.

1. Wymagania wstępne

Narzędzie	Wersja	Uwagi
Windows	10/11 64-bit x64	Można na innych systemach, ale ja działałem na Windows
Node.js	20+
npm	dowolna	instaluje się z Node.js
git	dowolna
Docker Desktop	najnowsza	wymaga akceptacji licencji przy starcie
LM Studio albo klucze API do wybranego modelu	najnowsza	Jeżeli chcesz wszystko lokalnie, to trzeba pobrać i załadować model z hugging face (polecam Gemma 4 od Google).

---

2. Instalacja krok po kroku

• Komendy wpisujemy w wierszu poleceń!
• Ścieżki plików i folderów (D:\Mike itp.) dostosowujemy pod swoje warunki (jeżeli zmieniacie lokalizację pomiędzy dyskami np. C:\Pobrane na D:\Mike to trzeba dodać flagę: /d tak jak w pierwszym kroku) 

Krok 1 — Pobranie repozytorium Mike z github

cd /d D:\Mike

git clone https://github.com/willchen96/mike.git

cd mike

Krok 2 — Uruchomienie Docker Desktop

Otwórz Docker Desktop z menu Start i poczekaj aż ikona w zasobniku przestanie się animować.

Krok 3 — Uruchomienie MinIO (storage lokalny)

docker run -d -p 9000:9000 -p 9001:9001 –name minio -v D:\Mike\storage:/data minio/minio server /data –console-address „:9001”

Następnie wejdź na http://localhost:9001 (login: minioadmin / hasło: minioadmin) i utwórz bucket o nazwie mike.

Krok 4 — Instalacja i uruchomienie Supabase

npm install -g supabase

cd D:\Mike\mike

npx supabase init

npx supabase start

Po uruchomieniu zapisz klucze, które wyświetlą się w terminalu — będą potrzebne w plikach .env.

Krok 5 — Konfiguracja zmiennych środowiskowych

Najpierw w terminalu wydaj komendę i zapisz wynik:

node -e „console.log(require(’crypto’).randomBytes(32).toString(’hex’))”

Następnie otwórz plik komendą i w pliku uzupełnij zmienne zgodnie z poniższym schematem. Pamiętaj, że musisz wpisać swoje dane, w szczególności dane API. Po szczegóły spójrz do README.md 

D:\Mike\mike\backend\.env:

PORT=3001

FRONTEND_URL=http://localhost:3000

DOWNLOAD_SIGNING_SECRET=<wynik komendy: node -e „console.log(require(’crypto’).randomBytes(32).toString(’hex’))”>

SUPABASE_URL=http://127.0.0.1:54321

SUPABASE_SECRET_KEY=<Authentication Keys → Secret z npx supabase status>

R2_ENDPOINT_URL=http://localhost:9000

R2_ACCESS_KEY_ID=minioadmin

R2_SECRET_ACCESS_KEY=minioadmin

R2_BUCKET_NAME=mike

OPENAI_API_KEY=local

OPENAI_BASE_URL=http://localhost:1234/v1

USER_API_KEYS_ENCRYPTION_SECRET=<jeżeli korzysatsz z LM Studio to wynik: node -e „console.log(require(’crypto’).randomBytes(32).toString(’hex’))”>

Teraz otwórz drugi plik:

D:\Mike\mike\frontend\.env.local:

NEXT_PUBLIC_SUPABASE_URL=http://127.0.0.1:54321

NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY=<Authentication Keys → Publishable z npx supabase status>

NEXT_PUBLIC_API_BASE_URL=http://localhost:3001

Krok 6 — Modyfikacja kodu pod LM Studio (opcjonalnie, jeśli chcesz postawić lokalnie)

Mike używa OpenAI Responses API które nie jest kompatybilne z LM Studio. Wymagane są zmiany w dwóch plikach.

Najpierw otwórz w terminalu:

notepad D:\Mike\mike\backend\src\lib\llm\models.ts 

i dodaj model wybrany model np. google/gemma-4-e4b do trzech list modeli:

export const OPENAI_MAIN_MODELS = [„gpt-5.5”, „gpt-5.4-mini”, „google/gemma-4-e4b”] as const;

export const OPENAI_MID_MODELS = [„gpt-5.4-mini”, „google/gemma-4-e4b”] as const;

export const OPENAI_LOW_MODELS = [„gpt-5.4-nano”, „google/gemma-4-e4b”] as const;

notepad D:\Mike\mike\backend\src\lib\llm\openai.ts — poproś Claude o przepisanie pliku pod /v1/chat/completions (standardowe API kompatybilne z LM Studio).

Zostaw sobie kopię zapasową oryginału na wszelki wypadek: openai.ts.backup.

Krok 7 — Załadowanie schematu bazy danych

docker exec -i supabase_db_mike psql -U postgres -d postgres < D:\Mike\mike\backend\schema.sql

Weryfikacja (16 tabel powinno być widocznych):

docker exec -i supabase_db_mike psql -U postgres -d postgres -c „\dt”

Krok 8 — Instalacja zależności

npm install –prefix D:\Mike\mike\backend

npm install –prefix D:\Mike\mike\frontend

---

3. Napotkane błędy i rozwiązania

Błąd	Przyczyna	Rozwiązanie
npm.ps1 cannot be loaded	PowerShell blokuje skrypty	Używaj cmd.exe zamiast PowerShell
Authentication failed przy git clone	Zły adres repozytorium	Właściwy adres: github.com/willchen96/mike
failed to connect to docker API	Docker Desktop nie jest uruchomiony	Uruchom Docker Desktop i poczekaj na pełny start
supabaseUrl is required	Brak pliku frontend/.env.local	Utwórz plik przez notepad D:\Mike\mike\frontend\.env.local
No connection could be made przy supabase	Docker nie działał	Uruchomić Docker Desktop przed npx supabase start
LM Studio niezgodne z Mike	Mike używa OpenAI Responses API	Przepisanie openai.ts pod /v1/chat/completions

---

4. Lokalizacje plików i serwisów (To jest moja konfiguracja – Twoja może się różnić pierwszym literą folderem głównym – u mnie D i Mike)

Element	Lokalizacja
Repozytorium	D:\Mike\mike\
Backend	D:\Mike\mike\backend\
Frontend	D:\Mike\mike\frontend\
Konfiguracja backendu	D:\Mike\mike\backend\.env
Konfiguracja frontendu	D:\Mike\mike\frontend\.env.local
Modyfikacja modeli AI	D:\Mike\mike\backend\src\lib\llm\models.ts
Modyfikacja OpenAI → LM Studio	D:\Mike\mike\backend\src\lib\llm\openai.ts
Kopia oryg. openai.ts	D:\Mike\mike\backend\src\lib\llm\openai.ts.backup
Schemat bazy danych	D:\Mike\mike\backend\schema.sql
Storage (MinIO)	D:\Mike\storage\
Panel MinIO	http://localhost:9001
Panel Supabase Studio	http://127.0.0.1:54323

---

5. Uruchamianie po restarcie komputera

Jeżeli instalujesz lokalnie na Windowsie, a nie na odrębnym serwerze, to po ponownym uruchomieniu komputera, żeby włączyć Mike, musisz ponownie uruchomić kilka rzeczy.

Wykonuj w tej kolejności:

1. Uruchom Docker Desktop — poczekaj aż w pełni wystartuje.

2. Uruchom Supabase (cmd.exe):

cd /d D:\Mike\mike

npx supabase start

2b. Uruchom minio

docker start minio

3. Uruchom LM Studio:

• Otwórz LM Studio
• Załaduj model np. google/gemma-4-e4b
• Uruchom Local Server na porcie 1234 (STANDARDOWY PORT)

4. Uruchom backend (otwórz pierwsze okno cmd.exe):

cd /d D:\Mike\mike

npm run dev -prefix backend

5. Otwórz drugie okno cmd.exe i Uruchom frontend:

cd /d D:\Mike\mike

npm run dev -prefix frontend

6. Otwórz przeglądarkę i adres:

http://localhost:3000

7. Zaloguj się i działaj!