Hansero/Hai-Studio-release
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

README.md 업데이트

Browse Source
This commit is contained in:
kkt
2026-06-23 15:31:24 +09:00
parent a94c9f7637
commit a66c43b255
1 changed files with 192 additions and 343 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+192 -343
View File
@@ -1,164 +1,18 @@
# Hansero VisionCore / Hai-Studio Installer Releases
# Hansero Hai-Studio 설치 및 사용 안내
한세로테크노 AI 비전 학습 프로그램 및 검사 런타임 설치파일 배포용 저장소입니다.
한세로테크노 AI 비전 학습 프로그램 설치파일입니다.
이 저장소는 **소스코드 저장소가 아니라 설치파일 릴리즈 저장소**입니다.
프로그램 소스코드, 개발 이력, 내부 구현 파일은 별도 소스 저장소에서 관리하며, 이 저장소에는 사내 설치 및 배포에 필요한 설치파일과 사용 안내만 보관합니다.
이 설치파일에는 학습 프로그램, 실행 런타임, 샘플 프로그램이 포함되어 있습니다.
---
## 1. 프로그램 개요
## 1. 설치 방법
### Hai-Studio / AI Trainer
Hai-Studio는 한세로테크노 내부에서 사용하는 AI 비전 학습 프로그램입니다.
주요 기능은 다음과 같습니다.
* 이미지 데이터셋 관리
* Detection / Segmentation / Classification / Pose 학습 프로젝트 구성
* YOLO 기반 PT/Python 학습 및 추론
* 학습 모델 ONNX 변환
* C# Native ONNX 추론 모드 지원
* 라벨링 및 검수 기능
* 샘플 프로젝트 실행
* 검사 프로그램 연동용 모델 생성
---
## 2. 저장소 용도
이 저장소는 다음 목적에 사용합니다.
* 최종 설치파일 보관
* 버전별 릴리즈 관리
* 사내 PC 설치용 파일 배포
* 설치 방법 및 주의사항 안내
* 소스코드와 배포파일 분리 관리
이 저장소에는 원칙적으로 다음 파일만 포함합니다.
```text
README.md
CHANGELOG.md
installers/
docs/
checksums/
```
권장 구조는 다음과 같습니다.
```text
.
├─ README.md
├─ CHANGELOG.md
├─ installers/
│ ├─ HaiStudioTrainer_Setup_v1.0.xx.exe
│ ├─ HanseroInspectionRuntime_Setup_v1.0.xx.exe
│ └─ HanseroVisionCore_Full_Setup_v1.0.xx.exe
├─ docs/
│ ├─ 설치_방법.md
│ ├─ 사용_전_확인사항.md
│ └─ 문제해결.md
└─ checksums/
└─ SHA256SUMS.txt
```
---
## 3. 설치파일 구분
### 3.1 Hai-Studio Trainer Installer
학습 프로그램 설치파일입니다.
포함 대상:
* Hai-Studio / AI Trainer 실행 프로그램
* AI Engine SDK
* Native ONNX 추론 모듈
* Python / PT YOLO 학습 런타임
* ONNX 변환 기능
* 샘플 프로젝트
* Tools
* Assets
* Docs
일반적으로 학습 프로그램을 설치할 PC에는 이 설치파일을 사용합니다.
---
### 3.2 Inspection Runtime Installer
검사 프로그램 실행용 런타임 설치파일입니다.
포함 대상:
* AI Engine SDK
* Native ONNX Runtime
* 검사 프로그램 실행에 필요한 공통 런타임
* 샘플 검사 프로젝트
* Tools
* Assets
* Docs
학습 기능이 필요 없고, 검사 프로그램 실행만 필요한 PC에는 이 설치파일을 사용합니다.
---
### 3.3 Full Local Installer
전체 통합 설치파일입니다.
포함 대상:
* Hai-Studio / Trainer
* SDK
* Runtime
* Samples
* Tools
* Assets
* Docs
개발, 테스트, 오프라인 설치, 현장 대응용 PC에는 전체 통합 설치파일을 사용합니다.
---
## 4. 파일명 규칙
설치파일은 다음 형식을 권장합니다.
```text
HaiStudioTrainer_Setup_v1.0.xx.exe
HanseroInspectionRuntime_Setup_v1.0.xx.exe
HanseroVisionCore_Full_Setup_v1.0.xx.exe
```
예시:
```text
HaiStudioTrainer_Setup_v1.0.95.exe
HanseroInspectionRuntime_Setup_v1.0.95.exe
HanseroVisionCore_Full_Setup_v1.0.95.exe
```
버전 표기는 가능한 한 다음 기준을 따릅니다.
```text
Major.Minor.Build
```
예시:
```text
v1.0.95
v1.0.96
v1.0.97
```
---
## 5. 설치 위치
1. 설치파일을 다운로드합니다.
2. 설치파일을 마우스 오른쪽 버튼으로 클릭합니다.
3. `관리자 권한으로 실행`을 선택합니다.
4. 설치 안내에 따라 설치를 진행합니다.
5. 설치가 완료되면 바탕화면 또는 시작 메뉴에서 프로그램을 실행합니다.
기본 설치 위치는 다음과 같습니다.
@@ -166,190 +20,200 @@ v1.0.97
C:\Program Files\Hansero\VisionCore\
```
설치 후 권장 폴더 구조는 다음과 같습니다.
---
## 2. 학습 프로그램 사용 방법
### 2.1 프로그램 실행
설치 후 `Hai-Studio` 또는 `Hansero AI Trainer`를 실행합니다.
---
### 2.2 새 프로젝트 생성
1. `새 프로젝트`를 선택합니다.
2. 프로젝트 이름을 입력합니다.
3. 학습 유형을 선택합니다.
지원 학습 유형:
```text
C:\Program Files\Hansero\VisionCore\
├─ Studio
├─ Trainer
├─ SDK
├─ Runtime
├─ Samples
├─ Tools
├─ Assets
└─ Docs
Detection
Segmentation
Classification
Pose
```
설치파일 종류와 버전에 따라 일부 폴더는 포함되지 않을 수 있습니다.
4. 프로젝트 저장 위치를 선택합니다.
5. 프로젝트를 생성합니다.
---
## 6. 설치 전 확인사항
### 2.3 이미지 추가
설치 전 다음 사항을 확인합니다.
* Windows 10 또는 Windows 11 64bit
* 관리자 권한 설치 권장
* 기존 버전 실행 중이면 종료 후 설치
* 백신 또는 보안 프로그램에서 설치파일 차단 여부 확인
* GPU 사용 시 NVIDIA 드라이버 설치 여부 확인
* 오프라인 설치 시 설치파일 용량과 포함 런타임 확인
1. 학습에 사용할 이미지 폴더를 선택합니다.
2. 이미지를 프로젝트에 추가합니다.
3. 이미지 목록에서 라벨링할 이미지를 선택합니다.
---
## 7. 설치 방법
### 2.4 라벨링
1. 최신 릴리즈 설치파일을 다운로드합니다.
2. 설치파일을 마우스 오른쪽 버튼으로 클릭합니다.
3. `관리자 권한으로 실행`을 선택합니다.
4. 설치 경로를 확인합니다.
5. 설치를 완료합니다.
6. 시작 메뉴 또는 바탕화면 바로가기로 프로그램을 실행합니다.
1. 이미지에서 검사할 대상을 박스로 지정합니다.
2. 클래스 이름을 선택하거나 새로 추가합니다.
3. 필요한 이미지에 라벨을 추가합니다.
4. 작업 후 저장합니다.
---
## 8. 설치 후 확인사항
### 2.5 학습 실행
1. `학습` 메뉴로 이동합니다.
2. 모델 종류와 학습 옵션을 선택합니다.
3. 학습을 실행합니다.
4. 학습 진행 상태와 로그를 확인합니다.
학습이 완료되면 결과 모델이 생성됩니다.
---
### 2.6 추론 테스트
1. 학습된 모델을 선택합니다.
2. 테스트 이미지를 선택합니다.
3. 추론을 실행합니다.
4. 검출 결과, 점수, 처리 시간을 확인합니다.
---
### 2.7 ONNX 변환 및 Native 추론
학습된 PT 모델은 ONNX로 변환할 수 있습니다.
ONNX 모델은 C# Native ONNX 추론 모드에서 사용할 수 있습니다.
사용 모드:
```text
PT / Python YOLO 모드
C# Native ONNX 모드
```
속도 비교나 실제 검사 프로그램 연동 테스트가 필요한 경우 Native ONNX 모드를 사용합니다.
---
## 3. 샘플 프로그램 사용 방법
설치 후 샘플은 다음 위치에서 확인할 수 있습니다.
```text
C:\Program Files\Hansero\VisionCore\Samples\
```
---
### 3.1 샘플 폴더 확인
`Samples` 폴더에는 테스트용 이미지, 모델, 설정 파일이 포함되어 있습니다.
예시 구조:
```text
Samples
├─ BoltInspection
├─ TrainerSample
├─ Models
└─ Images
```
설치 버전에 따라 폴더 이름은 다를 수 있습니다.
---
### 3.2 샘플 실행
1. `Samples` 폴더를 엽니다.
2. 실행 파일 또는 샘플 프로젝트 파일을 선택합니다.
3. 프로그램을 실행합니다.
4. 샘플 이미지와 모델이 자동으로 불러와지는지 확인합니다.
5. 추론 또는 검사를 실행합니다.
---
### 3.3 샘플 프로젝트 열기
학습 프로그램에서 샘플을 열려면:
1. `프로젝트 열기`를 선택합니다.
2. `Samples` 폴더로 이동합니다.
3. 샘플 프로젝트 폴더를 선택합니다.
4. 프로젝트가 정상적으로 열리는지 확인합니다.
5. 라벨, 이미지, 모델이 정상적으로 표시되는지 확인합니다.
---
### 3.4 샘플 검사 실행
샘플 검사 프로그램에서는 다음 항목을 확인합니다.
```text
이미지 로드
모델 로드
추론 실행
OK / NG 결과 표시
검출 박스 표시
처리 시간 표시
결과 저장
```
샘플이 정상 동작하면 설치가 정상적으로 완료된 것입니다.
---
## 4. 설치 후 확인사항
설치 후 다음 항목을 확인합니다.
### Hai-Studio / Trainer
* 프로그램 정상 실행 여부
* 새 프로젝트 생성 가능 여부
* 샘플 프로젝트 열기 가능 여부
* PT / Python YOLO 모드 선택 가능 여부
* Native ONNX 추론 모드 선택 가능 여부
* ONNX 변환 기능 동작 여부
* GPU 장치 표시 여부
* 추론 테스트 실행 여부
### Runtime
* Runtime 폴더 존재 여부
* SDK 폴더 존재 여부
* Samples 폴더 존재 여부
* 검사 샘플 실행 여부
* ONNX 모델 로드 여부
---
## 9. 설치파일 용량 확인 기준
런타임 포함 여부는 설치파일 용량으로 1차 확인할 수 있습니다.
```text
수십 MB 수준
→ 런타임 또는 샘플 누락 가능성 있음
수 GB 수준
→ Python / AI Runtime / Samples 포함 가능성 높음
```
특히 Trainer 설치파일은 Python 기반 학습 런타임을 포함하는 경우 용량이 크게 증가할 수 있습니다.
---
## 10. 버전 업데이트 절차
새 설치파일을 등록할 때는 다음 순서로 진행합니다.
1. 설치파일 생성
2. 테스트 PC에서 설치 검증
3. 실행 및 샘플 프로젝트 검증
4. 설치파일명을 버전 규칙에 맞게 변경
5. `installers/` 폴더에 업로드
6. `CHANGELOG.md` 업데이트
7. 필요 시 `checksums/SHA256SUMS.txt` 업데이트
8. Git tag 또는 Gitea Release 등록
권장 커밋 메시지:
```text
Add Hai-Studio Trainer installer v1.0.xx
```
또는:
```text
Release Hansero VisionCore installer v1.0.xx
학습 프로그램 실행 여부
샘플 프로젝트 열기 여부
이미지 추가 가능 여부
라벨링 가능 여부
학습 실행 가능 여부
ONNX 변환 가능 여부
Native ONNX 추론 가능 여부
샘플 검사 프로그램 실행 여부
```
---
## 11. 소스코드 저장소와의 관계
이 저장소는 설치파일 배포 전용 저장소입니다.
소스코드는 별도 저장소에서 관리합니다.
예시:
```text
소스코드 저장소
→ hansero-visioncore
→ hansero-ai-trainer
→ hansero-ai-engine-sdk
릴리즈 저장소
→ hansero-visioncore-installer-releases
```
릴리즈 저장소에는 다음 항목을 올리지 않습니다.
```text
bin/
obj/
.vs/
.git/
소스 전체 압축본
개발 중간 산출물
개인 토큰
개인 설정 파일
임시 테스트 파일
```
---
## 12. 보안 주의사항
설치파일 배포 저장소에는 다음 정보를 포함하지 않습니다.
* Gitea 개인 토큰
* API Key
* 서버 접속 비밀번호
* 사내 DB 접속 정보
* 고객사 보안 자료
* 학습 데이터 원본 중 외부 반출 제한 자료
* 모델 파일 중 고객사 반출 제한 대상
설치파일을 외부에 전달하기 전에는 포함 파일을 반드시 확인합니다.
---
## 13. 문제 해결
### 설치파일 실행이 차단되는 경우
Windows SmartScreen 또는 백신에서 차단할 수 있습니다.
조치 방법:
1. 설치파일 우클릭
2. 속성 선택
3. 차단 해제 항목이 있으면 체크
4. 관리자 권한으로 실행
---
## 5. 문제 발생 시 확인사항
### 프로그램이 실행되지 않는 경우
다음을 확인합니다.
* 설치 경로에 한글 또는 특수문자가 과도하게 포함되어 있는지 확인
* Runtime 폴더 존재 여부 확인
* 필요한 DLL 파일 존재 여부 확인
* 백신에서 일부 파일을 격리했는지 확인
* 로그 파일 확인
```text
관리자 권한으로 실행했는지 확인
설치가 정상 완료되었는지 확인
백신 프로그램에서 차단하지 않았는지 확인
설치 폴더가 삭제되지 않았는지 확인
```
---
### 샘플이 열리지 않는 경우
다음을 확인합니다.
```text
Samples 폴더가 있는지 확인
샘플 이미지가 있는지 확인
샘플 모델 파일이 있는지 확인
설치파일 용량이 비정상적으로 작지 않은지 확인
```
---
@@ -357,44 +221,29 @@ Windows SmartScreen 또는 백신에서 차단할 수 있습니다.
다음을 확인합니다.
* NVIDIA 드라이버 설치 여부
* CUDA 지원 GPU 여부
* ONNX Runtime GPU 패키지 포함 여부
* 프로그램 설정에서 GPU 장치 선택 여부
```text
NVIDIA 그래픽카드 장착 여부
NVIDIA 드라이버 설치 여부
GPU 사용 옵션 선택 여부
```
GPU 사용이 불가능한 경우 CPU 모드로 실행할 수 있습니다.
---
### 샘플 프로젝트가 열리지 않는 경우
## 6. 권장 사용 순서
다음을 확인합니다.
* Samples 폴더가 설치되었는지 확인
* 샘플 이미지, 모델, 설정 파일이 모두 포함되어 있는지 확인
* 설치파일 용량이 비정상적으로 작지 않은지 확인
---
## 14. 담당
* 개발 / 유지보수: 한세로테크노
* 용도: 사내 AI 비전 학습 및 검사 프로그램 배포
* 배포 대상: 사내 개발 PC, 검사 PC, 현장 테스트 PC
---
## 15. 변경 이력
자세한 변경 내용은 `CHANGELOG.md`를 확인합니다.
간단한 릴리즈 기록은 아래 형식으로 작성합니다.
처음 설치 후에는 아래 순서로 확인합니다.
```text
v1.0.xx
- Hai-Studio Trainer 설치파일 업데이트
- Native ONNX 추론 모드 추가
- PT/Python YOLO 학습 모드 유지
- 샘플 프로젝트 포함
- Runtime 경로 자동 탐색 개선
1. 학습 프로그램 실행
2. 샘플 프로젝트 열기
3. 샘플 이미지 추론 실행
4. 새 프로젝트 생성
5. 이미지 추가
6. 라벨링
7. 학습 실행
8. 학습 모델 추론 테스트
9. ONNX 변환
10. Native ONNX 추론 테스트
```