README.md

---
title: LocalPCAgent 제어 인터페이스
emoji: 💻
colorFrom: indigo
colorTo: blue
sdk: gradio
sdk_version: 3.50.2
app_file: app.py
pinned: false
---

# LocalPCAgent 제어 인터페이스

LocalPCAgent 서버와 통신하여 로컬 PC의 기능을 원격으로 제어할 수 있는 Gradio 기반 웹 인터페이스입니다. ngrok을 통해 노출된 로컬 PC 서버와 연결하여 각종 기능을 제어합니다.

## 작동 원리

이 앱은 **서버-프록시** 방식으로 작동합니다:

1. Gradio 서버가 웹 클라이언트와 ngrok 서버 사이의 프록시 역할을 수행
2. 클라이언트에서 Gradio로 요청 → Gradio에서 ngrok으로 요청 전달 → 결과 반환
3. CORS 제한 없이 안정적인 양방향 통신 지원

## 주요 기능

- ngrok URL을 통한 서버 연결
- 서버 상태 확인
- 에코 테스트 (UDP 통신)
- 장치 목록 조회 및 정보 확인
- 프로그램 목록 조회 및 실행

## 사용 방법

1. 로컬 PC에서 ngrok과 함께 LocalPCAgent 서버 실행
2. 생성된 ngrok URL 복사
3. 이 웹앱에서 URL 입력 후 연결
4. 다양한 기능 탭을 통해 원격 기능 테스트

## 기술 스택

- Gradio (웹 인터페이스)
- Python Requests (HTTP 클라이언트)
- JSON (데이터 형식)