📎 Paperclip One-Click Kit (페이퍼클립 원클릭 키트)

Windows에서 더블클릭 한 번으로 Paperclip을 설치·실행·관리하는 왕초보용 키트입니다. Paperclip = AI 에이전트(직원)들을 "회사 조직"처럼 운영하는 오픈소스 앱.

🌐 English README · 📖 왕초보 상세 가이드 / Beginner Guide

---

✨ 이게 뭔가요?

• Paperclip 공식 설치는 npx paperclipai onboard 한 줄이지만, 비개발자에겐 Node.js 설치·버전·경로 문제로 막히기 쉽습니다.
• 이 키트는 그걸 bat 파일 더블클릭으로 대신 처리합니다: Node 자동 점검/설치 → Paperclip 설정 → 실행 → 브라우저 자동 열기.
• 영어+한국어 병기 메뉴, 자주 쓰는 기능은 버튼 하나로.

🚀 빠른 시작 (3단계)

1. 이 저장소를 다운로드(초록색 Code → Download ZIP) 후 압축을 풉니다.
2. Paperclip-Install.bat 더블클릭 → 처음 한 번만 (Node 점검/설치 + 설정 + 첫 실행).
   • 권한(UAC) 창이 뜨면 "예" 를 누르세요.
3. 이후엔 Paperclip-Menu.bat 더블클릭 → 1(Open) → 브라우저에 Paperclip 화면이 뜹니다.

폴더는 아무 곳에나 둬도 되고 bat 이름을 바꿔도 됩니다. 단, 각 bat과 lib 폴더는 같은 폴더에 두세요.

📂 폴더 구조

파일	역할
Paperclip-Install.bat	처음 설치 (Node 점검/설치 + 설정 + 첫 실행)
Paperclip-Menu.bat	메인 메뉴 (실행·버전·로그인·복구 등 모든 기능)
Paperclip-Uninstall.bat	삭제
lib/*.ps1	실제 동작 스크립트 (지우지 마세요)
README.md · README.en.md	설명서 (한국어 / 영어)
GUIDE.md	왕초보 상세 가이드
LICENSE	Apache License 2.0

🖥 메뉴 사용법 (Paperclip-Menu.bat)

입력	기능
1	Open Paperclip — 켜고 화면 열기 (꺼져 있으면 자동 시작)
2	Help — 도움말·링크
9	Set up / Re-setup — 설치 / 재설치
A	Advanced — 고급 메뉴 (아래)
0	Exit — 끝내기

고급(A) 메뉴: 버전 확인 / 업데이트 / 로그인 / 로그아웃 / 내 로그인 / 점검(doctor) / 로그 폴더 / 복구(Repair) / 삭제

🔑 API 키 · 비용 (중요)

• Paperclip 자체는 무료지만, AI를 실제로 부리려면 AI 제공사 API 키가 필요하고 쓴 만큼 비용이 듭니다.
• 입문 추천: Google Gemini (aistudio.google.com, 무료 한도 있음). 그 외 OpenAI (platform.openai.com), Anthropic (console.anthropic.com).
• 키는 Paperclip 대시보드(설정 화면)에 입력하고, 예산 한도(budget) 를 꼭 설정하세요.
• ⚠️ API 키 = 비밀번호. 캡처·채팅·깃허브에 올리지 마세요. 발급/안전 방법은 GUIDE.md 참고.

🌐 접속 주소

• 켜면 브라우저가 자동으로 열립니다. 보통 http://localhost:8123, 그 포트가 사용 중이면 다음 포트(예: 8124)로 뜹니다. 정확한 주소는 검은 창에 표시됩니다.

🗑 제거

• Paperclip-Uninstall.bat 더블클릭 → YES 입력. (데이터 C:\Users\(나)\.paperclip 삭제. Node.js는 그대로 둡니다.)

🛠 문제 해결

증상	해결
"설치 안 됨 / Not set up"이 떠요	메뉴 1 (자동 설정·실행) 또는 9
화면이 안 떠요	검은 창 닫지 말기 → 20~30초 후 새로고침(F5) → A → 6(점검)
빨간 에러 / 이상 동작	A → 8(Repair: 캐시 정리 + 재다운로드)
winget이 없다고 나와요	https://nodejs.org/ko/download 에서 LTS 설치 후 다시 실행

⚙️ 요구 사항

• Windows 10 / 11, 인터넷 연결.
• Node.js 20 이상 (없으면 키트가 winget으로 자동 설치).

🔒 운영 · 보안 주의

• 검은 창을 닫으면 Paperclip이 꺼집니다 (켜 둔 동안만 동작).
• 데이터·DB는 내 PC ~/.paperclip에 로컬 저장(외부 전송 없음).
• 이 키트에는 어떤 비밀값(API 키·토큰·비밀번호)도 들어있지 않습니다.

📜 라이선스

Apache License 2.0 © SoDam AI Studio — LICENSE

Paperclip 앱 자체는 별도의 오픈소스 프로젝트입니다 → https://github.com/paperclipai/paperclip