PrivateGPT в России: установка и подключение к API 2026

Искусственный интеллект всё глубже проникает в рабочие процессы российских компаний и разработчиков. Но что делать, когда корпоративные данные нельзя отправлять во внешние облака, а доступ к зарубежным сервисам заблокирован? Ответ — PrivateGPT: локальный ChatGPT на ваших данных, который работает прямо на вашем сервере.

В этом руководстве разберём, что такое PrivateGPT, почему в России с ним возникают трудности, как его установить и — главное — как подключить к PlusVibe API, чтобы получить полноценный доступ к GPT-4, Claude и другим моделям без VPN и блокировок.

Что такое PrivateGPT и зачем он нужен

PrivateGPT — это open-source проект, позволяющий запустить языковую модель целиком на локальной машине или корпоративном сервере. В отличие от облачного ChatGPT, ваши данные никуда не уходят: все запросы, документы и ответы остаются внутри вашей инфраструктуры.

Основные сценарии применения:

Анализ конфиденциальных документов — договоры, финансовые отчёты, медицинские карты без риска утечки.
Корпоративный чат-бот — обучите модель на внутренней базе знаний компании.
RAG-системы (Retrieval-Augmented Generation) — умный поиск по тысячам PDF, Word и Excel файлов.

Соответствие 152-ФЗ

Разработка без цензуры — локальные модели не имеют ограничений облачных провайдеров.

PrivateGPT поддерживает работу с локальными моделями (LLaMA, Mistral, Qwen) через Ollama, а также подключение к внешним API с OpenAI-совместимым интерфейсом. Именно второй вариант особенно актуален для российских пользователей, которым нужна мощь GPT-4 или Claude при соблюдении требований к данным.

Почему с PrivateGPT возникают проблемы из России

Несмотря на то что PrivateGPT сам по себе работает локально, большинство пользователей хочет подключить его к мощным облачным моделям — GPT-4o, Claude 3.5 Sonnet, Gemini. И вот здесь начинаются трудности:

1. Блокировка OpenAI и Anthropic для российских IP

Начиная с 2023 года, OpenAI и Anthropic заблокировали регистрацию и использование API с российских IP-адресов. Попытка напрямую обратиться к api.openai.com из России завершается ошибкой 403 Forbidden или «Your country is not supported».

2. Платёжные ограничения

Даже при наличии VPN, оплатить подписку OpenAI российской картой (Мир, Visa/Mastercard российских банков) практически невозможно. Stripe и другие платёжные системы блокируют транзакции.

3. Юридические риски

Использование иностранных AI-сервисов для обработки персональных данных российских граждан противоречит 152-ФЗ «О персональных данных». Штрафы за нарушения выросли кратно в 2024–2025 годах.

4. Нестабильность через VPN

VPN-решения дают нестабильное соединение, высокие задержки и риск блокировки в любой момент. Для продакшн-систем это неприемлемо.

Решение — использовать российский OpenAI-совместимый прокси, например PlusVibe API, который принимает платежи в рублях, работает с российских IP и полностью совместим с форматом OpenAI API.

Установка PrivateGPT

Существует два основных способа установки: через Docker (рекомендуется для серверов и продакшена) и через npm/pip (для разработчиков).

Способ 1: Установка через Docker

Это самый простой и воспроизводимый способ. Убедитесь, что на сервере установлены Docker и Docker Compose.

# Клонируем репозиторий
git clone https://github.com/zylon-ai/private-gpt.git
cd private-gpt

# Создаём файл настроек
cp settings.yaml.example settings.yaml

# Запускаем через Docker Compose
docker compose up -d

После запуска PrivateGPT будет доступен по адресу http://localhost:8001. Веб-интерфейс откроется в браузере, API — на порту 8001.

Для работы с GPU (рекомендуется для производительности):

# Установка с поддержкой NVIDIA GPU
docker compose --profile gpu up -d

Проверка работоспособности:

curl http://localhost:8001/health
# Ответ: {"status": "ok"}

Способ 2: Установка через pip (Python)

Если Docker не подходит, можно установить PrivateGPT напрямую. Требуется Python 3.11+.

# Создаём виртуальное окружение
python3.11 -m venv .venv
source .venv/bin/activate  # Linux/Mac
# .venv\Scripts\activate  # Windows

# Устанавливаем Poetry (менеджер зависимостей)
pip install poetry

# Устанавливаем зависимости
poetry install --extras "ui llms-openai-like embeddings-openai-like"

# Копируем конфиг
cp settings.yaml.example settings.yaml

# Запускаем сервер
MAKE=setup poetry run python -m private_gpt

Настройка settings.yaml для внешнего API

После установки откройте settings.yaml и найдите секцию openai. Именно здесь мы укажем PlusVibe API вместо оригинального OpenAI:

llm:
  mode: openai

embedding:
  mode: openai

openai:
  api_key: "sk-pv-ваш-ключ-здесь"
  model: "gpt-4o"

Сохраните файл. Далее мы добавим base_url при подключении к PlusVibe API.

Подключение к PlusVibe API

PlusVibe API — российский прокси для доступа к GPT-4, Claude, Gemini и десяткам других моделей. Полностью совместим с OpenAI API: достаточно изменить base_url и ключ.

Шаг 1: Регистрация и получение ключа

Перейдите на https://plusvibeapi.ru/register
Зарегистрируйтесь (принимаем карты Мир, СБП, криптовалюту)
В личном кабинете создайте API-ключ — он начинается с sk-pv-

Шаг 2: Настройка PrivateGPT для работы с PlusVibe

Откройте settings.yaml и добавьте api_base:

llm:
  mode: openai

embedding:
  mode: openai

openai:
  api_key: "sk-pv-ваш-ключ"
  api_base: "https://plusvibeapi.ru/v1"
  model: "gpt-4o"

Для Docker-установки передайте переменные окружения:

docker compose up -d \
  -e OPENAI_API_KEY="sk-pv-ваш-ключ" \
  -e OPENAI_API_BASE="https://plusvibeapi.ru/v1"

Или создайте файл .env в корне проекта:

OPENAI_API_KEY=sk-pv-ваш-ключ
OPENAI_API_BASE=https://plusvibeapi.ru/v1
OPENAI_MODEL=gpt-4o

Доступные модели в PlusVibe

После подключения вам доступны все актуальные модели:

gpt-4o, gpt-4o-mini — GPT-4 от OpenAI
claude-opus-4, claude-sonnet-4 — Anthropic Claude
gemini-2.0-flash, gemini-2.5-pro — Google Gemini
deepseek-v3, deepseek-r1 — DeepSeek
Десятки других моделей через OpenRouter

Пример запроса к PrivateGPT через PlusVibe API

Проверим, что всё работает. Сначала через прямой HTTP-запрос к PlusVibe API:

curl -X POST https://plusvibeapi.ru/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-pv-ваш-ключ" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "Привет! Ты работаешь через PlusVibe API?"
      }
    ]
  }'

Пример на Python для интеграции в ваш код:

from openai import OpenAI

client = OpenAI(
    api_key="sk-pv-ваш-ключ",
    base_url="https://plusvibeapi.ru/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {
            "role": "system",
            "content": "Ты помощник для анализа корпоративных документов."
        },
        {
            "role": "user",
            "content": "Проанализируй следующий договор и выдели ключевые риски..."
        }
    ]
)

print(response.choices[0].message.content)

Пример на Node.js / JavaScript:

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-pv-ваш-ключ',
  baseURL: 'https://plusvibeapi.ru/v1',
});

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [
    { role: 'user', content: 'Привет из России!' }
  ],
});

console.log(response.choices[0].message.content);

Для загрузки документов непосредственно в PrivateGPT (RAG-режим):

curl -X POST http://localhost:8001/v1/ingest/files \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/your/document.pdf"

# После загрузки — задаём вопрос по документу
curl -X POST http://localhost:8001/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "private-gpt",
    "messages": [{"role": "user", "content": "Какие штрафные санкции предусмотрены в договоре?"}],
    "use_context": true
  }'

Итог: локальный AI на ваших данных без ограничений

PrivateGPT решает главную проблему корпоративного AI в России: как использовать мощные языковые модели, не нарушая требования к конфиденциальности данных и не завися от нестабильного VPN.

Схема работы проста:

Ваши документы загружаются в PrivateGPT на вашем сервере — они никуда не уходят.
Запросы к LLM идут через PlusVibe API (https://plusvibeapi.ru/v1) — российский прокси без блокировок.
Ответы возвращаются прямо в ваш интерфейс или приложение.

Что вы получаете в итоге:

Доступ к GPT-4o, Claude 4, Gemini из России без VPN
Оплата рублями через карты Мир и СБП
Полный контроль над данными — они не покидают ваш сервер
Соответствие 152-ФЗ при правильной настройке
OpenAI-совместимый API — переписывать код не нужно

Готовы начать? Зарегистрируйтесь на plusvibeapi.ru/register, получите API-ключ и запустите свой локальный AI уже сегодня. Первые запросы — бесплатно.

Получить API-ключ бесплатно