Документация

С чего начать

В облаке

Откройте приложение, заведите бесплатный аккаунт — устанавливать ничего не нужно. Чтобы включить ассистента, добавьте свой ключ AI-провайдера в Настройки → AI. Вы платите провайдеру напрямую, наценки за токены нет.

На своём сервере

Весь стек поднимается через Docker Compose: Postgres, Redis, Meilisearch, MinIO, SearXNG, сервер совместного редактирования, MCP-сервер и две песочницы для кода. Владелец инстанса не ограничен ни планами, ни лимитами.

git clone https://github.com/iezhik87/sinoutX.git
cd sinoutX
cp .env.example .env   # заполните значения
docker compose up -d

Подробности развёртывания — в DEPLOY.md.

Аккаунт и безопасность

Первый зарегистрированный пользователь становится владельцем инстанса (OWNER). Дальше регистрация работает в одном из трёх режимов, который владелец выбирает в админке: открытая, по инвайт-коду или закрытая.

Двухфакторная аутентификация (TOTP) включается в Настройки → Безопасность: приложение показывает QR-код, после подтверждения кодом 2FA становится обязательной при входе. Вход защищён от перебора — пять неудачных попыток блокируют пару «почта + IP» на 15 минут.

Пространство и проекты

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

Проект Входящие (Inbox) создаётся сам и служит для быстрой записи: туда попадает всё, что ассистент не привязал к конкретному проекту. Он системный, поэтому не считается за проект в лимитах плана.

Модули тоже устроены как проекты — только помеченные особым флагом, со своими реестрами вместо страниц.

Страницы и редактор

Редактор блочный: заголовки, списки, чек-листы, таблицы, код, цитаты, изображения, вложения, ссылки между страницами. Страницы вкладываются друг в друга и образуют дерево.

Совместное редактирование работает в реальном времени: текст синхронизируется через отдельный сервер (Hocuspocus/Yjs), видны курсоры соавторов.

История версий хранится отдельно — любую версию можно посмотреть и восстановить.

Экспорт страницы или всего проекта: md, docx, pdf, zip, а бюджет — в csv.

Задачи

Статусы: TODO, IN_PROGRESS, REVIEW, DONE, CANCELLED. Приоритеты: LOW, MEDIUM, HIGH, URGENT.

Представления: список, доска (канбан с перетаскиванием), диаграмма Гантта, диаграмма сгорания, трекер времени. Есть подзадачи, теги, комментарии, произвольные поля и правила автоматизации.

Повторяющиеся задачи. У задачи можно задать правило повторения. Когда исходная задача закрывается, планировщик создаёт следующую и «гасит» исходную, чтобы не плодить дубликаты.

Напоминания задаются списком моментов времени и приходят в приложение и в Telegram.

Поиск по базе

Поиск двухслойный. Meilisearch отвечает за мгновенный полнотекстовый поиск по страницам, задачам, заметкам и распознанным файлам. Поверх него работает семантический слой на эмбеддингах — он находит по смыслу, даже когда точных слов в тексте нет.

Индекс перестраивается при каждом старте сервера; принудительный переиндекс есть в Настройки → Бэкап → Reindex.

Доска идей и граф знаний

Vision Board — бесконечный холст: стикеры, заметки, изображения, связи между узлами. Ассистент умеет создавать холсты и добавлять на них узлы.

Граф знаний строится по ссылкам между страницами, заметками, задачами и источниками — и показывает, что с чем связано.

Ассистент и AI-ключи

Ассистент живёт в приложении и в Telegram. Он не советует, а делает: создаёт страницы и задачи, пишет записи в реестры, ищет в интернете, считает калории и балансы, напоминает и присылает утренние сводки.

BYOK — ключи ваши. В Настройки → AI добавляется ключ провайдера, модель выбирается для каждого пользователя отдельно. Наценки за токены нет: вы платите провайдеру напрямую.

Поддерживаемые провайдеры:

У каждого провайдера можно задать свой Base URL. Благодаря этому подключается любой OpenAI-совместимый эндпоинт — локальный LM Studio, собственный прокси или self-hosted шлюз. Для локальных моделей ключ не нужен.

Под капотом у ассистента больше семидесяти инструментов. Они разложены по группам:

Часть инструментов закрыта гейтингом возможностей — их нельзя вызвать без соответствующего права:

Поиск по интернету

Инстанс поднимает собственный SearXNG — метапоисковик, который агрегирует Google, Bing, DuckDuckGo и другие. Ваши запросы не уходят в чужую аналитику.

Ассистент не просто ищет, а доводит результат до вашей базы: читает найденные страницы, сохраняет их как источники и связывает со страницей проекта.

Шаблоны проектов

Шаблон — это не пустая заготовка, а сценарий: ассистент строит структуру страниц и задач, ищет источники и пишет содержимое. Встроенные шаблоны:

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

Навыки и свои инструменты

Навык (скил) — повторяющееся действие по расписанию, которое ассистент заводит себе сам по вашей просьбе: утренний брифинг, еженедельный отчёт по финансам, напоминание сдать анализы. Управляется инструментами create_skill, list_skills, delete_skill и требует возможности assistant_full.

Свои инструменты. Любой HTTP-API можно обернуть в инструмент, который ассистент будет вызывать наравне со встроенными. Обычно его собирает сам ИИ по вашему описанию: «ходи на такой-то эндпоинт, вот ключ, верни курс валют». Определение хранится в настройках пространства, ключи шифруются, запросы проходят через защиту от SSRF и таймаут.

Песочница кода

Инструмент execute_code запускает Python или bash в отдельном контейнере, а не внутри бэкенда. Контейнеров два, и это принципиально:

Модули и реестры

Модуль — это вертикальное расширение: набор реестров (Collections) с готовой схемой, представлениями и подсказками для ассистента. Ставится и удаляется в один клик в разделе Модули.

Реестр — таблица с типизированными полями. Доступные типы:

Поле relation ссылается на записи другого реестра. Поле secret шифруется на диске, маскируется в интерфейсе и исключается из поиска и памяти ассистента.

Каждый реестр показывается в одном из представлений: table, form, chart, board, calendar, gallery.

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

Свои модули. Владелец инстанса может импортировать собственный манифест — из файла или по URL — и он появится в общей витрине.

Медкарта

Личный медицинский архив. Реестры: профиль, анализы, показатели, визиты, состояния, лекарства, измерения, питание, исследования, документы.

Измерения хранят давление, пульс, глюкозу, сатурацию, температуру, вес, шаги, калории и ИМТ. Питание считает калории и БЖУ — достаточно написать ассистенту «на обед салат с курицей 250 г».

Распознавание документов. Пайплайн medical-scan читает фото или PDF анализа и раскладывает показатели по строкам, вместе с референсными границами — значения вне нормы подсвечиваются.

Всю карту можно выгрузить одним PDF.

Финансы

Реестры: счета, транзакции, бюджет. Поддерживаются расходы, доходы и переводы между счетами.

Обмен валют. У перевода задаются сумма списания, сумма зачисления и курс — поэтому обмен между счетами в разных валютах считается по вашему курсу, а не по чужому справочнику.

Распознавание чеков. Пайплайн receipt-scan читает фото чека, определяет магазин, сумму и категорию и записывает расход.

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

Сейф

Пароли, карты и произвольные секреты. Реестры: логины, карты, секреты.

Поля с типом secret шифруются на диске отдельным ключом инстанса. В списках они показываются масками, значение отдаётся только по явному запросу конкретного поля.

Выдача в Telegram. Попросите бота «дай пароль от gmail» — он пришлёт значение и удалит своё сообщение через минуту. Само сообщение не сохраняется в истории диалога.

Импорт из Bitwarden. Экспортируйте хранилище в незашифрованный JSON и загрузите на странице модуля: логины, карты и защищённые заметки разложатся по реестрам, секретные поля зашифруются при записи.

Память

Модуль хранит долговременную память ассистента в компактном виде: ядро (кто вы и что для вас важно), факты, сущности и эпизоды. Память переживает перезапуск диалога и работает в приложении, в Telegram и во внешних агентах через MCP.

Ассистент пополняет её инструментами remember и recall, а консолидация схлопывает накопленные эпизоды в устойчивые факты.

Личный рост

Привычки с отметками выполнения, цели по методике OKR с ключевыми результатами и дневник. Ассистент умеет заводить привычку, отмечать её, ставить цель и делать запись в дневник — из чата, без открытия интерфейса.

Мессенджеры: Telegram и Viber

Telegram

Бот становится полноценным пультом ассистента. Подключается за три шага: создать бота у @BotFather, вставить токен в Настройки → Интеграции, нажать «Подключить».

Что умеет: текст, пересланные фото и PDF (распознаются), голосовые сообщения (расшифровываются), живой индикатор «печатает…» с описанием текущего шага, форматированные ответы, кнопки действий под задачами.

Viber

Второй канал того же ассистента. Бот создаётся на partners.viber.com, токен вставляется в Настройки → Интеграции → Viber; вместо /start нужно подписаться на бота — так он узнаёт, куда писать.

Работает то же самое: заметки и задачи, распознавание фото и PDF, кнопки действий, напоминания и утренние сводки. Команды /tasks, /today, /balance, /new, /help понимаются как текст.

Чего в Viber нет и почему это видно:

• Нет индикатора «печатает…» и редактирования сообщений — живой строки прогресса не будет, ответ приходит целиком.
• Нельзя удалить отправленное сообщение — поэтому инструмент выдачи паролей из Сейфа в Viber отключён на уровне набора инструментов агента: секрет, который нельзя отозвать, не должен попадать в чат.
• Файлы отправляются только по публичной ссылке — выгрузка проекта документом работает в Telegram.

Подключение Claude (MCP)

В SinoutX встроен MCP-сервер, поэтому внешний агент — например Claude Desktop — может читать и писать ваше пространство как долговременную память. Создайте ключ в Настройки → API-ключи и добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "sinout": {
      "command": "npx",
      "args": ["-y", "mcp-remote",
        "https://app.sinout.dasp.top/mcp",
        "--header", "x-api-key:sk_sinoutx_ваш_ключ"]
    }
  }
}

После перезапуска появятся инструменты sinout_*: страницы, задачи, события, заметки, бюджет, реестры, память, граф, поиск и загрузка файлов. Отдельно есть sinout_init_agent — он подтягивает инструкции и реестры, чтобы агент сразу понимал, что куда класть.

API и ключи

Всё, что делает интерфейс, доступно через REST API с префиксом /api/v1. Персональный ключ создаётся в Настройки → API-ключи и передаётся заголовком x-api-key. У ключа можно задать срок жизни и права.

Интерактивная документация со списком всех эндпоинтов открывается по адресу /docs на вашем инстансе.

curl https://app.sinout.dasp.top/api/v1/projects \
  -H "x-api-key: sk_sinoutx_ваш_ключ"

Импорт и экспорт

Импорт в Настройки → Импорт: ZIP-экспорт Notion (Markdown & CSV или HTML) и ZIP-архив хранилища Obsidian. Иерархия страниц сохраняется.

Экспорт: страница или проект в md, docx, pdf и zip; бюджет — в csv; модуль целиком — в PDF. Ассистент умеет присылать экспорт файлом прямо в Telegram.

Бэкап и восстановление

Пользовательский бэкап (Настройки → Бэкап) выгружает ZIP со всем содержимым: проекты, страницы, задачи, заметки, события, бюджет, вложения и связи. Восстановление добавляет недостающие объекты, не удаляя существующие.

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

Совместная работа

Делится не пространство, а конкретный проект. У приглашённого две возможные роли:

Страницы редактируются одновременно, курсоры соавторов видны в реальном времени.

Админка и мониторинг

Владельцу и админам доступны: управление пользователями, режим регистрации, журнал аудита, лицензионные ключи, импорт модулей и выдача возможностей конкретному пользователю (гейтинг из раздела про ассистента).

Мониторинг показывает, кто сейчас онлайн, загрузку процессора и памяти, сеть, диски, историю за последний час и настраиваемые оповещения при выходе за пороги.

Квоты. Для каждого пользователя видно занятое место и лимит; при исчерпании загрузка файлов блокируется. Лимит можно переопределить поверх плана.

Тарифы

За строки в базе денег не берут. Проекты, страницы, заметки, задачи, реестры и модули безлимитны на любом тарифе: они ничего не стоят и наказывать за пользование продуктом бессмысленно. Платят только за то, у чего есть себестоимость.

Место покупается, а не измеряется. Пакет — 200 МБ за $0.60 в месяц. Он списывается в момент покупки и дальше ежемесячно, пока вы его держите. Когда место заканчивается, загрузка файлов останавливается — уже загруженное никуда не девается и остаётся доступным. Отдать пакет можно, если файлы после этого влезут в оставшийся лимит: удалять их за вас никто не будет.

Один кошелёк. Хостинг, место, люди и токены списываются с одного баланса; пополняется он криптовалютой. Свой ключ AI обнуляет счётчик токенов навсегда — это и есть обещание «0% наценки».

Сколько стоят токены. На встроенной модели: $0.65 за 1 млн входящих токенов и $1.31 за 1 млн исходящих (кэшированный ввод — в разы дешевле). В человеческих единицах обычный ответ ассистента стоит доли цента, а месяц активного использования редко превышает пару долларов. Со своим ключом токены не тарифицируются нами вовсе.

Совместная работа. Коллег вы приглашаете по почте в общие проекты. У каждого свой отдельный аккаунт — они не сидят под одним входом. Отдельной платы «за место» нет: каждый аккаунт это обычный пользователь со своей подпиской $5/мес и своим балансом (или своим ключом). Приглашение бесплатно; вы платите только за себя, коллега — только за себя. На своём сервере совместную работу открывает лицензия Team.

Новый аккаунт в облаке начинается замороженным. Заметки, поиск и экспорт работают, но чтобы создавать и загружать — пополните баланс. Первое пополнение сразу закрывает месяц и снимает заморозку. Минимальное пополнение — $15.

Лицензия Team вечная. Платёж покупает год обновлений, а не право пользоваться. Не продлили — всё продолжает работать, просто не обновляется.

Стоп-кран. На встроенную модель действует месячный потолок расходов (по умолчанию $20). Он защищает не нас, а вас: зациклившийся ночью агент способен сжечь бюджет за час.

Неоплата облака замораживает запись, а не данные. Чтение, поиск и экспорт продолжают работать; пополнение сразу возвращает всё. Владелец и админы инстанса не платят и не замораживаются никогда. На своём сервере ежемесячных счетов нет вовсе.

Приватность

Данные лежат на вашем сервере, в вашей базе. Ассистент работает на вашем ключе AI: запрос уходит выбранному провайдеру напрямую, наценки за токены нет. Хотите совсем без внешних сервисов — подключите локальную модель через Ollama.

Поиск по интернету идёт через свой SearXNG, а не через чужой поисковик с вашей аналитикой. Секреты Сейфа шифруются на диске и исключены из индексации и памяти. Все значимые действия пишутся в журнал аудита.

Подробнее: Политика приватности · Условия