AI 용어집 · 기초 · AI 플랫폼·솔루션 · AI 보안
safetensors 세이프텐서, 모델 가중치 파일 형식
safetensors는 AI 모델의 가중치(학습으로 정해진 숫자들)를 안전하고 빠르게 저장·불러오도록 만든 파일 형식이다. 파일을 여는 것만으로 숨겨진 코드가 실행될 위험이 없다는 점이 가장 큰 특징이다.
용어 정보
- 난이도
- 기초 · 소식을 읽을 때 자주 만나는 기술 용어
- 카테고리
- 인프라·모델 활용
- 분야
- AI 플랫폼·솔루션, AI 보안
- 추가
- 2026-10-12
어떻게 작동하나
파일 맨 앞에 작은 목차(헤더)가 있고, 여기에 각 텐서(숫자 묶음)의 이름, 자료형, 모양, 파일 안 위치가 적혀 있다. 그 뒤에는 실제 숫자들이 그대로 이어 붙어 있을 뿐 실행할 코드는 들어 있지 않다. 그래서 프로그램은 목차만 읽고 필요한 부분을 메모리에 바로 연결(메모리 매핑)해 빠르게 불러올 수 있다. 예전에 흔히 쓰던 PyTorch의 .bin·.pt 파일은 파이썬 pickle 방식이라 파일을 여는 순간 임의 코드가 실행될 수 있었는데, safetensors는 이 구멍을 구조적으로 막았다.
pickle 파일 vs safetensors
.bin·.pt (pickle)예전 PyTorch 방식
- 열 때 임의 코드가 실행될 수 있음
- 전체를 읽어 들여야 함
safetensors목차 + 숫자만
- 코드가 없어 열기가 안전함
- 메모리 매핑으로 빠르게 로딩
- 헤더만 보고 구성 확인 가능
공통 둘 다 모델 가중치를 저장하는 파일이다
어디서 보게 되나
Hugging Face 모델 페이지의 'Files and versions' 탭에서 가장 자주 본다. 큰 모델은 model-00001-of-00004.safetensors처럼 여러 조각으로 나뉘고, 어느 텐서가 어느 조각에 있는지 적은 model.safetensors.index.json이 함께 있다. 조각 파일 크기를 모두 더하면 가중치를 GPU에 올릴 때 필요한 메모리를 대략 짐작할 수 있다. Transformers, vLLM 같은 도구는 이 파일을 기본으로 읽는다.
알아 둘 점
safetensors는 '저장 형식'일 뿐 모델 자체가 안전하다는 보증은 아니다. 파일 열기는 안전해도, 모델이 학습 과정에서 백도어를 품었거나 저장소에 함께 올라온 파이썬 코드(trust_remote_code)가 위험할 수는 있다. 또 같은 모델이라도 safetensors와 .bin이 함께 있으면 safetensors 쪽을 받는 편이 안전하고 빠르다. 노트북에서 llama.cpp 계열로 돌릴 때는 보통 GGUF라는 다른 형식을 쓴다는 점도 구분해 두자.
예시
Hugging Face에서 오픈웨이트 모델을 내려받으려는데 파일 목록에 .bin과 .safetensors가 모두 보인다면, 사내 보안 지침에 따라 safetensors만 받도록 설정하는 경우가 많다. 조각 파일 크기 합계를 보고 "이 정도면 GPU 한 장에 올라가겠다" 하고 서빙 구성을 고르는 것도 흔한 장면이다.