---

Внимание: Этот проект активно развивается. Он обладает надежными основными возможностями и покрытием тестами, и мы продолжаем улучшать документацию, защиту и функциональные возможности с каждым релизом. Приветствуются вклады, сообщения об ошибках и отзывы.

Возможности

• Визуальное исследование графов — перетаскивание сущностей, интерактивное исследование связей
• 20+ встроенных трансформаций — DNS, WHOIS, SSL-сертификаты, геолокация, обогащение веб/email/хэш/социальных сетей и другое
• Transform Hub — просматривайте и устанавливайте трансформации сообщества из реестра
• AI Investigator — агентные исследования на основе подсказок, которые планируют запуски трансформаций, транслируют прогресс в реальном времени и обобщают результаты с возможностью аудита
• Импорт / Экспорт — импорт в форматах JSON, CSV, GraphML и MTGX
• Анализ графов — центральность, обнаружение сообществ, кратчайшие пути
• Совместная работа в реальном времени — проекты, общий доступ и синхронизация в реальном времени через Supabase Realtime
• Асинхронные задания трансформаций — очередь Redis/RQ с обновлениями прогресса через WebSocket
• Система плагинов — обнаружение плагинов на основе директорий с манифестами YAML
• Инструмент CLI — поиск, установка и управление трансформациями из терминала
• Работает везде — локальный режим SQLite (без конфигурации) или PostgreSQL + Supabase для командных/облачных настроек
• Готов к использованию с Docker — развертывание одной командой docker compose up

Скриншоты

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

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

Инструмент	Версия
Python	3.14+
uv	latest
Node.js	20+
pnpm	latest

Бэкенд```bash

cd backend uv sync uv run uvicorn ogi.main:app --reload

API будет доступен по адресу `http://localhost:8000`.

Для локального выполнения трансформации также должны быть запущены Redis и transform worker. Одного Redis недостаточно.

Запустите Redis:```bash
docker run -d --name ogi-redis -p 6379:6379 redis:7-alpine

Запустите воркер преобразования во втором терминале:```bash cd backend uv run python -m ogi.worker.run_worker

Если вы видите `Job queue not available` или `Redis not available`, убедитесь, что:

- `OGI_REDIS_URL` указывает на `redis://localhost:6379/0` для локальных запусков на хосте
- бэкенд был перезапущен после запуска Redis
- отдельный процесс воркера запущен
- вы не используете hostname `redis`, доступный только в Docker, вне Docker Compose

Если вы запускаете бэкенд с PostgreSQL (`OGI_USE_SQLITE=false`), при запуске автоматически применяются миграции Alembic перед обработкой запросов. Развертывания Docker делают то же самое в точке входа контейнера бэкенда.

Запуски AI Investigator обрабатываются другим отдельным воркером:```bash
cd backend
uv run python -m ogi.agent.run_worker

Фронтенд```bash

cd frontend pnpm install pnpm dev

Откройте http://localhost:5173. Вот и всё.

### AI Investigator

AI Investigator — это опциональный рабочий процесс на основе провайдера, который может планировать последовательности преобразований, запрашивать утверждения и обобщать ход расследования в рабочем пространстве.

- Откройте вкладку `AI Investigator` в проекте
- Настройте провайдера и модель в диалоге настроек исследователя
- Сохраните ключи API провайдера в разделе `API Keys`
- Запустите отдельный процесс `agent-worker` вместе с бэкендом

Текущая реализация поддерживает настройку провайдера для каждого пользователя и выделенный рабочий процесс, который выполняет шаги расследования независимо от основного API-сервера.

### CLI

Два поддерживаемых способа запуска CLI:

**Рекомендуемый** (активация не требуется):```bash
cd backend
uv sync
uv run ogi --help

Активированная virtualenv (простая команда ogi):```bash cd backend uv venv

PowerShell:

..venv\Scripts\Activate.ps1 uv pip install -e . ogi --help

## Docker

### Разработка```bash
cp .env.example .env
docker compose up

Продуктивная среда

Используйте предварительно собранные образы GHCR.

Важно: docker-compose.prod.yml требует внешнюю базу данных PostgreSQL. Он не включает сервис db.

Если вы хотите использовать единый локальный стек Docker со встроенными Postgres и Redis, используйте:```bash docker compose up -d

Используйте файл компоновки для продакшена только если у вас уже есть доступный экземпляр PostgreSQL и вы установили `OGI_DATABASE_URL` соответствующим образом:```bash
docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d

Установите OGI_IMAGE_TAG в .env, чтобы зафиксировать конкретный тег образа релиза (например, v0.2.6). По умолчанию — latest.

Hetzner Cloud