Передумови
- Linux (Ubuntu/Debian/CentOS тощо) або macOS
- 2 ГБ+ RAM, 10 ГБ+ вільного місця на диску
- Доступ до shell з виходом до публічного npm registry
- Node.js 18.x або 20.x LTS (див. крок 1)
- Обліковий запис CometAPI з активним API key — отримайте його тут
1
Отримайте свій CometAPI API key
2
Встановіть Node.js через nvm
n8n 1.x потребує Node.js 18.x або 20.x. Рекомендований підхід — nvm:
Якщо пізніше ви побачите
n8n: command not found, перезапустіть термінал або переконайтеся, що глобальний bin-каталог npm, яким керує nvm, є у вашому PATH.3
Встановіть і запустіть n8n


4
Створіть свій обліковий запис власника
Відкрийте http://localhost:5678/ у браузері. Під час першого запуску майстер налаштування попросить вас створити обліковий запис Owner (email + password). Завершіть цей крок і увійдіть у систему.

5
Встановіть community node CometAPI
- Перейдіть до Settings (внизу ліворуч) → Community nodes
- Натисніть Install a community node
- Введіть назву пакета:
@cometapi-dev/n8n-nodes-cometapi - Позначте прапорець підтвердження ризиків і натисніть Install


Якщо секція Community Nodes відсутня: переконайтеся, що ви увійшли під обліковим записом Owner, і перевірте в Settings → Security, що встановлення community node увімкнено.
6
Створіть workflow і налаштуйте credentials
- Натисніть + New угорі, щоб створити workflow.
- Натисніть + на полотні та знайдіть CometAPI, щоб додати вузол.


- Додайте вузол Manual Trigger і з’єднайте його з вузлом CometAPI.
- У вузлі CometAPI, у розділі Credential to connect with, виберіть Create new. Вставте свій CometAPI API key у поле CometAPI Key і натисніть Save. Base URL за замовчуванням —
https://api.cometapi.com, і зазвичай його не потрібно змінювати.

- Налаштуйте вузол:
- Model: введіть поточний model ID, який хочете використовувати
- Messages: встановіть Role у
user, а Content — у свій тестовий Prompt (наприклад,Hello) - Необов’язково: додайте повідомлення
system, задайте Max Tokens, Temperature тощо.
- Натисніть Execute step, щоб запустити вузол. Панель Output покаже JSON-відповідь.

Усунення несправностей
Усунення несправностей
- Помилки
node-gypабо native build — встановіть build tools:sudo apt install build-essential python3(Debian/Ubuntu) або Xcode Command Line Tools (macOS). - Помилки прав доступу npm (EACCES) — використовуйте nvm для встановлення Node.js на рівні користувача;
sudoне потрібен. - Конфлікт порту (
localhost:5678недоступний) — встановітьN8N_PORT=5679(або інший вільний порт) перед запускомn8n start. - Відсутня секція Community Nodes — увійдіть під обліковим записом Owner і перевірте Settings → Security.
- npm install завершується невдачею в корпоративних мережах — налаштуйте proxy:
npm config set proxy http://user:pass@host:port - Вузол CometAPI повертає 401/403 — перевірте свій API key і що model доступна у вашому тарифному плані CometAPI.
- Порожні відповіді або помилки ліміту token — збільште Max Tokens; за потреби скоригуйте Temperature і Top P.
- n8n зупиняється після закриття термінала — використовуйте pm2:
pm2 start "n8n" --name n8n && pm2 save.

