6단계로 바로 시작하기
처음 사용하는 경우 아래 순서만 따라가면 파일을 추가하고 첫 질문까지 진행할 수 있습니다.
설치하기
Microsoft Store에서 AhriDesk 또는 무료 AhriDesk (Web)을 설치합니다.
상세 보기 →실행 · 연결 확인
앱을 실행하고 브라우저에서 로컬 서버 연결 상태가 초록색인지 확인합니다.
상세 보기 →AI 설정하기
OpenAI, Gemini, Groq, Ahri vLLM 중 사용할 제공자와 모델을 선택합니다.
상세 보기 →컬렉션 만들기
함께 검색할 자료를 하나의 컬렉션으로 묶어 질문 범위를 관리합니다.
상세 보기 →파일 추가하기
파일 선택, 폴더 선택 또는 Drag & Drop으로 자료를 로컬 서버에 추가합니다.
상세 보기 →질문하기
사용할 컬렉션을 체크하고 질문하면 선택한 범위에서 관련 문서를 검색해 답변합니다.
상세 보기 →설치와 버전 선택
Microsoft Store에서 AhriDesk 또는 AhriDesk (Web)을 검색해 설치합니다. 두 버전은 같은 로컬 기반 문서 검색 흐름을 사용하지만 실행 방식과 일부 파일 조작 기능, 가격 정책이 다릅니다.
AhriDesk와 AhriDesk (Web)의 주요 차이
| 항목 | AhriDesk | AhriDesk (Web) |
|---|---|---|
| 실행 방식 | 독립 Windows 애플리케이션 | 웹 브라우저 + 로컬 서버 |
| 가격 | 15일 무료 체험 후 유료 한국 ₩13,900 / 그 외 지역 US$9.99 |
무료 |
| 광고 | 없음 | 있음 |
| 파일/폴더 선택 | 지원 | 지원 |
| Drag & Drop | 지원 | 지원 |
| Ctrl+C / Ctrl+V 파일 추가 | 지원 | 미지원 |
| 파일 다운로드 | 지원 | 미지원 |
앱 실행과 로컬 서버 연결
설치 후 Microsoft Store의 열기 버튼이나 Windows 앱 아이콘으로 실행합니다. AhriDesk (Web)은 로컬 서버가 시작된 뒤 기본 웹 브라우저에서 서비스 탭을 엽니다.
① 설치한 앱 실행하기
Microsoft Store의 열기 버튼이나 Windows에 설치된 앱 아이콘으로 실행할 수 있습니다.
② 서비스 준비 및 로딩
앱 실행 후 필요한 구성 요소와 로컬 서버가 준비됩니다. AhriDesk (Web)은 준비가 끝나면 브라우저에서 서비스 화면을 엽니다.
연결 대기 화면이 나타난다면
로컬 서버가 아직 준비되지 않았거나 브라우저를 새로 고침한 경우 연결 대기 화면이 표시될 수 있습니다. 이때 다시 연결을 눌러 로컬 서버와 연결합니다.
기본 설정 확인하기
설정의 일반 메뉴에서 이름, 언어, 시작 프로그램 설정, 로컬 서버 URL을 확인하거나 변경할 수 있습니다.
- 이름: AhriDesk에서 사용할 사용자 이름
- 언어: 인터페이스 표시 언어
- 시작 프로그램 설정: Windows 시작 시 AhriDesk 실행 여부
- 로컬 서버 URL: 현재 AhriDesk가 연결할 로컬 서버 주소
사용할 AI 설정하기
설정의 AI 설정에서 답변 생성에 사용할 AI 제공자와 모델을 선택합니다. OpenAI, Gemini, Groq는 개인 API Key를 입력해 저장해야 하며, 저장된 Key는 Windows 환경 변수에 보관됩니다. Ahri vLLM은 별도 API Key 없이 사용할 수 있습니다.
① AI 제공자 · 모델 선택과 API Key 설정
사용할 AI 제공자와 모델을 선택합니다. OpenAI, Gemini, Groq를 사용하는 경우 개인 API Key를 입력하며, 저장된 API Key는 Windows 환경 변수에 보관됩니다.
② Ahri vLLM은 API Key 없이 사용
Ahri vLLM을 선택하면 별도의 개인 API Key를 입력하지 않고 사용할 수 있습니다.
AI 제공자 비교
API Key 필요 여부와 비용 정책을 비교한 뒤 사용 목적에 맞는 제공자를 선택하세요.
| AI 제공자 | API Key | 비용 | 특징 |
|---|---|---|---|
| ChatGPT (OpenAI) | 필요 | 사용량에 따라 과금 | OpenAI에서 발급받은 개인 API Key와 API 결제 또는 크레딧 설정이 필요합니다. |
| Gemini (Google) | 필요 | 사용량에 따라 과금 | Google AI API를 사용할 수 있는 개인 API Key와 결제 또는 크레딧 설정이 필요합니다. |
| Groq | 필요 | 무료 사용 한도 제공 | 개인 API Key가 필요하며 Groq가 제공하는 무료 사용 한도 내에서는 별도 API 비용 없이 사용할 수 있습니다. |
| Ahri vLLM | 불필요 | 무료 | 현재 gemma-4-26B-A4B-it 모델을 제공합니다. 별도 외부 AI 계정이나 API Key 없이 사용할 수 있습니다. |
한정된 자체 서버 자원을 여러 사용자가 함께 사용하므로 동시 이용자가 많거나 서버 부하가 높은 경우 응답이 느려지거나 일시적으로 정상 응답하지 않을 수 있습니다. Ahri vLLM으로 전달된 요청 데이터는 AI 모델 학습 용도로 사용하지 않습니다.
API Key 저장과 사용량 확인
OpenAI, Gemini, Groq의 API Key를 저장하면 Windows 환경 변수에 보관되어 AhriDesk가 해당 AI API를 호출할 때 사용합니다. API 사용량 화면에서는 AhriDesk에서 사용한 요청 및 토큰 사용량을 확인할 수 있습니다.
질문할 자료를 컬렉션으로 묶기
컬렉션은 AI에게 함께 검색하도록 지정할 문서들의 묶음입니다. 질문할 때 사용할 컬렉션을 선택하면 선택된 컬렉션 안의 파일을 대상으로 관련 내용을 검색합니다.
📚 컬렉션
회사 규정, 프로젝트 A, 계약서, 논문 자료처럼 질문 범위를 주제별로 나누는 지식 묶음입니다.
📁 폴더
컬렉션 내부 파일을 보기 좋게 정리하기 위한 경로입니다. 폴더 자체가 별도의 AI 검색 범위를 만드는 기능은 아닙니다.
파일과 폴더 추가하기
생성한 컬렉션에 질문에 사용할 파일이나 폴더를 추가합니다. 추가된 파일은 로컬 AhriServer에서 문서 처리와 검색 준비 과정을 거칩니다.
| 추가 방법 | AhriDesk | AhriDesk (Web) |
|---|---|---|
| 파일 선택 / 폴더 선택 | 지원 | 지원 |
| Drag & Drop | 지원 | 지원 |
| Ctrl+C → Ctrl+V | 지원 | 미지원 |
파일 처리 상태 확인
오른쪽 패널의 로그 탭에서 파일 추가와 처리 상태를 확인할 수 있습니다. 하단의 시멘틱 변환 결과 보기를 누르면 파일이 검색 가능한 형태로 처리되는 과정을 자세히 확인할 수 있습니다.
파일 목록과 미리보기
컬렉션의 파일은 그리드 또는 리스트 형태로 볼 수 있습니다. 파일을 더블 클릭하면 오른쪽 미리 보기 탭에서 내용을 확인할 수 있고, 크게 보기도 지원합니다.
① 파일 목록 보기 방식 바꾸기
파일 목록은 리스트 형식과 그리드 형식 중 원하는 방식으로 확인할 수 있습니다.
② 파일 미리보기와 크게 보기
파일을 더블 클릭하면 오른쪽 미리 보기 탭에서 내용을 확인할 수 있으며, 필요하면 크게 볼 수 있습니다.
지원 문서의 실제 미리보기
PDF, 이미지뿐 아니라 Word, Excel 등 지원되는 파일 형식은 앱에서 내용을 확인할 수 있습니다.
지원 파일 형식
다음 파일 형식을 AhriDesk에 추가하여 처리할 수 있습니다. 종류가 많기 때문에 필요한 카테고리만 펼쳐 확인할 수 있습니다.
문서 및 오피스 파일
개발 및 설정 파일
이미지 및 미디어 파일
기타 파일
라이트 모드와 다크 모드
AhriDesk는 라이트 모드와 다크 모드를 지원합니다. 사용 환경이나 선호도에 따라 화면 테마를 변경할 수 있습니다.
컬렉션을 선택하고 문서에 질문하기
왼쪽 패널에서 질문에 사용할 컬렉션의 체크박스를 켠 뒤 질문을 입력합니다. AhriDesk는 선택된 컬렉션 안에서 질문과 관련 있는 내용을 검색하고, 검색된 문맥을 선택한 AI 모델에 전달해 답변을 생성합니다.
긴 대화를 빠르게 찾고, 흐름을 분리하기
질문과 답변 짝으로 이동하기
대화가 길어져 질문과 답변이 멀리 떨어진 경우 말풍선을 클릭하면 연결된 질문·답변 위치로 자동 스크롤됩니다. 긴 대화에서 찾고 싶은 응답을 빠르게 다시 확인할 때 유용합니다.
서브 대화창으로 흐름 분리하기
현재 주제와 직접 관련 없는 추가 질문은 서브 대화창으로 옮길 수 있습니다. 메인 대화의 흐름을 유지하면서 보조 질문을 별도로 관리할 수 있습니다.
공지와 게시판 이용하기
오른쪽 패널의 공지 탭에서 안내를 확인할 수 있습니다. 게시판 바로가기를 누르면 지원을 원하는 파일 확장자, 사용 질문, 오류 제보, 기능 개선 요청과 기타 건의 사항을 작성할 수 있습니다.
