macOS Sequoia(버전 15.x)에서 BibleAI 설치 및 실행하기

macOS Sequoia(버전 15.x) 환경에서 이 코드를 실행하기 위해서는 Python 설치, 가상환경 설정, 그리고 필요한 라이브러리(Library) 설치 과정이 필요합니다.  BigSur 이후 모든 버전 호환됩니다. 인텔 칩 및 실리콘 M1, M2 칩 모두 지원됩니다. 

특히 Sequoia는 최신 보안 정책이 강화되었으므로, 아래 순서대로 터미널(Terminal)에서 진행하시면 됩니다.

---

1. 파이썬 및 필수 도구 설치

macOS에는 기본적으로 파이썬이 설치되어 있지만, 개발용으로는 Homebrew를 통한 설치가 권장됩니다.

1. 터미널(Command + Space 후 'Terminal' 입력)을 엽니다.
2. Homebrew 설치 (이미 있다면 건너뛰세요):
3. Bash

    

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

4. Python 설치:
5. Bash

    

   brew install python
   

---

2. 프로젝트 환경 설정 및 라이브러리 설치

agape1383.py가 사용하는 외부 라이브러리들을 설치해야 합니다. 시스템 라이브러리와 꼬이지 않도록 가상환경을 사용하는 것이 Sequoia에서 안전합니다.

1. 코드와 데이터가 있는 폴더로 이동합니다:
2. Bash

    

   cd /path/to/your/folder  # 실제 폴더 경로로 변경
   

3. 가상환경 생성 및 활성화:
4. Bash

    

   python3 -m venv venv
   source venv/bin/activate
   

5. 필수 라이브러리 한 번에 설치:
   Bash

    

   pip install streamlit pandas numpy pymupdf python-docx beautifulsoup4 ebooklib pyperclip

---

3. macOS Sequoia 권한 설정

이 프로그램은 로컬 파일(docx, sqlite3 등)을 읽어야 하므로, 터미널에 전체 디스크 접근 권한이 있으면 좋습니다.

• 시스템 설정 > 개인정보 보호 및 보안 > 전체 디스크 접근 권한
• 터미널(Terminal) 혹은 사용하시는 **IDE(VS Code 등)**을 '켬'으로 설정합니다.

---

4. 프로그램 실행

모든 준비가 끝났습니다. 터미널에서 다음 명령어를 입력하세요.

Bash

 

 

streamlit run agape_cross_platform.py

잠시 후 브라우저가 열리면서 Trinity Engine 화면이 나타날 것입니다.

---

⚠️ macOS Sequoia 주의사항 (에러 해결)

• EbookLib 경고: ebooklib 설치 시 최신 파이썬 버전에서 경고가 날 수 있으나 실행에는 지장이 없습니다.
• 파일 경로: 맥은 윈도우와 경로 표시가 다릅니다. 사이드바에서 폴더 경로를 입력할 때 /Users/사용자이름/Documents/Expsb와 같은 유닉스 방식 경로를 사용해야 합니다.
• TWM 파일 인식: 앞서 말씀하신 대로 .twm 파일을 읽으려면 코드 내 get_external_commentaries 함수에 .twm 분기 로직이 포함되어 있는지 확인해 주세요. (현재 업로드하신 agape1383.py 원본에는 .sqlite3 위주로 되어 있을 수 있으니, 아까 수정한 쿼리문을 반영하셔야 합니다.)

 

 
 
 
 

 
 
단, 검색 폴더 설정에서 폴더들이 번호순으로 정렬되어 나타나지 않는 다. agape_cross_platform_fixed.py 는 여러 번 수정 후 완성되어 일단 이 코드로 윈도우, 리눅스, 맥에서 사용하는 중이며, 맥에서의 이 이슈는 따로 수정할 필요가 있음.