[버그] [튜토리얼] 최초 실행 시 특정 라이브러리가 없어 실패하는 현상

[ParkGyeongTae]

버그 요약 (Summary)

• 최초 실행시 psycopg[binary] 라이브러리가 없고, DB_TYPE 이 없어 실행하지 못하는 현상

재현 단계 (Steps to Reproduce)

1. 어떤 환경에서 (예: 운영체제, Python 버전, Lang2SQL 버전 등)

• Apple M4 Pro, 15.6.1(24G90)

2. 구체적으로 어떤 입력을 했는지 (자연어 쿼리, 설정, 벡터 DB 종류, DataHub 유무 등)

• 튜터리얼대로 실행

3. 기대 결과는 무엇이었는지

• 정상 실행

4. 실제 결과는 무엇인지 (에러 메시지, 로그, SQL 결과, 속도 문제 등)

• 실패 로그는 아래 로그에 기록함.

환경 (Environment)

• Lang2SQL 버전: 0.2.2
• Python 버전: 3.11
• OS (예: Ubuntu 22.04, macOS 13): Apple M4 Pro, 15.6.1(24G90)
• VectorDB 종류 및 설정 (FAISS / pgvector 등): FAISS
• DataHub 설정 유무: 안함.
• 기타 관련된 설정 (예: .env, 구성 파일 등)

스크린샷 / 로그 (Screenshots & Logs)

ImportError: no pq wrapper available.
Attempts made:
- couldn't import psycopg 'c' implementation: No module named 'psycopg_c'
- couldn't import psycopg 'binary' implementation: No module named 'psycopg_binary'
- couldn't import psycopg 'python' implementation: libpq library not found

ValueError: DB type must be provided or set in environment as DB_TYPE.

추가 정보 (Additional Context)

• 이전에 유사한 오류가 있었는지? N/A
• 회피 방법(임시 해결책)이 있는 경우 -> 라이브러리 설치 및 설정 추가, 문서 수정
• 이 버그가 프로젝트 전체에 어떤 영향을 미치는지 N/A