AI BOM
AI BOM(AI Bill of Materials)은 모델의 구성 정보를 부품 명세로 정리하는 분석입니다. 모델 카드, 라이선스, 베이스 모델, 학습 데이터셋, 파일 형식 같은 정보를 모아 정리하고, 확인이 필요한 곳을 표시합니다. 라이선스 위반을 판정하거나 규제 준수를 인증하지는 않습니다. AI 모델 서비스에서 사용합니다.
- 분석 : 모델 구성 명세 정리와 표준 형식(CycloneDX · SPDX) 출력
- 필요한 것 : 모델 저장소(Hugging Face · GitHub · GitLab) 연결
- 결과 : 구성요소 목록, 라이선스 범주, 확인이 필요한 항목, 표준 형식 문서
연결한 저장소 종류에 따라 분석 방식이 두 가지로 나뉩니다.
- Hugging Face 모델 : 공개된 모델 정보를 읽어 구성을 정리합니다.
- GitHub · GitLab 저장소 모델 : 제작 조직이 작성한 자체 모델 명세를 발행합니다.
Hugging Face 모델
Hugging Face 모델은 저장소에 공개된 모델 카드 · 설정 · 파일 정보를 읽어 구성요소와 라이선스, 학습 데이터를 정리합니다.
- 분석 실행 : 상단 요약 툴바의 분석 실행으로 시작합니다. 실행 창에서 작성자가 선언한 입력 정보를 수정하거나 추가로 입력하고, 모델을 어떻게 쓰는지 신호 기준(용도)을 선택할 수 있습니다.
- 모델 가중치는 내려받지 않습니다. 저장소에 공개된 정보만 읽습니다.
- 등록한
revision과 저장소의 현재 상태가 다르면, 현재main을 분석한다는 안내가 표시됩니다.
결과 화면은 다음으로 구성됩니다.
- 구성요소 목록 : 구성요소 개수와 라이선스 범주 필터, 각 구성요소 카드와 상세 서랍을 제공합니다.
- AI BOM 문서 : 종합 검토 신호, 구성 목록 완전성, 작성자 입력, 배포 파일 대조(일치 · 기록과 다름 · 대상 미확정 · 기록에 없음), 표준 형식 검증(CycloneDX · SPDX)을 요약합니다. 문서는 모델 식별, 이용 조건 · 파일 검사, 출처 · 미확인, 확인할 항목, 검증 · 내려받기 다섯 개 섹션으로 나뉘며, CycloneDX · SPDX 아티팩트를 내려받을 수 있습니다.
GitHub · GitLab 자체 모델 명세
GitHub · GitLab 저장소 모델은 공개 모델 정보 대신 제작 조직이 작성하는 자체 모델 명세를 만들어 발행합니다.
- AI BOM 생성 : AI BOM 생성을 누르면 생성(발행)이 진행됩니다. 저장소에서 커밋, 모델 파일 목록과 지문, 설정 파일 유무를 자동으로 수집해 CycloneDX 1.7 문서를 만듭니다.
- 입력 정보(선택) : 모델 이름 · 버전과 알고 있는 정보를 직접 입력합니다. 입력하지 않은 항목은 미기록으로 표시됩니다.
- 분석 대상은 등록한 브랜치로 고정됩니다.
읽는 범위와 다루는 방식은 다음과 같습니다.
- 커밋, 모델 파일 목록과 지문, README ·
config.json· LICENSE, 모델 파일 구조를 읽습니다. - 모델 파일은 실행하지 않습니다. safetensors 는 헤더만, PyTorch 파일(
.pt·.pth·.bin·.ckpt)은 구조 부분만 읽으며, 파일별 바이트 상한이 적용됩니다.
발행본에는 모델과 기반 모델, 학습 · 평가 데이터셋(작성자 선언), 모델 파일과 지문(저장소 지문과 제출한 지문 대조), 근거 연결(저장소 · 브랜치 · 커밋 · 설정 파일), 기록되지 않았거나 확인하지 못한 범위가 담기며, CycloneDX 1.7 형식 검증을 통과하면 문서를 내려받을 수 있습니다.
자체 모델 명세의 입력 정보는 작성자 선언으로 기록되며, 입력한 내용이 사실인지는 Vulinder 가 확인하지 않습니다. 저장소에서 읽어 대조한 항목과 선언으로만 남은 항목은 화면에서 구분해 표시합니다.
산출물의 성격
AI BOM 은 저장소의 현재 공개 상태를 읽어 정리한 명세입니다. 운영 중인 AI 시스템 전체의 성분표가 아니며, 패키지 · 검색 DB · 외부 AI API 는 찾지 않습니다. 라이선스 위반 판정이나 규제 준수 인증도 아닙니다.
AI BOM 분석과 생성은 실행할 때마다 크레딧(VU)이 차감됩니다. 사용량과 잔량은 결제 · 구독에서 확인할 수 있습니다.