diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..266adbc --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,5 @@ +# Regler for dette projekt + +- Al tekst på siden, i filnavne og i commit-beskeder er på dansk. +- Siden er ren HTML, CSS og lidt JavaScript. Ingen frameworks, ingen build-trin. +- Hver ændring laves på sin egen gren og som en pull request, så den kan godkendes før den rammer `main`. diff --git a/README.md b/README.md index c803af7..23bdbe4 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,14 @@ # Personlig hjemmeside -Skoleprojekt 2026. Én `index.html` med indlejret CSS, alt indhold på dansk. +Skoleprojekt 2026. Alt indhold er på dansk. + +## Filer + +- `index.html` – forsiden med navn og tre linjer om mit arbejde +- `projekter.html` – underside med et udvalg af projekter +- `stil.css` – fælles stil for begge sider (rolig palet, lyst og mørkt tema) +- `tema.js` – knappen, der skifter mellem lyst og mørkt tema +- `TEKNIK.md` – kursets fire tekniske spor dokumenteret på min egen opsætning +- `CLAUDE.md` – projektets tre regler til Claude Code Åbn `index.html` i en browser for at se siden. diff --git a/TEKNIK.md b/TEKNIK.md new file mode 100644 index 0000000..f28ecbd --- /dev/null +++ b/TEKNIK.md @@ -0,0 +1,194 @@ +# Til de tekniske: de fire spor dokumenteret på min egen opsætning + +Kurset *AI i praksis* har fire valgfri spor for de tekniske: terminal og git, +Claude Code i terminalen, webhooks og en lokal sprogmodel. Jeg kører i forvejen +alle fire ting til daglig på mit eget hjemmelab, så i stedet for kursets +eksempler dokumenterer jeg her, hvordan jeg gør, og hvad kursets øvelser svarer +til hos mig. Alle kommandoer og alt output herunder er kørt rigtigt den 28. oktober 2026. + +Mit setup er en del større, end opgaven kræver. Det er med vilje: pointen er at +vise, at kursets fire byggeklodser er præcis de samme, uanset om de kører i +skyen eller på en server i kælderen. + +## Spor A: Terminalen og git + +**Kurset:** installér git, klon kursets repo fra GitHub, kig på historikken med +`git log`, lav en ændring og se den med `git status` og `git diff`. + +**Hos mig:** jeg bruger ikke GitHub til min egen kode. Jeg kører min egen +git-server, [Gitea](https://about.gitea.com/), i en container på min +Proxmox-server. Den har samme funktioner som GitHub (repos, pull requests, +issues), men data bliver hjemme. Dette repo ligger der. + +``` +$ git --version +git version 2.55.0 + +$ git clone https://git.powerdata.dk/masterdraco/personlig-hjemmeside.git +$ cd personlig-hjemmeside +$ git log --oneline --all +a3d9aab docs: README beskriver de nye filer +25b4ca3 feat: mørkt tema med knap, valget huskes i browseren +be57940 feat: underside med projekter og fælles stil.css +7de0837 feat: personlig hjemmeside som enkelt index.html +``` + +Historikken ovenfor er hele denne hjemmesides tilblivelse. Hvert commit svarer +til ét forslag (pull request), som jeg har godkendt på Gitea. + +**Hvad jeg bruger ud over kursets fire kommandoer:** + +- `git checkout -b feature/navn` laver en gren, så en ændring kan bedømmes for sig. +- `git push -u origin feature/navn` sender grenen op, og Gitea tilbyder straks at lave en pull request. +- Gitea har et API, så en pull request kan oprettes fra terminalen med `curl`, uden at åbne browseren. + +**Lært:** git er det samme, uanset hvor serveren står. GitHub er bare én +udbyder af git-hosting. Når man selv kører serveren, lærer man samtidig, hvad +der ligger under: en mappe med commits og en webflade ovenpå. + +## Spor B: Claude Code i terminalen + +**Kurset:** installér Claude Code med npm, stil dig i repo-mappen, giv agenten en +lille opgave på dansk og godkend dens forslag. Skriv en `CLAUDE.md` med tre +linjer om projektets regler. + +**Hos mig:** hele denne hjemmeside er bygget med Claude Code i terminalen, ikke +via browseren. Jeg gav opgaven på dansk, og agenten læste, skrev og testede +filerne, tog skærmbilleder af siden i en browser og lavede derefter én gren og +én pull request pr. opgave, som jeg selv godkender. + +``` +$ node --version +v26.12.1 +$ claude --version +2.1.312 (Claude Code) +``` + +Projektets `CLAUDE.md` ligger i roden af dette repo og har tre regler: alt på +dansk, ingen frameworks, og hver ændring som en pull request. Agenten læser den +automatisk, hver gang den starter i mappen. + +Derudover har jeg en global `CLAUDE.md` i min hjemmemappe. Den fortæller +agenten om hele mit hjemmelab: hvor min git-server er, at den aldrig må pushe +til GitHub, hvilke lokale sprogmodeller den kan bruge til kodegenerering, og +hvor min videnbank ligger. Det er "medarbejderhåndbogen" fra kurset, bare på +et par hundrede linjer i stedet for tre. + +**Lært:** arbejdsdelingen er den samme som i kurset: mål ind, forslag ud, +menneske i midten. Forskellen i terminalen er, at man ser hvert værktøjskald, +og at agenten kan bruge alt det, man selv har adgang til fra terminalen (git, +curl, ens egne servere). + +## Spor C: Webhooks + +**Kurset:** lav et Google Apps Script med en `doPost`, udrul det som webapp, og +kald det med `curl`. Scriptet sender en mail med det, der blev sendt. + +**Hos mig:** jeg kører [n8n](https://n8n.io/), et selvhostet flow-værktøj, på +mit hjemmelab. Det bruger jeg til daglig til at koble ting sammen: mails der +klassificeres af en lokal sprogmodel, besked til min telefon når noget sker på +en overvågning, og automatiske rapporter. Under hvert eneste af de flows ligger +en webhook. + +Til dokumentationen lavede jeg et flow på to knuder: en *Webhook*-knude, der +lytter på `/webhook/kursus-test`, og en *Respond to Webhook*-knude, der svarer +med det, den fik. Flowet blev oprettet gennem n8n's API fra terminalen, +aktiveret, kaldt og slettet igen. + +``` +$ curl -X POST -H "Content-Type: application/json" \ + -d '{"besked":"hej fra terminalen"}' \ + https://MIN-N8N-SERVER/webhook/kursus-test +{"ok":true,"modtaget":{"besked":"hej fra terminalen"}} +``` + +Kursets Apps Script og min n8n-knude gør det samme: en adresse plus kode, der +kører ved kald. Forskellen er, at n8n giver en grafisk flade til at hænge de +næste trin på (send mail, kald en sprogmodel, skriv i et regneark), og at det +hele kører på min egen maskine. + +**Lært:** en webhook er den mindste fællesnævner for al automatisering. Kan man +den, kan man koble næsten alt sammen, og man kan altid teste den med `curl` +før man bygger videre. + +## Spor D: Kør en sprogmodel på din egen maskine + +**Kurset:** installér LM Studio, hent en lille åben model, chat med den uden +wifi, start den lokale server og tal med den via `curl`. + +**Hos mig:** jeg kører to lokale sprogmodel-servere, begge med samme slags +API som kurset viser (OpenAI-kompatibelt `/v1/chat/completions`): + +1. **På min arbejdscomputer:** [llama.cpp](https://github.com/ggml-org/llama.cpp) + med modellen `qwen2.5-coder:7b` på grafikkortet (AMD RX 9070 XT via Vulkan). + Den kører som en systemd-tjeneste, jeg kan starte og stoppe. Claude Code + bruger den til at generere kode, så jeg sparer cloud-tokens. +2. **På hjemmeserveren:** [Ollama](https://ollama.com/) med et dusin større + modeller (bl.a. Gemma 4 i 31B og en Qwen3 i 32B), som mine automatiseringer + og min videnbank kalder. + +Kursets curl-kommando, kørt uændret mod min lokale llama.cpp-server: + +``` +$ curl http://localhost:8080/v1/chat/completions -H "Content-Type: application/json" \ + -d '{"messages":[{"role":"user","content":"Forklar hvad en webhook er, på dansk, i to sætninger"}]}' +``` + +Svar (78 tokens på 0,79 sekunder, altså omkring 100 tokens i sekundet): + +> En webhook er en måde, hvor et system automatisk sender en HTTP-besked til et +> andet system, når en bestemt begivenhed sker. Det gør det muligt for +> programmer og systemer at interagere og opdatere hverandre i realtid, uden at +> bruge traditionelle metoder for at anmode om opdateringer. + +Kursets sammenligning med en cloudmodel, ud fra min daglige brug: + +| | Lokal 7B-model (llama.cpp) | Lokal 26–32B-model (Ollama) | Cloudmodel (Claude) | +|---|---|---|---| +| Hastighed | Meget hurtig, ~100 tok/s | Langsom, flere minutter på lange svar | Hurtig | +| Kvalitet | God til afgrænset kode | God til resonnering og dansk | Bedst, især til lange opgaver | +| Dansk | Brugbart, små fejl ("hverandre") | Godt | Fejlfrit | +| Pris | Strøm | Strøm + et dyrt grafikkort | Abonnement pr. måned | +| Data | Forlader aldrig huset | Forlader aldrig huset | Sendes til udbyderen | + +**Lært:** en sprogmodel er en fil plus et program, der kører den. API'et er en +aftale, og den aftale er den samme for LM Studio, llama.cpp, Ollama og +cloududbyderne. Derfor kan man bytte model uden at skrive sin kode om. Det er +det stærkeste argument i enhver snak om databeskyttelse: man kan rent faktisk +beholde data hjemme, og det koster hastighed og kvalitet, ikke muligheder. + +## Bonus: min egen udgave af GitHub Pages + +Kursets side ligger på GitHub Pages, så repoet også er en hjemmeside. Gitea har +ikke den funktion indbygget, så jeg byggede den selv på hjemmelabbet, og den +viser i øvrigt alle fire spor i brug på én gang: + +1. **En lille container** (Debian) med webserveren nginx, der serverer mappen + med repoet. Repoet blev hentet med `git clone` (spor A). +2. **En webhook** (spor C) på containeren, lavet med det lille program + `webhook`. Når Gitea sender et push-signal, tjekker den signaturen og kører + `git pull`. Siden er opdateret få sekunder efter, at en pull request er + godkendt. +3. **Min reverse proxy** (Nginx Proxy Manager) sender `michael.powerdata.dk` + videre til containeren med et wildcard-certifikat, så siden har https. +4. **Hele opsætningen blev lavet af Claude Code i terminalen** (spor B): + containeren oprettet, pakker installeret, webhook registreret gennem + Giteas API og proxy-host oprettet gennem proxyens API. Sprogmodellen i spor + D er ikke med her, men den sidder i samme hjemmelab og kaldes af de samme + webhooks i n8n. + +Resultatet: https://michael.powerdata.dk, som opdaterer sig selv, når +noget rammer `main` i dette repo. Samme idé som GitHub Pages, bare på en +server i kælderen. Gitea kunne i første omgang ikke kalde webhooken, fordi den +som standard nægter at sende til private netværksadresser, så den indstilling +måtte slås til. Det er en god sikkerhedsregel, og et godt eksempel på, at +"det virker ikke" tit er "det er beskyttet". + +## Hvad de fire spor har til fælles + +Alle fire spor handler om det samme: at komme et lag ned under den grafiske +flade og se, at der ligger noget simpelt og genbrugeligt. Git er en mappe med +historik. Agenten er et program, der kalder værktøjer. En webhook er en adresse +med kode bag. En sprogmodel er en fil med et API foran. Når man kører tingene +selv, bliver det tydeligt, at skyen bare er en anden, der kører de samme fire +ting for én. diff --git a/index.html b/index.html index cd40502..7b2baa3 100644 --- a/index.html +++ b/index.html @@ -9,112 +9,19 @@ - + +

Michael Laursen

Nørre Aaby, Fyn

+ +