Установка acmenra-cv¶

pip (рекомендуется)¶

Установка только легковесного ядра (без тяжелых ML-зависимостей):

pip install acmenra-cv

Если вы планируете использовать YOLO, установите пакет с опциональной зависимостью (это автоматически подтянет плагин acmenra-yolo):

pip install "acmenra-cv[yolo]"

Из исходников¶

git clone https://github.com/acmenra/acmenra-cv.git
cd acmenra-cv
pip install -e .

Проверка установки¶

import acmenra_cv
print(acmenra_cv.__version__)  # Ожидаемый вывод: 0.3.0.0 или выше

Требования¶

Python¶

Python 3.9+

Базовые зависимости (Core)¶

numpy>=1.21.0
opencv-python>=4.5.0

(Зависимости ultralytics и torch больше не входят в базовую установку, они устанавливаются только при выборе опции [yolo])

Для разработки¶

pytest>=7.0.0
ddt>=1.6.0
black>=23.0.0
mypy>=1.0.0

Установка на российских ОС¶

Astra Linux¶

sudo apt update
sudo apt install python3 python3-pip python3-venv libgl1

python3 -m venv acmenra-env
source acmenra-env/bin/activate
pip install acmenra-cv

РЕД ОС¶

sudo dnf install python3 python3-pip mesa-libGL

python3 -m venv acmenra-env
source acmenra-env/bin/activate
pip install acmenra-cv

Docker¶

FROM python:3.11-slim

WORKDIR /app

# Установка с поддержкой YOLO
RUN pip install "acmenra-cv[yolo]"

COPY . .

CMD ["python", "main.py"]

Troubleshooting¶

Ошибка: `ImportError: libGL.so.1: cannot open shared object file`¶

Решение: Установите системные библиотеки OpenGL: - Ubuntu/Debian: sudo apt install libgl1-mesa-glx - Astra Linux: sudo apt install libgl1

Ошибка: `ModuleNotFoundError: No module named 'acmenra_yolo'`¶

Решение: Вы пытаетесь использовать YOLO-бэкенд, но установили только ядро. Выполните: pip install "acmenra-cv[yolo]".

Следующие шаги¶

Быстрый старт