Omnigent: один harness для кількох agent CLI
Дізнайтеся, як Omnigent керує встановленими agent CLI, що таке meta-harness, як зафіксувати release 0.7.0 і ізолювати агентів на VPS.
Що таке Omnigent
Omnigent — це open source meta-harness: один рівень оркестрації, який керує вже встановленими інструментами командного рядка агентів (CLI). Він не замінює Claude Code, Codex, Cursor, OpenCode, Hermes або Pi. Omnigent запускає їх, призначає кожному завдання та контролює результат у межах одного сеансу з єдиним набором політик. Databricks опублікувала репозиторій у June 2026 за ліцензією Apache 2.0, а PyPI досі класифікує пакет як alpha.
Практичне твердження вузьке, тому його варто сформулювати прямо. Ви один раз описуєте агента у YAML і вказуєте harness, який його запускає. Якщо змінити цей один рядок, той самий агент працюватиме через CLI іншого постачальника. В інших налаштуваннях нічого змінювати не потрібно, оскільки Omnigent керує циклом над агентами, а не циклом усередині них.
Що таке meta-harness і чим він відрізняється від framework?
Harness — це програма, яка запускає модель у циклі. Вона читає ваш prompt, викликає tools, редагує файли та повертає результат. Claude Code — це harness. Codex — це harness. Ви встановлюєте його, входите в систему, і він працює самостійно.
Framework — це бібліотека, для якої ви пишете код. Ви імпортуєте її, визначаєте кроки в Python, і ваша програма стає агентом. Щоб змінити vendor, потрібно редагувати код, оскільки client vendor інтегрований у вашу програму.
Meta-harness розташований на рівень вище за обидва ці компоненти. Це супервізор, який запускає harness як дочірні процеси. Omnigent запускає CLI vendor, передає йому завдання та читає отриману відповідь. Ви продовжуєте використовувати вже встановлений CLI і наявну subscription або API (application programming interface) key, за яку вже сплачується доступ. У цьому полягає вся відмінність. Саме вона визначає цільову аудиторію інструмента: людей, у яких уже працює кілька agent CLI і які втомилися запускати їх по одному в кожному терміналі.
Яку проблему розв’язує один рівень оркестрації?
- Зміна постачальника потребує одного рядка. Визначення агента зберігає
harnessіmodelяк дані, тому перенесення ролі від одного постачальника до іншого потребує редагування YAML-файлу, а не переписування конфігурації. - Перевірка може виконуватися між різними постачальниками. Diff, створений однією моделлю, перевіряє модель іншої компанії. Дві моделі з одного сімейства зазвичай мають однакові «сліпі зони», тому друга думка від того самого постачальника менш цінна.
- Політики мають єдине місце визначення. Порогові значення бюджету та запити на підтвердження оголошуються у файлі агента й застосовуються до кожного підлеглого агента.
- Сесія не залежить від одного інструмента. Один transcript охоплює роботу кількох CLI, тому можна переглянути всі виконані дії без об’єднання чотирьох окремих історій прокручування.
Ціна цього рішення — сам рівень оркестрації. Кожна помилка в Omnigent тепер стає помилкою між вами та агентом, який раніше працював самостійно. На етапі alpha це реальна, а не теоретична ціна.
Де multi-agent harness вписується поруч з інструментами для одного агента
Якщо ви ще не запускали одного агента на сервері, почніть із цього. Наш посібник із запуску coding agent на VPS охоплює сценарій з одним агентом від початку до кінця, і Omnigent передбачає, що це налаштування у вас уже є. Ширше поле self-hosted AI agents — це місце, де ви обираєте самих агентів, а як насправді працюють агенти буде кращою відправною точкою, якщо наведена тут термінологія вам незнайома.
Omnigent також належить до іншої площини, ніж connector layer. Такі завдання, як надання агентам доступу до власних джерел даних, стосуються того, до чого агент може отримати доступ. Omnigent визначає, який агент запускається, у якому порядку та з якими обмеженнями. Ви можете використовувати обидва підходи одночасно, оскільки вони не дублюють один одного.
Що потрібно перед встановленням
- Python 3.12 або новішої версії. Опублікований пакет оголошує
requires-python >= 3.12. tmux, оскільки в ньому запускаються terminal harness.- Щонайменше один CLI клієнта, уже встановлений і з виконаним входом.
- Node.js 22 або новішої версії з
npm, оскільки вони потрібні harness для Claude, Codex і Pi. Інсталятор перевіряє наявність Node 22.10 або новішої версії та виводить попередження, якщо її немає. Самому Omnigent Node не потрібен: wheel у PyPI містить зібрані web assets, а Node стає обов’язковою залежністю лише під час збирання з git checkout.
Встановлюйте зафіксований реліз, а не main
curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh -s -- --version 0.7.0Частина sh -s -- не є декоративною. Без неї sh сприймає --version як власний параметр, і інсталятор взагалі не запускається. Коли sh — це Bash, він виводить власну версію Bash і успішно завершує роботу. У результаті нічого не встановлюється, і жодних попереджень немає. З -s -- sh читає скрипт із pipe і передає --version 0.7.0 інсталятору. У репозиторії, де кожні кілька тижнів з’являються breaking changes, це визначає різницю між відтворюваним середовищем і неочікуваною зміною.
Станом на 29 October 2026 реліз 0.7.0 усе ще опублікований у PyPI, але найновіший реліз тепер має версію 0.22.0 і датований 13 November 2026. Попередній реліз 0.19.1 — це security-focused patch без нових функцій. Він оновлює залежності після компрометації проміжного центру сертифікації eMudhra, і проєкт рекомендує виконати оновлення. Важливий сам pin, а не номер версії: зафіксуйте протестовану версію та прочитайте breaking changes у release notes, перш ніж змінювати її. Водночас pin не є підставою пропускати security release, тому змініть його після виходу такого релізу.
Інсталятор використовує uv, Python package manager від Astral, і пропонує спочатку встановити uv, якщо його немає. Якщо uv уже встановлено, пропустіть скрипт:
uv tool install --force --python 3.12 "omnigent==0.7.0"Extras працюють за тією самою схемою, і flag повторюється: --extra e2b --extra kubernetes для скрипту або "omnigent[e2b,kubernetes]" з uv. Скрипт також додає extra databricks, якщо не передати --no-databricks, тоді як наведений вище рядок із uv встановлює пакет без нього. Зверніть увагу: git tag має значення v0.7.0, а версія пакета в PyPI — 0.7.0.
uv розміщує binary у каталозі, який повертає uv tool dir --bin, зазвичай ~/.local/bin, і інсталятор пропонує додати цей каталог до профілю shell. Якщо відразу після чистого встановлення команда не знаходиться, причина саме в цьому. Перевірте результат:
omni upgrade --checkЦя команда порівнює встановлену версію з останньою опублікованою версією та повідомляє, чи доступне оновлення, не виконуючи його. omni і omnigent — це та сама програма під двома назвами.
Спрямуйте його до постачальника моделей
omni setupМайстер шукає облікові дані, які вже доступні у вашому середовищі, і запитує ті, яких бракує. Він працює з API-ключами, підписками постачальників, шлюзами на кшталт OpenRouter або Ollama, а також робочими просторами Databricks. Якщо на цій самій машині ви вже запускаєте локальний сервер моделей за допомогою Ollama, спрямуйте шлюз до нього, і трафік не залишатиме хост.
Мінімальний запуск із кількома агентами
Приклади агентів зберігаються в репозиторії, тому клонуйте той самий тег, який ви встановили, а не main.
git clone --depth 1 --branch v0.7.0 https://github.com/omnigent-ai/omnigent.git
cd omnigent
omnigent run examples/polly/Polly — це оркестратор для написання коду кількома агентами, який постачається разом із репозиторієм. Його конфігурація оголошує субагентів із назвами claude_code, codex, opencode, cursor, hermes і pi, а також одне правило, заради якого варто запускати весь приклад: перевірку завжди виконує інший постачальник, ніж реалізацію. Polly не пише код самостійно. Він планує роботу, розподіляє мету на робочі елементи, делегує кожен із них і передає кожен diff на перевірку рецензенту від іншого постачальника.
Перш ніж щось делегувати, Polly виконує попередню перевірку, щоб визначити, які CLI субагентів фактично доступні на машині. Якщо встановлено CLI лише одного постачальника, передати diff нікому, тому встановіть щонайменше два CLI, перш ніж оцінювати результат. Debby, інший приклад, що постачається разом із репозиторієм, — це агент для дебатів із двома головами: однією Claude і однією GPT:
omni debbyЦе швидкий спосіб перевірити, що налаштовано два провайдери, оскільки для роботи Debby потрібні обидва.
Субагенти оголошуються як інструменти
Файл агента має формат YAML. executor містить назви harness, моделі та параметри автентифікації. tools містить сервери MCP (model context protocol), функції Python і субагентів. Субагент — це інструмент із type: agent і власним executor. Саме цей механізм лежить в основі всього описаного вище.
name: orchestrator
prompt: |
You coordinate coding and review tasks.
executor:
harness: claude-sdk
model: databricks-claude-sonnet-4-6
tools:
coder:
type: agent
prompt: Write and test code.
executor:
harness: claude-sdk
model: databricks-claude-opus-4-7
reviewer:
type: agent
prompt: Review proposed changes.
executor:
harness: claude-sdk
model: databricks-claude-sonnet-4-6omnigent run path/to/my_agent.yamlЦі ідентифікатори моделей взято з власного прикладу docs/AGENT_YAML_SPEC.md проєкту, і це назви моделей, розміщених у Databricks. Замініть harness і model на значення, які налаштовані у вашій системі в omni setup. Інші значення harness у специфікації включають antigravity, copilot, kimi і qwen. Поточна специфікація на main також документує acp:<slug> для будь-якого сервера Agent Client Protocol, але специфікація v0.7.0 його не містить. Тому перевірте, чи працює він у зафіксованій вами версії, перш ніж покладатися на нього. Специфікація також підтримує pass_history: true для субагента. Цей параметр передає йому батьківський діалог. Це збільшує витрати токенів під час кожного делегування, тому вимкніть його для субагентів, яким потрібне лише поточне завдання. Якщо prompt кодера вказує йому внести найменшу працездатну зміну, його рецензент отримує diff, достатньо короткий для фактичного читання. У цьому випадку це важливіше за модель, вибрану для будь-якої з ролей.
Чому тривала оркестрація має виконуватися на VPS
Багатоагентний запуск — це не команда на дві хвилини. Потрібно планувати, делегувати завдання, чекати на паралельну роботу в git worktree, перевіряти результат і вносити зміни. Закриття кришки ноутбука припиняє все це. VPS (virtual private server) залишається доступним і зберігає мережеве підключення, тому сесія продовжується, коли ви не стежите за нею.
omnigent server --background
omnigent server statusСервер розміщує вебінтерфейс користувача на порту 6767. omnigent server status повідомляє, чи запущено сервер, а omnigent stop вимикає його. У v0.7.0 omni server start вилучили на користь omni server --background; у v0.9.0 її повернули як застарілий псевдонім.
Не публікуйте 6767 на публічній адресі. Безпечними є два варіанти. Залиште порт закритим у firewall і перенаправляйте його через SSH за допомогою ssh -N -L 6767:localhost:6767 you@your-server, а потім відкрийте вебінтерфейс на http://localhost:6767 на власному комп’ютері. Або завершіть TLS (transport layer security) перед ним і ввімкніть автентифікацію:
OMNIGENT_AUTH_ENABLED=1 omnigent server --backgroundНалаштування firewall — це звичайна робота, описана в основах firewall ufw для VPS, а якщо на сервері вже працюють контейнери за Traefik перед кількома застосунками Docker Compose, то Omnigent є ще одним сервісом у такій самій схемі.
Для розгортання в контейнері каталог deploy/docker/ у репозиторії містить конфігурацію Compose: ./bootstrap.sh створює секрети в .env, а потім docker compose up -d запускає Omnigent і Postgres, причому сервер працює на порту 8000, а не 6767. OMNIGENT_PORT змінює цей порт хоста. Compose обчислює DATABASE_URL автоматично (на інших цільових платформах розгортання та сама змінна вибирає Postgres або SQLite), а OMNIGENT_AUTH_ENABLED за замовчуванням має значення 1 усередині контейнерів. Це правильне значення за замовчуванням для всього, що доступне ззовні.
Щодо розміру, у примітках до розгортання споживання пам’яті сервером у стані простою оцінюється приблизно в 275 MB RSS, а конфігурація Fly.io закріплює машину обсягом 1 GB. Вимірювання в стані простою стосується лише supervisor; 1 GB — це виділена пам’ять машини. Sub-agent можуть спільно використовувати робочий каталог і середовище батьківського процесу, зокрема його sandbox через os_env: inherit. Окремі git worktree — це рішення для оркестрації, тому розраховуйте розмір сервера з урахуванням harness і agent, які ви запускаєте одночасно. Після запуску сервера команда omnigent login https://your-host, а потім omnigent host https://your-host реєструє ваш ноутбук на ньому, а omnigent attach <session_id> дає змогу продовжити запущену сесію з іншого пристрою.
Ізолюйте кожного субагента перед завершенням роботи
Omnigent постачає sandbox на рівні операційної системи під назвою Omnibox. У Linux він використовує namespace bubblewrap і seccomp, тому межі ізоляції забезпечує ядро, а не prompt агента. Агент із prompt injection не може обійти правило ядра за допомогою текстової інструкції. Спочатку встановіть залежність:
sudo apt install bubblewrapКонфігурація зберігається в os_env у файлі агента:
os_env:
type: caller_process
cwd: .
sandbox:
type: linux_bwrap
write_paths: [.]
write_files: []
read_paths: []
allow_network: true
cwd_allow_hidden: [.venv]
env_passthrough: []
egress_rules: []
credential_proxy: []Робочий каталог доступний лише для читання, доки ви не зазначите його в write_paths. Тому агент, який працює неправильно, не зможе записувати дані за межами workspace. Dotfiles верхнього рівня в робочому каталозі та кожен кореневий каталог read_paths залишаються прихованими, доки їх не буде вказано в cwd_allow_hidden. Завдяки цьому широке право на читання не відкриває непомітно каталоги верхнього рівня .ssh або .aws. Вкладені dotfiles за замовчуванням залишаються видимими; задайте cwd_hidden_scan_recursive: true, щоб приховати їх у всьому дереві. Задайте egress_rules, і весь HTTP- та HTTPS-трафік проходитиме через proxy з політикою deny за замовчуванням, а кожне правило матиме формат "METHODS host/path-glob". credential_proxy забезпечує ще сильнішу ізоляцію: агент зберігає лише placeholder, а proxy підставляє справжній секрет під час виходу запиту. Тому витік transcript не розкриває нічого придатного для використання. У конфігурації з кількома harness кожен субагент має власний блок sandbox у власному конфігураційному файлі в agents/. Тому reviewer можна позбавити доступу до мережі, залишивши його implementer.
Обмеження зазначено в документації, і воно має значення. OS sandbox застосовується до викликів інструментів sys_os_* і до терміналів. Він не поширюється на MCP servers і не охоплює сам supervisor process Omnigent. Запущений вами MCP server працює поза sandbox із вашими правами доступу. Саме через цю прогалину надійнішим підходом залишається окрема одноразова машина для кожного агента. Цьому присвячено матеріал запуск coding agents у disposable VM. Інша частина завдання — облікові дані. Матеріал як не допустити доступу агента до секретів стає складнішим, а не простішим, коли шість субагентів спільно використовують один host.
Порогові значення витрат — це політики, оголошені в тому самому файлі:
policies:
budget:
type: function
handler: omnigent.policies.builtins.cost.cost_budget
factory_params:
max_cost_usd: 5.00
ask_thresholds_usd: [1.00, 3.00]Політика cost_budget запитує підтвердження після досягнення м’яких порогів і за замовчуванням блокує всі моделі на рівні max_cost_usd. Якщо задати непорожній список expensive_models, обмеження перетворюється на умову пониження: моделі, яких немає в цьому списку, можуть продовжувати витрачати кошти. Якщо один vendor використовується для планування, другий — для реалізації, а третій — для перевірки, витрати виникають одночасно в трьох місцях. Тому встановіть пороги до першого unattended run, а не після першого рахунка. Серед вбудованих політик також є max_tool_calls_per_session і ask_on_os_tools, які запитують підтвердження перед операціями з файлами та shell. Наші нотатки про контроль витрат AI agent на VPS безпосередньо стосуються цього випадку. Тут вони ще важливіші, оскільки паралельні субагенти збільшують швидкість витрачання коштів.
Наскільки активно розвивається цей репозиторій?
Дані, на яких побудовано графік
[
{
"version": "v0.2.0",
"released": "2026-06-19",
"interval": 3
},
{
"version": "v0.3.0",
"released": "2026-06-27",
"interval": 8
},
{
"version": "v0.4.0",
"released": "2026-07-03",
"interval": 6
},
{
"version": "v0.5.0",
"released": "2026-07-10",
"interval": 7
},
{
"version": "v0.5.1",
"released": "2026-07-10",
"interval": 0
},
{
"version": "v0.6.0",
"released": "2026-07-21",
"interval": 11
},
{
"version": "v0.7.0",
"released": "2026-07-27",
"interval": 6
}
]Це дати опублікованих релізів зі сторінки релізів самого проєкту станом на 3 August 2026. У період від 2026-06-19 до 2026-07-27 вийшло 7 релізів із тегами, а найдовший проміжок між будь-якими двома релізами становив 11 днів. v0.5.1 вийшов того самого дня, що й попередній реліз. Перші два релізи в PyPI — 0.1.0 від 13 June 2026 і 0.1.1 від 16 June 2026 — не мають записів на сторінці релізів GitHub, тому їх не включено до графіка; для v0.2.0 показано три дні, відлік яких ведеться від 0.1.1.
У двох із цих релізів змінилися команди, які вже були наведені в документації. У v0.7.0 omni server start вилучено на користь omni server --background. У v0.6.0 extra omnigent[memory] перейменували на omnigent[hindsight], але залишили memory як alias для сумісності; він працював до версії 0.10.0 включно. Починаючи з 0.11.0, випущеної 25 August 2026, alias вилучено, тому рядок встановлення, скопійований зі статті за June, більше не встановлює клієнт Hindsight. Саме тому в команді встановлення потрібен --version, а у вашому git clone має бути вказаний tag. Це вимога сумісності, а не питання стилю.
Після цього аналізу темп розробки не знизився. Станом на 29 October 2026 у PyPI доступна версія 0.20.0, випущена 28 October, — це тринадцять minor-релізів після 0.7.0. У release notes проєкту для кількох із них зазначено breaking changes. Для всього, що скопійовано з цієї сторінки, важливі дві зміни: у v0.12.0 звичайна команда omni запускає background host замість агента Polly (omni run тепер запускає агента за замовчуванням), а v0.13.0 вимагає tmux версії 3.3 або новішої для керованих терміналів.
Чого я поки не став би йому довіряти
Станом на 27 жовтня 2026 року репозиторій має близько 11k зірок, 1.8k форків і приблизно 910 відкритих issue. Перший публічний реліз вийшов трохи більше чотирьох місяців тому. Зірки показують зацікавленість, але зацікавленість не означає зрілість. Проєкт позначений як alpha, і наведена вище історія релізів це підтверджує.
- Я не став би запускати його на хості, де зберігаються production credentials, оскільки sandbox не охоплює MCP servers або supervisor.
- Я не став би залишати запуск без нагляду без політики
cost_budget, оскільки три vendors можуть паралельно нараховувати оплату; якщо списокexpensive_modelsне порожній, витрати можуть продовжуватися на дешевших моделях. - Я не став би відкривати server на публічній IP-адресі без налаштованого
OMNIGENT_AUTH_ENABLEDі TLS перед ним. - Я поки не вважав би agent YAML стабільним між minor-версіями. Зафіксуйте версію та прочитайте release notes перед оновленням.
Є ще один момент, про який варто знати заздалегідь. У v0.6.0 додано анонімізовану телеметрію використання. У README зазначено, що вона збирається за замовчуванням. Проєкт документує цю функцію, зокрема спосіб відмови від неї, на окремій сторінці telemetry. Прочитайте цю сторінку та свідомо ухваліть рішення, якщо машина обробляє робочі дані клієнтів.
Сьогодні Omnigent справді добре виконує саме те завдання, для якого його створено. У вас є три або чотири agent CLI, ви вже платите за них і хочете, щоб один із них писав код, а інший його перевіряв. Це вже працює на одній машині з повноцінною sandbox ізоляцією в Linux. Усе, що виходить за ці межі, поки слід вважати перспективним, але незавершеним.
FAQ
Чи є Omnigent агентом або програмою, яка запускає агентів?
Він запускає агентів. Omnigent — це meta-harness: він запускає вже встановлені vendor CLI, зокрема Claude Code, Codex або OpenCode, призначає кожному завдання та контролює результати в межах одного сеансу. Власної моделі він не має. Цим він відрізняється від framework, у якому ви пишете Python-код на основі бібліотеки, а ваша програма стає агентом.
Чи потрібно встановити Claude Code і Codex до того, як Omnigent стане корисним?
Потрібно встановити й авторизувати принаймні один vendor CLI, оскільки Omnigent керує цими програмами, а не замінює їх. Для прикладу Polly, що постачається разом із продуктом, бажано мати два або більше CLI від різних vendor. Правило Polly полягає в тому, що перевірку завжди виконує інший vendor, ніж той, що реалізував зміни. Тому за наявності лише одного CLI немає другого vendor, якому можна передати diff.
Як встановити певну версію Omnigent, а не останню?
Передайте --version через інсталяційний скрипт із sh -s --, як у sh -s -- --version 0.7.0. Без -s --, sh сприймає --version як власну опцію, і інсталятор не запускається: наприклад, Bash виводить власну версію та завершує роботу. Якщо uv уже встановлено, uv tool install --force --python 3.12 "omnigent==0.7.0" виконує те саме завдання. Git tag має значення v0.7.0, а рядок версії PyPI — 0.7.0.
Чи достатньо sandbox Omnibox для автономного запуску агентів?
Він забезпечує надічний захист у межах заявлених функцій і чітко визначає, чого не охоплює. У Linux він використовує bubblewrap разом із seccomp, тому kernel контролює обмеження доступу до файлів і мережі, а агент не може їх обійти. У документації зазначено, що це поширюється на виклики інструментів sys_os_* і термінали, але не поширюється на MCP servers або процес supervisor Omnigent. Тому MCP server працює зі звичайними правами користувача. Саме через це окрема disposable virtual machine для кожного агента залишається надійнішим способом ізоляції для автономної роботи.
Скільки пам’яті потрібне серверу Omnigent на VPS?
У deploy notes проєкту вказано приблизно 275 MB RSS у стані простою, а конфігурація Fly.io виділяє machine обсягом 1 GB. Це вимірювання в стані простою стосується лише самого сервера, а не його sub-agents. Sub-agents можуть спільно використовувати робочий каталог і середовище батьківського процесу, зокрема його sandbox через os_env: inherit; окремі робочі копії не гарантуються. Запуски в стилі Polly використовують паралельні git worktrees, тому обсяг RAM і дискового простору слід розраховувати за кількістю агентів, які ви плануєте запускати одночасно, а не за потребами сервера.