🚀 무작정 따라하기 — 6단계로 끝나는 첫 세팅

서버로 쓸 디바이스에 설치

늘 켜둘 안드로이드 TV·셋탑박스·안 쓰는 폰을 준비합니다.

• 1-1. Google Play에서 AEB 설치
• 1-2. AEB에서 "서버 시작" 한 번 누르고 그대로 둠 (다른 세팅은 본폰에서 진행)
• 1-3. (권장) 안드로이드 TV · 셋탑박스 · 안 쓰는 폰 — 늘 켜져 있는 기기가 좋아요

Install on the device that will be your server

Pick an Android TV, set-top box, or a spare phone that stays on 24/7.

• 1-1. Install AEB from Google Play
• 1-2. Tap "Start server" once and leave it alone — all the rest of the setup happens on your main phone
• 1-3. (Recommended) Android TV · set-top box · a spare phone — anything that stays powered

본폰에 세팅 + SmartThings 연동

입력하기 편한 본폰에서 OAuth 동의(2단계)까지 한 번에 끝냅니다. PAT 입력은 영구 PAT 가 있을 때만.

• 2-1. 본폰에 AEB 설치, 서버 시작은 하지 않음
• 2-2. 설정 탭 → "SmartThings 연결" 버튼 (PAT 입력 비워둬도 OK)
• 2-3. 모드 선택 화면에서 "Server 로 연결" 선택 (v1.1.0+ — 본폰이지만 일단 Server 모드로 잡아두면 4번에서 한 방에 옮기기 편해요)
• 2-4. 자동으로 브라우저가 열림 → SmartThings 로그인 → 동의 (1단계: CLI 권한)
• 2-5. "권한 1/2 완료" 토스트 → 두 번째 동의 화면이 자동으로 뜸 → 같은 계정으로 한 번 더 동의 (2단계: SmartApp 등록)
• 2-6. 자동으로 AEB 로 돌아오면 "Connected" 토스트 확인하면 끝

🔑 영구 PAT 를 가지고 있다면 2-2 의 PAT 입력란에 붙여넣고 진행 — 그러면 1단계 OAuth 가 자동으로 건너뛰어집니다. 24h 만료 PAT 는 입력해도 자동 폐기되므로 의미 없음.

Set up on your main phone + connect SmartThings

Do OAuth consent (2 steps) once on your main phone where typing is easier. PAT entry is only for users with a permanent PAT.

• 2-1. Install AEB on your main phone — do NOT start the server here
• 2-2. Setting tab → tap "Connect SmartThings" (leaving the PAT field empty is fine)
• 2-3. On the mode-select screen, pick "Connect as Server" (v1.1.0+ — yes, even on your phone; staking it as Server here makes step 4 a one-tap move)
• 2-4. A browser opens automatically → sign in to SmartThings → consent (step 1: CLI permission)
• 2-5. A "Step 1/2 complete" toast appears → the second consent screen opens automatically → consent again with the same account (step 2: SmartApp registration)
• 2-6. AEB returns automatically — when you see the "Connected" toast, you're done

🔑 If you have a permanent PAT, paste it into the PAT field in 2-2 — that skips OAuth step 1 automatically. 24h-expiring PATs are auto-discarded so pasting them has no effect.

본폰에서 AI API 키 등록

LLM 키도 본폰에서 입력해두면 다음 단계에서 한 번에 서버로 옮겨집니다.

• 3-1. (추천) Gemini API 키 발급해서 저장 — 무료 할당량으로 즉시 시작 가능
• 3-2. 결제하신 Claude / OpenAI 키가 있다면 함께 저장 (한 개만 저장해도 동작, 여러 개 저장하면 Chat·자동화에서 선택 가능)

Add your AI API keys on the main phone

Enter LLM keys here and they'll move to the server in the next step.

• 3-1. (Recommended) Issue a Gemini API key and save it — its free quota gets you started immediately
• 3-2. If you have paid Claude / OpenAI keys, add them too (one is enough; multiple keys let you pick a provider in Chat / automations)

서버용 디바이스로 이전

본폰에서 만든 Server 모드 연결을 1번 디바이스로 통째로 넘깁니다. (v1.1.0+ — PAT/LLM 키뿐 아니라 OAuth 토큰까지 한 번에 핸드오버)

• 4-1. 본폰 AEB → "다른 AEB로 이전" 버튼
• 4-2. 1번에서 켜둔 서버용 디바이스 선택 → "이전" 한 번
• 4-3. 자동 처리 — 본폰의 Server 모드 연결이 서버 디바이스로 이동하고, 본폰에서는 자동 해제됩니다 (두 폰이 같은 토큰을 동시에 갖지 않도록).
• 4-4. (선택 A — 본폰에서도 Chat 사용) 본폰 → 설정 → PAT 재발급 → 모드 선택에서 "Chat 으로 연결" → OAuth 동의. 서버는 Server 모드, 본폰은 Chat 모드로 간섭 없이 같이 돌아요.
• 4-5. (선택 B — 본폰은 더 안 쓰기) 본폰의 AEB 앱 삭제하거나 그대로 두기.

Hand off to the server device

Transfer the Server-mode connection you just built straight to the device from step 1. (v1.1.0+ — not just PAT/LLM keys but OAuth tokens too in one shot.)

• 4-1. Main-phone AEB → "Move to another AEB"
• 4-2. Pick the server device from step 1 → tap "Send" once
• 4-3. Automatic — the Server-mode connection moves to the server device and clears from your phone (so two phones never hold the same token).
• 4-4. (Option A — also use Chat on your phone) Phone → Settings → reissue a PAT → on the mode-select screen pick "Connect as Chat" → accept OAuth. Server runs in Server mode, phone in Chat mode — no interference.
• 4-5. (Option B — done with the phone) Uninstall AEB from the phone, or just leave it.

EdgeBridge Agent 설치 + 테스트

SmartThings 앱 안에서 LLM에게 직접 명령을 보낼 수 있는 디바이스를 추가합니다.

• 5-1. "EdgeBridge Agent invitation" 링크로 채널 가입
• 5-2. SmartThings 앱 → 기기 추가 → 주변 기기 검색 → 1번에서 쓰던 허브 선택
• 5-3. 자동으로 EdgeBridge Agent 기기가 추가됨
• 5-4. 추가된 기기 진입 → 맨 아래 "LLM으로 명령하기" 입력란에 한 줄 입력
• 5-5. "전송중..." 표시 후 응답이 표시되면 정상 동작

Install the EdgeBridge Agent driver and test

Add a device that lets you send LLM prompts straight from the SmartThings app.

• 5-1. Join the channel via the "EdgeBridge Agent invitation" link
• 5-2. SmartThings app → Add device → Scan nearby → pick the hub from step 1
• 5-3. The EdgeBridge Agent device is added automatically
• 5-4. Open the device → at the bottom, type a prompt into "Send to LLM"
• 5-5. You'll see "Sending..." then the response — that means it's working

루틴(자동화)에 활용

트리거에 맞춰 LLM이 자동으로 호출되도록 루틴에 끼워 넣습니다.

• 6-1. SmartThings 루틴 탭 → "+" 버튼으로 새 루틴 시작
• 6-2. 동작 추가 → 목록에서 "LLM으로 명령하기" 선택
• 6-3. Prompt 입력 + Provider/Model 선택 → 저장
• 6-4. 트리거 발생 시 자동으로 LLM 호출 — 응답은 TTS·푸시 등 다음 동작에 활용 가능

Wire it into a routine (automation)

Drop the LLM action into a routine so it fires on your trigger.

• 6-1. SmartThings Routines tab → "+" to start a new routine
• 6-2. Add an action → pick "Send to LLM" from the list
• 6-3. Enter the prompt + pick Provider/Model → save
• 6-4. When the trigger fires the LLM is called automatically — pipe the response to TTS, push notifications, or any follow-up action