Системная программная платформа — среда исполнения, администрирования и мониторинга моделей искусственного интеллекта на автономных вычислительных устройствах. Описание функциональных характеристик, инструкция по установке и информация для эксплуатации.
Правообладатель: ООО «КапиТех»
Версия ПО: 1.0
Дата документа: 28.08.2026
Полное наименование: Системная программная платформа «КапиБокс» — среда исполнения, администрирования и мониторинга моделей искусственного интеллекта.
Сокращённое наименование: «КапиБокс».
Правообладатель: Общество с ограниченной ответственностью «КапиТех» (ООО «КапиТех»), ИНН 1655512058, ОГРН 1261600002839, адрес места нахождения: 420043, Республика Татарстан, г. Казань, ул. Вишневского, д. 59А, корп. 3, кв. 135.
Основание прав: свидетельство о государственной регистрации программы для ЭВМ № 2026684075 от 07 августа 2026 года, выданное Федеральной службой по интеллектуальной собственности (Роспатент). Правообладатель — ООО «КапиТех»; автор — Капитонов Евгений Александрович; исключительное право принадлежит правообладателю на основании статьи 1295 Гражданского кодекса Российской Федерации (служебное произведение).
Платформа «КапиБокс» предназначена для локального — на устройстве заказчика, без использования облачных сервисов — исполнения языковых и мультимодальных моделей искусственного интеллекта, а также для администрирования и мониторинга среды их исполнения. Платформа обеспечивает:
Обработка данных производится исключительно локально; облачная составляющая для работы платформы не требуется.
Платформа предоставляет прикладному программному обеспечению программный интерфейс на основе протокола HTTP с форматом обмена данными JSON:
| Метод | URI | Назначение |
|---|---|---|
| POST | /llm/generate | Генерация текста в чат-формате (последовательность сообщений messages с ролями) |
| GET | /models | Перечень моделей искусственного интеллекта, доступных для исполнения |
| GET | /health | Состояние платформы: службы, загруженные модели, ресурсы, статус лицензии |
| GET | /queue | Очередь запросов к моделям: занятость, исполняемые задачи, число ожидающих |
| GET | /license/status | Статус лицензии рабочего места (офлайн-проверка ключей) |
| POST | /rag/search | Поиск по смыслу во встроенном векторном хранилище (эмбеддинг-модели) |
| GET | /rag/count | Количество фрагментов в коллекции векторного хранилища |
Служебные и пользовательские данные платформы размещаются в шифрованном хранилище на локальном накопителе устройства, что исключает доступ к данным при физическом изъятии накопителя.
Платформа обеспечивает настройку сетевых параметров устройства (адресация, параметры подключения к локальной сети заказчика) через веб-интерфейс, без необходимости доступа к операционной системе устройства.
Доступ к функциям администрирования защищается двухфакторной аутентификацией по стандарту TOTP (одноразовые пароли на основе времени): помимо пароля, требуется код из приложения-аутентификатора.
/health) для контроля состояния служб, моделей и вычислительных ресурсов;| Компонент | Характеристика |
|---|---|
| Основной язык программирования | Python версии 3.12 |
| Веб-часть (программный интерфейс HTTP) | Каркас FastAPI, ASGI-сервер Uvicorn |
| Службы исполнения | Служебные юниты systemd: kapibox-inference (исполнение моделей), kapibox-runtime (администрирование, мониторинг, программный интерфейс) |
| Формат обмена данными | JSON |
| Компонент | Лицензия | Назначение |
|---|---|---|
| Python | PSF License (совместима с BSD) | Среда исполнения |
| FastAPI | MIT | Каркас программного интерфейса HTTP |
| Uvicorn | BSD-3-Clause | ASGI-сервер |
| Pydantic | MIT | Валидация данных |
| Requests | Apache 2.0 | HTTP-клиент для внутренних обращений между службами |
| cryptography | Apache 2.0 / BSD | Криптографические операции (проверка подписей обновлений и лицензионных ключей) |
| PyYAML | MIT | Конфигурационные файлы |
| Библиотеки исполнения нейросетевых моделей | Apache 2.0 / MIT / BSD | Исполнение моделей искусственного интеллекта на графическом ускорителе |
Все перечисленные компоненты являются свободным программным обеспечением с лицензиями, разрешёнными к использованию в Российской Федерации, и не включены в перечень запрещённых компонентов, указанный в подпункте «б» пункта 5 Постановления Правительства Российской Федерации от 16.11.2015 № 1236.
| Компонент | Характеристика |
|---|---|
| Операционная система | Linux: Ubuntu 22.04 LTS и выше, а также отечественные операционные системы на базе Linux (Astra Linux, «РЕД ОС», «Альт») |
| Архитектуры | aarch64, x86_64 |
| Вычислители | графический ускоритель с поддержкой технологии NVIDIA CUDA — встраиваемые платформы NVIDIA Jetson, настольные NVIDIA DGX Spark, дискретные ускорители рабочих станций и серверов |
Указаны в документе «Инструкция по установке экземпляра программного обеспечения «КапиБокс»», раздел 2.
Программное обеспечение «КапиБокс» распространяется предустановленным на программно-аппаратных комплексах производства ООО «КапиТех»:
Комплексы размещаются в инфраструктуре заказчика. Право использования программного обеспечения предоставляется на условиях простой (неисключительной) лицензии.
Платформа «КапиБокс» предназначена для организаций, которым требуется применение моделей искусственного интеллекта при обязательной локальной обработке данных (без передачи в облачные сервисы), в том числе:
Программное обеспечение «КапиБокс» относится к сфере искусственного интеллекта в соответствии с критериями, установленными Приказом Министерства экономического развития Российской Федерации от 29 июня 2021 года № 392. Обоснование отнесения приведено в отдельном документе («Обоснование отнесения программного обеспечения «КапиБокс» к сфере искусственного интеллекта»).
В соответствии с Приказом Министерства цифрового развития, связи и массовых коммуникаций Российской Федерации от 22.09.2020 № 486 программное обеспечение «КапиБокс» относится к классам:
Программное обеспечение «КапиБокс» не содержит в своём составе самостоятельных баз данных, подлежащих государственной регистрации в качестве отдельных объектов интеллектуальной собственности. Для хранения конфигурационных параметров и служебных данных используется встроенное шифрованное хранилище на локальном накопителе устройства.
Основной язык взаимодействия с программным обеспечением — русский: веб-интерфейс платформы, сообщения об ошибках, техническая документация, сообщения службы технической поддержки. Технические идентификаторы программного интерфейса HTTP (имена методов, полей JSON) используют английский язык в соответствии с общепринятой отраслевой практикой.
*Документ подготовлен ООО «КапиТех» для комплекта документации программного обеспечения «КапиБокс» в составе подачи сведений для включения в единый реестр российских программ для ЭВМ и баз данных (в соответствии с пунктом 2.1.4 Методических рекомендаций Минцифры России).*
Правообладатель: ООО «КапиТех»
Версия ПО: 1.0 (проверочный экземпляр, сборка 1.1)
Дата документа: 23 сентября 2026
Системная программная платформа «КапиБокс» — среда исполнения, администрирования и мониторинга моделей искусственного интеллекта на вычислительном устройстве (далее — платформа «КапиБокс», программное обеспечение). Платформа предназначена для локального исполнения языковых и иных моделей искусственного интеллекта без использования облачных сервисов, а также для администрирования и мониторинга среды их исполнения.
Настоящая инструкция описывает развёртывание проверочного экземпляра программного обеспечения, предоставленного для проведения экспертной проверки в соответствии с подпунктом «а» пункта 11 Правил, утверждённых постановлением Правительства Российской Федерации от 16.11.2015 № 1236, и пунктом 2.1.2.3 Методических рекомендаций по работе с ФГИС «Реестры ПО».
Экземпляр предоставляется в виде преднастроенного образа виртуальной машины в формате Oracle VirtualBox (файл KapiBox-1.1-proverochnyy.ova) с установленным и активированным программным обеспечением. Образ содержит:
kapibox-runtime (администрирование, мониторинг, лицензирование, программный интерфейс HTTP) и служба kapibox-inference (исполнение моделей искусственного интеллекта);kapibox-update) с открытым ключом проверки подписи пакетов, проверочными пакетами обновления и журналом доставок.Ссылка для скачивания образа (она же указана в заявлении в поле «Ссылка на экземпляр программного обеспечения для проведения экспертной проверки»):
https://kapitech.ru/kapibox/KapiBox-1.1-proverochnyy.ova (размер 3,9 ГБ)
Контрольная сумма SHA-256 образа: 995a125f97cab1a9a63eb0a55effb5b960f16150bd828def9714a78049e70213 (файл KapiBox-1.1-proverochnyy.ova.sha256 рядом с образом).
Учётные данные доступа к консоли виртуальной машины (максимальные привилегии):
| Параметр | Значение |
|---|---|
| Пользователь | ekspert |
| Пароль пользователя | KapiBox2026! |
| Права | полные (sudo без запроса пароля) |
Пользователь root | пароль KapiBox2026root! |
| Доступ | консоль VirtualBox либо SSH на порт 22 виртуальной машины (оба пользователя, вход по паролю) |
Технические средства защиты авторских прав, ограничивающие проверку, в экземпляре отсутствуют: лицензионные ключи уже применены, а также приведены в разделе 6 для повторного применения при необходимости.
| Компонент | Характеристика |
|---|---|
| Средство виртуализации | Oracle VirtualBox 7.x (Windows, Linux или macOS) |
| Процессор хоста | x86_64 с поддержкой аппаратной виртуализации (Intel VT-x / AMD-V), 2 ядра для виртуальной машины |
| Оперативная память хоста | не менее 8 ГБ (виртуальной машине выделяется 4 ГБ) |
| Дисковое пространство | не менее 30 ГБ свободного места |
| Сеть | не требуется: экземпляр работает автономно; сетевой адаптер в режиме NAT нужен только для доступа к интерфейсу с хоста |
Графический ускоритель для проверочного экземпляра не требуется: модели исполняются на центральном процессоре. Промышленное исполнение платформы производится на вычислителях с ускорителями NVIDIA (встраиваемые платформы Jetson, NVIDIA DGX Spark, дискретные ускорители) в составе программно-аппаратного комплекса. В проверочном экземпляре представлены среда исполнения моделей, программный интерфейс HTTP, лицензирование, векторное хранилище, подсистема обновлений и мониторинг; подсистемы, привязанные к аппаратной части комплекса (шифрованный том данных, настройка сети устройства и двухфакторная аутентификация рабочего места в веб-интерфейсе комплекса), демонстрируются на живом экземпляре по разделу 7.
Примечание для хостов под управлением Windows. Если в Windows включён гипервизор (компоненты Hyper-V, «Платформа виртуальной машины», WSL 2, Docker Desktop или «Изоляция ядра»), Oracle VirtualBox работает через него в режиме совместимости — в строке состояния окна виртуальной машины отображается значок черепахи. В этом режиме виртуальная машина с двумя процессорами может надолго останавливаться при исполнении моделей (запросы пунктов 5.4–5.6 завершаются по времени ожидания). Это особенность средства виртуализации, а не программного обеспечения. На таком хосте после импорта следует выключить виртуальную машину и установить ей один процессор (VirtualBox: «Настроить» → «Система» → «Процессор» → 1), после чего запустить снова — проверка раздела 5 выполняется в полном объёме. Иные варианты: хост под управлением Linux либо Windows с отключённым гипервизором (bcdedit /set hypervisorlaunchtype off и перезагрузка) — параметры образа менять не требуется.
Шаг 1. Скачать файл образа KapiBox-1.1-proverochnyy.ova по ссылке из заявления и сверить контрольную сумму SHA-256.
Шаг 2. В Oracle VirtualBox выполнить импорт: меню «Файл» → «Импорт конфигураций…» → указать файл .ova → «Далее» → «Импорт». Параметры виртуальной машины (2 процессора, 4 ГБ оперативной памяти, сетевой адаптер NAT) заданы в образе и изменения не требуют.
Шаг 3. Проброс портов для доступа с хоста уже задан в образе (VirtualBox: «Настроить» → «Сеть» → «Дополнительно» → «Проброс портов» — при необходимости проверить):
| Имя | Протокол | Порт хоста | Порт гостя | Назначение |
|---|---|---|---|---|
| api | TCP | 8000 | 8000 | программный интерфейс платформы |
| ssh | TCP | 2222 | 22 | консоль по SSH (ssh -p 2222 ekspert@127.0.0.1) |
Шаг 4. Запустить виртуальную машину. Загрузка занимает около 30 секунд; службы платформы запускаются автоматически (юниты systemd в состоянии enabled).
Шаг 5. Войти в консоль виртуальной машины (учётные данные — раздел 2) и убедиться, что службы запущены:
systemctl status kapibox-inference
systemctl status kapibox-runtime
Обе службы должны находиться в состоянии active (running).
Проверка выполняется запросами к программному интерфейсу HTTP платформы (порт 8000). Запросы можно выполнять из консоли виртуальной машины (http://localhost:8000) либо с хоста через проброс портов (http://127.0.0.1:8000). Соответствие функций описанию — раздел 3 документа «Описание функциональных характеристик ПО „КапиБокс"».
curl http://localhost:8000/health
Ответ: {"status":"ok","service":"kapibox-runtime"}.
curl http://localhost:8000/license/status
Ответ содержит отпечаток устройства (otpechatok), режим rabotaet, дату оплаченного обслуживания (oplacheno_po) и число оставшихся дней. Проверка подписи ключей выполняется локально, без обращения к сети.
Проверка защиты лицензированием: остановить службу, переименовать файл /var/lib/kapibox/licenzii/obsluzhivanie.key, запустить службу — режим сменится на приостановку с пояснением; вернуть файл на место — режим rabotaet восстановится.
curl http://localhost:8000/models
Ответ содержит перечень моделей, установленных в экземпляре.
curl -X POST http://localhost:8000/llm/generate \
-H "Content-Type: application/json" \
-d '{"messages":[{"role":"user","content":"Ответь одним предложением: что такое реестр российского программного обеспечения?"}],"max_new_tokens":120}'
Ответ содержит сгенерированный моделью текст на русском языке. Первое обращение загружает модель в память и на центральном процессоре может занять до нескольких минут (зависит от производительности хоста); последующие ответы формируются за секунды. Команда curl без параметра --max-time дожидается ответа.
curl http://localhost:8000/queue
Ответ: занятость среды исполнения, исполняемые задачи и число ожидающих запросов (при одновременных запросах из п. 5.4 видно постановку в очередь).
curl -X POST http://localhost:8000/embed \
-H "Content-Type: application/json" \
-d '{"texts":["контроль качества дорожного покрытия"]}'
Ответ содержит векторное представление текста (embeddings). Наполнение векторного хранилища выполняется готовыми векторами (/rag/upsert, точки {id, vector, payload}), поиск — по тексту запроса (/rag/search, поле query) или по вектору. Сквозная проверка «вектор → хранилище → поиск по смыслу» выполняется приложенным в экземпляре сценарием:
bash /opt/kapibox/proverka.sh
Сценарий вычисляет векторы для двух фрагментов («Диагностика автомобильных дорог», «Поставка молочной продукции»), помещает их в коллекцию proverka, выполняет поиск по запросу «обследование дорожного полотна» и выводит результат: ближайшим по смыслу возвращается фрагмент «Диагностика автомобильных дорог»; затем печатает число фрагментов в коллекции (/rag/count?collection=proverka). Все запросы сценария — обычные HTTP-запросы к перечисленным точкам, их текст виден в самом сценарии.
Доставка пакетов на промышленном комплексе идёт по исходящему защищённому соединению с сервером обслуживания правообладателя; в автономном проверочном экземпляре сервер недоступен, поэтому пакеты приложены в каталоге /opt/kapibox/obnovleniya/ и применяются той же подсистемой вручную. Сценарий:
bash /opt/kapibox/proverka_obnovleniy.sh
Сценарий выполняет: (1) применение пакета 1.0.1 с подписью правообладателя — проверка подписи манифеста по открытому ключу /etc/kapibox/update_sign_public.pem, проверка целостности, расшифровка, раскладка файлов по карте компонентов устройства, перезапуск затронутых служб, проверка работоспособности платформы (/health, /models) и запись в журнал доставок; (2) попытку применения пакета с изменённым манифестом — подпись не подтверждается, пакет отклоняется; (3) вывод журнала доставок командой kapibox-update состояние (файл /var/lib/kapibox/updates/sostoyanie.json). Откат к предыдущему состоянию: kapibox-update откатить. Команды принимают и латинские синонимы (apply, rollback, status) — удобно при вводе из терминала без русской раскладки. Документация — раздел 3.5 описания функциональных характеристик.
Ключи применены к экземпляру и хранятся в каталоге /var/lib/kapibox/licenzii/ (aktivaciya.key, obsluzhivanie.key). Для повторного применения (например, после удаления) достаточно вернуть файлы в каталог и перезапустить службу kapibox-runtime; проверка ключей выполняется по открытому ключу license_sign_public.pem из того же каталога. Ключи выпущены правообладателем на отпечаток проверочного экземпляра и действительны по 31.12.2027.
Помимо образа виртуальной машины, правообладатель поддерживает живой экземпляр платформы на вычислителе с графическим ускорителем NVIDIA (браузерная консоль к тем же точкам программного интерфейса):
| Параметр | Значение |
|---|---|
| Адрес | https://demo-kapibox.kapitech.ru |
| Логин и пароль | приведены в экземпляре инструкции, приложенном к заявлению; предоставляются по запросу на e@kapitech.ru |
| Доступность | на весь период экспертизы |
Он демонстрирует исполнение полноразмерных моделей на графическом ускорителе и подсистемы комплекса, привязанные к аппаратной части (раздел 3); для проверки функций, перечисленных в разделе 5, достаточно образа.
| Компонент | Расположение |
|---|---|
| Платформа «КапиБокс» (байт-код Python) | /opt/kapibox/app/platform/kapibox-runtime/ |
| Окружение Python | /opt/kapibox/venv/ |
| Служба исполнения моделей | /opt/kapibox/inference/ |
| Модели искусственного интеллекта | /var/lib/kapibox/modeli/ |
| Векторное хранилище | /var/lib/kapibox/rag/ |
| Лицензионные ключи | /var/lib/kapibox/licenzii/ (каталог /var/lib/kapibox/ доступен через sudo) |
| Подсистема обновлений | /usr/local/sbin/kapibox-update, ключи /etc/kapibox/, пакеты /opt/kapibox/obnovleniya/, журнал /var/lib/kapibox/updates/ |
| Юниты systemd | /etc/systemd/system/kapibox-runtime.service, /etc/systemd/system/kapibox-inference.service |
| Журналы | journalctl -u kapibox-runtime, journalctl -u kapibox-inference |
| ФИО | Должность | Контакты | Режим работы |
|---|---|---|---|
| Капитонов Евгений Александрович | Генеральный директор, руководитель разработки | Электронная почта: e@kapitech.ru. Телефон: +7 (960) 069-81-52 | Будние дни с 10:00 до 19:00 по московскому времени |
*Документ подготовлен ООО «КапиТех» для комплекта документации программного обеспечения «КапиБокс» в составе подачи сведений для включения в единый реестр российских программ для ЭВМ и баз данных (в соответствии с пунктами 2.1.2.3 и 2.1.4 Методических рекомендаций Минцифры России).*
Правообладатель: ООО «КапиТех»
ПО: Системная программная платформа «КапиБокс», версия 1.0
Дата документа: 28.08.2026
Настоящий документ содержит информацию, необходимую для эксплуатации экземпляра программного обеспечения «КапиБокс»: требования к среде функционирования, порядок контроля работоспособности, работу с журнальными файлами, порядок обновления и сведения о технической поддержке. Документ предназначен как для эксплуатирующего персонала заказчика, так и для экспертов Министерства цифрового развития, связи и массовых коммуникаций Российской Федерации при проведении экспертизы заявления о включении программного обеспечения в единый реестр российских программ для ЭВМ и баз данных.
| Компонент | Требование |
|---|---|
| Операционная система | Linux: Ubuntu 22.04 LTS и выше, а также отечественные операционные системы на базе Linux (Astra Linux, «РЕД ОС», «Альт») |
| Архитектура процессора | aarch64 или x86_64 |
| Вычислитель | графический ускоритель с поддержкой технологии NVIDIA CUDA — встраиваемые платформы NVIDIA Jetson, настольные NVIDIA DGX Spark, дискретные ускорители рабочих станций и серверов |
| Оперативная память | Не менее 8 ГБ |
| Дисковое пространство | Не менее 32 ГБ свободного места (с учётом моделей искусственного интеллекта) |
| Сеть | Локальная сеть заказчика; постоянный доступ к сети Интернет не требуется (используется только для получения пакетов обновлений) |
При поставке в составе программно-аппаратных комплексов «КапиБокс» и «КапиБокс-Т» соответствие требованиям обеспечено производителем; со стороны заказчика дополнительные действия не требуются.
Программное обеспечение функционирует в виде двух служебных юнитов systemd:
| Служба | Назначение |
|---|---|
kapibox-inference | Исполнение моделей искусственного интеллекта на локальном ускорителе |
kapibox-runtime | Администрирование, мониторинг, лицензирование, обновления, программный интерфейс HTTP |
Контроль состояния служб:
systemctl status kapibox-inference
systemctl status kapibox-runtime
Штатное состояние обеих служб — active (running). При аварийном завершении службы перезапускаются автоматически средствами systemd.
curl http://localhost:8000/health
Ответ содержит сведения о состоянии служб, загруженных моделях искусственного интеллекта, использовании вычислительных ресурсов и статусе лицензии рабочего места. Точка предназначена в том числе для интеграции с внешними системами мониторинга заказчика.
curl http://localhost:8000/models
Ответ содержит перечень моделей искусственного интеллекта, установленных на устройстве и доступных для исполнения, с указанием их версий.
curl -X POST http://localhost:8000/llm/generate \
-H "Content-Type: application/json" \
-d '{"messages": [{"role": "user", "content": "Ответь одним предложением: что ты умеешь?"}]}'
Ответ содержит текст, сгенерированный моделью искусственного интеллекта, на русском языке в чат-формате.
События работы программного обеспечения записываются в системный журнал операционной системы (systemd-journald). Просмотр журналов штатными средствами:
journalctl -u kapibox-inference # журнал службы исполнения моделей
journalctl -u kapibox-runtime # журнал службы администрирования
journalctl -u kapibox-runtime -f # наблюдение в режиме реального времени
journalctl -u kapibox-runtime --since today # события за текущие сутки
В журналы записываются: запуск и остановка служб, загрузка и выгрузка моделей, операции обновления, события лицензирования и аутентификации, ошибки и предупреждения.
Обновления программного обеспечения распространяются в виде пакетов, подписанных электронной подписью ООО «КапиТех»:
Участие эксплуатирующего персонала в процедуре обновления не требуется. Все операции обновления фиксируются в системном журнале (см. раздел 5).
Для проведения экспертизы ООО «КапиТех» по запросу эксперта предоставляет:
| ФИО | Должность | Контакты | Режим работы |
|---|---|---|---|
| Капитонов Евгений Александрович | Генеральный директор, руководитель разработки | Электронная почта: e@kapitech.ru. Телефон: +7 (960) 069-81-52 | Будние дни с 10:00 до 19:00 по московскому времени |
Служба технической поддержки консультирует по вопросам установки, настройки, эксплуатации и обновления программного обеспечения. Основной канал обращений — электронная почта e@kapitech.ru.
*Документ подготовлен ООО «КапиТех» для комплекта документации программного обеспечения «КапиБокс» в составе подачи сведений для включения в единый реестр российских программ для ЭВМ и баз данных (в соответствии с пунктом 2.1.4 Методических рекомендаций Минцифры России).*