═══════════════════════════════════════════════════════════
  자비스 — 내 화면을 같이 보면서 일하는 AI 비서
  리본랩스(REBORN LABS) 무료 배포
═══════════════════════════════════════════════════════════

이 파일부터 읽으시면 됩니다. 5분이면 됩니다.


┌───────────────────────────────────────────────────────┐
│ 설치는 클로드가 대신 합니다                            │
└───────────────────────────────────────────────────────┘

  직접 뭘 깔 필요가 없습니다.
  폴더를 열고 "설치해줘" 한 마디면 됩니다.


  ■ 먼저 클로드 코드가 있어야 합니다

    이 자비스는 클로드가 두뇌입니다.
    클로드 코드가 없으면 동작하지 않습니다.
    이미 쓰고 계시면 이 부분은 건너뛰세요.

        npm install -g @anthropic-ai/claude-code

    깐 다음 아무 폴더에서  claude  를 한 번 실행해
    로그인까지 마치세요.
    (Node.js 가 없다면 nodejs.org 에서 먼저 받으셔야 합니다)


  ── 1단계 ──────────────────────────────────────────────

  받은 zip 을 압축 풀기 합니다.
  바탕화면이든 문서 폴더든 상관없습니다.

    ※ 폴더 경로에 한글이 섞이면 가끔 문제가 납니다.
      잘 안 되면  C:\jarvis  처럼 영문 경로로 옮겨 보세요.


  ── 2단계 ──────────────────────────────────────────────

  그 폴더에서 검은 명령창을 엽니다.

    압축을 푼 폴더를 탐색기로 연 다음,
    위쪽 주소창을 클릭하고  cmd  를 친 뒤 엔터.
    검은 창이 그 폴더 위치에서 열립니다.

    ※ 주소창은  > 내 PC > 문서 > jarvis-voice  처럼
      표시된 줄입니다. 클릭하면 글자를 칠 수 있게 바뀝니다.


  ── 3단계 ──────────────────────────────────────────────

  클로드를 띄웁니다.

        claude


  ── 4단계 ──────────────────────────────────────────────

  이렇게 말합니다.

        설치해줘

    폴더 안의 CLAUDE.md 를 읽고 클로드가 알아서 합니다.
    보통 1~3분 걸립니다.

    클로드가 하는 일:
      무엇이 없는지 점검 → 없는 것만 설치
      → 다시 점검해서 전부 준비됐는지 확인
      → 실행 방법 안내


  ── 5단계 ──────────────────────────────────────────────

  클로드가 알려준 대로 실행합니다.

        python 자비스.py

    ※ 직접 치셔야 합니다.
      클로드가 대신 띄우면 마이크가 안 잡힙니다.


  ── 6단계 ──────────────────────────────────────────────

  브라우저 창이 하나 열립니다.

    ★★ 그 창을 마우스로 한 번 클릭하세요.

       브라우저는 사용자가 누르기 전에는 소리를 내지 않습니다.
       누르면 붉은 원이 사라지고 자비스가 깨어납니다.
       "소리가 안 나요" 의 대부분이 이것입니다.


  ■ 이렇게 나오면 정상입니다

      ✓ 파이썬 3.10 이상 — 3.11.9
      ✓ numpy · sounddevice · faster-whisper
      ✓ ffmpeg
      ✓ 클로드 CLI (로그인까지)
      ✓ 마이크
      · config.json — 없음 (없어도 됩니다)

      전부 준비됐습니다.  python 자비스.py  로 시작하세요.

    맨 아래 "config.json — 없음" 은 문제가 아닙니다.
    화면 보기·일정·알람·받아적기는 설정 없이 그대로 됩니다.
    설정이 필요한 건 지메일 메일함과 윈도우 예약작업, 이 둘뿐입니다.


┌───────────────────────────────────────────────────────┐
│ 말 걸기                                             │
└───────────────────────────────────────────────────────┘

  "자비스야" 하고 부른 뒤 말씀하세요.
  한 번 부르면 45초 동안은 이름을 다시 안 불러도 이어집니다.

  이렇게 말해 보세요:

      "자비스야, 화면 같이 보자"
          → 지금 보이는 화면을 같이 봅니다

      "이 화면에 뭐가 있는지 말해줘"
          → 보이는 것을 읽어 줍니다

      "내일 오후 세 시에 미팅 잡아줘"
          → 일정에 넣습니다

      "십 분 뒤에 알려줘"
          → 시간이 되면 먼저 말합니다

      "받아적어"   …   "끝"
          → 말한 것을 그대로 문서로 저장합니다

      "그만"
          → 끝냅니다


┌───────────────────────────────────────────────────────┐
│ 만들어지는 파일                                     │
└───────────────────────────────────────────────────────┘

  내일정.json    일정          기억.json   기억한 것
  할일.json      할 일         알람.json   걸린 알람
  받아쓴것/      받아쓴 문서    산출물/     만든 문서

  전부 이 폴더 안에만 있습니다. 어디로도 보내지 않습니다.


┌───────────────────────────────────────────────────────┐
│ 설정 (선택)                                         │
└───────────────────────────────────────────────────────┘

  config.example.json 을 config.json 으로 복사한 뒤 고치세요.

      호칭          자비스가 부를 이름
      메일함        지메일 안 읽은 메일 확인 (앱 비밀번호 필요)
      업무현황      윈도우 예약 작업 확인
      제품안내      아래 '먼저 밝힙니다' 참고

  없어도 됩니다. 일정·알람·받아적기·화면보기는 그냥 됩니다.


┌───────────────────────────────────────────────────────┐
│ 먼저 밝힙니다                                       │
└───────────────────────────────────────────────────────┘

  이 자비스 안에는 리본랩스 제품(클로드킷) 안내가 들어 있습니다.

  숨기지 않으려고 규칙을 코드로 묶고 문서로 넣었습니다.
  자세한 것은 같은 폴더의  안내규칙.md  를 보세요.

      · 일이 끝난 직후에만, 하루 한 번까지
      · 한 번 거절하면 영구히 안 묻습니다
      · 끄려면 config.json 에  {"제품안내":{"켜기":false}}

  꺼도 기능은 전부 그대로입니다.


┌───────────────────────────────────────────────────────┐
│ 안 될 때                                            │
└───────────────────────────────────────────────────────┘

  소리가 안 나요       → 브라우저 창을 한 번 클릭하셨나요
  대답을 안 해요       → "자비스야" 하고 부르셨나요 (45초 지나면 다시)
  창이 안 열려요       → 주소창에 127.0.0.1:8791 을 직접 쳐 보세요
  느려요               → 화면을 볼 때와 검색할 때는 10초쯤 걸립니다

  그래도 안 되면 클로드에게 그대로 말하세요.
  "자비스가 안 돼" 라고 하면 폴더를 보고 고쳐 줍니다.


═══════════════════════════════════════════════════════════
  리본랩스 · rebornlabs.kr
  자비스는 무료입니다. 대화할 때마다 각자의 클로드 사용량이 듭니다.
═══════════════════════════════════════════════════════════
