설치
pip 로 geo-mlops-sdk 설치와 필요한 엑스트라 선택
geo-mlops-sdk 는 공개 PyPI 에서 배포. Python 3.10 이상 필요(3.10 ~ 3.14 지원).
한 줄 설치
장비에서 에이전트를 실행하고, NVIDIA GPU 사용률을 보고하고, PLC 를 읽고, YOLO 모델을 장비에서 실행하려면:
python3 -m venv /opt/geo-mlops/venv
/opt/geo-mlops/venv/bin/pip install 'geo-mlops-sdk[edge,gpu,modbus,yolo]'
/opt/geo-mlops/venv/bin/geo-mlops-edge --version # 0.3.0/opt/geo-mlops/venv 는 배포 장의 systemd 유닛이 가정하는 경로. 다른 경로에 설치하면 유닛의 ExecStart 도 수정 필요.
엑스트라
기본 설치(pip install geo-mlops-sdk)는 httpx 와 pydantic 만 설치. CentralClient 만 사용하는 애플리케이션에는 웹 서버나 GPU 라이브러리가 불필요하기 때문. 나머지는 엑스트라로 선택.
| 엑스트라 | 추가 기능 | 필요한 경우 |
|---|---|---|
edge | 에이전트 런타임, 로컬 API(FastAPI), 데몬 geo-mlops-edge | 장비에서 에이전트를 실행하는 경우(사실상 항상) |
gpu | 하트비트에 NVIDIA GPU 사용률(nvidia-ml-py) | NVIDIA GPU 가 있는 장비. 없으면 GPU 값은 빈 값으로 보고. |
modbus | Modbus TCP 수집기(pymodbus) | PLC 를 읽는 경우 |
yolo | 장비에서 YOLO 모델 실행(ultralytics, numpy, pillow) | 장비에서 YOLO 추론을 실행하는 경우 |
rfdetr | 장비에서 RF-DETR 모델 실행(rfdetr) | 장비에서 RF-DETR 추론을 실행하는 경우 |
all | 위 항목 전체 | 개발 PC 에서 모든 기능을 시험하는 경우 |
엑스트라 없이 geo_mlops_sdk.EdgeRuntime 같은 에이전트 기능을 호출하면 설치할 엑스트라를 안내하는 오류 발생.
ImportError: EdgeRuntime needs the edge runtime; install 'geo-mlops-sdk[edge]'geo-mlops-edge 명령은 기본 설치에도 포함. 단 edge 엑스트라 없이 실행하면 ModuleNotFoundError: No module named 'pydantic_settings' 오류로 종료.
PyPI 의 0.0.2 사용 금지
설치 확인
geo-mlops-edge --version
python -c "import geo_mlops_sdk; print(geo_mlops_sdk.__version__)"다음: 5분 시작에서 장비 하나 연결.