JasonLiu0826/ackem

Ack — Windows를 위한 로컬 우선 AI 동반자

소개 – Ackem (Autonomous Companion Keeping Emotional Memory)은 Electron으로 구축된 Windows 전용 데스크톱 애플리케이션입니다. OpenAI 호환 언어 모델(OpenAI나 DeepSeek 같은 클라우드 서비스, 또는 Ollama/LM Studio 같은 로컬 서버)을 연결하여 채팅, 과거 대화 기억, 감정/관계 상태 추적, 시스템 트레이 아이콘이나 데스크톱 펫으로 나타나는 지속적인 "친구"를 제공합니다.

주요 기능

• 채팅 – 설정된 LLM에 프롬프트를 보내고 채팅 창에 응답을 표시합니다.
• 구조화된 메모리 – 모든 대화는 로컬에 저장되며 임베딩(embeddings)으로 인덱싱되어 검색 가능하고, 타임라인/지식 그래프로 시각화할 수 있습니다. 또한 일반 텍스트(.txt)나 Markdown(.md) 파일을 장기적인 컨텍스트로 가져올 수 있습니다.
• 동반자 상태 – 앱은 신뢰도, 기분, 관계 단계, 일기를 유지합니다. 성격 프리셋과 능동적인 메시지를 통해 "동반자"가 더 생생하게 느껴집니다.
• 데스크톱 존재감 – 시스템 트레이 아이콘, 선택적 기하학적 오브/LIVE2D 펫, 음성 STT/TTS(선택 사항)를 지원합니다.
• 확장 기능 – 확장 센터(Extension Center)를 통해 개발자가 플러그인(예: WeChat 브리지, 게임 모드 통합, 사용자 정의 스킬)을 추가할 수 있습니다.
• 로컬 우선 데이터 – 모든 채팅, 메모리, API 키 및 설정은 Ackem.exe 옆의 data/ 폴더에 저장됩니다. 릴리스 zip 파일에는 사용자 데이터가 포함되어 있지 않으며 원격 측정(telemetry) 데이터를 전송하지 않습니다.

시작하기(최종 사용자)

1. GitHub 또는 Gitee 릴리스 페이지에서 green 릴리스 zip 파일을 다운로드합니다.
2. zip 파일을 SSD의 폴더에 압축 해제합니다(zip 내부에서 직접 실행하지 마십시오).
3. Ackem.exe(또는 제공된 배치 파일)를 실행합니다. 첫 실행 시 임베딩 모델을 추출하며 약 10~30초가 소요됩니다.
4. 개인정보 보호/규정 준수 화면에 동의합니다.
5. Settings → Model & API를 열고 사용할 LLM의 베이스 URL, 모델 ID, API 키를 입력합니다.
6. 채팅을 시작합니다. 메모리 뷰를 통해 .txt/.md 파일을 가져와 동반자에게 장기적인 지식을 제공합니다.

개발자 참고 사항

• 이 프로젝트는 Vite 기반 렌더러를 사용하는 Electron 앱입니다. 개발을 위해서는 Windows 환경에서 Node 20+가 필요합니다.
• 핵심 스크립트: npm run dev(개발 모드 실행), npm run build(컴파일), npm run dist:green(포터블 릴리스 생성), npm run dist:setup(NSIS 설치 프로그램).
• 아키텍처는 7개의 논리적 시스템(Brain, Heart, Mouth, Neural, Extension, Time 등)으로 나뉘어 있으며 docs/developer/architecture/에 문서화되어 있습니다.
• 코드베이스에는 TypeScript 타입 체크, 단위 테스트, SQLite 기반 데이터 계층이 포함되어 있습니다.

개인정보 보호 및 데이터 처리

• 공식 릴리스에는 사용자 데이터가 포함되어 있지 않습니다. 첫 실행 후 모든 데이터는 로컬 data/ 디렉토리에 저장됩니다.
• API 키는 로컬 설정 파일에만 저장되며, Ackem 서버로 원격 측정 데이터를 전송하지 않습니다.
• 저장소에는 상세한 개인정보 처리방침(docs/privacy-and-data.md)이 포함되어 있습니다.

상태 – 단일 관리자에 의해 활발히 테스트 중입니다. 충돌이나 지연은 드물지만 발생할 수 있으며, 예상치 못한 동작이 발생하면 Issue를 열어주시기 바랍니다.

라이선스 – AGPL-3.0. 개인, 연구 및 오픈 소스 통합 사용은 허용됩니다. 상업용 또는 폐쇄형 소스 SaaS 사용 시 별도의 상업용 라이선스가 필요합니다(README의 연락처 참조).

---

위의 모든 정보는 저장소의 README 및 링크된 문서에서 직접 가져온 것입니다.