No description
  • Svelte 40%
  • JavaScript 29.4%
  • TypeScript 20.8%
  • CSS 5.3%
  • Shell 3.7%
  • Other 0.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
lex 3ad34c9a1e
All checks were successful
GlitchTip release / release (push) Successful in 1s
Configure GlitchTip and Claude integration
2026-11-11 18:15:20 +01:00
.forgejo/workflows Configure GlitchTip and Claude integration 2026-11-11 18:15:20 +01:00
app App-menu: VPS eruit, eigen iconen voor Webmail, SSH, PB en Hydra 2026-09-28 20:09:24 +02:00
docs Configure GlitchTip and Claude integration 2026-11-11 17:59:20 +01:00
searxng lxsearch: zoekinterface op SearXNG met AI-overzicht, kaders en widgets 2026-09-20 14:46:04 +02:00
.env.example lxsearch: zoekinterface op SearXNG met AI-overzicht, kaders en widgets 2026-09-20 14:46:04 +02:00
.gitignore install.sh: kloont van git in plaats van code embedden, draait als systemd-service 2026-09-22 17:02:27 +02:00
docker-compose.yml lxsearch: zoekinterface op SearXNG met AI-overzicht, kaders en widgets 2026-09-20 14:46:04 +02:00
install.sh install.sh: kloont van git in plaats van code embedden, draait als systemd-service 2026-09-22 17:02:27 +02:00
README.md install.sh leesbaar: geen tar/base64 meer, gewoon cat-blokken per bestand 2026-09-21 21:17:35 +02:00

lxsearch

Zoekinterface op een headless SearXNG, met tabs voor web, beeld, video, nieuws en code, en een AI-overzicht dat via OpenRouter een antwoord met bronvermelding streamt.

  • app/ SvelteKit (adapter-node), bevat zowel de UI als de serverroutes
  • searxng/settings.yml SearXNG-configuratie, JSON-output aangezet
  • docker-compose.yml beide containers op een intern netwerk

SearXNG heeft bewust geen ports: alleen de app-container kan erbij. De OpenRouter-key staat uitsluitend server-side en komt nooit in de clientbundel.

Beheer

/admin, afgeschermd met ADMIN_PASSWORD uit .env. Zonder dat wachtwoord blijft de pagina dicht. Je vinkt er per tab aan welke engines bevraagd worden (SearXNG kent er hier 57 voor web, 35 voor beeld, 31 voor video en 14 voor nieuws) en stelt taal, veilig zoeken, de modellen, de systeemprompt, het AI-overzicht, het kennispaneel en de cachetijden in. Opslaan leegt meteen de caches, anders blijven resultaten van de oude engines hangen. Instellingen staan in data/settings.json, buiten het image, dus ze overleven een herbouw.

Bij Modellen zet je er meerdere onder elkaar, op volgorde van voorkeur. Weigert de eerste, bijvoorbeeld door een rate limit of omdat hij niet bestaat, dan gaat de volgende automatisch aan de beurt; alleen bij een geweigerde sleutel stopt het meteen, want dan helpt geen enkel model. De respons draagt een X-Model-header met het model dat het antwoord leverde. Staan alle modellen vol, dan zegt het AI-kader dat met naam en toenaam.

De knop Model testen stuurt één korte vraag naar een model en toont het antwoord of de reden waarom het niet lukte. Handig, want niet elk model deugt: openrouter/free gaf hier User Safety: safe terug in plaats van inhoud, en gratis modellen lopen regelmatig tegen een rate limit. In gebruik: inclusionai/ling-3.0-flash-vl:free met poolside/laguna-xs-2.1:free eronder. Die eerste antwoordt in ongeveer vier seconden. openai/gpt-4o-mini en openrouter/auto werken ook, maar kosten geld. Loopt een model vol, dan meldt het AI-kader dat met zoveel woorden in plaats van een vage storing.

PUBLIC_ORIGIN moet kloppen met het adres waarop de site draait. Anders weigert adapter-node elk formulier op de beheerpagina als cross-site.

Kwaliteit en robuustheid

Resultaten worden op de server opgehaald en staan in de HTML. Zoeken, bladeren, tabs en het tijdfilter werken daardoor ook zonder JavaScript: het formulier is een gewone GET naar /search en tabs en paginering zijn echte links.

SearXNG levert zijn resultaten per engine gegroepeerd aan, waardoor het beste resultaat van de tweede engine achter het elfde van de eerste belandt. app/src/lib/rank.js herrangschikt met Reciprocal Rank Fusion: elk resultaat krijgt punten voor zijn plaats bij elke engine, dus instemming tussen engines weegt zwaarder dan één engine die iets bovenaan zet. Zonder die stap kwam bij "google maps" de supportpagina boven maps.google.com.

Verder: een tijdfilter van dag tot jaar onder "Filters" naast de tabs (op schermen smaller dan 700px staan daar ook Video, Nieuws en Code, zodat de tabrij beperkt blijft tot Web, Beeld en Filters), spellingcorrectie van SearXNG ("bedoelde je"), bangs zoals !ddg die de enginekeuze aan SearXNG overlaten, een sneltoets / naar het zoekveld, een skip-link, aria-live op de resultaten en /health voor een uptime-controle.

Grenzen en login

Alle /api-routes en /search hebben een begrenzing per IP-adres: 15 AI-antwoorden per vijf minuten (die kosten geld), 200 suggesties, 300 favicons en 120 zoekopdrachten per minuut. Wie is ingelogd op /admin heeft geen begrenzing, dus één wachtwoord regelt zowel beheer als onbeperkt zoeken. Bij een overschrijding volgt een 429 met een Retry-After en een uitleg.

Afbeeldingen lopen via /api/img, met een handtekening in de URL zodat het geen open proxy is. De bronsite ziet daardoor het IP-adres van de bezoeker niet. Elke respons draagt Referrer-Policy: no-referrer, X-Content-Type-Options en X-Frame-Options.

Zoekbalk

De balk geeft suggesties tijdens het typen, via /api/suggest dat SearXNG's autocompleter doorgeeft. Pijltjes omhoog en omlaag lopen door de lijst, Enter zoekt, Escape sluit. De aanvraag wacht tot je even stopt met typen en het antwoord wordt tien minuten bewaard.

Browsers kunnen lxsearch als zoekmachine toevoegen: /opensearch.xml beschrijft zowel de zoek-URL als de suggestie-URL, en de pagina verwijst ernaar met een <link rel="search">. In Chrome komt hij na een bezoek vanzelf in de lijst bij Instellingen, Zoekmachine; in Firefox verschijnt hij onder het plusje in de zoekbalk.

Kaders en widgets

Naast de resultaten staan dezelfde soort kaders als bij Google:

Of een kader verschijnt wordt op entiteitsniveau beslist, niet op tekstniveau. app/src/lib/entity.js weegt vijf signalen en npm run check:entity bewaakt ze:

  1. De titel moet bij de zoekopdracht passen: gelijke woordenverzamelingen, of de zoekopdracht is een kortere vorm van de titel. "sir david attenborough" mag "David Attenborough" opleveren, "svelte kit" krijgt niets van het artikel "Svelte".
  2. Het item moet een P31 (is een) hebben, en geen doorverwijspagina, lijst of categorie zijn.
  3. Is het woord zelf een doorverwijspagina op Wikipedia ("python"), dan zijn er meerdere kandidaten en blijft het kader weg.
  4. Instemming uit de eigen resultaten: het Wikipedia-artikel of de officiële site moet in de eerste vijf staan, of minstens twee resultaattitels moeten over het onderwerp gaan. Dit is de dichtstbijzijnde vervanger voor de kliksignalen die Google gebruikt en wij bewust niet verzamelen.
  5. Bekendheid via het aantal taalversies in Wikidata: minder dan drie is een voetnoot, twaalf of meer mag de grote kop met fotomozaïek. Een mislukte opvraag, bijvoorbeeld een rate limit van Wikipedia, wordt niet gecached: anders blijft een onderwerp een dag lang zonder kader staan terwijl er niets mis mee is.

Het kennispaneel wordt niet bij elke zoekopdracht opgehaald. Een gedeelde filter (app/src/lib/entity.js, ook in de browser) slaat vragen, klussen en berekeningen over: "webshop laten maken" en "wat kost een webshop" leveren geen Wikipedia-verkeer op, "maastricht" wel. Artikelen zonder eigen afbeelding krijgen ook geen fotomozaïek, dat scheelt nog een beeldzoektocht.

  • Entiteitskop boven de resultaten: grote titel, fotomozaïek van vijf beelden en feitkaarten (leeftijd, opgericht, inwoners, oppervlakte). Die kop verschijnt alleen bij een duidelijk onderwerp: er moeten feiten uit Wikidata zijn, een eigen artikelfoto en minstens drie beelden. Is het zwakker, dan blijft het bij het zijpaneel, anders staat er bij elke zoekopdracht een collage.

  • Kennispaneel rechts ("Over"), met samenvatting en feiten. Vanaf 1480px schuift het omhoog en staat het naast de entiteitskop in plaats van eronder, zodat die ruimte niet leeg begint; smaller blijft het onder de kop staan. De samenvatting komt van Wikipedia (Nederlands, met Engels als terugval), de feiten uit Wikidata: opgericht, geboren, overleden, inwoners, oppervlakte en website. Er verschijnt alleen een kader als de gevonden titel echt bij de zoekopdracht past, anders krijg je willekeurige kaders bij vage zoektermen. Een dag gecached.

  • Widgets bovenaan de resultaten, boven het AI-overzicht:

    • rekenmachine: (1250 + 380) * 1,21
    • percentage: 20% van 250, 250 + 21%, van 80 naar 100 in procent
    • btw: 100 excl btw, 121 incl btw, 100 9% excl btw, met het btw-bedrag erbij
    • eenheden: 10 km in miles, 100 c in f, 1 gb in mb
    • wisselkoers: 100 eur in usd
    • vertalen: vertaal hond naar engels, hond in het frans
    • getalstelsels: 255 in binair, 0xff in decimaal
    • kleur: #3a78d5 of rgb(58,120,213), met staal en hsl
    • datum: hoeveel dagen tot kerst, 30 dagen na vandaag, dagen tussen 1-1-2026 en 1-3-2026
    • tijdzone: hoe laat is het in Tokyo
    • toeval: kop of munt, 2 dobbelstenen, willekeurig getal 1 tot 100
    • wachtwoord: wachtwoord 16 tekens, in de browser gemaakt
    • eigen IP: wat is mijn ip

    Elke kaart heeft een kopieerknop die bij hover verschijnt. Alles behalve de koersen rekent lokaal in de browser, dus het antwoord staat er voordat de zoekresultaten binnen zijn. Koersen komen van de ECB via frankfurter.dev (een uur gecached), vertalingen van MyMemory (een dag gecached).

De rekenmachine gebruikt geen eval maar een eigen parser: anders zou alles wat iemand in de zoekbalk typt uitvoerbare code worden.

Favicons komen via /api/favicon, die eerst de site zelf probeert en anders een iconendienst. De bytes worden gecontroleerd op een echte afbeeldingssignatuur, want sommige sites serveren onder image/x-icon gewoon tekst (shopware.com stuurt een data-URI). Levert niets een afbeelding op, dan tekent de server zelf een lettertegel: zo krijgt de bezoeker nooit een 404 in de console. De browser van de bezoeker praat dus nooit rechtstreeks met de bronsite. Interne hostnamen en IP-adressen worden geweigerd, zodat die route niet te misbruiken is om het eigen netwerk af te tasten. Lukt het niet, dan valt de chip terug op een letter.

Vormgeving (branch liquid-glass): kaders, zoekbalk en tabs zijn doorschijnende lagen met achtergrondvervaging, een randlijn die rondom van sterkte wisselt en een glans linksboven, boven een zacht kleurverloop dat het glas iets geeft om op te pikken. Wie in het systeem doorschijnendheid uitzet (prefers-reduced-transparency), krijgt gewoon vlakke kaarten. Kleuren en hoekradii zijn uit de referentieschermen gemeten in plaats van geschat, achtergrond #2e2522, kaarten #3f3838, zoekveld #535351, accent #3a78d5, kaarten 12px rond en de zoekbalk 24px. Lettertypes zijn Inter voor de tekst, Outfit voor koppen en wordmark, IBM Plex Mono voor metadata.

Dezelfde URL van meerdere engines wordt tot één regel samengevoegd, met de engines erachter samengevoegd.

Zoekresultaten worden tien minuten in het geheugen bewaard (300 pagina's). In searxng/settings.yml staat de engine-timeout op 2 seconden. Welke engines bevraagd worden regel je op de beheerpagina: de app stuurt engines= mee in plaats van categories=, want die twee sluiten elkaar uit en met categories negeert SearXNG de enginelijst. Standaard staan brave, duckduckgo en yep aan voor web, samen goed voor zo'n 50 resultaten in ongeveer een seconde. De code-tab heeft geen eigen lijst en bevraagt alles van die categorie.

AI-antwoorden worden een uur lang in het geheugen van de app-container bewaard, met de modelnaam en de zoekterm als sleutel (maximaal 200 stuks). Dezelfde vraag kost daarna geen OpenRouter-call meer en verschijnt direct in plaats van na ruim tien seconden. De cache is leeg na elke herstart, dat is bewust: geen Redis ernaast. Een afgebroken stream wordt niet bewaard.

Fonts (Bricolage Grotesque, IBM Plex Sans en Mono) staan in app/static/fonts en worden lokaal geserveerd. Ze via Google Fonts laden zou elke zoekopdracht alsnog aan Google melden.

Starten

Op een server: install.sh is het enige bestand dat je nodig hebt. De hele repo staat er letterlijk leesbaar in, één cat > pad <<'EOF' ... EOF-blok per bestand (op een handvol lettertypebestanden na, die zijn binair en staan er als een klein base64-blokje in). Niets om uit te pakken: het script schrijft elk bestand gewoon neer. Het installeert daarna Docker en de compose-plugin als die ontbreken (via get.docker.com), installeert Node.js/npm op de host als dat kan (Debian/Ubuntu via NodeSource, voor npm run check en de zelftests buiten Docker om, niet vereist), maakt .env aan, genereert ADMIN_SECRET en een eigen secret_key voor SearXNG (anders deelt elke installatie dezelfde uit de repo), vraagt naar de OpenRouter-key, het publieke adres en het admin-wachtwoord, en bouwt en start daarna de containers.

scp install.sh server:/tmp/
ssh server 'bash /tmp/install.sh /opt/lxsearch'

Zonder tweede argument wordt het /opt/lxsearch. Opnieuw draaien kan gerust: bestaande waarden in .env en een al vervangen secret_key blijven staan. Na git pull of een wijziging: ./scripts/build-install.sh bouwt install.sh opnieuw vanuit install.sh.head, install.sh.tail en de huidige staat van de repo.

Handmatig, of lokaal om te ontwikkelen:

cp .env.example .env    # vul OPENROUTER_API_KEY in
docker compose up -d --build

Interface op http://localhost:3000 (poort aanpasbaar met APP_PORT).

Configuratie

Variabele Doel Default
OPENROUTER_API_KEY vereist voor de AI-modus geen
OPENROUTER_MODEL model-slug, zie https://openrouter.ai/models openai/gpt-4o-mini
APP_PORT poort van de interface 3000
PUBLIC_ORIGIN adres van de site, nodig voor de beheerformulieren http://localhost:3000
ADMIN_PASSWORD wachtwoord voor /admin, leeg houdt de pagina dicht geen
ADMIN_SECRET houdt beheersessies geldig over herstarts heen willekeurig

Bij uitrol naar een server: vervang server.secret_key in searxng/settings.yml door een nieuwe waarde uit openssl rand -hex 16.

Ontwikkelen

cd app
npm install
SEARXNG_URL=http://localhost:8080 npm run dev

Voor npm run dev moet SearXNG bereikbaar zijn op de host. Zet daarvoor tijdelijk ports: ["8080:8080"] bij de searxng-service, of draai alleen de app buiten Docker.

Controles

cd app
npm run check           # svelte-check en TypeScript
npm run check:sse       # SSE-parser
npm run check:md        # markdown-renderer, inclusief HTML-escaping
npm run check:cache     # TTL-cache
npm run check:instant   # rekenmachine, eenheden, tijdzones
npm run check:currency  # herkennen van valuta-zoekopdrachten
npm run check:entity    # welke zoekopdrachten een kennispaneel verdienen
npm run check:rank      # herrangschikking van de resultaten
npm run check:limit     # de begrenzer per bezoeker
npm run check:sign      # ondertekening van de afbeeldingsproxy
npm run check:translate # herkennen van vertaalvragen
npm run check:imagetype # controle of een bestand echt een afbeelding is

Handmatig, met de stack draaiend:

docker compose exec app wget -qO- "http://searxng:8080/search?q=test&format=json" | head -c 200
curl -s -m 3 localhost:8080 || echo "searxng niet publiek bereikbaar, zoals bedoeld"