Дистрибутив

🔵 Собранный архив с бинарниками и документацией — для работы без исходников.

17.1 Что внутри

Путь	Что это
`bin/agent-os[.exe]`	единый CLI. Подкоманды: `serve` (HTTP-сервер + сайт + виджет + API), `bench`, `scrape`, `hook`, `route`, `tool`, `office`, `module` (`module workflow run`), `pdf-exporter`, `mcp-fake`. Подкоманды расширяемы модулями (реестр `agent_os_cli`)
`bin/officecli_pdf_exporter[.exe]`	PDF-экспортер-плагин OfficeCLI (headless Chromium, автоскачивание); тонкий шим на `agent-os pdf-exporter`, должен лежать рядом с `agent-os`
`bin/libduckdb.so` / `bin/duckdb.dll`	рантайм DuckDB (Linux / Windows) — должен лежать рядом с бинарниками
`docs/`	плейбук (`agent-os-docs/`) — настройка, агенты, инструменты, хуки
`skills/`	скиллы-плейбуки для агентов (`.agents/skills/*/SKILL.md`)
`config/`	стартовое дерево конфига (server.yaml + budgets.yaml + демо-агенты `hello-agent` и `mcp-demo-agent`)
`config/plugins.yaml` (опц.)	список нативных плагинов (DLL), загружаемых при старте
`.env.example`	шаблон окружения
`VERSION`	версия
`README.md`	краткая памятка по архиву

Некоторые необязательные возможности при первом использовании сами скачивают свой рантайм (нужен доступ в интернет): ONNX Runtime и модели (security.onnx), OfficeCLI (office_tool), headless Chromium (PDF-экспорт, browser_tool). Демо-агенту mcp-demo-agent нужен Node.js (npx в PATH).

Сервер модульный: фичи (docs, widget, cron, workflow, каналы, …) — это модули, которые можно включать (server.yaml → modules.enabled) и расширять своими (linked-крейт или нативная DLL). Нативные DLL кладутся рядом с бинарниками и перечисляются в config/plugins.yaml; по умолчанию архив их не содержит. См. 20-native-plugins и 32-building-a-module.

17.2 Сборка

Архивы собираются скриптами в scripts/:

./scripts/build_distrib.sh — Linux (distrib/agent-os-distrib-linux.zip);
powershell -File scripts/build_distrib.ps1 — Windows (distrib/agent-os-distrib-windows.zip).

Скрипты собирают release-бинарники, упаковывают agent_os_docs/ как docs/, .agents/skills/ как skills/, config-starter/ как config/, плюс .env.example и VERSION, и считают .sha256.

17.3 Скачивание

Архивы отдаёт сам сервер:

URL	Что
`/distrib/agent-os-distrib-linux.zip` (+`.sha256`)	Linux
`/distrib/agent-os-distrib-windows.zip` (+`.sha256`)	Windows
`/distrib/agent-os-android.apk` (+`.sha256`)	Android

На сайте — раздел «Скачать» (/site/download.html). Путь к папке дистрибутива меняется через AGENT_OS_DISTRIB_DIR (по умолчанию distrib).

Файлы отдаются потоком и поддерживают докачку (HTTP Range, ответ 206): curl -C - -O <url> или wget -c <url> продолжают оборванную загрузку.

Linux-архив пересобирается на сервере при каждом деплое. Windows-архив и APK собираются на машине разработчика и выкладываются шагами scripts/deploy.sh (APK — если рядом лежит свежая сборка distrib/agent-os-android.apk).

17.4 Быстрый старт из архива

Запускать из корня распакованного архива — config/ и .env ищутся относительно текущей папки.

cp .env.example .env        # укажи DEEPSEEK_API_KEY
./bin/agent-os serve

copy .env.example .env
notepad .env
bin\agent-os.exe serve

Локальные тестеры — подкоманды того же бинарника: agent-os tool <tool.yaml> '<json>', agent-os hook <hook.yaml> user "hi", agent-os bench --port=3001 --max=3, agent-os scrape <url>; запуск воркфлоу — agent-os module workflow run <workflow.yaml> (бывший workflow_tool).

Затем открой http://127.0.0.1:3000/widget?model=hello-agent — виджет с демо-агентом. Подробности — в 02-quickstart. В стартовом конфиге нет config/web/, поэтому /site/ отвечает 404, пока сайт не добавлен.