BibleAI 설치 가이드 - Windows

 

 

 

해외 사용의 경우를 대비하여 교회명을 바꾸는 로직을 추가하여 로컬 앱의 배포 준비가 끝났습니다. 화면에 보이는 교회명은 우즈베크어입니다. 새로운 설치 가이드를 아래에 안내합니다.

 

📖 [설치 가이드] BibleAI: 성경 주석 연구소 만들기

이 프로그램은 인터넷 연결 없이도 내 컴퓨터에서 수백 권의 주석을 빛의 속도로 검색해주는 목회자용 말씀 연구 도구입니다. 파이썬을 몰라도 아래 순서대로만 따라오시면 5분 안에 설치가 끝납니다.

⚠️ 시작 전 준비

• 파일 다운로드: 보내드린 링크를 통해 압축 파일을 다운로드하고, 압축을 풀어주세요. (가급적 C:\BibleAI 처럼 찾기 쉬운 곳에 풀어주시는 것이 좋습니다.)
• 압축 해제 후 폴더 모습: 아래 그림처럼 폴더 안에 main.py, requirements.txt 등 모두 6개의 파일과 core 폴더를 포함한 주석 데이터가 담긴 폴더들이 있는지 확인하세요.

---

1단계: 파이썬(Python) 설치하기

프로그램을 돌리기 위한 엔진을 설치하는 과정입니다.

1. python.org에 접속합니다.
2. 노란색 [Download Python 3.xx.x] 버튼을 클릭하여 설치 파일을 받습니다.
3. [중요] 설치 파일을 실행하면 창이 뜨는데, 맨 아래에 있는 [Add Python to PATH] 체크박스를 반드시 체크하세요! (이걸 안 하면 실행이 안 됩니다.)
4. [Install Now]를 눌러 설치를 완료합니다.

---

2단계: 프로그램 설치 및 설정

1. 1_필수부품설치.bat 실행: 필요한 파이썬 라이브러리들을 자동으로 설치합니다.

2. 잠시 기다리면 Setup.py가 실행되어 시스템(현재 PC 환경)을 진단합니다.

• 교회명 입력: 한글, 영문, 이모지 등 원하는 이름을 입력하면 모든 위치에 자동 반영됩니다.
• API 키 설정: Groq API 키를 입력하여 AI 엔진을 활성화합니다.
• Groq API 키 발급 받는 법 (무료)

1. Groq Cloud 접속: Groq Cloud Console 사이트에 접속합니다.
2. 로그인: 구글(Google) 계정으로 로그인하면 가장 빠릅니다.
3. 키 생성: 왼쪽 메뉴에서 'API Keys'를 클릭한 후, 화면 중앙의 [+ Create API Key] 버튼을 누릅니다.
4. 이름 입력: 키 이름은 자유롭게(예: MyBibleAI) 정하고 생성합니다.
5. 복사 및 저장: 화면에 나타난 긴 영문+숫자 조합의 키를 [Copy] 버튼을 눌러 복사합니다.

• 주의: 이 키는 창을 닫으면 다시 볼 수 없으니 따로 메모장에  꼭 저장해야 합니다!

6. Setup.py에 입력: 복사한 키를 Setup.py 실행 창의 Groq API Key 칸에 붙여넣고 [설정 적용]을 누릅니다. 끝!

---

• 완전 무료: 현재 Groq는 개인 사용자에게 넉넉한 무료 한도를 제공하고 있어, 간단한 내용 검색 등 백과사전의 역할을 하기에는 충분합니다.
• 검색한 자료를 바탕으로 분석하거나 설교 초안을 작성하기 위해서는 올라마의 gpt 모델 등을 사용하는 것이 좋습니다. 
• 보안 주의: 이 키는 목사님만의 고유한 열쇠이므로, 타인에게 노출되지 않도록 주의해 주세요. (그래서 Setup.py 입력 창에서도 * 표시로 가려지게 설계했습니다!)
• 수동으로 올라마 싸이트 (https://ollama.com/)에 접속하여 올라마에이전트를 다운로드하고 설치합니다.

3단계: 프로그램 실행

3. 2_프로그램실행.bat 실행: 이제 모든 설정이 적용된 BibleAI가 시작됩니다.

 

---

💡 자주 묻는 질문 (FAQ)

• Q: 까만 창에 빨간 글씨가 떠요!
• 대부분 1단계에서 'Add Python to PATH'를 체크하지 않아서 생기는 문제입니다. 파이썬을 삭제하고 다시 설치해 보세요.

• Q: 다음날 다시 켜려면 어떻게 하나요?
• 2_프로그램실행.bat 을 실행하거나 폴더에서 터미널을 열고 streamlit run main.py만 입력하시면 됩니다.

• Q: 주석 데이터 위치를 못 찾겠어요.
• 화면 왼쪽 사이드바에서 검색 대상 폴더 설정을 확인하세요. 어떤 폴더도 선택하지 않으면 텍스트 기반 파일만 검색합니다.