์ฝ˜ํ…์ธ ๋กœ ๊ฑด๋„ˆ๋›ฐ๊ธฐ

ํ€ต์Šคํƒ€ํŠธ: HUB-SDK ์„ค์น˜ํ•˜๊ธฐ

์•ˆ๋…•ํ•˜์„ธ์š”, ํ™˜์˜ํ•ฉ๋‹ˆ๋‹ค! ๋ฒˆ๊ฑฐ๋กœ์›€ ์—†์ด ๋น ๋ฅด๊ฒŒ Ultralytics ์„œ๋น„์Šค์™€ ํ†ตํ•ฉํ•˜๊ณ  ์‹ถ๋‹ค๋ฉด ์ œ๋Œ€๋กœ ์ฐพ์•„ ์˜ค์…จ์Šต๋‹ˆ๋‹ค. HUB-SDK ์„ค์น˜ ๊ฐ€์ด๋“œ๋Š” ๋ช…ํ™•ํ•œ ๋‹จ๊ณ„๋ณ„ ์ง€์นจ์„ ํ†ตํ•ด ๋น ๋ฅธ ์‹œ๊ฐ„ ๋‚ด์— ์„œ๋น„์Šค๋ฅผ ์‹œ์ž‘ํ•  ์ˆ˜ ์žˆ๋„๋ก ์„ค๊ณ„๋˜์—ˆ์Šต๋‹ˆ๋‹ค. ์ˆ™๋ จ๋œ ๊ฐœ๋ฐœ์ž์ด๋“  ์ด์ œ ๋ง‰ ์‹œ์ž‘ํ•œ ๊ฐœ๋ฐœ์ž์ด๋“  ์‰ฝ๊ณ  ๊ฐ„๋‹จํ•œ ์„ค์น˜ ํ”„๋กœ์„ธ์Šค๋ฅผ ์ œ๊ณตํ•˜๋Š” ๊ฒƒ์ด ๋ชฉํ‘œ์ž…๋‹ˆ๋‹ค. ๊ทธ๋Ÿฌ๋‹ˆ ์ข‹์•„ํ•˜๋Š” ์Œ๋ฃŒ๋ฅผ ๋“ค๊ณ  ํ•จ๊ป˜ ์„ค์น˜ ์—ฌ์ •์„ ์‹œ์ž‘ํ•ด๋ณด์„ธ์š”!

์ „์ œ ์กฐ๊ฑด

์„ค์น˜์˜ ํ•ต์‹ฌ์„ ์‚ดํŽด๋ณด๊ธฐ ์ „์— ํ•„์š”ํ•œ ๋„๊ตฌ๊ฐ€ ๋ชจ๋‘ ์ค€๋น„๋˜์–ด ์žˆ๋Š”์ง€ ํ™•์ธํ•ด ๋ณด๊ฒ ์Šต๋‹ˆ๋‹ค. ์›ํ™œํ•œ ์„ค์น˜ ํ”„๋กœ์„ธ์Šค๋Š” ์˜ฌ๋ฐ”๋ฅธ ์„ค์ •์—์„œ ์‹œ์ž‘๋˜๋ฏ€๋กœ ์ค€๋น„ํ•ด์•ผ ํ•  ๋„๊ตฌ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค:

  • Python: HUB-SDK๋ฅผ ์‚ฌ์šฉํ•˜๋ ค๋ฉด ์ปดํ“จํ„ฐ์— Python ์ด ์„ค์น˜๋˜์–ด ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์‹œ์Šคํ…œ์— ์•„์ง ์„ค์น˜๋˜์–ด ์žˆ์ง€ ์•Š์€ ๊ฒฝ์šฐ python.org์—์„œ ์ตœ์‹  ๋ฒ„์ „์„ ๋‹ค์šด๋กœ๋“œํ•˜์„ธ์š”.

  • Git(์„ ํƒ ์‚ฌํ•ญ): Git์€ HUB-SDK๋ฅผ ์„ค์น˜ํ•˜๋Š” ๋ฐ ํ•„์ˆ˜์ ์ธ ๊ฒƒ์€ ์•„๋‹ˆ์ง€๋งŒ, ์ตœ์‹  ๊ธฐ๋Šฅ์„ ์†Œ์Šค์—์„œ ๋ฐ”๋กœ ์‚ฌ์šฉํ•˜๋ ค๋Š” ๊ฒฝ์šฐ ๊ฐ•๋ ฅํžˆ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค. Git์€ git-scm.com์—์„œ ๋‹ค์šด๋กœ๋“œํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ด๋Ÿฌํ•œ ์ „์ œ ์กฐ๊ฑด์ด ํ•ด๊ฒฐ๋˜์—ˆ์œผ๋ฏ€๋กœ ์„ค์น˜ ๋‹จ๊ณ„๋กœ ๋„˜์–ด๊ฐˆ ์ค€๋น„๊ฐ€ ๋œ ๊ฒƒ์ž…๋‹ˆ๋‹ค.

์„ค์น˜ ๋ฐฉ๋ฒ•

ํ•„์š”์— ๋”ฐ๋ผ ๋‘ ๊ฐ€์ง€ ๊ธฐ๋ณธ ๋ฐฉ๋ฒ• ์ค‘ ํ•˜๋‚˜๋ฅผ ์„ ํƒํ•˜์—ฌ HUB-SDK๋ฅผ ์„ค์น˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ฐ ๊ฒฝ๋กœ๊ฐ€ ์ œ๊ณตํ•˜๋Š” ๊ธฐ๋Šฅ์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค:

PyPI์—์„œ ์„ค์น˜

์•ˆ์ •์„ฑ๊ณผ ์„ค์น˜ ํŽธ์˜์„ฑ์„ ์›ํ•˜์‹ ๋‹ค๋ฉด PyPI์—์„œ ์ตœ์‹  ์•ˆ์ • ๋ฒ„์ „์˜ HUB-SDK๋ฅผ ์„ค์น˜ํ•˜๋Š” ๊ฒƒ์ด ์ข‹์Šต๋‹ˆ๋‹ค. Python ์˜ ํŒจํ‚ค์ง€ ์ธ์Šคํ†จ๋Ÿฌ์ธ pip๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์„ค์น˜ํ•˜๋Š” ๋ฐฉ๋ฒ•์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค:

pip install hub-sdk

์ด ๋ช…๋ น์„ ์‹คํ–‰ํ•˜๋ฉด ์•ˆ์ •๋œ ๋ฒ„์ „์˜ HUB-SDK๋ฅผ ๊ฐ€์ ธ์™€ Python ํ™˜๊ฒฝ์— ๋ฐ”๋กœ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค. HUB-SDK๋ฅผ ์‹œ์ž‘ํ•˜๋Š” ๊ฐ€์žฅ ๋น ๋ฅธ ๋ฐฉ๋ฒ•์ž…๋‹ˆ๋‹ค.

HUBClient ์ดˆ๊ธฐํ™”

์„ค์น˜๊ฐ€ ์™„๋ฃŒ๋˜๋ฉด ์ด์ œ HUBClient๋ฅผ ์‚ฌ์šฉํ•  ์ฐจ๋ก€์ž…๋‹ˆ๋‹ค. HUBClient๋Š” Ultralytics ์—์ฝ”์‹œ์Šคํ…œ๊ณผ์˜ ์ธํ„ฐํŽ˜์ด์Šค๋ฅผ ์œ„ํ•œ ๊ฒŒ์ดํŠธ์›จ์ด๊ฐ€ ๋  ๊ฒƒ์ž…๋‹ˆ๋‹ค. ์•„๋ž˜์—์„œ ํด๋ผ์ด์–ธํŠธ๋ฅผ ์ธ์ฆํ•˜๊ณ  ์‚ฌ์šฉํ•˜๋Š” ๋‘ ๊ฐ€์ง€ ๋ฐฉ๋ฒ•์„ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์˜ต์…˜ A: ์ธ์ฆ์— API ํ‚ค ์‚ฌ์šฉ

๊ฐ„ํŽธํ•จ๊ณผ ๋ณด์•ˆ์„ ์œ„ํ•ด API ํ‚ค๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์„ ์„ ํ˜ธํ•˜๋Š” ๋ถ„๋“ค์„ ์œ„ํ•ด ์„ค์ • ๋ฐฉ๋ฒ•์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค:

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"}

๋Œ€์‹  Ultralytics ์—์„œ ์ œ๊ณตํ•œ ์‹ค์ œ API ํ‚ค๋ฅผ ์‚ฝ์ž…ํ•ฉ๋‹ˆ๋‹ค. <YOUR-API-KEY>. API์— ์•ก์„ธ์Šคํ•˜๊ธฐ ์œ„ํ•ด ๋ณด์•ˆ ํ‚ค๊ฐ€ ํ•„์š”ํ•œ ๊ฒฝ์šฐ ์ด ๋ฐฉ๋ฒ•์„ ์„ ํ˜ธํ•ฉ๋‹ˆ๋‹ค.

์˜ต์…˜ B: ์ธ์ฆ์— ์ด๋ฉ”์ผ/๋น„๋ฐ€๋ฒˆํ˜ธ ์Œ ์‚ฌ์šฉ

์ด๋ฉ”์ผ/๋น„๋ฐ€๋ฒˆํ˜ธ ์กฐํ•ฉ์„ ์‚ฌ์šฉํ•ด์•ผ ํ•˜๋Š” ๊ฒฝ์šฐ์—๋„ ๋งˆ์ฐฌ๊ฐ€์ง€๋กœ ๊ฐ„๋‹จํ•ฉ๋‹ˆ๋‹ค:

from hub_sdk import HUBClient

credentials = {"email": "<YOUR-EMAIL>", "password": "<YOUR-PASSWORD>"}

๊ต์ฒด <YOUR-EMAIL> ๊ทธ๋ฆฌ๊ณ  <YOUR-PASSWORD> ๋กœ๊ทธ์ธ ์ž๊ฒฉ ์ฆ๋ช…์œผ๋กœ ๋กœ๊ทธ์ธํ•ฉ๋‹ˆ๋‹ค. ์ด ์ ‘๊ทผ ๋ฐฉ์‹์€ ๋” ์ „ํ†ต์ ์ด์ง€๋งŒ ๋˜‘๊ฐ™์ด ๊ฐ•๋ ฅํ•ฉ๋‹ˆ๋‹ค.

๋งˆ์ง€๋ง‰์œผ๋กœ ์„ ํƒํ•œ ์ž๊ฒฉ ์ฆ๋ช… ๋ฉ”์„œ๋“œ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ HUBClient ๊ฐ์ฒด๋ฅผ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค:

HUB SDK ์ธ์ฆ

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"}  # api key
client = HUBClient(credentials)
from hub_sdk import HUBClient

credentials = {"email": "<YOUR-EMAIL>", "password": "<YOUR-PASSWORD>"}  # email and password
client = HUBClient(credentials)

์œ„์˜ ์ฝ”๋“œ ์ค„์„ ์‹คํ–‰ํ•˜๋ฉด Ultralytics ์„œ๋น„์Šค๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋‹ค์–‘ํ•œ ์ž‘์—…์„ ์ˆ˜ํ–‰ํ•  ์ค€๋น„๊ฐ€ ๋œ HUBClient ์ธ์Šคํ„ด์Šค๋ฅผ ์„ฑ๊ณต์ ์œผ๋กœ ์ƒ์„ฑํ–ˆ์Šต๋‹ˆ๋‹ค!


๋ชจ๋“  ์ค€๋น„๊ฐ€ ์™„๋ฃŒ๋˜์—ˆ์Šต๋‹ˆ๋‹ค! ์ด์ œ HUB-SDK๊ฐ€ ์„ค์น˜๋˜๊ณ  ์ดˆ๊ธฐํ™”๋œ HUBClient๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด์ œ๋ถ€ํ„ฐ Ultralytics ์—์ฝ”์‹œ์Šคํ…œ์—์„œ ์ œ๊ณตํ•˜๋Š” ๋‹ค์–‘ํ•œ ๊ธฐ๋Šฅ์„ ์‚ดํŽด๋ณผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ํ”„๋กœ์ ํŠธ์— HUB-SDK์˜ ๊ฐ•๋ ฅํ•œ ์„ฑ๋Šฅ๊ณผ ์œ ์—ฐ์„ฑ์„ ํ™œ์šฉํ•˜๊ณ , ๋ฌธ์„œ๋ฅผ ํƒ์ƒ‰ํ•˜์—ฌ ๋” ๋งŽ์€ ๊ธฐ๋Šฅ์„ ์‚ดํŽด๋ณด๊ณ , ๋ฌธ์ œ๊ฐ€ ๋ฐœ์ƒํ•˜๋ฉด ํด๋ฆญ ํ•œ ๋ฒˆ์œผ๋กœ ์นœ์ ˆํ•œ ์ง€์›ํŒ€์— ๋ฌธ์˜ํ•˜์„ธ์š”. ํ–‰๋ณตํ•œ ์ฝ”๋”ฉ!


๋Œ“๊ธ€