Hister is een open-source, privacy-georiënteerde zoekmachine waarmee gebruikers een persoonlijke index kunnen opbouwen van bezochte webpagina's en lokale bestanden. In tegenstelling tot commerciële zoekmachines draait Hister lokaal, waardoor er geen telemetrie is en de data volledig in eigen beheer blijft.
Belangrijkste kenmerken:
- Indexering: Volledige tekstindexering van webpagina's via browser-extensies (Chrome/Firefox), lokale mappen en geïmporteerde bestanden.
- Toegang: Gebruikers kunnen zoeken via een webinterface, de terminal (TUI) of een AI-assistent via het Model Context Protocol (MCP).
- Functionaliteit: Ondersteuning voor geavanceerde zoekfilters, wildcards en optionele semantische zoekopdrachten via configureerbare embeddings.
- Technische basis: De software is geschreven in Go en is gelicentieerd onder de AGPLv3.
Hister: Je eigen zoekmachine
Snelstart
- Download het binary-bestand voor jouw platform vanuit de nieuwste release en hernoem dit naar
hister (hister.exe op Windows).
- Op Linux of macOS maak je het bestand uitvoerbaar:
chmod +x hister
- Start Hister op Linux of macOS:
./hister listen
- Op Windows voer je
.\hister.exe listen uit in PowerShell.
Houd dit terminalvenster open tijdens het gebruik van Hister. De server moet actief zijn om pagina's te indexeren en te doorzoeken.
- Open http://127.0.0.1:4433 en installeer de browserextensie voor Firefox of Chrome.
- Bezoek een webpagina met de extensie ingeschakeld. Keer daarna terug naar Hister en zoek naar een zin van die pagina om je eerste geïndexeerde resultaat te vinden.
Voor een lokale persoonlijke installatie is geen configuratie vereist. Raadpleeg de volledige snelstartgids om te kiezen wat Hister precies indexeert. Om bestaande inhoud te doorzoeken, kun je browsergeschiedenis importeren, lokale mappen indexeren of bestanden importeren.
Alternatieve installatiemethoden zijn onder andere Homebrew (brew install hister), Docker en Nix. Zie de installatiehandleiding voor instructies.
Functies
- Focus op privacy: Geen telemetrie of verplichte clouddiensten. Draai Hister lokaal of op infrastructuur die je zelf beheert.
- Volledige tekstindexering: Doorzoek de werkelijke inhoud van bezochte pagina's en lokale bestanden, niet alleen de titels en URL's.
- Automatische browserindexering: Sla nieuw bezochte pagina's automatisch op met de Firefox- of Chrome-extensie.
- Krachtige zoekopdrachten: Maak gebruik van veldfilters, exacte zinnen, wildcards, negatie, aliassen en resultaatprioriteiten.
- Optionele semantische zoekopdracht: Vind documenten op basis van betekenis via een door jou geconfigureerd embeddings-eindpunt.
- Crawler en browser-import: Indexeer websites of importeer bestaande browsergeschiedenis.
- Web, terminal en MCP-clients: Zoek via de browser, TUI, opdrachtregel of een AI-assistent.
- Ondersteuning voor meerdere gebruikers: Houd documenten en zoekresultaten van elke gebruiker gescheiden op een gedeelde server.
Privacy
Standaard heeft Hister geen telemetrie en geen cloudsynchronisatie. De browserextensie verzendt geïndexeerde pagina-inhoud alleen naar de Hister-server die jij configureert, met uitzondering van het downloaden van pagina-favicons. De server slaat documenten en zoekindexen op diezelfde server op.
Optionele semantische zoekopdrachten verzenden documenttekst naar het door jou gekozen embeddings-eindpunt. Bekijk het privacyoverzicht en de configuratie voor semantische zoekopdrachten voordat je externe integraties inschakelt.
Waarom Hister?
In tegenstelling tot traditionele zoekmachines bouwt Hister een persoonlijke zoekindex op van de webpagina's en bestanden die jij besluit te bewaren. Je inhoud blijft op je eigen Hister-server, waardoor het nuttig is voor het vinden van informatie die je al eens bent tegengekomen, zonder afhankelijk te zijn van een externe zoekprovider.
Ontwikkeling
Vereisten
Voor ontwikkeling zijn Go 1.26, npm en een C-compiler voor CGO-afhankelijkheden nodig.
Bouwen
git clone https://github.com/asciimoo/hister.git
cd hister
./manage.sh build
Om aan de webapp te werken met hot reload en automatische Go-rebuilds:
npm run serve:app
Dit start een Vite-ontwikkelingsserver en de Go-backend met automatische rebuilds via Air.
Community en bijdragen
Sluit je aan bij ons op IRCNet in #hister of op Discord.
Lees CONTRIBUTING.md voordat je een wijziging indient. Bugs en suggesties kunnen worden gemeld in de issue tracker. Voor beveiligingsrapporten kun je terecht bij SECURITY.md.
Licentie
AGPLv3 of een latere versie.
Hister: Je eigen zoekmachine
Snelstart
- Download het binary-bestand voor jouw platform vanuit de nieuwste release en hernoem dit naar
hister (hister.exe op Windows).
- Op Linux of macOS maak je het bestand uitvoerbaar:
chmod +x hister
- Start Hister op Linux of macOS:
./hister listen
- Op Windows voer je
.\hister.exe listen uit in PowerShell.
Houd dit terminalvenster open tijdens het gebruik van Hister. De server moet actief zijn om pagina's te indexeren en te doorzoeken.
- Open http://127.0.0.1:4433 en installeer de browserextensie voor Firefox of Chrome.
- Bezoek een webpagina met de extensie ingeschakeld. Keer daarna terug naar Hister en zoek naar een zin van die pagina om je eerste geïndexeerde resultaat te vinden.
Voor een lokale persoonlijke installatie is geen configuratie vereist. Raadpleeg de volledige snelstartgids om te kiezen wat Hister precies indexeert. Om bestaande inhoud te doorzoeken, kun je browsergeschiedenis importeren, lokale mappen indexeren of bestanden importeren.
Alternatieve installatiemethoden zijn onder andere Homebrew (brew install hister), Docker en Nix. Zie de installatiehandleiding voor instructies.
Functies
- Focus op privacy: Geen telemetrie of verplichte clouddiensten. Draai Hister lokaal of op infrastructuur die je zelf beheert.
- Volledige tekstindexering: Doorzoek de werkelijke inhoud van bezochte pagina's en lokale bestanden, niet alleen de titels en URL's.
- Automatische browserindexering: Sla nieuw bezochte pagina's automatisch op met de Firefox- of Chrome-extensie.
- Krachtige zoekopdrachten: Maak gebruik van veldfilters, exacte zinnen, wildcards, negatie, aliassen en resultaatprioriteiten.
- Optionele semantische zoekopdracht: Vind documenten op basis van betekenis via een door jou geconfigureerd embeddings-eindpunt.
- Crawler en browser-import: Indexeer websites of importeer bestaande browsergeschiedenis.
- Web, terminal en MCP-clients: Zoek via de browser, TUI, opdrachtregel of een AI-assistent.
- Ondersteuning voor meerdere gebruikers: Houd documenten en zoekresultaten van elke gebruiker gescheiden op een gedeelde server.
Privacy
Standaard heeft Hister geen telemetrie en geen cloudsynchronisatie. De browserextensie verzendt geïndexeerde pagina-inhoud alleen naar de Hister-server die jij configureert, met uitzondering van het downloaden van pagina-favicons. De server slaat documenten en zoekindexen op diezelfde server op.
Optionele semantische zoekopdrachten verzenden documenttekst naar het door jou gekozen embeddings-eindpunt. Bekijk het privacyoverzicht en de configuratie voor semantische zoekopdrachten voordat je externe integraties inschakelt.
Waarom Hister?
In tegenstelling tot traditionele zoekmachines bouwt Hister een persoonlijke zoekindex op van de webpagina's en bestanden die jij besluit te bewaren. Je inhoud blijft op je eigen Hister-server, waardoor het nuttig is voor het vinden van informatie die je al eens bent tegengekomen, zonder afhankelijk te zijn van een externe zoekprovider.
Ontwikkeling
Vereisten
Voor ontwikkeling zijn Go 1.26, npm en een C-compiler voor CGO-afhankelijkheden nodig.
Bouwen
git clone https://github.com/asciimoo/hister.git
cd hister
./manage.sh build
Om aan de webapp te werken met hot reload en automatische Go-rebuilds:
npm run serve:app
Dit start een Vite-ontwikkelingsserver en de Go-backend met automatische rebuilds via Air.
Community en bijdragen
Sluit je aan bij ons op IRCNet in #hister of op Discord.
Lees CONTRIBUTING.md voordat je een wijziging indient. Bugs en suggesties kunnen worden gemeld in de issue tracker. Voor beveiligingsrapporten kun je terecht bij SECURITY.md.
Licentie
AGPLv3 of een latere versie.
Groetjes,