Jõhvi tehisarupäev

Eelseadistus — mis peaks olema arvutis enne päeva algust

Author

Indrek Seppo · indrek.seppo@seppo.ai

1 Miks see leht on olemas

Eesmärk. Tulla päeva esimese tunniga juba töövalmis, mitte hakata installimisi ja kontode loomist alles kohapeal tegema. Üks tund on lühike — kui pool sellest kulub npm install-i ootamisele, on ehitusele vähem aega.

Ühepäeva tehisarupäev on praktiline. Esimene tund-poolteist on sõnavara ja raamistik. Ülejäänud aja ehitame. Selleks, et ehitamise tundideks oleks tööriist käes ja konto avatud, palun tee see kontroll-nimekiri enne päeva algust läbi.

2 Hädavajalik (must-have)

Need on käivitusmiinimum. Ilma nendeta ei pääse esimese kahe tunni järel ehitusele.

Tööriist Miks vaja Kuidas saada
Terminal Vajalik, kui kasutad CLI-vormi (claude / codex terminalis). Töölaua-rakenduse kasutajale kasulik git-, npm- ja Pythoni-käskude jaoks. macOS: Terminal või iTerm. Windows: Windows Terminal + PowerShell või WSL2. Linux: ükskõik milline.
Tekstiredaktor Failide vaatamine, käsitsi-parandused, diff-i lugemine. Pärisprogrammeerijate seas on populaarne näiteks VS Code (tasuta, code.visualstudio.com), aga sobivad ka teised — Sublime Text, Notepad++, JetBrains, nano, vim.
Brauser Prototüüpide testimine, GitHubi veebiliides, dokumentatsioon. Modernne Chrome / Firefox / Edge / Safari.
Git Versioonihaldus — iga muudatus salvestatakse, midagi ei lähe kaduma. macOS: tuleb XCode’iga või brew install git. Windows: git-scm.com installer. Linux: apt install git / dnf install git.
Node.js (v22 LTS või uuem; soovituslik v24 LTS) Claude Code ja Codex CLI paigaldatakse npm-iga. macOS: brew install node. Windows: nodejs.org installer. Linux: paketihaldur või nodesource.com.
Python 3.13+ (soovituslik 3.14) API-näidete ja väikeste skriptide jaoks; mitmed skillid eeldavad seda. macOS: brew install python@3.14. Windows: python.org. Linux: paketihaldur.
Claude Code või Codex (ükskõik kumb) Päeva põhitööriistad. Kasuta kas CLI-d (terminalis claude / codex) või töölaua-rakendust — Claude App (claude.com/download) / Codex App (openai.com/codex). Mõlemad vormid annavad sama funktsionaalsuse (skillid, MCP, plan mode, slash-käsud). Pelgalt veebivestlus claude.ai / chatgpt.com peal ei piisa, sest seal puuduvad skillide ja failide-haldamise täisvõimalused. CLI: npm install -g @anthropic-ai/claude-code ja/või npm install -g @openai/codex. Või lae alla Claude App / Codex App ülaltoodud lehtedelt.
Tasuline AI-konto Tööriist ei tööta ilma kontota. Claude Pro ($20/kuu) või Max (claude.ai/upgrade) JA/VÕI ChatGPT Plus ($20/kuu) või Pro (chatgpt.com) — või kummagi Business / Team versioon.
Important

Test enne päeva. Käivita terminalis claude (või codex) — või ava Claude App / Codex App — ja logi sisse. Kui näed prompti ja saad esimese vestluse käima, oled valmis.

Tip

Päeva eeldatav kulu osaleja kohta: Pro / Plus tellimus (~20 €/kuu) + ~50 € lisakrediiti kontol (kas otse ChatGPT- või Claude-kontol või Anthropic Console / OpenAI Platform platvormi-kontol). Pro / Plus üksi võib päeva läbi venitada, aga intensiivse tööga jõuab 5-tunnise akna limiidini päris kiiresti — tunniga või isegi vähemaga. Kui lisakrediit on olemas, lülitub CLI automaatselt selle peale ja töö ei katke. 50 € sisse peaks üsna ilusasti ära mahtuma ja ülegi jääma — kuigi igaühe töö võib erineda.

3 Soovituslik (nice-to-have)

Need ei ole kohustuslikud, aga teevad päeva sujuvamaks. Eriti gh CLI ja API-võti varuks.

Tööriist Mille jaoks
GitHub konto (üsna soovitatav) Kood ja SKILL.md-d elavad pilves; tiim saab paralleelselt töötada; iga muudatus on jälgitav. Solo-prototüübi puhul saab hakkama ka ilma, aga pikemas plaanis on GitHub töövoo selgroog. github.com/signup — konto eelnevalt loodud, 2FA sisse lülitatud.
gh CLI (GitHub CLI) PR-ide loomine käsurealt, agent oskab seda kasutada. macOS: brew install gh. Windows: winget install GitHub.cli. Linux: paketihaldur.
VS Code Parim diff-vaatur, sisseehitatud git, tasuta. Kui pole veel — sobiv ehituspäeva tööriist.
Lisakrediit kontol (varuks, kui Pro / Plus limiit saab täis) Lisa enne päeva ~50 € lisakrediiti kas otse oma ChatGPT- või Claude-kontole või API-platvormi kontole (console.anthropic.com / platform.openai.com). CLI lülitub Pro/Plus limiidi täitumisel automaatselt selle peale. Eraldi API-võtit iseenesest paigaldama ei pea — krediit konto peal piisab.
Homebrew (macOS) Paketihaldur — paigaldab git, node, python, gh ühe käsuga. brew.sh.
WSL2 (Windows) Linux-keskkond Windowsis. Mõned skillid eeldavad Unix-tööriistu. Mitte kohustuslik, aga aitab.
Aktiveeritud GitHubi autentimine HTTPS + Personal Access Token või SSH võti. Vt docs.github.com.

4 Päevasisene eelvalmistus (sisu, mitte tööriistad)

Tehniline keskkond on pool tööst. Teine pool on tellijapoolne materjal: konkreetne kasutusjuht ja päris-näited. Ilma nendeta on päev tühi harjutus.

Need kolm asja peavad enne päeva olemas olema — need on tellija kohustus, mitte osaleja:

  1. Üks konkreetne kasutusjuht on läbi mõeldud — sh kust tulevad andmed ja kuidas neile ligi pääseb (API-võti, login, eksport vms). Päev ei alga tühjalt lehelt — tiim teab, mis töövoogu prototüüpima asutakse ja mille pealt seda testitakse.
  2. 1–2 päris näidissisendit sellest tööst (kliendikiri, dokument, kõnesalvestus, andmerida — mis iganes vorm). Tundlikud andmed pseudonüümitud või asendatud.
  3. Näide heast väljundist — milline näeks välja “õige vastus” sellele sisendile, kui inimene selle käsitsi teeks? Ilma selleta ei oska AI-le öelda, mille poole sihtida.
Tip

Kui näide heast väljundist puudub, kirjuta üks ise enne päeva. 5 minutit ette tehtud “siiamaani teeme käsitsi nii”-näidet säästab koolitusel tunni.

4.1 Alternatiiv: avalike andmete ja API-de pealt harjutusülesanded

Kui Sinu organisatsioonil pole päris kasutusjuhti veel selge, või tahad enne päeva harjutamiseks midagi kindlat, vali üks neist. Kõik andmeallikad on tasuta ja avalikult kättesaadavad ilma lepingu või sisselogimiseta (mõned vajavad anonüümset API-võtit, aga registreerimine on minutiline).

Kui tellija pool kasutusjuhti veel täpsustab, või tahad mängulist harjutust kõrval, on siin viis valmis-ideed avalikest andmetest, mida saab Eestis kasutada ilma kontot loomata:

Idee Mida prototüüp teeb Andmeallikad
Asukohaanalüüs “Kas Narva mnt 7 sobib uue kohviku jaoks?” — annab struktureeritud hinnangu (kättesaadavus, konkurents, demograafia). Maa- ja Ruumiameti geokodeerija, Statistikaamet PxWeb API, GTFS ühistransport.
Eesti turu- ja laienemisraport “Kas Viljandis tasub avada hambakliinik / jõusaal?” — koondab demograafia, ettevõtete tihedust, ostujõudu. Statistikaamet PxWeb API; e-Äriregistri bulk-avaandmed; MTA avaandmed; Tallinna avaandmete API.
Riigihanke bid/no-bid “Kas me peaksime sellele hankele pakkuma?” — koondab nõuded, tähtajad, tellija varasemad hanked, riskimärgid. Riigihangete register (avalik otsing ilma sisselogimiseta); ettevõtte taustaks e-Äriregistri bulk + MTA avaandmed; sektorinäitajateks Statistikaamet.
Tervishoiu nõudluse planeerija “Kus oleks mõistlik avada füsioteraapiakeskus?” — agregeeritud rahvastiku- ja teenuste-andmed. TEHIKu avaandmed (REST + OData); Statistikaamet rahvastikule; geokodeerija.
Poliitikamuutuste brief “Mis seadusemuudatused võivad mõjutada meie tegevusvaldkonda?” — uudisvoo monitoor + kokkuvõte. Riigikogu JSON API, ERJK JSON API, Riigi Teataja.
Note

Kui Sinu tiim soovib päeva sees lahendada midagi enda organisatsioonile kasulikku, eelistame seda alati avalikku-andmete-harjutusele.

5 Konto-test enne päeva (5 minutit)

Tee see test vähemalt päev varem, mitte hommikul kell 9:30 tehisarupäeva uksel. Maksaminek, 2FA, e-maili kinnitus jms võtab tihti aega.

Käi see kontroll läbi enne päeva. Kui mõni samm ebaõnnestub, saad rahulikult lahendada — koolitusel jääb personaalseks abiks vähe aega.

# 1. Git on olemas?
git --version
# Oodatud: git version 2.40.0 või uuem

# 2. Node.js on olemas?
node --version
# Oodatud: v22.0.0 või uuem (soovituslik v24 LTS)

# 3. Python on olemas?
python3 --version
# Oodatud: Python 3.13.0 või uuem (soovituslik 3.14)

# 4. Claude Code on paigaldatud ja sisse logitud?
claude --version
# Käivita üks vestlus: kirjuta "claude" ja küsi midagi lihtsat.

# 5. (Või) Codex on paigaldatud ja sisse logitud?
codex --version
# Käivita üks vestlus: kirjuta "codex" ja küsi midagi lihtsat.

# 6. Git on seadistatud sinu nime ja e-mailiga?
git config --global user.name
git config --global user.email
# Mõlemad peavad midagi tagastama.

# 7. GitHubi konto on olemas ja autenditav?
gh auth status     # kui gh on paigaldatud
# või proovi käsitsi: ava github.com, logi sisse.
Warning

Kui mingi käsk ütleb “command not found”, on see tööriist paigaldamata. Vt vastava rea juurest, kuidas paigaldada.

6 Operatsioonisüsteemi-spetsiifika

Pole “õiget” operatsioonisüsteemi. Kõik kolm töötavad. Erinevad ainult installikäsud ja terminal-rakenduse nimi.

6.1 macOS

# Homebrew (üks kord, kui pole)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Põhipakett
brew install git node python@3.14 gh

# Agendid
npm install -g @anthropic-ai/claude-code
npm install -g @openai/codex

6.2 Windows

Soovituslik tee: WSL2 (Ubuntu) — saad Linux-keskkonna ja Unix-tööriistad. Mõned skillid ja MCP-serverid eeldavad neid.

# WSL2 paigaldus (PowerShell administraatorina)
wsl --install
# Pärast restart: ava Ubuntu, jätka all "Linux" sektsiooniga.

Alternatiiv: Windows Terminal + PowerShell. Töötab, aga mõned skillid vajavad väiksemaid kohandusi.

# Windowsi natiivsed installerid:
winget install Git.Git
winget install OpenJS.NodeJS.LTS
winget install Python.Python.3.14
winget install GitHub.cli

6.3 Linux (Ubuntu / Debian)

sudo apt update
sudo apt install git python3 python3-pip nodejs npm gh

# Kui apt-i Node.js on liiga vana (< v22):
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

# Agendid
sudo npm install -g @anthropic-ai/claude-code
sudo npm install -g @openai/codex

6.4 Linux (Fedora / RHEL)

sudo dnf install git python3 python3-pip nodejs npm gh
sudo npm install -g @anthropic-ai/claude-code
sudo npm install -g @openai/codex

7 Mida me ei vaja

Selguse mõttes — mõned asjad, mille pärast inimesed muretsevad, aga mida päeva jooksul ei lähe vaja.

  • Lokaalseid AI-mudeleid (Llama, Mistral, kohalikke Ollama-mudeleid). Päev kasutab pilve-mudeleid (Claude, GPT-5).
  • GPU-d. CPU laptop töötab täpselt sama hästi.
  • Docker (kui sa ei plaani spetsiifiliselt MCP-serveriga eksperimenteerida).
  • PostgreSQL / muu andmebaas. Ühepäeva-prototüüp elab failis.
  • Programmeerimiskogemust. Päev on disainitud tehniliselt mitte-tugevatele kasutajatele — agent kirjutab koodi sinu eest.

8 Kontrollnimekiri päeva hommikuks

Ole valmis, kui suudad öelda jah kõigele: