hister README

The project's README from github.com/asciimoo/hister. As one markdown file: README.md.

Hister

Your own search engine

Hister is a private search engine for the pages you visit and the files you keep. It indexes their full contents so you can find information again from the web interface, terminal, or an AI assistant connected through MCP.

Try the demo · Download Hister · Read the quickstart · Documentation

Hister web interface

Quickstart

  1. Download the binary for your platform from the latest release, then rename it to hister (hister.exe on Windows).

  2. On Linux or macOS, make it executable:

    chmod +x hister
    
  3. Start Hister on Linux or macOS:

    ./hister listen
    

    On Windows, run .\hister.exe listen in PowerShell.

  4. Open http://127.0.0.1:4433 and install the browser extension for Firefox or Chrome.

No configuration is required for a local personal setup. See the complete quickstart to import existing browser history and choose what Hister indexes.

Features

Hister terminal interface

Privacy

By default, Hister has no telemetry and no cloud sync. The browser extension sends indexed page content only to the Hister server you configure, apart from downloading page favicons. The server stores documents and search indexes on that server.

Optional semantic search sends document text to the embeddings endpoint you choose. Review the privacy overview and semantic search configuration before enabling remote integrations.

Development

Requirements are Go 1.26, npm, and a C compiler for CGO dependencies.

git clone https://github.com/asciimoo/hister.git
cd hister
./manage.sh build

To work on the web app with hot reload and automatic Go rebuilds:

npm run serve:app

This starts a Vite development server and the Go backend with automatic rebuilds through air.

Community and contributing

Join us on IRCNet in #hister or on Discord.

Read CONTRIBUTING.md before submitting a change. Bugs and suggestions belong in the issue tracker. For security reports, see SECURITY.md.

Sponsors

Uruky

License

AGPLv3 or any later version

hister (asciimoo/hister)

Searching Database…

6.1K ·GitHub
Что это такое?Hister — это приватная поисковая система, которую вы развёртываете на собственном сервере. Она полностью индексирует страницы, которые вы посещаете, и файлы, которые храните, поэтому позже вы можете искать их содержимое через веб-интерфейс, из терминала или с помощью ИИ-ассистента через MCP.
Это расширение для браузера или полноценный поисковый сервер?Это самостоятельный сервер (один исполняемый файл, написанный на Go), который вы запускаете на своём компьютере или на собственной инфраструктуре. Расширения для Firefox и Chrome — это лишь часть, которая отправляет новые посещённые страницы на этот сервер.
Как его запустить?Скачайте готовый бинарный файл для вашей ОС из последнего релиза, переименуйте его в hister (hister.exe в Windows), сделайте его исполняемым в Linux/macOS, затем запустите 'hister listen' (или '.\\hister.exe listen' в Windows) и установите расширение для браузера.
Нужны ли мне Go или npm, чтобы им пользоваться?Нет, для обычного использования достаточно запустить скачанный бинарный файл. Go 1.26, npm и C-компилятор нужны только в том случае, если вы хотите собрать Hister из исходников или доработать веб-приложение.
Работает ли семантический поиск сразу после установки?Нет, семантический поиск необязателен и заработает только после того, как вы сами настроите внешний эндпоинт для эмбеддингов; без этого Hister выполняет обычный полнотекстовый поиск.
Что происходит с моими данными о просмотрах?По умолчанию ничего не покидает ваш компьютер: нет ни телеметрии, ни синхронизации с облаком. Расширение браузера отправляет проиндексированное содержимое страниц только на настроенный вами сервер Hister (а также загружает фавиконы), и всё хранится на этом сервере.
Может ли несколько человек пользоваться одним сервером Hister?Да, в нём есть поддержка нескольких пользователей: на общем сервере документы и результаты поиска каждого пользователя хранятся отдельно.
Поиск ограничен простыми ключевыми словами?Нет, Hister поддерживает фильтры по полям, фразы, подстановочные знаки, исключение слов, псевдонимы и приоритеты результатов для более точных запросов.
Может ли он индексировать существующую историю браузера, а не только новые посещения?Да, есть импорт из браузера и краулер, так что можно подключить уже имеющуюся историю или проиндексировать целые сайты, а не только страницы, открытые после установки.
Что именно интеграция MCP позволяет делать ИИ-ассистенту?Она позволяет ИИ-ассистенту, подключённому через MCP, напрямую искать по вашей проиндексированной истории браузера и файлам, фактически давая ему доступ к поиску по вашей личной поисковой системе.
What are similar projects?xerj, qmd, memex, memos, karakeep, FluxDown, Surge, wigolo
Creator
asciimoo
Size
25 MB
Stars
6.1K
Age
9mo
Commits · 90 Days