{"id":40025878,"url":"https://github.com/jjh4450/aihubshell_image","last_synced_at":"2026-02-02T04:17:12.325Z","repository":{"id":275341453,"uuid":"925802949","full_name":"jjh4450/aihubshell_image","owner":"jjh4450","description":"AI Hub에서 CLI로 데이터를 다운로드할 수 있는 툴인 aihubshell을 Docker로 간단히 실행할 수 있도록 구성한 비공식 이미지입니다.","archived":false,"fork":false,"pushed_at":"2026-01-12T02:04:42.000Z","size":13,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-12T06:56:27.816Z","etag":null,"topics":["aihub","aihubshell","docker-image"],"latest_commit_sha":null,"homepage":"https://jeje.work/docker-aihubshell-docker-","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jjh4450.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2025-02-01T19:31:35.000Z","updated_at":"2025-03-11T23:53:04.000Z","dependencies_parsed_at":"2026-01-19T04:00:35.111Z","dependency_job_id":null,"html_url":"https://github.com/jjh4450/aihubshell_image","commit_stats":null,"previous_names":["jjh4450/aihubshell_image"],"tags_count":44,"template":false,"template_full_name":null,"purl":"pkg:github/jjh4450/aihubshell_image","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjh4450%2Faihubshell_image","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjh4450%2Faihubshell_image/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjh4450%2Faihubshell_image/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjh4450%2Faihubshell_image/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jjh4450","download_url":"https://codeload.github.com/jjh4450/aihubshell_image/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjh4450%2Faihubshell_image/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28561593,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T03:31:16.861Z","status":"ssl_error","status_checked_at":"2026-01-19T03:31:15.069Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["aihub","aihubshell","docker-image"],"created_at":"2026-01-19T04:00:26.957Z","updated_at":"2026-01-19T04:00:49.417Z","avatar_url":"https://github.com/jjh4450.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# aihubshell Docker 이미지 (비공식) 🚀\n\nAI Hub에서 **CLI**로 데이터를 다운로드할 수 있는 툴인 `aihubshell`을 Docker로 간단히 실행할 수 있도록 구성한 **비공식** 이미지입니다.  \n본 이미지는 `Alpine Linux` 기반으로 제작되었으며, 사용 전에 **AI Hub** 이용 약관을 반드시 숙지하고, 데이터셋 다운로드 승인 여부 등을 **사전에 확인**한 후 사용해주세요.\n\n\n## 📚 목차\n1. [개요](-#개요)  \n2. [이미지 가져오기](-#이미지-가져오기)  \n3. [컨테이너 실행](-#컨테이너-실행)  \n4. [docker-compose 사용](-#docker-compose-사용)  \n5. [사용 예시](-#사용-예시)  \n6. [주의사항](-#주의사항)  \n7. [보안 및 법적 고지](-#보안-및-법적-고지)  \n8. [라이선스](-#라이선스)\n\n\n## 💡 개요\n[AI Hub](https://aihub.or.kr)에서 제공하는 학습용 데이터는 **aihubshell** 유틸리티를 통해 터미널(명령줄)에서 간단히 다운로드할 수 있습니다.  \n본 저장소에서는 `aihubshell`이 **미리 설치**된 Docker 이미지를 제공함으로써:\n\n- **설치 편의성**: 별도 구성 없이 `docker pull` 후 바로 사용  \n- **환경 격리**: 호스트 OS에 영향 없이 동일한 환경 보장  \n- **이식성**: Windows, Mac, Linux 등 어디에서나 일관된 실행 가능  \n\n### Dockerfile 주요 내용(요약)\n```dockerfile\nFROM alpine:latest\n\nRUN apk update \u0026\u0026 apk add --no-cache curl unzip\n\nRUN curl -o \"aihubshell\" https://api.aihub.or.kr/api/aihubshell.do \\\n    \u0026\u0026 chmod +x aihubshell \\\n    \u0026\u0026 cp aihubshell /usr/bin\n\nENTRYPOINT [\"/bin/sh\"]\n```\n- `apk add`를 통해 `curl`과 `unzip` 설치  \n- `aihubshell` 다운로드 및 실행 권한 부여  \n\n\n## 📥 이미지 가져오기\n이미 **빌드된 이미지를 GHCR**에서 직접 받아 사용할 수 있습니다.\n\n```bash\ndocker pull ghcr.io/jjh4450/aihubshell_unofficial:latest\n```\n\u003e 원하시는 다른 버전 태그가 있다면 `:latest` 대신 해당 태그를 지정하세요.\n\u003e\n\u003e 이 이미지는 외부 의존성이 적고 매주 자동 업데이트되어 **`:latest` 태그 사용을 권장합니다.**\n\n## ⚡ 컨테이너 실행\n\n### 1) 간단 실행\n```bash\ndocker run -it --rm \\\n  ghcr.io/jjh4450/aihubshell_unofficial:latest\n```\n- `-it`: 터미널 상호작용(인터랙티브) 모드  \n- `--rm`: 컨테이너 종료 시 자동 제거  \n\n컨테이너 내부로 접속되면 `sh` 셸을 통해 `aihubshell` 명령어를 바로 입력할 수 있습니다:\n```bash\naihubshell -mode l\n# AI Hub 데이터셋 목록 조회\n```\n\n### 2) `aihubshell` 명령어 바로 실행\n```bash\ndocker run -it --rm \\\n  ghcr.io/jjh4450/aihubshell_unofficial:latest \\\n  aihubshell -mode l # 원하는 명령어 입력 가능\n```\n\n\n## 🤝 docker-compose 사용\n\n볼륨 마운트를 통해 **호스트 디렉토리**에 데이터를 저장하고 싶다면, 예시와 같은 `compose.yml`을 사용할 수 있습니다.\n\n```yaml\nservices:\n  aihub:\n    image: ghcr.io/jjh4450/aihubshell_unofficial:latest\n    container_name: aihubshell_container\n    volumes:\n      - \u003cyour_dir\u003e:/data  # 호스트의 경로를 컨테이너 내부 /data(default)에 연결\n    tty: true\n    stdin_open: true\n```\n\n이후 다음 명령어로 컨테이너를 실행합니다:\n```bash\ndocker-compose up -d\n# 백그라운드 모드 실행\n\ndocker exec -it aihubshell_container sh\n# 실행 중인 컨테이너에 접속 (터미널)\n```\n이제 컨테이너 내부에서 `aihubshell` 명령어를 사용할 수 있으며, `/data`에 다운로드된 파일은 호스트의 `./data` 디렉토리에서 확인 가능합니다.\n\n\n## 📝 사용 예시\n\n### 1) 데이터셋 목록 조회\n```bash\naihubshell -mode l\n```\n- 출력되는 목록에서 `datasetkey`를 확인할 수 있습니다.\n\n### 2) 전체 다운로드\n```bash\naihubshell -mode d \\\n  -datasetkey \u003c데이터셋KEY\u003e \\\n  -aihubid 'AIHUB_아이디' \\\n  -aihubpw 'AIHUB_비밀번호'\n```\n- 해당 데이터셋에 대한 다운로드 승인(승인신청 후)이 이미 완료되어 있어야 합니다.\n\n### 3) 특정 파일 다운로드\n```bash\naihubshell -mode d \\\n  -datasetkey \u003c데이터셋KEY\u003e \\\n  -filekey \u003c파일KEY1,파일KEY2,...\u003e \\\n  -aihubid 'AIHUB_아이디' \\\n  -aihubpw 'AIHUB_비밀번호'\n```\n- `,`로 여러 개의 `filekey`를 구분하여 선택 다운로드가 가능합니다.\n\n### 4) 저장 경로 지정\n```bash\naihubshell -mode d \\\n  -datasetkey \u003c데이터셋KEY\u003e \\\n  -aihubid 'AIHUB_아이디' \\\n  -aihubpw 'AIHUB_비밀번호' \\\n  -o /data\n```\n- `/data` 디렉토리에 저장하여 호스트의 `./data`에서 확인할 수 있습니다.\n\n\n## ⚠️ 주의사항\n\n1. **AI Hub 이용 약관**  \n   - `aihubshell`은 AI Hub 공식 API와 연동되므로, 사용 전 반드시 [AI Hub 이용 약관](https://aihub.or.kr)을 준수하세요.\n\n2. **데이터 승인**  \n   - 데이터셋 다운로드 전 해당 데이터셋에 대해 **다운로드 승인이 완료**되어 있어야 합니다.\n\n3. **특수문자 비밀번호**  \n   - `-aihubid` 또는 `-aihubpw` 인수에 특수문자가 포함된 경우, **홑따옴표**(`'...'`)로 감싸 입력하세요.\n\n4. **디스크 여유 공간**  \n   - 압축된 데이터셋 용량이 큰 경우, 최소 2~3배 이상의 디스크 용량을 확보하시기 바랍니다.\n\n5. **데이터 보존**  \n   - Docker 컨테이너 내부 스토리는 컨테이너 종료와 함께 사라집니다.  \n   - 다운로드된 파일을 영구적으로 보관하려면, **호스트 볼륨 마운트**(예: `-v ./data:/data`)를 권장합니다.\n\n\n## 🔒 보안 및 법적 고지\n1. **보안 책임**  \n   - 본 이미지는 단순히 `aihubshell`을 실행하기 위한 환경을 제공할 뿐,  \n     **사용자의 인증 정보(아이디/비밀번호) 보안을 완전히 보장하지 않습니다.**  \n   - 민감 정보는 환경변수나 직접 입력 시 주의하세요.\n\n2. **법적 책임 한계**  \n   - 본 이미지는 AI Hub와 공식적인 관계가 없는 **비공식** 프로젝트입니다.  \n   - 본 이미지를 사용함으로써 발생할 수 있는 **법적 문제, 데이터 손실, 기타 피해** 등은 전적으로 사용자의 책임입니다.  \n   - **AI Hub 데이터** 사용에 따른 모든 책임(저작권, 개인정보보호, 보안 등)은 최종적으로 **사용자**에게 있습니다.  \n   - Dockerfile 및 예제 코드는 참고용이며, **사용 시 발생하는 문제에 대해 어떠한 책임도 지지 않습니다.**\n\n3. **취약점 가능성**  \n   - `Alpine Linux` 최소 환경에서 기본 패키지만을 설치하였으며,  \n     추가적인 보안 설정(방화벽, IDS 등)은 제공하지 않습니다.  \n   - 필요한 보안 강화 조치는 **사용자**가 직접 진행해야 합니다.\n\n\n## 📜 라이선스\n\n- **Dockerfile 및 예제 코드**: [MIT License](LICENSE)  \n- **`aihubshell` 유틸리티**: [AI Hub 정책](https://aihub.or.kr)에 따름  \n\n\u003e 문의  \n\u003e - **AI Hub 데이터 다운로드/정책**: [AI Hub](https://aihub.or.kr)  \n\u003e - **Docker 이미지 이슈**: GitHub Issue로 제보  \n\n**즐거운 AI Hub 데이터 다운로드 되세요!** ☺️  \n[ghcr.io/jjh4450/aihubshell_unofficial:latest](https://github.com/jjh4450?tab=packages)  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjjh4450%2Faihubshell_image","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjjh4450%2Faihubshell_image","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjjh4450%2Faihubshell_image/lists"}