Open Brain

Ваша персональная инфраструктура знаний. Записывайте мысли откуда угодно, ищите по смыслу.

Open Brain хранит ваши мысли с помощью AI-сгенерированных эмбеддингов, поэтому любой AI-ассистент может искать по вашей памяти на основе смысла, а не ключевых слов. Мысли поступают из Telegram, автоматизированных конвейеров или любого MCP-совместимого AI-клиента (Claude, ChatGPT и другие) и мгновенно становятся доступными для поиска. Граф знаний автоматически связывает похожие мысли, извлекает сущности и отслеживает закономерности совместного появления. Автоматическое обслуживание поддерживает граф в актуальном состоянии — дедуплицирует почти дубликаты, отслеживает развитие тем, синтезирует идеи и архивирует устаревший контент.

Все хранится в вашей собственной базе данных, поэтому вы владеете своими данными.

Как это работает

flowchart LR
    TG[Telegram Message] --> TGBot[telegram-bot\nEdge Function]
    MCP[AI Client\nClaude/ChatGPT] --> MCPServer[open-brain-mcp\nEdge Function]
    Pipeline[RSS/HF Papers/\nEmergent Mind] --> RunPipeline[run-pipeline\nEdge Function]
    TGBot --> OR1[OpenRouter\nEmbedding + Metadata]
    MCPServer --> OR2[OpenRouter\nEmbedding + Search]
    RunPipeline --> OR3[OpenRouter\nTriage + Embed]
    OR1 --> DB[(Postgres\n+ pgvector)]
    OR2 --> DB
    OR3 --> DB
    MCPServer --> DB
    TGBot --> TGReply[Telegram Reply\nwith Metadata]

Путь захвата

Когда вы отправляете сообщение в Telegram-бот, Edge-функция telegram-bot подхватывает его через вебхук. Она параллельно отправляет сообщение в OpenRouter для двух задач: генерации векторного эмбеддинга (числового представления смысла) и извлечения метаданных, таких как темы, упомянутые люди, задачи, тематика, оценка качества и именованные сущности. Мысль проверяется на семантические дубликаты, сохраняется в вашей базе данных с автоматическими ссылками на связанные мысли, а бот отвечает кратким содержанием того, что было сохранено.

Путь конвейера

Edge-функция run-pipeline автоматически собирает идеи из RSS-лент (AI-рассылки), ежедневных статей Hugging Face и Emergent Mind (трендовые статьи arXiv). Каждый элемент проходит сортировку на релевантность, эмбеддинг, дедупликацию и сохранение. Запускается по расписанию через GitHub Actions (развертывание в Supabase) или встроенный cron-контейнер (развертывание в Docker).

Путь поиска

Любой AI-клиент, подключенный через MCP (Model Context Protocol), может искать ваши мысли по смыслу с помощью семантического поиска, просматривать их по фильтрам (тип, тема, человек, время), получать сводную статистику или запрашивать еженедельный обзор тем. Edge-функция open-brain-mcp обрабатывает эти запросы, аутентифицируясь с помощью вашего персонального ключа доступа.

Граф знаний

Каждая мысль автоматически связывается с похожими мыслями через векторное сходство. Связи со сходством выше 0.80 классифицируются LLM в типизированные отношения (расширяет, противоречит, является-доказательством-для, заменяет). Именованные сущности (люди, инструменты, проекты, организации) извлекаются и разрешаются в общий граф сущностей. Ребра совместного появления отслеживают, какие мысли извлекаются вместе с течением времени, укрепляя связи на основе реальных паттернов использования.

Хранение

Все хранится в Postgres с использованием pgvector для быстрого поиска по сходству. Мысли сохраняются вместе с их эмбеддингами (1536-мерные векторы), метаданными, типизированными связями и ссылками на сущности. Вы можете развернуть решение на Supabase (управляемый хостинг) или самостоятельно с помощью Docker Compose.

Варианты развертывания

Выберите, как вы хотите запускать Open Brain:

Развертывание в Supabase

Предварительные требования

1. Аккаунт Supabase — Supabase — это хостинговая база данных Postgres со встроенными API, аутентификацией и Edge-функциями (бессерверный код). Создайте бесплатный аккаунт на supabase.com. Создайте новый проект — вам понадобятся URL проекта (выглядит как https://abcdef.supabase.co) и сервисный ключ роли (длинная строка, которую можно найти в разделе Settings > API).

2. Supabase CLI — Инструмент командной строки для управления вашим проектом Supabase (применение миграций базы данных, развертывание функций, установка секретов).

   npm install -g supabase

3. Аккаунт OpenRouter — OpenRouter маршрутизирует запросы к AI-моделям. Здесь он используется для генерации эмбеддингов (векторных представлений ваших мыслей) и извлечения метаданных. Создайте аккаунт на openrouter.ai и сгенерируйте API-ключ в панели управления.

4. Telegram-бот (рекомендуется) — Основной способ захвата мыслей на ходу. Создайте бота через @BotFather в Telegram и запустите скрипт настройки (см. ниже). Если вам нужен только доступ через MCP, этот шаг можно пропустить.

Быстрый старт

1. Клонируйте репозиторий

git clone https://github.com/YOUR_USERNAME/open_brain.git
cd open_brain

2. Привяжите ваш проект Supabase

cd supabase
supabase link --project-ref YOUR_PROJECT_REF
cd ..

Совет: Ваш идентификатор проекта (ref) — это поддомен в вашем URL Supabase. Если ваш URL https://abcdef.supabase.co, ваш идентификатор проекта — abcdef.

3. Запустите bootstrap

./scripts/bootstrap.sh

Bootstrap проведет вас через настройку окружения. Он запросит каждый секрет (URL Supabase, сервисный ключ, API-ключ OpenRouter, токены Telegram и т.д.), автоматически сгенерирует криптографический ключ доступа MCP и запишет все в .env.local. Если у вас уже есть .env.local, он покажет существующие значения и позволит обновить конкретные из них.

4. Запустите deploy

./scripts/deploy.sh

Deploy применяет схему базы данных (создает таблицу мыслей с индексами векторного поиска), загружает ваши секреты в Supabase и развертывает все Edge-функции. Он показывает пошаговый чек-лист по мере выполнения каждой операции. В конце он выводит ваш URL для подключения к MCP и готовую команду для Claude Code.

5. Запустите validate

./scripts/validate.sh

Validate выполняет 8 проверок вашего развертывания, чтобы подтвердить, что все работает: доступ к базе данных, RPC-функции, доступность Edge-функций, аутентификация, захват мыслей, семантический поиск и список мыслей. Он выводит чек-лист с результатами (пройдено/не пройдено) для каждой проверки и итоговое резюме.

Настройка Telegram-бота (опционально)

Создайте бота через @BotFather в Telegram, затем запустите скрипт настройки:

./scripts/setup-telegram.sh YOUR_BOT_TOKEN

Скрипт проверяет ваш токен, регистрирует вебхук, настраивает автодополнение команд и выводит переменные окружения и секреты для настройки. Следуйте выведенным инструкциям для завершения настройки.

Подключите ваш AI-клиент

После развертывания подключите ваш AI-клиент, чтобы начать использовать Open Brain. Вам понадобятся два значения:

• URL эндпоинта MCP: https://YOUR_REF.supabase.co/functions/v1/open-brain-mcp/mcp (Supabase) или http://localhost:80/functions/v1/open-brain-mcp (Docker)

• Ключ доступа MCP: Ключ, сгенерированный во время настройки (сохранен в .env.local или .env для Docker)

Совет: Скрипт развертывания (Supabase) или запуска (Docker) выводит точную команду подключения с уже подставленными вашими значениями.

Claude Code (CLI — рекомендуется)

claude mcp add --transport http --header "x-brain-key: YOUR_MCP_KEY" open-brain https://YOUR_REF.supabase.co/functions/v1/open-brain-mcp/mcp

Это регистрирует Open Brain как MCP-сервер, который Claude Code может использовать в любом диалоге. Замените YOUR_MCP_KEY и YOUR_REF на ваши реальные значения.

Claude Code (проект .mcp.json)

Добавьте это в файл .mcp.json в корне вашего проекта, чтобы поделиться подключением с вашей командой:

{
  "mcpServers": {
    "open-brain": {
      "type": "http",
      "url": "https://YOUR_REF.supabase.co/functions/v1/open-brain-mcp/mcp",
      "headers": {
        "x-brain-key": "${MCP_ACCESS_KEY}"
      }
    }
  }
}

Примечание: Синтаксис ${MCP_ACCESS_KEY} использует расширение переменных окружения, поэтому ваш ключ не попадает в систему контроля версий. Установите переменную окружения MCP_ACCESS_KEY на каждой машине, которая использует эту конфигурацию.

Claude Desktop

Claude Desktop не поддерживает удаленные MCP-серверы через конфигурационные файлы. Вместо этого:

1. Откройте Claude Desktop > Settings > Connectors

2. Нажмите Add a new connector

3. Введите URL эндпоинта MCP: https://YOUR_REF.supabase.co/functions/v1/open-brain-mcp/mcp

4. Настройте заголовок аутентификации x-brain-key с вашим ключом доступа MCP

ChatGPT (Pro/Team/Enterprise/Edu)

1. Перейдите в Settings > Connectors > Advanced > Developer Mode

2. Добавьте URL MCP-сервера: https://YOUR_REF.supabase.co/functions/v1/open-brain-mcp/mcp

3. Настройте заголовок аутентификации x-brain-key с вашим ключом доступа MCP

Примеры использования

Захват через Telegram

Отправьте любое сообщение вашему боту, и Open Brain автоматически обработает его:

You: Just had a great meeting with Sarah about the Q3 product roadmap.
     She wants to prioritize the mobile app redesign.

Bot: Captured!
  Type: meeting_note
  Theme: personal
  Topics: q3-roadmap, mobile-app-redesign
  Quality: 0.7
  People: Sarah
  Action items: Prioritize mobile app redesign
  Why: Records a product strategy decision with clear ownership
  Related: "Product planning session notes..." (82% similar)

Каждое сообщение превращается в вектор, обогащается извлеченными метаданными, проверяется на дубликаты, автоматически связывается с похожими мыслями, а сущности разрешаются в граф знаний.

Семантический поиск

Попросите любой подключенный AI-клиент поискать в вашем «мозге»:

You: Search my brain for anything about product roadmap discussions

Claude: I found 3 relevant thoughts:
  1. (0.89 similarity) Meeting with Sarah about Q3 product roadmap...
  2. (0.82 similarity) Product planning session notes...
  3. (0.76 similarity) Quarterly goals discussion...

Семантический поиск находит мысли по смыслу — даже если вы использовали другие слова. Запрос о «планировании продукта» найдет мысли о «обсуждениях дорожной карты», потому что их смысл схож.

Еженедельный обзор

Получите сгенерированную AI сводку ваших недавних размышлений:

You: Give me a weekly review of my recent thoughts

Claude: Here's your weekly review:
  Themes: Product planning, team meetings, technical architecture
  Open loops: Mobile redesign decision pending, API migration timeline
  Connections: Sarah mentioned in 3 meetings this week, all about mobile

Еженедельный обзор анализирует мысли за последние 7 дней и синтезирует темы, незавершенные задачи, связи между идеями и пробелы в ваших размышлениях.

Доступные инструменты

См. docs/cookbook.md для подробных паттернов использования, композиций инструментов и неочевидного поведения.

Навыки (Рабочие процессы Claude Code)

Open Brain включает навыки Claude Code — структурированные многофазные рабочие процессы, которые объединяют инструменты MCP выше в анализ более высокого уровня. Навыки автоматически обнаруживаются из .claude/skills/ и вызываются как слэш-команды.

См. docs/skills/README.md для подробных описаний и использования.

Автоматическое обслуживание

Open Brain запускает фоновое обслуживание для поддержания здоровья графа знаний. Эти задания выполняются автоматически — через GitHub Actions (развертывание в Supabase) или встроенный cron-контейнер (развертывание в Docker).