# Требования

Перед установкой 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onerpa.ru/ai-platforma-oneapa/bystryj-start/trebovaniya.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.