설치
geo-mlops-sdk 를 pip 로 설치하고 필요한 엑스트라를 고른다
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.2.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 에서 한 번에 시험할 때 |
엑스트라 없이 에이전트 기능을 부르면 어느 엑스트라를 설치해야 하는지 알려 주는 오류가 납니다.
ImportError: EdgeRuntime needs the edge runtime; install 'geo-mlops-sdk[edge]'PyPI 의 0.0.2 는 쓰지 마세요
설치 확인
geo-mlops-edge --version
python -c "import geo_mlops_sdk; print(geo_mlops_sdk.__version__)"다음: 5분 시작에서 장비 하나를 실제로 붙여 봅니다.