Update: Hugging Face 배포 설정 및 EXAONE 통합 개선

.github/workflows/README.md

@@ -81,3 +81,4 @@ GitHub 저장소의 Settings > Secrets and variables > Actions에서 다음 secr
 - `.gitignore`에서 해당 파일이 제외되지 않았는지 확인
 - 워크플로우의 `paths` 필터에 해당 파일이 포함되어 있는지 확인
 
+

.github/workflows/deploy-to-hf.yml

@@ -69,3 +69,4 @@ jobs:
           echo "✅ Deployment completed successfully!"
           echo "Space URL: https://huggingface.co/spaces/${{ secrets.HF_USERNAME }}/${{ secrets.HF_SPACE_NAME }}"
 
+

.github/workflows/test.yml

@@ -57,3 +57,4 @@ jobs:
         run: |
           echo "✅ All tests passed!"
 
+

Dockerfile

@@ -35,3 +35,4 @@ ENV HOST=0.0.0.0
 
 # 6. 애플리케이션 실행 (직접 실행 대신 start.sh를 통해 Ollama와 앱을 모두 실행)
 CMD ["./start.sh"]
+

EXAONE_설치_가이드.md

@@ -168,5 +168,6 @@ tokenizer = AutoTokenizer.from_pretrained("LGAI-EXAONE/EXAONE-3.0-7.8B-Instruct"
 
 
 
+
 
 

HF_UPLOAD_GUIDE.md

@@ -142,3 +142,4 @@ Write-Host "파일 복사 완료!"
 ### 파일 누락
 - 모든 필수 디렉토리(`app/`, `templates/`, `static/`)가 업로드되었는지 확인
 
+

README_HF.md

@@ -54,3 +54,4 @@ Settings > Repository secrets에서 다음 환경 변수를 설정하세요:
 
 MIT License
 
+

add_exaone_model.py

@@ -163,5 +163,6 @@ if __name__ == "__main__":
 
 
 
+
 
 

add_exaone_with_token.py

@@ -5,11 +5,41 @@ EXAONE-3.0-7.8B-Instruct 모델을 Ollama에 추가하는 스크립트 (토큰
 import os
 import subprocess
 from pathlib import Path
+import sys
 
-# Hugging Face 토큰 (환경 변수에서 읽기)
-HF_TOKEN = os.environ.get("HUGGINGFACE_HUB_TOKEN") or os.environ.get("HF_TOKEN")
+# 프로젝트 루트를 Python 경로에 추가
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+def get_huggingface_token():
+    """
+    Hugging Face 토큰 가져오기 (환경 변수 우선, 없으면 DB에서)
+    Google API 키 관리 방식과 동일한 패턴
+    """
+    # 환경 변수에서 먼저 확인
+    token = os.getenv('HUGGINGFACE_HUB_TOKEN', '').strip()
+    if not token:
+        token = os.getenv('HF_TOKEN', '').strip()
+    
+    if token:
+        print(f"[Hugging Face] 환경 변수에서 토큰 가져옴 (길이: {len(token)}자)")
+        return token
+    
+    # DB에서 가져오기 (순환 참조 방지를 위해 여기서 임포트)
+    try:
+        from app.database import SystemConfig
+        # Flask 애플리케이션 컨텍스트 없이도 작동하도록 시도
+        token = SystemConfig.get_config('huggingface_token', '').strip()
+        if token:
+            print(f"[Hugging Face] DB에서 토큰 가져옴 (길이: {len(token)}자)")
+        return token
+    except Exception as e:
+        print(f"[Hugging Face] DB에서 토큰 조회 실패 (환경 변수 사용): {e}")
+        return ''
+
+# Hugging Face 토큰 가져오기
+HF_TOKEN = get_huggingface_token()
 if not HF_TOKEN:
-    raise ValueError("HUGGINGFACE_HUB_TOKEN 또는 HF_TOKEN 환경 변수를 설정해주세요.")
+    raise ValueError("HUGGINGFACE_HUB_TOKEN 또는 HF_TOKEN 환경 변수를 설정하거나, 관리 페이지에서 토큰을 설정해주세요.")
 
 def set_huggingface_token():
     """Hugging Face 토큰 설정"""

app.py

@@ -70,3 +70,4 @@ if __name__ == '__main__':
         import traceback
         traceback.print_exc()
 
+

app/huggingface_client.py

@@ -0,0 +1,46 @@
+"""
+Hugging Face 토큰 관리 모듈
+Google Gemini API 키 관리 방식과 동일한 패턴으로 구현
+"""
+
+import os
+from typing import Optional
+
+def get_huggingface_token() -> str:
+    """
+    Hugging Face 토큰 가져오기 (환경 변수 우선, 없으면 DB에서)
+    
+    Returns:
+        Hugging Face 토큰 문자열 (없으면 빈 문자열)
+    """
+    # 환경 변수에서 먼저 확인
+    token = os.getenv('HUGGINGFACE_HUB_TOKEN', '').strip()
+    if not token:
+        token = os.getenv('HF_TOKEN', '').strip()
+    
+    if token:
+        print(f"[Hugging Face] 환경 변수에서 토큰 가져옴 (길이: {len(token)}자)")
+        return token
+    
+    # DB에서 가져오기 (순환 참조 방지를 위해 여기서 임포트)
+    try:
+        from app.database import SystemConfig
+        token = SystemConfig.get_config('huggingface_token', '').strip()
+        if token:
+            print(f"[Hugging Face] DB에서 토큰 가져옴 (길이: {len(token)}자)")
+        else:
+            print(f"[Hugging Face] DB에 토큰이 없거나 비어있음")
+        return token
+    except Exception as e:
+        print(f"[Hugging Face] DB에서 토큰 조회 실패: {e}")
+        return ''
+
+def reset_huggingface_token():
+    """
+    Hugging Face 토큰 캐시 초기화 (토큰이 업데이트된 후 호출)
+    """
+    # 현재는 단순히 함수를 다시 호출하면 되지만, 
+    # 향후 캐싱이 추가될 경우를 대비한 함수
+    pass
+
+

app/routes.py

@@ -1983,6 +1983,26 @@ def get_gemini_api_key():
         traceback.print_exc()
         return jsonify({'error': f'API 키 조회 중 오류가 발생했습니다: {str(e)}'}), 500
 
+@main_bp.route('/api/admin/huggingface-token', methods=['GET'])
+@admin_required
+def get_huggingface_token():
+    """Hugging Face 토큰 조회"""
+    try:
+        from app.huggingface_client import get_huggingface_token
+        token = get_huggingface_token()
+        
+        # 보안을 위해 마스킹된 값 반환 (처음 8자만 표시)
+        masked_token = token[:8] + '...' if token and len(token) > 8 else ''
+        return jsonify({
+            'has_token': bool(token),
+            'masked_token': masked_token
+        }), 200
+    except Exception as e:
+        print(f"[Hugging Face 토큰 조회] 오류: {e}")
+        import traceback
+        traceback.print_exc()
+        return jsonify({'error': f'토큰 조회 중 오류가 발생했습니다: {str(e)}'}), 500
+
 @main_bp.route('/api/admin/model-tokens', methods=['GET'])
 @admin_required
 def get_model_tokens():
@@ -2223,6 +2243,51 @@ def set_gemini_api_key():
         traceback.print_exc()
         return jsonify({'error': f'API 키 저장 중 오류가 발생했습니다: {str(e)}'}), 500
 
+@main_bp.route('/api/admin/huggingface-token', methods=['POST'])
+@admin_required
+def set_huggingface_token():
+    """Hugging Face 토큰 저장/업데이트"""
+    
+    try:
+        if not request.is_json:
+            return jsonify({'error': 'Content-Type이 application/json이 아닙니다.'}), 400
+        
+        data = request.json
+        if not data:
+            return jsonify({'error': '요청 데이터가 없습니다.'}), 400
+        
+        token = data.get('token', '').strip()
+        
+        if not token:
+            return jsonify({'error': '토큰을 입력해주세요.'}), 400
+        
+        # 토큰 저장 (SystemConfig.set_config 내부에서 테이블 생성 처리)
+        SystemConfig.set_config(
+            key='huggingface_token',
+            value=token,
+            description='Hugging Face API 토큰'
+        )
+        
+        # Hugging Face 클라이언트에 토큰 재로드 알림
+        try:
+            from app.huggingface_client import reset_huggingface_token
+            reset_huggingface_token()
+            print(f"[Hugging Face] 토큰이 업데이트되어 클라이언트가 재로드되었습니다.")
+        except Exception as e:
+            print(f"[Hugging Face] 토큰 재로드 실패: {e}")
+        
+        return jsonify({
+            'message': 'Hugging Face 토큰이 성공적으로 저장되었습니다.',
+            'has_token': True
+        }), 200
+        
+    except Exception as e:
+        db.session.rollback()
+        print(f"[Hugging Face 토큰 저장] 오류: {e}")
+        import traceback
+        traceback.print_exc()
+        return jsonify({'error': f'토큰 저장 중 오류가 발생했습니다: {str(e)}'}), 500
+
 @main_bp.route('/api/ollama/models', methods=['GET'])
 @login_required
 def get_ollama_models():

download_exaone_model.py

@@ -4,12 +4,41 @@ Ollama에서 사용할 수 있도록 준비하는 스크립트
 """
 
 import os
+import sys
 from huggingface_hub import snapshot_download, login
 
-# Hugging Face 토큰 (환경 변수에서 읽기)
-HF_TOKEN = os.environ.get("HUGGINGFACE_HUB_TOKEN") or os.environ.get("HF_TOKEN")
+# 프로젝트 루트를 Python 경로에 추가
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+def get_huggingface_token():
+    """
+    Hugging Face 토큰 가져오기 (환경 변수 우선, 없으면 DB에서)
+    Google API 키 관리 방식과 동일한 패턴
+    """
+    # 환경 변수에서 먼저 확인
+    token = os.getenv('HUGGINGFACE_HUB_TOKEN', '').strip()
+    if not token:
+        token = os.getenv('HF_TOKEN', '').strip()
+    
+    if token:
+        print(f"[Hugging Face] 환경 변수에서 토큰 가져옴 (길이: {len(token)}자)")
+        return token
+    
+    # DB에서 가져오기 (순환 참조 방지를 위해 여기서 임포트)
+    try:
+        from app.database import SystemConfig
+        token = SystemConfig.get_config('huggingface_token', '').strip()
+        if token:
+            print(f"[Hugging Face] DB에서 토큰 가져옴 (길이: {len(token)}자)")
+        return token
+    except Exception as e:
+        print(f"[Hugging Face] DB에서 토큰 조회 실패 (환경 변수 사용): {e}")
+        return ''
+
+# Hugging Face 토큰 가져오기
+HF_TOKEN = get_huggingface_token()
 if not HF_TOKEN:
-    raise ValueError("HUGGINGFACE_HUB_TOKEN 또는 HF_TOKEN 환경 변수를 설정해주세요.")
+    raise ValueError("HUGGINGFACE_HUB_TOKEN 또는 HF_TOKEN 환경 변수를 설정하거나, 관리 페이지에서 토큰을 설정해주세요.")
 MODEL_NAME = "LGAI-EXAONE/EXAONE-3.0-7.8B-Instruct"
 
 def download_model():

install_exaone_direct.py

@@ -6,11 +6,40 @@ EXAONE-3.0-7.8B-Instruct를 Ollama에 직접 추가하는 스크립트
 import os
 import subprocess
 import json
+import sys
+
+# 프로젝트 루트를 Python 경로에 추가
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+def get_huggingface_token():
+    """
+    Hugging Face 토큰 가져오기 (환경 변수 우선, 없으면 DB에서)
+    Google API 키 관리 방식과 동일한 패턴
+    """
+    # 환경 변수에서 먼저 확인
+    token = os.getenv('HUGGINGFACE_HUB_TOKEN', '').strip()
+    if not token:
+        token = os.getenv('HF_TOKEN', '').strip()
+    
+    if token:
+        print(f"[Hugging Face] 환경 변수에서 토큰 가져옴 (길이: {len(token)}자)")
+        return token
+    
+    # DB에서 가져오기 (순환 참조 방지를 위해 여기서 임포트)
+    try:
+        from app.database import SystemConfig
+        token = SystemConfig.get_config('huggingface_token', '').strip()
+        if token:
+            print(f"[Hugging Face] DB에서 토큰 가져옴 (길이: {len(token)}자)")
+        return token
+    except Exception as e:
+        print(f"[Hugging Face] DB에서 토큰 조회 실패 (환경 변수 사용): {e}")
+        return ''
 
-# Hugging Face 토큰 (환경 변수에서 읽기)
-HF_TOKEN = os.environ.get("HUGGINGFACE_HUB_TOKEN") or os.environ.get("HF_TOKEN")
+# Hugging Face 토큰 가져오기
+HF_TOKEN = get_huggingface_token()
 if not HF_TOKEN:
-    raise ValueError("HUGGINGFACE_HUB_TOKEN 또는 HF_TOKEN 환경 변수를 설정해주세요.")
+    raise ValueError("HUGGINGFACE_HUB_TOKEN 또는 HF_TOKEN 환경 변수를 설정하거나, 관리 페이지에서 토큰을 설정해주세요.")
 
 def create_simple_modelfile():
     """간단한 Modelfile 생성 (로컬 경로 대신 모델 이름만 사용)"""

install_exaone_simple.py

@@ -7,11 +7,40 @@ Ollama 0.13.0에서는 직접 Hugging Face 모델을 지원하지 않으므로
 import os
 import subprocess
 from pathlib import Path
-
-# Hugging Face 토큰 (환경 변수에서 읽기)
-HF_TOKEN = os.environ.get("HUGGINGFACE_HUB_TOKEN") or os.environ.get("HF_TOKEN")
+import sys
+
+# 프로젝트 루트를 Python 경로에 추가
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+def get_huggingface_token():
+    """
+    Hugging Face 토큰 가져오기 (환경 변수 우선, 없으면 DB에서)
+    Google API 키 관리 방식과 동일한 패턴
+    """
+    # 환경 변수에서 먼저 확인
+    token = os.getenv('HUGGINGFACE_HUB_TOKEN', '').strip()
+    if not token:
+        token = os.getenv('HF_TOKEN', '').strip()
+    
+    if token:
+        print(f"[Hugging Face] 환경 변수에서 토큰 가져옴 (길이: {len(token)}자)")
+        return token
+    
+    # DB에서 가져오기 (순환 참조 방지를 위해 여기서 임포트)
+    try:
+        from app.database import SystemConfig
+        token = SystemConfig.get_config('huggingface_token', '').strip()
+        if token:
+            print(f"[Hugging Face] DB에서 토큰 가져옴 (길이: {len(token)}자)")
+        return token
+    except Exception as e:
+        print(f"[Hugging Face] DB에서 토큰 조회 실패 (환경 변수 사용): {e}")
+        return ''
+
+# Hugging Face 토큰 가져오기
+HF_TOKEN = get_huggingface_token()
 if not HF_TOKEN:
-    raise ValueError("HUGGINGFACE_HUB_TOKEN 또는 HF_TOKEN 환경 변수를 설정해주세요.")
+    raise ValueError("HUGGINGFACE_HUB_TOKEN 또는 HF_TOKEN 환경 변수를 설정하거나, 관리 페이지에서 토큰을 설정해주세요.")
 
 def main():
     print("\n" + "=" * 60)

migrate_add_is_public.py

@@ -59,3 +59,4 @@ if __name__ == '__main__':
     print("=" * 60)
     migrate_database()
 
+

remove_token_from_history.ps1

@@ -0,0 +1,33 @@
+# Git 히스토리에서 Hugging Face 토큰 제거 스크립트
+
+$token = "YOUR_HUGGINGFACE_TOKEN_HERE"
+$files = @(
+    "EXAONE_추가_안내.md",
+    "add_exaone_with_token.py",
+    "download_exaone_model.py",
+    "install_exaone_direct.py",
+    "install_exaone_simple.py"
+)
+
+Write-Host "Git 히스토리에서 토큰 제거 중..."
+
+# 각 파일에 대해 filter-branch 실행
+foreach ($file in $files) {
+    Write-Host "처리 중: $file"
+    
+    # 파일이 존재하는 커밋만 처리
+    $commits = git log --all --pretty=format:"%H" -- "$file" 2>$null
+    if ($commits) {
+        # PowerShell을 사용하여 파일 내용 수정
+        git filter-branch --force --tree-filter @"
+if [ -f "$file" ]; then
+    sed -i 's/$token/YOUR_HUGGINGFACE_TOKEN_HERE/g' "$file" 2>/dev/null || \
+    (powershell -Command "(Get-Content '$file') -replace '$token', 'YOUR_HUGGINGFACE_TOKEN_HERE' | Set-Content '$file'")
+fi
+"@ --prune-empty --tag-name-filter cat -- --all 2>&1 | Out-Null
+    }
+}
+
+Write-Host "완료!"
+
+

templates/admin_settings.html

@@ -345,6 +345,27 @@
             </div>
         </div>
 
+        <!-- Hugging Face 토큰 설정 섹션 -->
+        <div class="card">
+            <div class="card-header">
+                <div class="card-title">Hugging Face 토큰 설정</div>
+            </div>
+            <div style="padding: 16px 0;">
+                <div class="form-group">
+                    <label for="huggingfaceToken">Hugging Face 토큰</label>
+                    <div style="display: flex; gap: 8px;">
+                        <input type="password" id="huggingfaceToken" placeholder="Hugging Face 토큰을 입력하세요" style="flex: 1; padding: 8px 12px; border: 1px solid #dadce0; border-radius: 4px; font-size: 14px;">
+                        <button class="btn btn-primary" onclick="saveHuggingFaceToken()">저장</button>
+                        <button class="btn btn-secondary" onclick="loadHuggingFaceToken()">현재 상태 확인</button>
+                    </div>
+                    <small style="color: #5f6368; font-size: 12px; display: block; margin-top: 4px;">
+                        Hugging Face(<a href="https://huggingface.co/settings/tokens" target="_blank">https://huggingface.co/settings/tokens</a>)에서 토큰을 발급받을 수 있습니다.
+                    </small>
+                    <div id="huggingfaceTokenStatus" style="margin-top: 8px; font-size: 13px;"></div>
+                </div>
+            </div>
+        </div>
+
         <!-- AI 모델별 토큰 수 관리 섹션 -->
         <div class="card">
             <div class="card-header">
@@ -467,6 +488,86 @@
             }
         }
 
+        // Hugging Face 토큰 관련 함수
+        async function loadHuggingFaceToken() {
+            try {
+                const response = await fetch('/api/admin/huggingface-token', {
+                    credentials: 'include'
+                });
+                
+                // 응답이 JSON인지 확인
+                const contentType = response.headers.get('content-type');
+                if (!contentType || !contentType.includes('application/json')) {
+                    const text = await response.text();
+                    console.error('Non-JSON response:', text.substring(0, 200));
+                    const statusDiv = document.getElementById('huggingfaceTokenStatus');
+                    statusDiv.innerHTML = `<span style="color: #ea4335;">서버 오류: 응답 형식이 올바르지 않습니다.</span>`;
+                    return;
+                }
+                
+                const data = await response.json();
+                
+                const statusDiv = document.getElementById('huggingfaceTokenStatus');
+                if (!response.ok) {
+                    statusDiv.innerHTML = `<span style="color: #ea4335;">오류: ${data.error || '알 수 없는 오류'}</span>`;
+                    return;
+                }
+                
+                if (data.has_token) {
+                    statusDiv.innerHTML = `<span style="color: #137333;">✓ 토큰이 설정되어 있습니다 (${data.masked_token})</span>`;
+                } else {
+                    statusDiv.innerHTML = `<span style="color: #ea4335;">⚠ 토큰이 설정되지 않았습니다</span>`;
+                }
+            } catch (error) {
+                console.error('Hugging Face 토큰 로드 오류:', error);
+                const statusDiv = document.getElementById('huggingfaceTokenStatus');
+                statusDiv.innerHTML = `<span style="color: #ea4335;">오류: ${error.message}</span>`;
+            }
+        }
+
+        async function saveHuggingFaceToken() {
+            const tokenInput = document.getElementById('huggingfaceToken');
+            const token = tokenInput.value.trim();
+            
+            if (!token) {
+                showAlert('토큰을 입력해주세요.', 'error');
+                return;
+            }
+
+            try {
+                const response = await fetch('/api/admin/huggingface-token', {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    credentials: 'include',
+                    body: JSON.stringify({ token: token })
+                });
+
+                // 응답이 JSON인지 확인
+                const contentType = response.headers.get('content-type');
+                if (!contentType || !contentType.includes('application/json')) {
+                    const text = await response.text();
+                    console.error('Non-JSON response:', text.substring(0, 200));
+                    showAlert('서버 오류: 응답 형식이 올바르지 않습니다.', 'error');
+                    return;
+                }
+
+                const data = await response.json();
+
+                if (response.ok) {
+                    showAlert(data.message, 'success');
+                    tokenInput.value = ''; // 보안을 위해 입력 필드 초기화
+                    loadHuggingFaceToken(); // 상태 업데이트
+                } else {
+                    showAlert(data.error || '토큰 저장 중 오류가 발생했습니다.', 'error');
+                }
+            } catch (error) {
+                console.error('Hugging Face 토큰 저장 오류:', error);
+                showAlert(`오류: ${error.message}`, 'error');
+            }
+        }
+
         // AI 모델별 토큰 수 관리 (입력/출력 분리)
         async function loadModelTokens() {
             const statusDiv = document.getElementById('modelTokensStatus');
@@ -747,6 +848,7 @@
         // 페이지 로드 시 API 키 상태 확인 및 토큰 수 설정 로드
         window.addEventListener('load', () => {
             loadGeminiApiKey();
+            loadHuggingFaceToken();
             loadModelTokens();
         });
     </script>

upload_to_hf.ps1

@@ -112,3 +112,4 @@ try {
     exit 1
 }
 
+