문서

설치

QGIS AI 는 커스텀 플러그인 저장소를 통해 설치·업그레이드됩니다. QGIS에 저장소 URL을 한 번만 등록하면, 이후의 모든 릴리스는 플러그인 관리자의 업그레이드 가능 탭에 자동으로 나타납니다 — 버튼 한 번이면 설치.

QGIS 3.28 LTR 이상 필요.

최초 설치 (저장소 1회 등록)

1단계. 플러그인 저장소 추가

1. QGIS에서 플러그인 → 플러그인 관리 및 설치… 열기
2. 왼쪽 설정(Settings) 탭으로 이동
3. 플러그인 저장소 아래 추가… 클릭
4. 아래 내용 입력 후 확인:
   • 이름: QGIS AI
   • URL: https://qgis.ai/plugins.xml
   • 활성화: 체크

2단계. 플러그인 설치

1. 같은 창에서 전체 플러그인 탭으로 전환
2. 검색창에 QGIS AI 입력
3. QGIS AI Assistant 선택 후 플러그인 설치 클릭
4. 설치가 끝나면 대화창 닫기

3단계. 어시스턴트 열기

QGIS 오른쪽에 AI Assistant 도크가 나타납니다. 보이지 않으면 보기 → 패널 → AI Assistant 로 활성화하세요.

최초 실행 시 설정 탭에서 Google 로그인(권장)을 수행하면 VWorld API 키가 자동 발급되어 바로 사용할 수 있습니다.

업그레이드 — 클릭 한 번

새 버전이 배포되면 QGIS 시작 시 플러그인 관리자에 업그레이드 가능 배지가 표시됩니다.

1. 플러그인 → 플러그인 관리 및 설치 → 업그레이드 가능 열기
2. QGIS AI Assistant 선택 후 플러그인 업그레이드 클릭
3. 잠시 기다리면 새 버전이 설치되고 자동으로 다시 로드됩니다

사이트 계정, 피드백 DB, Google 인증 토큰, API 키 캐시는 업그레이드 시 유지됩니다. v3.4.0 이후 사용자 데이터는 QGIS 프로필 디렉토리 (QgsApplication.qgisSettingsDirPath()/qgis_ai_assistant/) 에 저장되므로, 플러그인 폴더를 교체해도 데이터는 영향을 받지 않습니다.

3.3.x → 3.4.0 마이그레이션

구 플러그인 폴더 내부에 있던 DB(sites_credentials.db, feedback_learning.db 등)는 3.4.0 최초 로드 시 새 외부 경로로 자동 복사됩니다. 이후 업그레이드에서는 별도 조치가 필요하지 않습니다.

수동 ZIP 설치 (네트워크 제한 환경)

저장소 URL 접근이 차단된 네트워크라면 다운로드 페이지 에서 최신 ZIP을 받아 플러그인 → 플러그인 관리 및 설치 → ZIP에서 설치 로 설치하세요. v3.4.0 이후 사용자 데이터는 이 방식에서도 QGIS 프로필 위치로 자동 마이그레이션됩니다.

시스템 요구 사항

• QGIS 3.28 LTR 이상
• macOS 12+, Windows 10+, 또는 최신 Linux 배포판
• 최초 로그인 시 인터넷 연결 필요

문제 해결

“저장소 URL을 추가했는데 플러그인이 목록에 안 보입니다.” — 플러그인 관리자 설정 탭에서 저장소가 활성화됨 상태인지 확인하세요. 모든 저장소 옆 새로 고침 버튼을 한 번 눌러 주세요.

“업그레이드 버튼이 뜨지 않습니다.” — 이미 최신 버전이거나 저장소 상태가 연결 오류 일 수 있습니다. URL이 정확히 https://qgis.ai/plugins.xml 인지 다시 확인하세요.

어시스턴트 도크가 보이지 않습니다. — QGIS를 재시작하고 보기 → 패널 → AI Assistant 로 활성화하세요.

그 외 문의 — FAQ 를 참고하세요.