Semantic Mail 소개
Semantic Mail은 Gmail 메일함을 LLM 기반 벡터 검색 솔루션으로 전환하여, 많은 메일 중 필요한 정보를 빠르고 쉽게 찾고, 요약까지 제공해 주기 때문에 생산성과 효율성을 크게 높일 수 있습니다. 단순한 키워드 검색 대신, Gmail 메일 내용을 LLM(대형 언어 모델)을 사용한 임베딩(vector) 기반으로 분석하고, 의미 기반의 질의가 가능합니다.
Semantic Mail은 로컬 머신에서도 실행 가능하며, Ollama나 OpenAI 같은 LLM 프롬프트를 활용해 이메일 내용을 벡터로 변환한 후 ChromaDB에 저장하고 검색합니다. 일반적인 이메일 클라이언트보다 훨씬 '사람처럼' 메일 내용을 이해하고, 요약하거나 추론할 수 있습니다.
기존 메일 서비스는 날짜나 키워드 위주이지만, LLM과 결합한 벡터 기반 검색을 통해 “지난달 보낸 인보이스 찾기”나 “팀 회의 요약” 같은 자연어 질의로 업무 수행이 쉬워집니다. 즉, 기존 방식은 단순 검색에 머무르지만, Semantic Mail은 문의 응답이나 데이터 추출 등 '질문-응답' 구조로 메일함을 적극적으로 활용할 수 있게 합니다.
Semantic Mail의 주요 특징
- 로컬 실행 지원: Python 3.11+, Ollama 기반 로컬 임베딩과 ChromaDB 벡터 저장소 사용
- 점진적 동기화: “이메일 증가분만” 동기화하여 성능 효율 극대화
- 다양한 임베딩 모델 지원: nomic‑embed‑text, mxbai‑embed‑large, all‑minilm 등
- OpenAI 연동 가능: 클라우드 기반 “text‑embedding‑3‑small/large” 활용
- LLM 기반 요약 및 질의:
ask명령으로 이메일 내용 요약, 정보 추출 - 명령줄 기반 인터페이스:
smail sync,smail search,smail ask등 단순 사용법
Semantic Mail 설치 및 사용법
설치
# Ollama 설치
curl -fsSL https://ollama.ai/install.sh | sh
ollama serve
# semantic-mail 깃 클론 후 설치
git clone https://github.com/yahorbarkouski/semantic-mail.git
cd semantic-mail
uv pip install -e .
Gmail API 설정
- GCP 콘솔에서 Gmail API 활성화
- OAuth 2.0 클라이언트 생성 (데스크톱 앱)
smail setup실행 후Client ID,Client Secret입력
기본 명령어
smail sync: 이메일 다운로드 + 임베딩 생성smail search "질의문장": 의미 기반 이메일 검색smail ask "질문문장": 메일 내용 요약/질문에 답변smail stats: 동기화 통계 확인smail models: 지원 모델 목록 조회
LLM과 벡터 모델을 자유롭게 조합할 수 있어 맞춤형 검색 환경 구성도 가능합니다.
라이선스
Semantic Mail 프로젝트는 오픈소스 라이선스 중 하나인 MIT License로 공개되어 있으며, 상업적 사용과 수정이 모두 가능합니다. 자세한 라이선스는 저장소 내 LICENSE.txt 파일을 참고해주세요.
Semantic Mail GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 
