PC 화면 위에 항상 떠있는 AI 캐릭터와 대화하고, 파일 정리·검색 같은 간단한 작업도 자연어로 시킬 수 있는 로컬 실행 앱입니다. 인터넷 연결 없이 동작하며 대화 내용은 외부로 전송되지 않습니다.
| 항목 | 최소 | 권장 |
|---|---|---|
| OS | Windows 10 (x64) | Windows 11 |
| CPU | AVX2 지원 | AVX2 이상 (CPU-Z에서 확인 가능) |
| RAM | 4 GB | 8 GB 이상 |
| 저장공간 | 5 GB (앱 3 GB + 모델 2 GB) | 8 GB 이상 |
1단계: 설치
- GitHub Releases에서
AchatSetup.exe다운로드 AchatSetup.exe실행 → 설치 경로 선택 (기본:C:\Achat, 변경 가능)- "다음" 클릭 → 의존성 설치 + 모델 파일 자동 다운로드 (~2 GB, 수 분 소요)
2단계: 실행
바탕화면 바로가기 또는 시작 메뉴 → Achat 실행
첫 실행 시 임베딩 모델 다운로드와 세계관 인덱싱이 자동으로 진행됩니다. 인터넷 연결이 필요하며 약 1~3분 소요됩니다. 이후 실행부터는 즉시 시작됩니다.
제거
제어판 → 앱 → Achat → 제거 설치 경로 전체가 완전히 삭제됩니다. C 드라이브 어디에도 잔여 파일이 남지 않습니다.
- GitHub Releases에서
achat.zip다운로드 후 원하는 경로에 압축 해제 - 모델 파일에서
model_q4km.gguf다운로드 후 압축 해제 폴더의models\안에 복사 - PowerShell에서 의존성 설치:
winget install --id=astral-sh.uv -e # uv 설치 (최초 1회)
cd <압축 해제 경로>
copy pyproject-deploy.toml pyproject.toml
uv syncrun.bat실행 (또는Achat.exe더블클릭)
Achat은 두 가지 모드로 동작합니다.
대화 모드
화면 한쪽에 떠있는 캐릭터와 자유롭게 대화할 수 있습니다. 캐릭터는 대화 내용을 기억하고, 대화가 쌓일수록 말투와 반응이 달라집니다. 세계관을 설정하면 캐릭터가 그 배경 안에서 대화합니다.
기능 모드
입력창 위 해시태그를 클릭하면 기능 모드로 전환됩니다. 파일 정리, 이름 변경, 검색, 프롬프트 작성을 자연어로 지시할 수 있습니다. 기능 모드에서 나눈 대화는 캐릭터 대화 기록에 남지 않습니다.
PIP 마스코트 모드
우측 상단 버튼으로 창을 작은 캐릭터 이미지로 축소할 수 있습니다. 항상 화면 위에 떠있으며, 클릭하면 대화창이 다시 열립니다. 5분간 대화가 없으면 자동으로 절전 상태가 되고 LLM이 언로드됩니다.
| 동작 | 방법 |
|---|---|
| 창 이동 | 타이틀바 드래그 |
| 창 모서리 스냅 | 창을 화면 가장자리로 이동하면 자동 정렬 |
| PIP 모드 전환 | 타이틀바 우측 ⊟ 버튼 |
| 설정 패널 열기 | 타이틀바 우측 ⚙ 버튼 |
| 사이드 메뉴 열기 | 타이틀바 좌측 ≡ 버튼 |
| 앱 종료 | 타이틀바 × 버튼 (트레이로 최소화) 또는 트레이 아이콘 우클릭 → 종료 |
대화창 입력 위 해시태그 영역에서 #? 를 클릭하거나, 입력창에 기능 이름을 입력하면 해당 기능의 설명을 볼 수 있습니다.
| 키워드 | 설명 |
|---|---|
| 프롬프트, prompt | 프롬프트 변환 기능 설명 |
| 폴더, 분류, 정리 | 폴더 자동 분류 기능 설명 |
| 검색, 찾기 | 로컬 파일 검색 기능 설명 |
| 파일, 이름, 변환, 확장자 | 파일 이름/확장자 변경 기능 설명 |
| (그 외 입력) | 사용 가능한 전체 기능 목록 표시 |
대화창 상단 해시태그를 클릭하면 해당 기능으로 전환됩니다.
| 태그 | 기능 | 사용 예 |
|---|---|---|
#파일 변환 |
파일명 변경 또는 이미지 확장자 변환 (jpg / png / webp 등) | "선택한 파일들 이름 소문자로 바꿔줘" |
#프롬프트 변환 |
입력한 내용을 AI 모델용 프롬프트 형식으로 자동 가공 | "Flux 모델로 카페 창가 여성 이미지 만들어줘" |
#폴더 분류 |
지정한 기준에 맞춰 파일을 하위 폴더로 자동 정리 | "Downloads 폴더를 확장자별로 분류해줘" |
#파일 검색 |
폴더 내 파일명·내용 키워드 검색 (서브폴더 포함) | "Documents에서 '프로젝트 보고서' 관련 파일 찾아줘" |
#? |
각 기능 설명 보기 | 기능 이름 입력 후 검색 |
⚙ 버튼으로 열리는 설정 패널에서 다음을 변경할 수 있습니다.
- 테마 — Ocean(기본) / Amber / Violet
- 캐릭터 — 등록된 캐릭터 목록에서 선택
- 세계관 — 적용할 세계관 선택
- PIP 말풍선 방향 — 왼쪽 / 오른쪽 / 랜덤
≡ 버튼으로 열리는 사이드 메뉴에서 다음 기능을 사용할 수 있습니다.
- DB — 장기 기억(VDB)에 저장된 항목 확인·수정·삭제
- 설정 — 설정 패널과 동일
- 관리 — 호감도 직접 조정, 캐릭터·세계관 생성
첫 실행 시 다음 두 가지가 자동으로 진행되며 앱이 응답하지 않는 것처럼 보일 수 있습니다.
| 항목 | 소요 시간 | 필요 조건 |
|---|---|---|
| 임베딩 모델 다운로드 (bge-m3, ~500 MB) | 인터넷 속도에 따라 1~5분 | 인터넷 연결 필수 |
| 세계관 RAG 인덱싱 | 30초~1분 | — |
두 번째 실행부터는 이 과정이 없으며 즉시 시작됩니다.
Achat은 인터넷 연결 없이 PC에서 직접 AI 모델을 실행합니다. CPU 성능에 따라 응답 생성에 10~30초 정도 소요될 수 있습니다.
| CPU 유형 | 예상 속도 |
|---|---|
| AVX2 지원 일반 CPU | 분당 약 500~900 글자 |
| 고성능 데스크탑 CPU | 분당 약 900~1500 글자 |
응답이 생성되는 동안 입력창이 비활성화됩니다. 앱이 멈춘 것이 아닙니다.
RAM이 부족하면 모델 로드 또는 캐릭터 전환 중 앱이 종료될 수 있습니다.
권장 실행 환경
- RAM 8 GB 이상
- 앱 실행 전 브라우저·무거운 프로그램 종료 권장
- 캐릭터 전환 시 이전 모델이 언로드된 후 새 모델이 로드됩니다 (약 5~10초 소요)
절전 모드
5분간 대화가 없으면 자동으로 절전 상태가 되며 LLM이 메모리에서 해제됩니다. 다음 입력 시 자동으로 재로드되며 약 5~15초 소요됩니다.
Achat은 캐릭터별로 대화 세션을 관리합니다.
- 캐릭터당 최대 3개 세션을 유지합니다. 초과 시 가장 오래된 세션이 자동 삭제됩니다.
- 세션을 초기화하면 단기 대화 기록은 삭제되지만, 장기 기억(VDB)은 별도 옵션으로 선택해 삭제할 수 있습니다.
- 앱을 재시작하면 마지막 세션이 자동으로 복원됩니다.
- 세션 데이터는 설치 경로의
data\sessions\폴더에 저장됩니다.
앱 내 캐릭터 생성 패널에서 직접 캐릭터를 만들 수 있습니다. 다음 항목에 유의하세요.
| 항목 | 제약 |
|---|---|
| 캐릭터 ID | 영문·숫자·밑줄만 사용 가능, 공백 불가 (CH_로 시작하는 파일명으로 저장됨) |
| 말투 설정 | 반말/존댓말 중 하나를 명확히 선택해야 일관된 응답이 나옵니다 |
| 규칙(rules) | 항목이 많을수록 모델이 모든 규칙을 따르지 못할 수 있습니다. 5개 이내 권장 |
| 이미지 | PNG 형식 권장. 투명 배경을 지원합니다 |
| 항목 | 제약 |
|---|---|
| 장소(place) 항목 수 | 10개 이내 권장. 많을수록 RAG 검색 정확도 저하 가능 |
| 각 항목 길이 | 200자 이내 권장. 너무 길면 청킹 시 내용이 잘릴 수 있음 |
| 세계관 변경 후 | 반드시 설정 패널에서 "세계관 재인덱싱" 실행 필요 (변경 내용이 대화에 반영되지 않을 수 있음) |
| 배경 이미지 | jpg/png 지원. 장소별로 1장씩 등록 가능 |