README.md에 설치 방법 및 출력 포맷 관련 내용 추가, pre-commit black 적용 #134

Author: ehddnr301

README.md

@@ -56,7 +56,13 @@ Lang2SQL은 자연어 쿼리를 최적화된 SQL 문으로 변환하는 오픈
 ### 빠른 설치
 
 ```bash
+# pip
 pip install lang2sql
+
+# uv
+uv venv --python 3.11
+source .venv/bin/activate
+uv add lang2sql
 ```
 
 ### 소스에서 설치
@@ -194,11 +200,6 @@ Lang2SQL은 LangGraph를 사용한 다단계 접근 방식을 따릅니다:
 - 현재는 Datahub를 통해 로컬에 FAISS VectorDB를 생성해야만 사용 가능한 구조입니다.
 - 이 결합도를 낮춰서 Datahub 없이도 기존에 준비된 VectorDB만 있으면 바로 활용할 수 있도록 아키텍처를 개선하는 작업입니다.
 
-### 출력 포맷 강화
-
-- 현재 Streamlit을 통한 웹 인터페이스만 지원하고 있습니다.
-- CLI, JSON 등 다양한 출력 포맷을 지원하여 사용자가 선호하는 환경에서 유연하게 활용할 수 있도록 개선합니다.
-
 ### 모니터링 / 로깅 강화
 
 - 프로젝트 사용 패턴과 성능을 모니터링하고, 상세한 로깅 시스템을 구축합니다.
@@ -209,6 +210,10 @@ Lang2SQL은 LangGraph를 사용한 다단계 접근 방식을 따릅니다:
 - 프로젝트 기여 장벽을 낮추기 위한 포괄적인 문서화 작업입니다.
 - 개발자 가이드, 튜토리얼 등을 체계적으로 정리하여 새로운 기여자들이 쉽게 참여할 수 있는 환경을 조성합니다.
 
+### LLM 프론트에서 분리하기
+
+프런트에서는 LLM 호출·키를 제거하고 내부 백엔드 API로 위임해 보안·권한·모니터링을 중앙화합니다.
+
 ---
 
 ## 🤝 기여하기

data_utils/datahub_source.py

@@ -143,6 +143,3 @@ def get_glossary_terms_by_urn(self, dataset_urn):
     def _is_valid_gms_server(self, gms_server):
         """GMS 서버 주소의 유효성을 검사하는 함수 (하위 호환성)"""
         return self.client._is_valid_gms_server(gms_server)
-
-
- 

engine/__init__.py

@@ -1,3 +1 @@
 """Lang2SQL Data Processing 진입점 패키지"""
-
-

engine/query_executor.py

@@ -115,5 +115,3 @@ def extract_sql_from_result(res: Dict[str, Any]) -> Optional[str]:
     except ValueError:
         logger.error("SQL을 추출할 수 없습니다.")
         return None
-
-

infra/__init__.py

@@ -1,3 +1 @@
 """인프라 계층 패키지 (DB, 모니터링 등)"""
-
-

infra/db/__init__.py

@@ -1,3 +1 @@
 """DB 접근 계층 패키지"""
-
-

infra/db/connect_db.py

@@ -118,5 +118,3 @@ def run_sql(self, sql: str) -> pd.DataFrame:
         except Exception as e:
             logger.exception("An error occurred while executing SQL: %s", e)
             raise
-
-

infra/monitoring/__init__.py

@@ -1,3 +1 @@
 """모니터링/헬스체크 패키지"""
-
-

infra/monitoring/check_server.py

@@ -72,5 +72,3 @@ def is_gms_server_healthy(*, url: str) -> bool:
             logger.exception("Unexpected request error to GMS server: %s", health_url)
 
         return False
-
-

interface/graph_builder.py

@@ -26,7 +26,9 @@
 )
 
 
-def build_selected_sequence(preset: str, use_profile: bool, use_context: bool) -> List[str]:
+def build_selected_sequence(
+    preset: str, use_profile: bool, use_context: bool
+) -> List[str]:
     """
     프리셋과 커스텀 토글에 따라 실행할 노드 시퀀스를 생성합니다.
 
@@ -110,9 +112,6 @@ def render_sequence(sequence: List[str]) -> str:
     return " → ".join(label_map[s] for s in sequence)
 
 
- 
-
-
 st.title("LangGraph 구성 UI")
 st.caption("기본/확장/커스텀으로 StateGraph를 구성하고 세션에 적용합니다.")
 
@@ -129,7 +128,10 @@ def render_sequence(sequence: List[str]) -> str:
     # 프리셋에서는 QUERY_MAKER 자동 포함
     use_query_maker = True
 
-def build_sequence_with_qm(preset: str, use_profile: bool, use_context: bool, use_qm: bool) -> List[str]:
+
+def build_sequence_with_qm(
+    preset: str, use_profile: bool, use_context: bool, use_qm: bool
+) -> List[str]:
     """
     QUERY_MAKER 포함 여부를 반영하여 시퀀스를 생성합니다.
 
@@ -152,13 +154,19 @@ def build_sequence_with_qm(preset: str, use_profile: bool, use_context: bool, us
     base_seq = build_selected_sequence(preset, use_profile, use_context)
     return base_seq
 
+
 sequence = build_sequence_with_qm(preset, use_profile, use_context, use_query_maker)
 
 st.subheader("실행 순서")
 st.write(render_sequence(sequence))
 
 st.subheader("그래프 생성")
-config = {"preset": preset, "use_profile": use_profile, "use_context": use_context, "use_query_maker": use_query_maker}
+config = {
+    "preset": preset,
+    "use_profile": use_profile,
+    "use_context": use_context,
+    "use_query_maker": use_query_maker,
+}
 
 # 선택이 바뀌면 자동으로 세션 그래프 갱신
 prev_config = st.session_state.get("graph_config")
@@ -177,4 +185,3 @@ def build_sequence_with_qm(preset: str, use_profile: bool, use_context: bool, us
 
 with st.expander("현재 세션 그래프 설정"):
     st.json(st.session_state.get("graph_config", {}))
-