AEB

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

이 순서대로 따라오시면 됩니다. 두더싱에 문의하실 때는 "퀵스타트 N-M에서 막혔다"고 알려주시면 빠르게 도와드릴 수 있어요. (예: "2-4에서 PAT 복사가 안 돼요")

📌 앱 버전 안내
이 가이드는 앱 버전 v1.1.6 기준으로 작성되었습니다.
📌 App Version Info
This guide is written based on app version v1.1.6.
⚡ 잠깐 — EdgeBridge 본연 기능만 쓰실 분은 1번 + 5-1~5-4 만 하면 됩니다
Tesla 같은 외부 클라우드 연동을 위한 중계(EdgeBridge) 용도로만 쓰실 거고 LLM 기능은 안 쓰실 계획이라면, 1번 단계(서버용 디바이스에 설치 + 서버 시작)와 5-1~5-4(채널 가입 → 드라이버 Install → 기기 추가)까지 하시면 됩니다. 중계 드라이버 자체를 채널에서 설치해야 하므로 5-1~5-4는 필수입니다. 나머지 2~4번과 5-5~5-6은 LLM·Chat·자동화 명령용이라 건너뛰어도 됩니다.
⚡ Heads up — if you only need EdgeBridge's relay role, do step 1 + steps 5-1 to 5-4
If you're only using AEB as the HTTP relay for things like Tesla integrations and you don't plan to use the LLM features, you still need step 1 (install on the server device and start the server) plus steps 5-1 to 5-4 (join the channel → Install the driver → add the device). The relay driver itself has to be installed from the channel, so 5-1 to 5-4 are required. The rest — steps 2 to 4 and 5-5 to 5-6 — are for the LLM, Chat, and automation prompts, so you can skip them.
1

서버로 쓸 디바이스에 설치

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

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

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
2

본폰에 세팅 + 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 는 입력해도 자동 폐기되므로 의미 없음.

2

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.

3

본폰에서 AI API 키 등록

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

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

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)
4

서버용 디바이스로 이전 (웹 관리)

화면 없는 서버 디바이스도 같은 네트워크의 브라우저(PC·폰)에서 관리할 수 있습니다.

  • 4-1. 서버 디바이스의 AEB [홈] 탭에서 웹 관리 PIN(4~12자리)을 입력 → 바로 아래에 접속 주소 http://기기IP:포트/admin가 표시됩니다. 서버는 켜 둡니다.
  • 4-2. 같은 네트워크의 아무 브라우저에서 그 주소를 열고 PIN으로 로그인.
  • 4-3. SmartThings 연결 — [API 키] 탭에 영구 PAT 붙여넣기(가장 간단), 또는 [SmartThings] 탭에서 SmartApp Server/Chat 연동.
  • 4-4. AI API 키·설정 — 각 탭에서 입력/변경. (허용/차단·인증은 즉시 적용)
  • 4-5. 모든 설정이 끝나면 마지막으로 [모든 설정 앱으로 보내기] 버튼을 누르세요.
4

Migrate to the server device (Web Admin)

Manage a display-less server device from any browser (PC/phone) on the same network.

  • 4-1. On the server device's AEB Home tab, enter a Web admin PIN (4–12 digits) → the address http://device-ip:port/admin appears right below. Keep the server running.
  • 4-2. Open that address in any browser on the same network and log in with the PIN.
  • 4-3. Connect SmartThings — paste a permanent PAT on the [API keys] tab (simplest), or use SmartApp Server/Chat on the [SmartThings] tab.
  • 4-4. AI API keys & settings — edit on each tab. (Allow/block and auth apply instantly.)
  • 4-5. Once all settings are done, finally tap the [Send all settings to app] button.
5

EdgeBridge Agent 설치 + 테스트

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

  • 5-1. "EdgeBridge Agent invitation" 링크로 채널 가입(Enroll)
  • 5-2. ⚠️ 가입만으로는 끝이 아닙니다 — 가입 후 채널 화면의 "Available Drivers" 목록에서 EdgeBridge Agent 드라이버를 찾아 [Install] 까지 눌러 허브에 설치하세요. (이 단계를 빠뜨리면 아래 "주변 기기 검색"을 해도 기기가 잡히지 않습니다.)
  • 5-3. SmartThings 앱 → 기기 추가 → 주변 기기 검색 → 1번에서 쓰던 허브 선택
  • 5-4. 자동으로 EdgeBridge Agent 기기가 추가됨
  • 5-5. 추가된 기기 진입 → 맨 아래 "LLM으로 명령하기" 입력란에 한 줄 입력
  • 5-6. "전송중..." 표시 후 응답이 표시되면 정상 동작
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 (Enroll)
  • 5-2. ⚠️ Enrolling is not enough — after enrolling, open the "Available Drivers" list on the channel page, find the EdgeBridge Agent driver and tap [Install] to deploy it to your hub. (Skip this and "Scan nearby" below won't find the device.)
  • 5-3. SmartThings app → Add device → Scan nearby → pick the hub from step 1
  • 5-4. The EdgeBridge Agent device is added automatically
  • 5-5. Open the device → at the bottom, type a prompt into "Send to LLM"
  • 5-6. You'll see "Sending..." then the response — that means it's working
6

루틴(자동화)에 활용

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

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

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

더 자세한 사용법은 사용법 가이드 · 문제가 생겼다면 트러블슈팅 참조.