---
title: Швидкий старт
description: Встановіть Klex і запустіть свого першого бота Klex.
---

## Встановлення

Боти Klex є самохостованими. Це означає, що ви повинні завантажити додаток Klex на машину, яка згодом діятиме як сховище пам'яті та середовище виконання для бота.

<Panel title="Корисно знати">
Бот **не** має автоматичного доступу до файлів у вашій системі. Натомість хост діє лише як місце, де відбувається мислення бота та зберігання й пошук пам'яті.

Будь-яка взаємодія із зовнішнім світом, включаючи пісочниці або повні машини для **використання комп'ютера** або розробки, явно потребує підключення комп'ютера через MCP.
</Panel>

Щоб встановити Klex, виконайте наступний скрипт у шелі вашої системи：

**macOS**

`curl -fsSL https://klex.bot/install.sh | sh`

**Linux**

`curl -fsSL https://klex.bot/install.sh | sh`

**Windows**

`irm https://klex.bot/install.ps1 | iex`

**WSL**

`curl -fsSL https://klex.bot/install.sh | sh`

## Створення вашого бота

**За допомогою хмари (рекомендовано)**

1. **Зареєструйтеся в Klex Cloud**

    Перейдіть до [Klex Cloud](https://cloud.klex.bot) і зареєструйтеся. На лівій бічній панелі виберіть панель Bots і натисніть `Set up a Klex Bot`.

2. **Запустіть Klex**

    Дотримуйтесь інструкцій у майстрі, щоб встановити та запустити додаток Klex.

3. **Створіть нового бота**

    У додатку Klex виберіть `Create a new Bot` у списку опцій і натисніть Enter.

4. **Назвіть вашого бота**

    Введіть ім'я, яке цей бот має використовувати. Бот знатиме, що це його власне ім'я.

5. **Зареєструйте бота у хмарі**

    Дотримуйтесь інструкцій у майстрі хмари, щоб підключити цього бота до вашої організації Klex Cloud.

6. **Налаштуйте постачальників моделей і вибір моделей**

    Майстер хмари тепер запропонує вам налаштувати постачальників моделей і моделей, які бот має використовувати.
    <Panel title="Корисно знати">
      Облікові дані постачальника безпечно передаються та зберігаються у власній конфігурації бота на машині, яка хостить бота, **не** у хмарі.
    </Panel>
    <Panel title="Корисно знати">
    Klex підтримує різноманітні підписки, постачальників першої сторони, локальних LLM-постачальників і загальних API-постачальників.

    Дізнайтеся більше про [постачальників моделей](/concepts/model-providers) і [вибір моделей](/concepts/model-selection).
    </Panel>

7. **Дайте боту його душу**

    На наступному кроці майстер запропонує вам створити душу бота. У вас є два варіанти：[Режим Творця](/concepts/soul#creator-mode) (*рекомендовано!*) і [Режим Год-повідомлень](/concepts/soul#god-message-mode)。

    [Дізнайтеся більше про душу](/concepts/soul)。

8. **Підключіть MCP**

    Дайте боту доступ до MCP. **Klex Cloud** допомагає вам легко створювати виділені акаунти для бота в кожному інтегрованому застосунку, але ви, звісно, можете підключити будь-який інший MCP.

**Автономний**

<Panel title="Важливо">
Якщо ви хочете використовувати боти Klex без Klex Cloud, вам потрібно переконатися, що принаймні один підключений MCP може проактивно ініціювати бота.
Це означає, що MCP **повинен** реалізувати **одне з наступного**：

- Розмови як окремі MCP-ресурси з повідомленнями про зміни
- Push-повідомлення згідно з нашим [розширенням MCP](https://github.com/stagewise-io/klex/tree/main/packages/mcp-extension-push-notifications)
</Panel>

1. **Запустіть Klex**

    Запустіть CLI наступною командою：`klex --no-cloud`

2. **Створіть нового бота**

    Виберіть `Create a new Bot` у списку опцій і натисніть Enter。

3. **Назвіть вашого бота**

    Введіть ім'я, яке цей бот має використовувати. Бот знатиме, що це його власне ім'я。

4. **Налаштуйте постачальників моделей**

    Перейдіть до `Settings -> Model Providers` і створіть екземпляр постачальника для кожного постачальника моделей, якого ви хочете використовувати。
    <Panel title="Корисно знати">
    Klex підтримує різноманітні підписки, постачальників першої сторони, локальних LLM-постачальників і загальних API-постачальників。

    [Дізнайтеся більше про постачальників моделей](/concepts/model-providers)。
    </Panel>

5. **Налаштуйте вибір моделей**

    Перейдіть до `Settings -> Model Selection` і налаштуйте модель для кожного випадку використання бота。
    <Panel title="Корисно знати">
    Ви повинні налаштувати дійсну модель для «Chat», але ми наполегливо рекомендуємо налаштувати всі можливості для забезпечення дешевшого використання та повної функціональності。

    [Дізнайтеся більше про вибір моделей](/concepts/model-selection)。
    </Panel>

6. **Дайте боту його душу**

    Перейдіть до `Settings -> God messages`, щоб надіслати `God message`. Зміст год-повідомлення має описувати, якою має бути душа бота (його робота, його характер тощо)。

    [Дізнайтеся більше про душу](/concepts/soul)。

7. **Підключіть MCP**

    Перейдіть до `Settings -> MCPs` і підключіть MCP, щоб дати боту доступ до зовнішнього світу。