# Rememberizer 앱

## 소개

Rememberizer 앱은 로컬 파일을 벡터 임베딩으로 변환하고 이를 Rememberizer 지식 기반에 업로드하는 데스크톱 애플리케이션입니다. 이 원활한 통합을 통해 AI 애플리케이션은 Rememberizer의 의미 검색 기능을 통해 개인 파일을 검색하고 참조할 수 있으며, 파일에 대한 직접적인 접근 없이도 귀하의 콘텐츠를 기반으로 답변을 제공합니다.

## 이점

* **안전한 데이터 통합:** 전체 문서를 제3자 AI 서비스와 공유하지 않고 로컬에서 파일을 업로드하고 처리합니다.
* **데이터 활용:** 로컬 문서를 가치 있고 검색 가능한 지식으로 변환합니다.
* **의미론적 이해:** 키워드 매칭뿐만 아니라 개념 기반 검색을 가능하게 하는 벡터 임베딩을 활용합니다.
* **강력한 AI 통합:** ChatGPT, Claude 및 맞춤형 애플리케이션을 포함한 다양한 AI 시스템에 지식을 연결합니다.
* **개인정보 보호 제어:** AI 도우미에 유용하게 만들면서 데이터 소유권을 유지합니다.

## 지원되는 플랫폼

현재 Rememberizer 앱은 다음에서 사용할 수 있습니다:

* **macOS**: Intel 및 Apple Silicon (M1/M2/M3) 프로세서

향후 계획된 지원 (아직 사용 가능하지 않음):

* Windows (개발 중)
* Linux (검토 중)

## 시스템 요구 사항

### macOS 요구 사항

* macOS 10.15 (Catalina) 이상
* 최소 8GB RAM (16GB 권장)
* 애플리케이션을 위한 500MB의 여유 디스크 공간
* 처리된 파일 캐시를 위한 추가 저장 공간
* 인증 및 임베딩 업로드를 위한 인터넷 연결

### 하드웨어 가속

* **Apple Silicon Mac:** 최적화된 성능을 위해 자동으로 MPS 지원 PyTorch를 사용합니다.
* **호환 가능한 GPU가 있는 Intel Mac:** 더 빠른 처리를 위해 GPU 가속을 활용할 수 있습니다.
* **CPU 전용 시스템:** 지능형 최적화와 함께 CPU 처리로 돌아갑니다.

## 설치

1. [여기에 제공된 링크](#download-links)에서 Rememberizer App의 최신 버전을 다운로드합니다.
2. 다운로드가 완료되면 다운로드 폴더에서 .dmg 파일을 찾아 두 번 클릭합니다.
3. 나타나는 창에서 Rememberizer App 아이콘을 응용 프로그램 폴더로 드래그합니다.
4. 응용 프로그램 폴더로 이동하여 Rememberizer App을 엽니다.
5. 보안 경고가 표시되면 다음 단계를 따릅니다:
   * 시스템 환경설정 > 보안 및 개인 정보 보호를 엽니다.
   * "어쨌든 열기"를 클릭하여 앱을 승인합니다.
   * 이 앱은 안전하게 서명되었지만 처음 사용할 때 이 경고가 발생할 수 있습니다.

## 구성 및 설정

### 처음 설정하기

1. **로그인:** 앱을 실행하고 Rememberizer 계정으로 로그인합니다. 인증을 위해 브라우저 창이 열립니다.

<figure><img src="https://2913883985-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs0e4JCKQXzEGPRlMO7nt%2Fuploads%2Fgit-blob-6e616a775371b8f25a8b5f47b2a72729b56bb053%2Fimage.png?alt=media" alt="Rememberizer 앱 로그인 화면"><figcaption><p>Rememberizer 계정에 연결하기 위해 로그인합니다</p></figcaption></figure>

<figure><img src="https://2913883985-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs0e4JCKQXzEGPRlMO7nt%2Fuploads%2Fgit-blob-12185aad147ecdea4879684de4851c47957ce98c%2Fimage%20(2).png?alt=media" alt="성공적인 인증 화면"><figcaption><p>성공적인 인증</p></figcaption></figure>

2. **데이터 소스 추가:** 로그인 후 앱이 백그라운드에서 실행됩니다. 메뉴 바 아이콘에서 접근합니다. 처리할 문서가 포함된 폴더를 추가합니다.

<figure><img src="https://2913883985-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs0e4JCKQXzEGPRlMO7nt%2Fuploads%2Fgit-blob-8c1d1ffa3dfdc939ed3bd754df1b4599b519b0bd%2Fimage%20(4).png?alt=media" alt="Rememberizer에 폴더 추가하기"><figcaption><p>메뉴 바에서 Rememberizer에 접근합니다</p></figcaption></figure>

<figure><img src="https://2913883985-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs0e4JCKQXzEGPRlMO7nt%2Fuploads%2Fgit-blob-e48ad98214856c359c7d7683247dc345dbc82faa%2Fimage%20(5).png?alt=media" alt="폴더 선택 대화상자"><figcaption><p>데이터 소스로 추가할 폴더를 선택합니다</p></figcaption></figure>

3. **파일 처리:** 앱이 선택한 폴더의 파일을 분석하고 처리하기 시작합니다. 이 과정에는 다음이 포함됩니다:
   * 파일 스캔 및 지원되는 형식 식별
   * 파일 내용을 최적 크기의 세그먼트로 나누기
   * 텍스트를 벡터 임베딩으로 변환하기
   * 메타데이터 및 임베딩을 Rememberizer 계정에 업로드하기

<figure><img src="https://2913883985-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs0e4JCKQXzEGPRlMO7nt%2Fuploads%2Fgit-blob-717f366349317a1947ea7258f6a88f075f3dcee6%2Fimage%20(6).png?alt=media" alt="Rememberizer 앱 상태 화면"><figcaption><p>상태 탭에서 처리 상태를 모니터링합니다</p></figcaption></figure>

### 고급 구성

Rememberizer 앱은 성능을 최적화하기 위한 여러 구성 옵션을 제공합니다:

1. **백그라운드 처리:** 파일 처리가 발생하는 시점을 제어합니다:
   * **자동 (기본값):** 파일을 지속적으로 백그라운드에서 처리합니다
   * **수동:** 명시적으로 트리거될 때만 파일을 처리합니다
2. **파일 유형 필터링:** 처리할 파일 유형을 사용자 정의합니다:
   * **기본값:** 모든 지원되는 파일 유형을 처리합니다
   * **사용자 정의:** 포함하거나 제외할 파일 확장자를 지정합니다
3. **Gitignore 지원:** 리포지토리에서 `.gitignore` 규칙을 자동으로 준수합니다:
   * 제외된 파일의 처리를 방지합니다
   * 버전 관리 선호도와의 일관성을 유지합니다

## 지원되는 파일 형식

Rememberizer 앱은 다양한 파일 형식을 처리할 수 있습니다:

| 카테고리   | 지원되는 형식                                                                        |
| ------ | ------------------------------------------------------------------------------ |
| 텍스트 파일 | .txt, .md, .rtf, .csv, .json, .xml, .yml, .yaml 등                              |
| 문서     | .pdf, .doc, .docx, .odt, .pages                                                |
| 프레젠테이션 | .ppt, .pptx, .key                                                              |
| 스프레드시트 | .xls, .xlsx, .numbers                                                          |
| 코드 파일  | .py, .js, .java, .c, .cpp, .cs, .html, .css, .php, .r, .rb, .go, .rs, .swift 등 |
| 구성     | .ini, .conf, .config, .env                                                     |
| 데이터    | .json, .xml, .csv, .tsv                                                        |

### 파일 크기 및 콘텐츠 제한

* 최대 파일 크기: 파일당 50MB
* 최대 임베디드 텍스트 추출: 파일당 1,000,000자
* 이진 및 실행 파일은 처리되지 않음
* 비밀번호로 보호된 파일은 처리되지 않음
* 손상된 파일은 건너뛰어질 수 있음

## 보안 및 개인 정보 보호

Rememberizer 앱은 여러 가지 보안 조치를 구현합니다:

1. **로컬 처리:** 초기 파일 처리는 귀하의 기기에서 로컬로 발생합니다.
2. **내용 암호화:** 문서 내용은 전송 전에 암호화됩니다.
3. **안전한 인증:** 안전한 토큰 관리를 통한 OAuth2.
4. **임베딩 기반 저장:** 벡터 표현만(원본 텍스트 아님)이 장기적으로 저장됩니다.
5. **Gitignore 준수:** 민감한 파일 처리를 피하기 위해 제외 패턴을 존중합니다.
6. **안전한 API 통신:** 모든 API 트래픽은 TLS 1.2+를 사용하는 HTTPS를 사용합니다.

### 데이터 사용 및 수집

* 앱은 벡터 임베딩과 파일에 대한 최소한의 메타데이터를 전송합니다.
* 원본 파일 내용은 Rememberizer 서버에 영구적으로 저장되지 않습니다.
* 처리 과정은 먼저 로컬에서 이루어지며 필요한 데이터만 전송됩니다.
* 서비스 기능에 필요한 것 외에는 추적이나 분석이 없습니다.

## 문제 해결

### 일반적인 문제 및 해결책

#### 애플리케이션이 시작되지 않음

* macOS 버전 확인 (10.15 이상 필요)
* 사용 가능한 디스크 공간 확인 (최소 500MB)
* 애플리케이션 설치를 위한 관리자 권한이 있는지 확인
* 컴퓨터를 재시작해 보세요

#### 인증 문제

* 인터넷 연결을 확인하세요
* Rememberizer 계정 자격 증명을 확인하세요
* 브라우저 쿠키를 지우고 다시 시도하세요
* 방화벽이 통신을 차단하고 있지 않은지 확인하세요

#### 처리되지 않는 파일

* 파일 유형이 지원되는지 확인하십시오.
* 파일 크기가 50MB 제한 이하인지 확인하십시오.
* 폴더 권한이 앱이 파일을 읽을 수 있도록 허용하는지 확인하십시오.
* 특정 오류 메시지를 확인하려면 상태 탭을 확인하십시오.
* 파일이 gitignore 규칙에 의해 제외되지 않는지 확인하십시오.

#### 느린 처리 성능

* 리소스를 많이 사용하는 애플리케이션 닫기
* 처음에는 폴더를 적게 추가한 후 확장하기
* 더 빠른 처리를 위해 작은 텍스트 파일 우선 처리
* 가능할 경우 GPU 가속 활성화
* 사용 가능한 디스크 공간 확인 (공간이 부족하면 속도 저하 발생 가능)

### 진단 정보

앱은 문제 해결에 도움이 되는 로그를 유지합니다:

1. 메뉴 바의 아이콘을 클릭하여 앱의 메뉴에 접근합니다
2. "고급" > "로그 표시"를 선택합니다
3. 오류 메시지나 경고를 위해 로그를 검토합니다
4. 문제를 보고할 경우, 관련 로그 섹션을 포함합니다

### 앱 초기화

지속적인 문제가 발생하는 경우:

1. Rememberizer 앱 종료
2. 터미널 열기
3. 실행: `defaults delete com.rememberizer.app`
4. 애플리케이션 재시작

## 다운로드 링크

* Rememberizer App 1.6.1 ([macOS](https://www.dropbox.com/scl/fi/hzytquytxmuhpov67spru/rememberizer-app-1.6.1.dmg?rlkey=0p30ok9qt4e33ua8scomagzev\&st=8yys88d5\&dl=1)) - [릴리스 노트](#version-161-october-4th-2024) 참조

보안 업데이트, 버그 수정 및 새로운 기능을 활용하기 위해 항상 최신 버전을 사용하세요.

## 릴리스 노트

### 버전 1.6.1 (2024년 10월 4일)

#### 기능 및 개선 사항

* **빈 폴더 지원**: 사용자는 이제 빈 폴더를 데이터 소스로 추가할 수 있습니다.
* **GPU 지원 및 성능 개선**: 처리 속도를 향상시키기 위해 GPU 가속 지원이 추가되었습니다.
* **강화된 임베딩 프로그램**: 기계별 빌드를 최적화하기 위해 PyTorch의 MPS 버전을 지원하도록 구성되었습니다.
* **지능형 CPU 감지**: 가장 적합한 버전의 임베딩 프로그램이 사용되도록 CPU 유형 감지가 구현되었습니다.
* **개선된 데이터 소스 관리**: 제거된 데이터 소스에서 효율적인 파일 삭제를 위해 배치 삭제 API를 활용했습니다.
* **모든 일반 텍스트 파일 지원**: 다양한 일반 텍스트 파일 유형의 처리가 가능해졌습니다.
* **Gitignore 규칙 준수**: Git 리포지토리에서 gitignore 규칙에 의해 무시된 파일은 이제 처리에서 제외됩니다.
* **소소한 UI 개선**: 사용자 인터페이스 및 성능 향상.

## 자주 묻는 질문

### 일반 질문

**Q: Rememberizer 앱은 무료로 사용할 수 있나요?**\
A: 앱은 무료로 다운로드할 수 있지만, 다양한 제한이 있는 구독 계층이 있을 수 있는 Rememberizer 계정이 필요합니다.

**Q: 앱이 이미지에서 텍스트를 추출하나요?**\
A: 현재 앱은 이미지에서 OCR(광학 문자 인식)을 수행하지 않습니다.

**Q: 내 파일이 다른 사용자와 공유되나요?**\
A: 아니요. 귀하의 파일은 귀하의 계정만을 위해 비공식적으로 처리되고 포함됩니다.

### 기술 질문

**Q: 앱이 내 시스템 리소스를 얼마나 사용할까요?**\
A: 앱은 백그라운드에서 효율적으로 실행되도록 설계되었지만, 대용량 폴더의 초기 처리 중에는 리소스 사용량이 증가합니다.

**Q: 앱이 항상 실행되어 있어야 하나요?**\
A: 지속적인 파일 모니터링 및 업데이트를 위해서는 그렇습니다. 그러나 필요할 때만 실행하도록 선택할 수 있습니다.

**Q: 처리할 수 있는 파일 수에 제한이 있나요?**\
A: 제한은 귀하의 Rememberizer 계정 등급에 따라 다릅니다. 이 제한에 가까워지면 앱이 알려줍니다.
