{"id":50556598,"url":"https://github.com/whoareyou-l/green_smart_install","last_synced_at":"2026-06-08T01:02:32.932Z","repository":{"id":362393072,"uuid":"1258872797","full_name":"whoareyou-l/green_smart_install","owner":"whoareyou-l","description":"Home Assistant custom integration for Green Smart greenhouse control","archived":false,"fork":false,"pushed_at":"2026-06-04T04:10:31.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-04T04:11:01.945Z","etag":null,"topics":["custom-integration","greenhouse","hacs","home-assistant","modbus","mqtt"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/whoareyou-l.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-04T02:07:20.000Z","updated_at":"2026-06-04T04:10:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/whoareyou-l/green_smart_install","commit_stats":null,"previous_names":["whoareyou-l/green_smart_install"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/whoareyou-l/green_smart_install","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoareyou-l%2Fgreen_smart_install","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoareyou-l%2Fgreen_smart_install/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoareyou-l%2Fgreen_smart_install/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoareyou-l%2Fgreen_smart_install/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whoareyou-l","download_url":"https://codeload.github.com/whoareyou-l/green_smart_install/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoareyou-l%2Fgreen_smart_install/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33895175,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["custom-integration","greenhouse","hacs","home-assistant","modbus","mqtt"],"created_at":"2026-06-04T08:00:19.095Z","updated_at":"2026-06-08T01:02:32.925Z","avatar_url":"https://github.com/whoareyou-l.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌿 Green Smart\n\n스마트 온실 관리 시스템 — Home Assistant 기반 올인원 Docker 패키지\n\n---\n\n## 기술 스택\n\n| 구성요소 | 역할 | 비고 |\n|---------|------|------|\n| **Home Assistant** | IoT 허브 · 대시보드 · 자동화 엔진 | 필수 |\n| **Green Smart** | 온실 전용 패널 · 기상청 날씨 연동 | 이 리포 |\n| **Mosquitto** | MQTT 브로커 — 센서 데이터 수신 | 필수 |\n| **ESPHome** | ESP32/ESP8266 센서 펌웨어 관리 | 선택 |\n| **Node-RED** | 복잡한 자동화 로직 | 선택 |\n\n---\n\n## 최소 하드웨어 요구사항\n\n| 항목 | 최소 | 권장 |\n|------|------|------|\n| CPU | 2코어 x86_64 / ARM64 | 4코어 |\n| RAM | 2 GB | 4 GB |\n| 저장장치 | 32 GB | 64 GB SSD |\n| OS | Debian 12 / Ubuntu 22.04 LTS | Debian 12 |\n| 네트워크 | 유선 LAN | 유선 LAN |\n\n\u003e `network_mode: host` 사용으로 **Linux 전용**입니다.\n\n---\n\n## 빠른 시작\n\n### ⚡ 완전 자동 (새 Linux 미니 PC, 아무것도 없는 상태)\n\n아래 명령 한 줄로 **apt 업데이트 → git 설치 → Docker 설치 → 클론 → 실행**까지 모두 처리됩니다.\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/whoareyou-l/green_smart_install/main/scripts/bootstrap.sh | sudo bash\n```\n\n\u003e `curl`도 없는 경우: `sudo apt-get install -y curl` 후 위 명령 실행\n\n설치 완료 후 브라우저에서 접속:\n```\nhttp://\u003c미니PC-IP\u003e:8123\n```\n\n---\n\n### 🔧 수동 설치 (git · Docker 이미 있는 경우)\n\n```bash\n# 1. 클론\ngit clone https://github.com/whoareyou-l/green_smart_install.git\ncd green_smart_install\n\n# 2. 설치 및 실행\nbash scripts/setup.sh\n```\n\n---\n\n### 📋 단계별 수동 실행\n\n```bash\ncp .env.example .env\ndocker compose up -d\ndocker compose ps\ndocker compose logs -f homeassistant\n```\n\n---\n\n## 디렉토리 구조\n\n```\ngreen_smart_install/\n├── docker-compose.yml          # 서비스 정의\n├── .env.example                # 환경변수 템플릿\n├── scripts/\n│   ├── setup.sh                # 최초 설치 스크립트\n│   └── update.sh               # 업데이트 스크립트\n├── custom_components/\n│   └── green_smart/            # HA 커스텀 통합\n│       ├── __init__.py\n│       ├── manifest.json\n│       ├── weather_api.py      # 기상청 API\n│       ├── weather_views.py    # REST 엔드포인트\n│       ├── kma_grid.py         # 격자 좌표 매핑\n│       └── panel/\n│           └── green-smart-panel.js  # 프론트엔드\n├── ha-config/                  # Home Assistant 설정\n│   ├── configuration.yaml\n│   ├── automations.yaml\n│   ├── scripts.yaml\n│   └── scenes.yaml\n└── mosquitto/\n    └── config/\n        └── mosquitto.conf      # MQTT 브로커 설정\n```\n\n---\n\n## Green Smart 설정\n\n1. `http://\u003cIP\u003e:8123` 접속 후 HA 계정 생성\n2. **설정 → 통합구성요소 → 추가** → `Green Smart` 검색 후 설치\n3. Green Smart 사이드바 패널 → **설정** 탭\n4. 기상청 API 키 입력 (아래 발급 방법 참고)\n\n### 기상청 API 키 발급\n\n1. [공공데이터포털](https://www.data.go.kr) 회원가입\n2. **기상청_단기예보 ((구)동네예보) 조회서비스** 신청 → 단기예보 API 키\n3. **기상청_중기예보 조회서비스** 신청 → 중기예보 API 키\n4. 승인 후 (보통 즉시) Green Smart 설정 화면에서 입력\n\n---\n\n## 선택적 서비스\n\n### ESPHome (ESP32 센서 관리)\n\n```bash\ndocker compose --profile sensors up -d\n# 접속: http://\u003cIP\u003e:6052\n```\n\n### Node-RED (자동화 로직)\n\n```bash\ndocker compose --profile advanced up -d\n# 접속: http://\u003cIP\u003e:1880\n```\n\n### 전체 서비스 동시 실행\n\n```bash\ndocker compose --profile sensors --profile advanced up -d\n```\n\n---\n\n## MQTT 센서 연동\n\nMosquitto 브로커 접속 정보:\n\n| 항목 | 값 |\n|------|-----|\n| 호스트 | `\u003c미니PC-IP\u003e` |\n| 포트 | `1883` |\n| WebSocket | `9001` |\n| 인증 | 없음 (내부망 기본값) |\n\nESPHome 센서 예시 (온도·습도):\n\n```yaml\n# esphome/greenhouse-zone1.yaml\nmqtt:\n  broker: 192.168.1.100    # 미니PC IP\n  topic_prefix: green_smart/zone1\n\nsensor:\n  - platform: dht\n    pin: GPIO4\n    temperature:\n      name: \"Zone 1 온도\"\n    humidity:\n      name: \"Zone 1 습도\"\n    update_interval: 60s\n```\n\n---\n\n## 업데이트\n\n```bash\nbash scripts/update.sh\n```\n\n---\n\n## 서비스 관리\n\n```bash\n# 상태 확인\ndocker compose ps\n\n# 로그 확인\ndocker compose logs -f homeassistant\ndocker compose logs -f mosquitto\n\n# 재시작\ndocker compose restart homeassistant\n\n# 중지\ndocker compose down\n\n# 완전 초기화 (데이터 포함 삭제)\ndocker compose down -v\n```\n\n---\n\n## 포트 정보\n\n| 서비스 | 포트 | 용도 |\n|--------|------|------|\n| Home Assistant | `8123` | 웹 대시보드 |\n| MQTT | `1883` | 센서 데이터 |\n| MQTT WebSocket | `9001` | 브라우저 MQTT |\n| ESPHome | `6052` | 펌웨어 관리 (선택) |\n| Node-RED | `1880` | 자동화 (선택) |\n\n---\n\n## 라이선스\n\nMIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhoareyou-l%2Fgreen_smart_install","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhoareyou-l%2Fgreen_smart_install","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhoareyou-l%2Fgreen_smart_install/lists"}