open-glean README

The project's README from github.com/hydra-db/open-glean. As one markdown file: README.md.

Open Glean, your second brain on Hydra DB

Open Glean is the AI workspace over Hydra DB. Ask a question across your memories, files, and connected apps. Open Glean retrieves the context, writes the answer, and cites its sources.

This is the open-source code for Open Glean. The Next.js server proxies requests to the official @hydradb/sdk. Keys are held in an encrypted, httpOnly session cookie and used server-side, never in the browser. You can also run it yourself with your own Hydra DB key.

Open Glean

Features

Getting started

npm ci
npm run dev

Copy .env.example to .env.local and set at least OPEN_GLEAN_SESSION_SECRET. Everything else is optional. Without a Hydra key, the app shows a connect screen and asks for one.

Open http://localhost:3000, then:

  1. Connect: paste your Hydra DB API key (create one at app.hydradb.com/keys) and pick a database.
  2. Add a model: in Settings, paste an OpenRouter (or other OpenAI-compatible) key and pick a model. It only writes answers; search works without it.
  3. Ask away, or add context first from the Context page (files, notes, URLs).

Running with Docker

docker build -t open-glean .
docker run -p 3000:3000 \
  -e OPEN_GLEAN_SESSION_SECRET=your-random-16-char-secret \
  -e HYDRA_API_KEY=your-hydra-key \
  -e OPENROUTER_API_KEY=your-openrouter-key \
  -e OPEN_GLEAN_LLM_MODEL=google/gemini-3.7-flash \
  -e MONGODB_URI=mongodb://your-mongo-host:27017 \
  open-glean

The image uses Next.js standalone output, so it ships only the runtime files and the dependencies the build uses. It runs as a non-root user.

How it works

Browser ──► Next.js proxy (/api/hydra/*) ──► @hydradb/sdk ──► api.hydradb.com
        └─► /api/llm/chat (streaming + web plugin) ─► your LLM provider

Environment & key security

API keys are not stored in the browser. When you connect in Settings, the key is verified server-side and stored in an AES-256-GCM-encrypted, httpOnly session cookie; every proxied request resolves it on the server. Nothing key-shaped is inlined into the JS bundle, localStorage, or any client state.

A stored key is also pinned to the endpoint it was stored with. A request may only choose the LLM base URL when it supplies its own API key. Otherwise a caller could pair an attacker-controlled URL with the server's key and have it sent there in an Authorization header.

Variable Purpose
OPEN_GLEAN_SESSION_SECRET Required in production. Any random 16+ char string. Encrypts the key session cookie.
HYDRA_API_KEY Optional deployment-level shared key: when set, no user key is needed at all
HYDRA_BASE_URL Optional default backend URL (defaults to https://api.hydradb.com)
HYDRA_DEFAULT_DATABASE Optional default tenant. Requests with no explicit database scope to this one.
MONGODB_URI Chat persistence. A MongoDB connection string, or a bare DocumentDB cluster endpoint (auto-detected via .docdb.*.amazonaws.com).
MONGODB_DB Database name for chats (defaults to open_glean).
OPENROUTER_API_KEY Optional server-level LLM key. When set, users need not enter their own.
OPEN_GLEAN_LLM_MODEL Default answer model id, e.g. openai/gpt-4o-mini. No built-in default. Without it (or a per-user model), answers are unavailable.
OPEN_GLEAN_LLM_BASE_URL Optional OpenAI-compatible endpoint for the server-level key (defaults to OpenRouter)
OPEN_GLEAN_ALLOW_PRIVATE_LLM_URL Allow an LLM base URL on a private or loopback address, for a local model such as Ollama or LM Studio. Off by default. It permits plaintext http: on a private address only. A public host still requires https:, and non-http schemes are rejected.
MONGODB_PROXY_KEY Shared secret for the Lambda proxy. The Lambda reads the same value as PROXY_KEY; the two names must match.
OPEN_GLEAN_MAX_CONCURRENT_RESEARCH Concurrent Deep Research runs per instance (default 3). Each run costs many LLM and retrieval calls

DocumentDB does not support IAM database authentication. The IAM token path in the code cannot authenticate against Amazon DocumentDB. AWS_REGION, AWS_IAM_USER_ARN and AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY are read by that path and are listed here only to describe what it expects. For DocumentDB, use a standard MongoDB connection string or the Lambda proxy.

Stack

Next.js 16, React 19, Tailwind CSS v4, and @hydradb/sdk. No other runtime dependency for data or AI.

License

Apache-2.0. See LICENSE and NOTICE.

Read NOTICE: connector logos are third-party trademarks and are not covered by the Apache grant.

open-glean (hydra-db/open-glean)

Searching Database…

1.6K ·GitHub
Open-glean
Что это такое?Open Glean — это open-source AI-рабочее пространство на базе Hydra DB: «второй мозг», которому можно задавать вопросы по вашим заметкам, файлам и подключённым приложениям; ответы составляются из найденного контекста со ссылками на источники.
Это готовая платформа или фронтенд, которому сзади нужна Hydra DB?Это веб-приложение на Next.js поверх Hydra DB: поиск и хранение данных живут в вашей базе Hydra, а сервер приложения проксирует каждый вызов через официальный @hydradb/sdk — то есть вы подключаете его к своей стороне Hydra.
Как его запустить?Скопируйте .env.example в .env.local и задайте OPENGLEANSESSIONSECRET (остальное необязательно), затем запустите приложение — есть и Docker-образ; он содержит только файлы для работы и запускается от непривилегированного пользователя (non-root).
Нужен ли мне API-ключ Hydra DB, чтобы реально искать по своим данным?Да — поиск выполняется в вашей базе Hydra. Создайте ключ на app.hydradb.com/keys и вставьте его на экране подключения; в развёрнутом экземпляре вместо этого можно задать общий HYDRAAPIKEY, и тогда пользователям ключ вообще не нужен.
Оно сразу отвечает на вопросы или сначала нужно настроить модель?Для ответов нужна LLM: модели по умолчанию нет, поэтому без OPENGLEANLLMMODEL (или выбранной пользователем модели в настройках) ответы недоступны. Сам поиск по Hydra работает и без неё.
Где хранятся мои API-ключи и история чатов?Ключи никогда не попадают в браузер: они проверяются на сервере и хранятся в httpOnly-сессии-куке, зашифрованной AES-256-GCM. Чаты сохраняются в MongoDB, когда она доступна, с запасным вариантом через localStorage.
Можно ли свободно пользоваться и менять проект, или в лицензии есть подвох?Apache-2.0 — свободное использование и изменение. Один нюанс из NOTICE: логотипы коннекторов — сторонние товарные знаки и не покрываются лицензией Apache.
Что такое Deep Research?Режим для вопросов, на которые не ответить одним запросом: Open Glean строит DAG из подвопросов, параллельно прогоняет каждый уровень через Hydra, пишет вывод по каждой ветке, дедуплицирует источники в один нумерованный список цитат и только затем пишет ответ. Таймлайн показывает план и ход работы в реальном времени.
Какие AI-модели он может использовать?Любой endpoint, совместимый с OpenAI, с вашим собственным ключом — встроен поиск по моделям OpenRouter с избранным. Локальные модели вроде Ollama или LM Studio тоже подойдут, если включена настройка OPENGLEANALLOWPRIVATELLMURL (по умолчанию выключена).
Могу ли я сузить область поиска запроса?Да — из верхней панели вы выбираете базу данных и коллекции, по которым запрос будет искать, и поиск расходится по всем выбранным коллекциям. Можно также открыть одну коллекцию и искать внутри неё.
Он ищет и в открытом интернете?По желанию — веб-поиск выполняется через веб-плагин вашего провайдера LLM (OpenRouter), а его цитаты появляются рядом с источниками Hydra в панели источников.
What are similar projects?quivr, whirl, onyx, openhikmah-web, khoj, OpenMetadata, Resume-Matcher, utopia
Which topics is it in?second-brain, ai-chat, deep-research, web-search, byok, openrouter, ai-assistant, vector-search, knowledge-management, knowledge-graph, mongodb, semantic-search
Creator
hydra-db
Size
1.4 MB
Stars
1.6K
Updated
CommitOct 17
Age
1mo
Commits · 90 Days