OpenHermesOS · ohOS

Твоё внимание должно работать на тебя, а не на платформу. ohOS — AI-native Linux-дистрибутив, где единственная оболочка — локальный ИИ-агент (Hermes). Включаешь машину → сразу попадаешь в агента, который живёт на твоей машине и на твоей стороне. Ни рабочего стола, ни меню «Пуск» — только ты и агент; документы и медиа открываются как временные поверхности по запросу. Зачем это → VISION.md

English (TL;DR): ohOS is a NixOS-based, kiosk-mode Linux distribution whose only persistent user interface is the Hermes AI agent (core + shell). It boots straight into the agent; there is no desktop environment. Apps, documents, media, browser and system functions surface as temporary, on-demand working surfaces. Not a new kernel — a distro + AI shell. Full English docs are a help-wanted task. See ROADMAP.md.

---

⚠️ Статус

pre-alpha, код ещё не собран. Это скелет проекта: структура, декларативная база (Nix flake), документация и процессы. Первая цель — ISO v0.1 «Bootable MVP». Полный план — в ROADMAP.md.

Флейк и модули написаны идиоматично, но ещё не валидированы на Linux-сборщике (эта машина — macOS). Проверка сборки — задачи P0-A2/P0-A4; их выполняет CI (.github/workflows/build.yml).

Что это

Слой	Технология
Интеллект	Hermes (ядро + Shell), подключаемая LLM (облако/локально)
Оболочка	Cage — Wayland-композитор в режиме киоска (одно приложение на весь экран)
Руки	Capability Broker — привилегированные действия только через манифесты, подтверждение и аудит
Зрение	Canvas — временные поверхности (документ / видео / таблица / терминал)
База	NixOS · Linux · systemd · PipeWire
Сборка	Nix flake → воспроизводимый ISO

Подробнее: docs/architecture.md · docs/security-model.md

Быстрый старт (сборка ISO)

Требуется Linux с установленным Nix (flakes включены) или Linux-сборщик. На macOS локально ISO не собрать.

# 1. Клонировать
git clone https://github.com/1977-code/openhermesos.git
cd openhermesos

# 2. Проверить флейк
nix flake check

# 3. Собрать ISO  (артефакт: result/iso/*.iso)
nix build .#iso -L

# 4. Записать на флешку (замените sdX на вашу — ОСТОРОЖНО, данные будут стёрты)
sudo dd if=result/iso/*.iso of=/dev/sdX bs=4M status=progress oflag=sync

Прогнать в VM без записи на диск:

nixos-rebuild build-vm --flake .#ohos && ./result/bin/run-*-vm

Полный процесс установки — docs/install.md.

Структура репозитория

flake.nix          — outputs: nixosConfigurations.{ohos, ohos-iso}, packages.iso
nixos/             — модули NixOS: configuration, kiosk (Cage), hermes, audio, networking, hardware/
shell/             — тонкий Shell-клиент (Canvas, онбординг, media, terminal) — D-3, WIP
runtime/           — capability-broker, task-manager, artifact-renderer, model-router, audit
tools/skills/      — навыки агента (+ manifest.yaml на каждый)
local-model/       — локальная fallback-модель (Ollama) для офлайна
sandbox/           — политики изоляции (seccomp/namespaces/containers)
installer/         — сборка ISO и first-boot
docs/              — architecture, security-model, skill-spec, install, hermes-integration, adr/
.github/           — issue/PR-шаблоны, CI

Как помочь

Проект open-source и ищет контрибьюторов. Начните с CONTRIBUTING.md и меток good first issue.

• 🧭 Дорожная карта и задачи с ID (P1-B3) → ROADMAP.md
• 🐛 Нашли баг? → шаблон Bug report
• 🔐 Уязвимость? → не создавайте публичный issue, см. SECURITY.md
• 💬 Вопросы/идеи → GitHub Discussions

Архитектурные решения принимаются через RFC → ADR (docs/adr/). Открытые развилки, которые ещё ждут решения (ветка Nixpkgs, ФС/шифрование, песочница и т.д.), помечены D-# в ROADMAP.

Лицензия

Apache-2.0 © 2026 The OpenHermesOS Authors. Отдельные компоненты — под своими лицензиями (см. NOTICE).