> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/ai-platforma-oneapa/bystryj-start/trebovaniya.md).

# Требования

Перед установкой OneAPA убедитесь, что ваша система соответствует минимальным требованиям.

## Аппаратные требования

### Сервер 1С

| Параметр              | Минимум | Рекомендуется |
| --------------------- | ------- | ------------- |
| Процессор             | 2 ядра  | 4+ ядра       |
| Оперативная память    | 4 ГБ    | 8+ ГБ         |
| Дисковое пространство | 10 ГБ   | 50+ ГБ        |

### Сервер Proxy

| Параметр              | Минимум | Рекомендуется |
| --------------------- | ------- | ------------- |
| Процессор             | 2 ядра  | 4+ ядра       |
| Оперативная память    | 4 ГБ    | 8+ ГБ         |
| Дисковое пространство | 5 ГБ    | 20+ ГБ        |

{% hint style="info" %}
Proxy-сервер может работать на том же сервере, что и 1С, или на отдельной машине.
{% endhint %}

### Для локальных моделей (Ollama)

| Параметр              | Минимум   | Рекомендуется |
| --------------------- | --------- | ------------- |
| Оперативная память    | 16 ГБ     | 32+ ГБ        |
| GPU (NVIDIA)          | 8 ГБ VRAM | 16+ ГБ VRAM   |
| Дисковое пространство | 50 ГБ     | 100+ ГБ       |

{% hint style="warning" %}
Для качественной работы локальных моделей рекомендуется использовать GPU с CUDA.
{% endhint %}

## Программные требования

### 1С:Предприятие

| Компонент                        | Версия        |
| -------------------------------- | ------------- |
| Платформа 1С:Предприятие         | 8.3.20 и выше |
| Режим совместимости конфигурации | 8.3.18 и выше |

### Docker (альтернатива Python)

| Компонент      | Версия                   |
| -------------- | ------------------------ |
| Docker         | 20.10 и выше             |
| Docker Compose | 2.0 и выше (опционально) |

### Операционная система

**Сервер 1С:**

* Windows Server 2016, 2019, 2022
* Windows 10/11 (для разработки)
* Linux (Astra Linux, Ubuntu, CentOS) с 1С для Linux

**Сервер Proxy:**

* Windows 10/11, Windows Server 2016+
* Linux (Ubuntu 20.04+, Debian 11+, CentOS 8+)
* macOS 12+ (для разработки)

## Сетевые требования

### Порты

| Порт    | Назначение                      | Направление        |
| ------- | ------------------------------- | ------------------ |
| 9000    | Proxy Server (HTTP API)         | Входящий           |
| 9000/ui | Chainlit Web UI                 | Входящий           |
| 443     | LLM провайдеры (OpenAI, Yandex) | Исходящий          |
| 11434   | Ollama (локальные модели)       | Входящий/Исходящий |

### Схема сетевого взаимодействия

```
┌─────────────────────────────────────────────────────────────────┐
│                     ЛОКАЛЬНАЯ СЕТЬ                               │
│                                                                  │
│  ┌─────────────┐         ┌─────────────┐                        │
│  │  Сервер 1С  │◄───────►│   Proxy     │                        │
│  │             │  :9000  │   Server    │                        │
│  └─────────────┘         └──────┬──────┘                        │
│                                 │                                │
└─────────────────────────────────┼────────────────────────────────┘
                                  │ :443 (HTTPS)
                                  ▼
                          ┌─────────────┐
                          │    LLM      │
                          │  Provider   │
                          │ (Internet)  │
                          └─────────────┘
```

### Для полностью изолированной сети (Ollama)

```
┌─────────────────────────────────────────────────────────────────┐
│                     ИЗОЛИРОВАННАЯ СЕТЬ                           │
│                                                                  │
│  ┌─────────────┐         ┌─────────────┐         ┌───────────┐  │
│  │  Сервер 1С  │◄───────►│   Proxy     │◄───────►│  Ollama   │  │
│  │             │  :9000  │   Server    │  :11434 │  Server   │  │
│  └─────────────┘         └─────────────┘         └───────────┘  │
│                                                                  │
│            ❌ Доступ в Интернет не требуется ❌                  │
└─────────────────────────────────────────────────────────────────┘
```

## Требования к LLM провайдеру

### OpenAI

| Требование | Описание                          |
| ---------- | --------------------------------- |
| Аккаунт    | Зарегистрированный аккаунт OpenAI |
| API ключ   | Активный API ключ (sk-...)        |
| Баланс     | Положительный баланс на счёте     |
| Доступ     | Доступ к API из вашей сети        |

### Yandex GPT

| Требование | Описание                        |
| ---------- | ------------------------------- |
| Аккаунт    | Аккаунт Yandex Cloud            |
| IAM токен  | Действующий IAM токен           |
| Folder ID  | ID каталога в Yandex Cloud      |
| Сервис     | Активированный сервис YandexGPT |

### Ollama (локальные модели)

| Требование | Описание                                   |
| ---------- | ------------------------------------------ |
| Установка  | Установленный Ollama                       |
| Модель     | Загруженная модель (llama3, mistral и др.) |
| Ресурсы    | Достаточно RAM/VRAM для модели             |

## Чек-лист проверки

### 1С:Предприятие

* [ ] Установлена платформа 8.3.20 или выше
* [ ] Есть доступ к конфигуратору
* [ ] Есть права на объединение конфигураций

### Docker

* [ ] Docker
* [ ] Доступ к командной строке с правами администратора

### Сеть

* [ ] Порт 9000 свободен для Proxy
* [ ] Есть доступ к LLM провайдеру (или настроен Ollama)

### LLM провайдер

* [ ] Получен API ключ
* [ ] Проверен доступ к API (опционально)

## Проверка версий

### Docker

```bash
# Проверка версии Docker
docker --version

# Ожидаемый вывод: Docker version 20.10.x или выше
```

### 1С:Предприятие

В режиме "1С:Предприятие" → меню "Справка" → "О программе":

```
1С:Предприятие 8.3 (8.3.20.xxxx)
```

## Что делать, если требования не выполнены

| Проблема          | Решение                                                       |
| ----------------- | ------------------------------------------------------------- |
| Старая версия 1С  | Обновите платформу до 8.3.20+                                 |
| Нет Docker        | Установите Docker Desktop (Windows/Mac) или docker.io (Linux) |
| Порт 9000 занят   | Измените порт Proxy в конфигурации                            |
| Нет доступа к LLM | Настройте Ollama для локальной работы                         |

## Далее

После проверки требований переходите к установке:

{% content-ref url="/pages/z1SGTBnETqlaohXEv5Jn" %}
[Установка](/ai-platforma-oneapa/bystryj-start/ustanovka.md)
{% endcontent-ref %}