Transformers documentation

๐Ÿค— Transformers์— ๊ธฐ์—ฌํ•˜๊ธฐ

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

๐Ÿค— Transformers์— ๊ธฐ์—ฌํ•˜๊ธฐ

๊ธฐ์—ฌ ๊ทœ์น™

PR์„ ์—ด ์ˆ˜ ์žˆ๋Š” ๋ฐฉ๋ฒ•์€ ๋‘ ๊ฐ€์ง€์ž…๋‹ˆ๋‹ค. ๊ธฐ์—ฌ๊ฐ€ ๊ฐ€๋Šฅํ•œ ์ƒํƒœ์˜ ์ด์Šˆ๋ฅผ ์ˆ˜์ •ํ•˜๊ฑฐ๋‚˜, ์ž์ฒด ๊ทผ๊ฑฐ๋ฅผ ๊ฐ–์ถ˜ ๋…๋ฆฝ์ ์ธ PR์„ ์—ฌ๋Š” ๊ฒƒ์ž…๋‹ˆ๋‹ค. ์ƒˆ๋กœ์šด ๋ชจ๋ธ๋„ ๋…๋ฆฝ์ ์ธ PR์„ ํ†ตํ•ด ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ, ์ƒˆ๋กœ์šด ๋ชจ๋ธ ์ถ”๊ฐ€๋ฅผ ์ฐธ๊ณ ํ•˜์„ธ์š”. Hugging Face ์ง์›, ์œ ์ง€๋ณด์ˆ˜์ž ๋ฐ ์ผ๋ถ€ ์žฅ๊ธฐ ๊ธฐ์—ฌ์ž๋Š” ์ด๋Ÿฌํ•œ ๊ทœ์น™์˜ ์ ์šฉ ๋Œ€์ƒ์—์„œ ์ œ์™ธ๋ฉ๋‹ˆ๋‹ค.

์ด์Šˆ ์ˆ˜์ •. PR ์„ค๋ช…์— Fixes #123๊ณผ ๊ฐ™์€ ์ข…๋ฃŒ ํ‚ค์›Œ๋“œ๋ฅผ ํฌํ•จํ•˜์—ฌ ์ด์Šˆ๋ฅผ ์—ฐ๊ฒฐํ•˜์„ธ์š”. ๋‹ค์Œ ์ž‘์—…์„ ์ˆ˜ํ–‰ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:

  • ์œ ์ง€๋ณด์ˆ˜์ž๊ฐ€ triaged ๋ผ๋ฒจ์„ ๋ถ™์ธ ํ›„, ๋‹น์‹ ์ด ๋งŒ๋“  ์ด์Šˆ
  • contributions-welcome ๋ผ๋ฒจ์ด ๋ถ™์€ ์ด์Šˆ
  • New model ๋ผ๋ฒจ์ด ๋ถ™์€ ์ด์Šˆ๋ฅผ ํ™•์ธํ•˜์„ธ์š”. ์ƒˆ ๋ชจ๋ธ ์ถ”๊ฐ€

์œ ์ง€ ๊ด€๋ฆฌ์ž๊ฐ€ ๋ช…์‹œ์ ์œผ๋กœ ํ—ˆ์šฉํ•˜์ง€ ์•Š๋Š” ํ•œ, ๋‹ค๋ฅธ ์‚ฌ๋žŒ์˜ ์ด์Šˆ๋Š” PR์„ ์—ด ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ์ž‘์—…ํ•  ์ˆ˜ ์—†๋Š” ์ด์Šˆ๋ฅผ ๋งํฌํ•œ PR์€ ํ๊ธฐ๋ฉ๋‹ˆ๋‹ค.

์ž๊ฒฉ์ด ๋˜๋Š” ์ด์Šˆ๋ฅผ ์ž‘์—…ํ•˜๊ธฐ ์ „์— ํ—ˆ๋ฝ์„ ๊ตฌํ•  ํ•„์š”๊ฐ€ ์—†์œผ๋ฉฐ, ์ด์Šˆ๋ฅผ ํŠน์ •์ธ์—๊ฒŒ ๋ฐฐ์ •ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. โ€œ์ด๊ฒƒ์„ ์ž‘์—…ํ•ด๋„ ๋ ๊นŒ์š”?โ€ ๋˜๋Š” โ€œ์ด๊ฒƒ์„ ์ œ๊ฒŒ ๋ฐฐ์ •ํ•ด ์ฃผ์„ธ์š”โ€์™€ ๊ฐ™์€ ์ฝ”๋ฉ˜ํŠธ๋Š” ๋ถˆํ•„์š”ํ•œ ๋…ธ์ด์ฆˆ๋งŒ ์ถ”๊ฐ€ํ•˜๋ฏ€๋กœ ์ƒ๋žตํ•˜๊ณ  PR์„ ์—ด์–ด ์ฃผ์„ธ์š”. ํ•ด๋‹น ์ด์Šˆ์— ๋Œ€ํ•œ ์ฒซ ๋ฒˆ์งธ PR์ด ์šฐ์„ ์ˆœ์œ„๋ฅผ ๊ฐ–์Šต๋‹ˆ๋‹ค.

contributions-welcome ๋˜๋Š” New model ์ด์Šˆ๋ฅผ ์ž‘์—…ํ•˜๊ธฐ ์ „์— ์ด๋ฏธ ๋ˆ„๊ตฐ๊ฐ€๊ฐ€ ํ•ด๋‹น ์ด์Šˆ์— ๋Œ€ํ•œ PR์„ ์—ด์—ˆ๋Š”์ง€ ํ™•์ธํ•˜์„ธ์š”. ์ด๋ฏธ PR์ด ์—ด๋ ค ์žˆ๋‹ค๋ฉด ๋‹ค๋ฅธ PR์„ ์—ด์ง€ ๋งˆ์„ธ์š”. ์˜ค๋ฅ˜๋ฅผ ๋ฐœ๊ฒฌํ–ˆ๋‹ค๋ฉด ๊ธฐ์กด PR์— ์ˆ˜์ • ์ œ์•ˆ์„ ๋‚จ๊ธฐ์„ธ์š”. ๊ธฐ์กด PR์ด ๊ทผ๋ณธ์ ์œผ๋กœ ๊ฒฐํ•จ์ด ์žˆ๊ฑฐ๋‚˜ ๋ฐฉ์น˜๋œ ์ƒํƒœ์ผ ๋•Œ๋งŒ ๊ฒฝ์Ÿ PR์„ ์—ด ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋ฐฉ์น˜๋œ ์ƒํƒœ๋ž€, ์ €์ž๊ฐ€ ๋ฆฌ๋ทฐ ์ฝ”๋ฉ˜ํŠธ์— ์‘๋‹ตํ•˜์ง€ ์•Š๊ฑฐ๋‚˜ 2์ฃผ ๋™์•ˆ ๋ณ€๊ฒฝ ์‚ฌํ•ญ์„ pushํ•˜์ง€ ์•Š์€ ๊ฒฝ์šฐ๋ฅผ ์˜๋ฏธํ•ฉ๋‹ˆ๋‹ค. ์œ ์ง€๋ณด์ˆ˜์ž์˜ ๋ฆฌ๋ทฐ๋ฅผ ๊ธฐ๋‹ค๋ฆฌ๊ณ  ์žˆ๋Š” PR์€ ๋ฐฉ์น˜๋œ ์ƒํƒœ๋กœ ๊ฐ„์ฃผ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์–ด๋–ค ๊ฒฝ์šฐ๋“ , ์ž์‹ ์˜ PR์„ ์—ด๊ธฐ ์ „์— ์ด์Šˆ์—์„œ ๊ทธ ์ด์œ ๋ฅผ ์„ค๋ช…ํ•˜์„ธ์š”.

๋…๋ฆฝ PR. ์•„์ง ์•„๋ฌด๋„ ๋ฌธ์ œ๋ฅผ ๋ณด๊ณ ํ•˜์ง€ ์•Š์•˜๋‹ค๋ฉด, ์ด์Šˆ ์—†์ด PR์„ ์—ด ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋…๋ฆฝ PR์€ ๋ฒ„๊ทธ ์ˆ˜์ •, ์„ฑ๋Šฅ ๊ฐœ์„ , ๋ฌธ์„œ์˜ ๊นจ์ง„ ์˜ˆ์‹œ ์ˆ˜์ •์ฒ˜๋Ÿผ ์‹ค์ œ ์˜ํ–ฅ์ด ์žˆ๋Š” ์งง์€ ๋ณ€๊ฒฝ ์‚ฌํ•ญ์— ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. PR ์„ค๋ช…์—๋Š” ์ด์Šˆ์™€ ๋™์ผํ•œ ๊ทผ๊ฑฐ๊ฐ€ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค:

  • ๋ฒ„๊ทธ์— ๋Œ€ํ•ด, ๊ณต๊ฐœ๋œ ์ฒดํฌํฌ์ธํŠธ, ๊ธฐ๋ณธ ์„ค์ • ๋˜๋Š” ๋ฌธ์„œํ™”๋œ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ main์—์„œ ์‹คํŒจํ•˜๊ณ  ์ˆ˜์ • ์‚ฌํ•ญ์ด ์ ์šฉ๋˜๋ฉด ํ†ต๊ณผํ•˜๋Š” ์งง์€ ์Šคํฌ๋ฆฝํŠธ
  • ์„ฑ๋Šฅ ํ–ฅ์ƒ์„ ์ž…์ฆํ•˜๋ ค๋ฉด, ๊ณต๊ฐœ๋œ ์ฒดํฌํฌ์ธํŠธ๋‚˜ ๊ธฐ๋ณธ ์„ค์ •๊ณผ ๊ฐ™์€ ํ˜„์‹ค์ ์ธ ์›Œํฌ๋กœ๋“œ์—์„œ ์‹คํ–‰ ์ „ํ›„์˜ ์ˆ˜์น˜์™€ ์‹คํ–‰์— ์‚ฌ์šฉํ•œ ํ•˜๋“œ์›จ์–ด๋ฅผ ๋ช…์‹œํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ํ•ซ ํŒจ์Šค์— ์—†๋Š” ํ•จ์ˆ˜์˜ ๋” ๋น ๋ฅธ ๋งˆ์ดํฌ๋กœ๋ฒค์น˜๋งˆํฌ๋Š” ์ธ์ •๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

ํ•ด๋‹น ๋ฌธ์ œ์— ๋Œ€ํ•œ ์ด์Šˆ๊ฐ€ ์ด๋ฏธ ์กด์žฌํ•˜๋Š” ๊ฒฝ์šฐ, PR์„ ๋งํฌํ•˜๋“  ํ•˜์ง€ ์•Š๋“  ํ•ด๋‹น ์ด์Šˆ๋ฅผ ํ†ตํ•ด ์ง„ํ–‰๋ฉ๋‹ˆ๋‹ค. ๊ธฐ์กด ์ด์Šˆ๋ฅผ ์ˆ˜์ •ํ•˜๋Š” ๋‹จ๋… PR์ด๊ฑฐ๋‚˜ ์ฆ๊ฑฐ๊ฐ€ ์—†๋Š” PR์€ ํ๊ธฐ๋ฉ๋‹ˆ๋‹ค. ์ด๋Ÿฌํ•œ ์š”๊ตฌ ์‚ฌํ•ญ์€ ์ƒˆ๋กœ์šด ๋ชจ๋ธ์—๋Š” ์ ์šฉ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

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

๋‹ค๋ฅธ ์‚ฌ๋žŒ์˜ PR ๊ฒ€ํ† . ์ปค๋ฎค๋‹ˆํ‹ฐ์˜ ๋ฆฌ๋ทฐ๋Š” ์ƒˆ๋กœ์šด ์ •๋ณด๋ฅผ ์ œ๊ณตํ•ด ์ค„ ๋•Œ ํ™˜์˜ํ•˜์ง€๋งŒ, ์œ ์ง€๋ณด์ˆ˜์ž๋Š” PR์˜ ๋ชจ๋“  ์ฝ”๋ฉ˜ํŠธ๋ฅผ ์ฝ์œผ๋ฉฐ, ์ด๋ฏธ ์ž์ฒด ๋ฆฌ๋ทฐ ๋„๊ตฌ๋ฅผ ์‹คํ–‰ํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค. ์ž์‹ ์ด ์—ด์ง€ ์•Š์€ PR์— ์ฝ”๋ฉ˜ํŠธ๋ฅผ ๋‚จ๊ธฐ๊ธฐ ์ „์—, ๊ตฌ์ฒด์ ์œผ๋กœ ์–ธ๊ธ‰ํ•  ๋‚ด์šฉ์ด ์žˆ๋Š”์ง€ ํ™•์ธํ•˜์„ธ์š”:

  • ๋ฌธ์ œ๋ฅผ ๋ฐœ๊ฒฌํ–ˆ๊ฑฐ๋‚˜ ๊ตฌ์ฒด์ ์ธ ๋ณ€๊ฒฝ ์‚ฌํ•ญ์„ ์ œ์•ˆํ•  ๊ฒฝ์šฐ, ๊ด€๋ จ ๋ผ์ธ์— ์ธ๋ผ์ธ ์ฝ”๋ฉ˜ํŠธ๋ฅผ ๋‚จ๊ฒจ ์ฃผ์„ธ์š”. ๊ฐ€๋Šฅํ•˜๋ฉด ์ €์ž๊ฐ€ ๋ฐ”๋กœ ์ ์šฉํ•  ์ˆ˜ ์žˆ๋Š” GitHub suggestion ํ˜•์‹์œผ๋กœ ์ž‘์„ฑํ•˜๋Š” ๊ฒƒ์ด ์ข‹์Šต๋‹ˆ๋‹ค. ๋ฒ„๊ทธ๋ฅผ ๋ณด๊ณ ํ•˜๋Š” ๊ฒฝ์šฐ ์žฌํ˜„ ์ฝ”๋“œ(reproducer)๋ฅผ ํ•จ๊ป˜ ์ œ๊ณตํ•˜๋ฉด ๋„์›€์ด ๋ฉ๋‹ˆ๋‹ค.
  • PR์ด ์ˆ˜์ •ํ•˜๋Š” ๋ฌธ์ œ๋ฅผ ๋ณด๊ณ ํ•œ ๊ฒฝ์šฐ, ํ•ด๋‹น PR์ด ์‚ฌ์šฉ์ž์˜ ๋ฌธ์ œ๋ฅผ ํ•ด๊ฒฐํ•˜๋Š”์ง€ ์—ฌ๋ถ€๋ฅผ ๊ฐ„๋‹จํžˆ ์•Œ๋ ค์ฃผ๋Š” ๊ฒƒ์ด ๋งค์šฐ ์œ ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • ์ผ๋ฐ˜์ ์ธ ์š”์•ฝ์ด๋‚˜ โ€œ์ด๊ฒƒ์„ ํ…Œ์ŠคํŠธํ–ˆ๊ณ  ์ž‘๋™ํ•ฉ๋‹ˆ๋‹คโ€๋ผ๋Š” ๋ณด๊ณ ๋Š” ๊ฒŒ์‹œํ•˜์ง€ ๋งˆ์„ธ์š”. ์œ ์ง€๋ณด์ˆ˜์ž๊ฐ€ ์•„๋‹Œ ์‚ฌ๋žŒ์˜ ์Šน์ธ ์—ฌ๋ถ€๋Š” PR์ด ๋ณ‘ํ•ฉ๋˜๋Š”์ง€์— ์˜ํ–ฅ์„ ์ฃผ์ง€ ์•Š์œผ๋ฉฐ, PR ๋‚ด์šฉ์„ ๋ฐ˜๋ณตํ•˜๋Š” ๊ธด ์ฝ”๋ฉ˜ํŠธ๋Š” ๊ฒฐ๊ณผ๋ฅผ ๋ฐ”๊พธ์ง€ ์•Š์œผ๋ฉด์„œ๋„ ์‹œ๊ฐ„์„ ์†Œ๋ชจ์‹œํ‚ต๋‹ˆ๋‹ค.

์ฝ”๋“œ๋ฅผ ์ž‘์„ฑํ•˜๋Š” ๋ฐฉ์‹์€ ์‚ฌ์šฉ์ž์˜ ์žฌ๋Ÿ‰์ด์ง€๋งŒ, ์ œ์ถœํ•˜๋Š” ๋ชจ๋“  ๋‚ด์šฉ์— ๋Œ€ํ•ด ์ฑ…์ž„์ด ์žˆ์œผ๋ฉฐ, ์ €ํ’ˆ์งˆ์˜ ์ด์Šˆ๋‚˜ PR์„ ๋ฐ˜๋ณต์ ์œผ๋กœ ์ƒ์„ฑํ•˜๋Š” ๊ณ„์ •์€ ์ฐจ๋‹จ๋  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋˜ํ•œ, ํ–‰๋™ ๊ฐ•๋ น์„ ์ค€์ˆ˜ํ•ด ์ฃผ์‹œ๊ธฐ ๋ฐ”๋ž๋‹ˆ๋‹ค.

What we look for in issues and PRs
  • ๋ฒ„๊ทธ์˜ ๋ช…ํ™•ํ•œ ์ง„๋‹จ. ๋น ๋ฅธ ์šฐํšŒ์ฑ…์€ ์ฝ”๋“œ ๋ถ€ํ’€๋ฆผ์ด๋‚˜ ๋‹ค๋ฅธ ๋ชจ๋ธ๊ณผ์˜ ํ˜ธํ™˜์„ฑ ๋ฌธ์ œ๋ฅผ ์ผ์œผํ‚ฌ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋ฌธ์ œ์˜ ์ •ํ™•ํ•œ ์›์ธ์„ ์ถ”์ ํ•˜๋Š” ๋ฐ ์‹œ๊ฐ„์„ ํˆฌ์žํ•˜๋Š” ๊ฒƒ, ํŠนํžˆ ํ•ด๋‹น ๋ฌธ์ œ๊ฐ€ ์ฒ˜์Œ ๋ฐœ์ƒํ•œ ์ปค๋ฐ‹์„ ์ฐพ๋Š” ๊ฒƒ(์˜ˆ: git bisect ์‚ฌ์šฉ)์€ ๋งค์šฐ ๊ฐ€์น˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • diff๋ฅผ ์ตœ์†Œํ™”ํ•˜์„ธ์š”. PR์„ ํ™•์ธํ•˜์—ฌ ๋ถˆํ•„์š”ํ•œ ๋ณ€๊ฒฝ ์‚ฌํ•ญ์„ ์ œ๊ฑฐํ•˜์„ธ์š”. ํ…Œ์ŠคํŠธ ์Šคํฌ๋ฆฝํŠธ๋‚˜ ๊ด€๋ จ ์—†๋Š” ํŒŒ์ผ์„ ์ปค๋ฐ‹ํ•˜์ง€ ์•Š์•˜๋Š”์ง€ ํ™•์ธํ•˜์„ธ์š”. ์ •๋ง๋กœ ํ•„์š”ํ•œ ๊ฒฝ์šฐ์—๋งŒ ์ฃผ์„์„ ์ถ”๊ฐ€ํ•˜์„ธ์š”. PR์ด 1์ค„ ์ˆ˜์ •์œผ๋กœ ํ•ด๊ฒฐ๋  ์ˆ˜ ์žˆ๋‹ค๋ฉด, 1์ค„ ์ˆ˜์ •์œผ๋กœ ๋งŒ๋“œ์„ธ์š”. ์ด๋ ‡๊ฒŒ ํ•˜๋ฉด PR ๋ฆฌ๋ทฐ๊ฐ€ ํ›จ์”ฌ ์‰ฌ์›Œ์ง€๊ณ  ์Šน์ธ๋  ๊ฐ€๋Šฅ์„ฑ์ด ๋†’์•„์ง‘๋‹ˆ๋‹ค.
  • ๋ฌธ์ œ๋ฅผ ์žฌํ˜„ํ•˜๋Š” ๋ฐ ์‹œ๊ฐ„์„ ํˆฌ์žํ•˜์„ธ์š”. ์‚ฌ์šฉ์ž๊ฐ€ ๋ฌธ์ œ๋ฅผ ๋ณด๊ณ ํ•˜๋Š” ๊ฒฝ์šฐ, ์‹ค์ œ๋กœ๋Š” ํ•ด๋‹น ์‚ฌ์šฉ์ž์˜ ๋จธ์‹  ํ™˜๊ฒฝ ๋ฌธ์ œ์ด๊ฑฐ๋‚˜, ๋ฌธ์ œ๋ฅผ ์ž˜๋ชป ์ง„๋‹จํ•˜์—ฌ ์ž˜๋ชป๋œ ํ•ด๊ฒฐ์ฑ…์„ ์ œ์•ˆํ•˜๋Š” ๊ฒฝ์šฐ๊ฐ€ ๋งค์šฐ ๋งŽ์Šต๋‹ˆ๋‹ค. ๋ณด๊ณ  ๋‚ด์šฉ์„ ๋„ˆ๋ฌด ๋ฏฟ์œผ๋ฉด, ๋•Œ๋กœ๋Š” ์กด์žฌํ•˜์ง€ ์•Š๋Š” ๋ฌธ์ œ์— ๋Œ€ํ•ด ์ž˜๋ชป๋œ ํ•ด๊ฒฐ์ฑ…์ด ๋„์ถœ๋ฉ๋‹ˆ๋‹ค! ๊ฐ„๋‹จํ•œ ์žฌํ˜„ ์Šคํฌ๋ฆฝํŠธ๋ฅผ ์ž‘์„ฑํ•˜๊ณ  ์‹คํ–‰ํ•˜์—ฌ ๋ฌธ์ œ๊ฐ€ ์‹ค์ œ๋กœ ํ™•์ธ๋˜๋Š”์ง€ ํ™•์ธํ•˜๋Š” ๊ฒƒ์€ ๋งค์šฐ ๊ฐ€์น˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ๋‹ค๋ฅธ ๋ชจ๋ธ๊ณผ ๋น„๊ตํ•˜์„ธ์š”. Transformers ์ €์žฅ์†Œ๋Š” ๋งค์šฐ ํฌ๋ฉฐ, ๋งŽ์€ ๋ชจ๋ธ์ด ์œ ์‚ฌํ•œ ์ž‘์—…์„ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค. ๋ฒ„๊ทธ๋ฅผ ์ˆ˜์ •ํ•  ๋•Œ, ํ•ด๋‹น ๋ฒ„๊ทธ๊ฐ€ ๋‹ค๋ฅธ ๋ชจ๋ธ์—๋„ ์กด์žฌํ•˜๋Š”์ง€ ํ™•์ธํ•˜๋Š” ๊ฒƒ์ด ์œ ์šฉํ•ฉ๋‹ˆ๋‹ค. PR์— โ€œ(๋‹ค๋ฅธ ๋ชจ๋ธ)๊ณผ ๋™์ผํ•œ ์ ‘๊ทผ ๋ฐฉ์‹์„ ์‚ฌ์šฉํ•˜์—ฌ ์ˆ˜์ •ํ–ˆ์Šต๋‹ˆ๋‹คโ€๋ผ๊ณ  ๊ด€๋ จ ์ฝ”๋“œ ๋งํฌ์™€ ํ•จ๊ป˜ ๋ช…์‹œํ•˜๋ฉด, ์ˆ˜์ •์ด ์ •ํ™•ํ•  ๊ฐ€๋Šฅ์„ฑ์ด ๋†’๊ณ  ๋‚˜๋จธ์ง€ ์ฝ”๋“œ๋ฒ ์ด์Šค์™€ ํ˜ธํ™˜๋จ์„ ๋ณด์—ฌ์ฃผ๊ธฐ ๋•Œ๋ฌธ์— ์œ ์ง€๋ณด์ˆ˜์ž์—๊ฒŒ ๋งค์šฐ ๋„์›€์ด ๋ฉ๋‹ˆ๋‹ค.
  • Avoid โ€œbusyworkโ€ PRs. We donโ€™t have time for small style changes or typo fixes in comments, and we donโ€™t accept fixes for โ€œtheoretical bugsโ€ found by code analysis that rarely if ever cause problems in practice, unless they can be exploited by an attacker.
  • ํ…Œ์ŠคํŠธ๋ฅผ ๋กœ์ปฌ๊ณผ CI์—์„œ ํ™•์ธํ•˜์„ธ์š”. PR์„ ์—ด๊ธฐ ์ „์— make fix-repo๋ฅผ ์‹คํ–‰ํ•˜๊ณ  utils/tests_fetcher.py๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ PR ๋ธŒ๋žœ์น˜์—์„œ ๋ณ€๊ฒฝํ•œ ํŒŒ์ผ๋“ค์„ ์ปค๋ฒ„ํ•˜๋Š” ํ…Œ์ŠคํŠธ ๋ชฉ๋ก์„ ํ™•์ธํ•˜์„ธ์š”. ํ•ด๋‹น ํ…Œ์ŠคํŠธ๋ฅผ ๋กœ์ปฌ์—์„œ ์‹คํ–‰ํ•˜์—ฌ PR์„ ์—ด๊ธฐ ์ „์— ํ†ต๊ณผํ•˜๋Š”์ง€ ํ™•์ธํ•˜์„ธ์š”. PR์„ ์—ฐ ํ›„์—๋Š” CI๊ฐ€ ๋…น์ƒ‰์œผ๋กœ ํ‘œ์‹œ๋˜๋Š”์ง€ ํ™•์ธํ•˜๊ณ , ๋ฆฌ๋ทฐ๋ฅผ ์š”์ฒญํ•˜๊ธฐ ์ „์— ๋ชจ๋“  ๋ฌธ์ œ๋ฅผ ์ˆ˜์ •ํ•˜์„ธ์š”. ์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ์•Œ๋ฆผ ์ŠคํŒธ์ด ํฌ๊ฒŒ ์ค„์–ด๋“ค์–ด ์œ ์ง€๋ณด์ˆ˜์ž์˜ ๋ถ€๋‹ด์„ ์ค„์ผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์„ค์ •

  1. GitHub์˜ Fork ๋ฒ„ํŠผ์„ ๋ˆŒ๋Ÿฌ Transformers๋ฅผ ํฌํฌํ•˜์—ฌ ๋‚ด ๊ณ„์ • ์•„๋ž˜์— ์‚ฌ๋ณธ์„ ๋งŒ๋“  ํ›„, ๋กœ์ปฌ๋กœ ํด๋ก ํ•˜์„ธ์š”.

    git clone git@github.com:<your Github handle>/transformers.git
    cd transformers
  2. upstream์ด๋ผ๋Š” ์ด๋ฆ„์˜ remote๋กœ Transformers ์ €์žฅ์†Œ๋ฅผ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค. origin์€ ๋‚ด ํฌํฌ๋ฅผ, upstream์€ ์†Œ์Šค ์˜ค๋ธŒ ํŠธ๋ฃจ์Šค๋ฅผ ๊ฐ€๋ฆฌํ‚ต๋‹ˆ๋‹ค. ์ด๋ฅผ ํ†ตํ•ด origin์— pushํ•˜๊ณ  PR์„ ์—ด๊ธฐ ์ „์— ๋กœ์ปฌ main์„ ๋™๊ธฐํ™”ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

    git remote add upstream https://github.com/huggingface/transformers.git
    git remote -v
    # origin    git@github.com:<your Github handle>/transformers.git (fetch)
    # origin    git@github.com:<your Github handle>/transformers.git (push)
    # upstream  https://github.com/huggingface/transformers.git (fetch)
    # upstream  https://github.com/huggingface/transformers.git (push)
  3. ํฌํฌ๋ฅผ ์ตœ์‹  ์ƒํƒœ๋กœ ์œ ์ง€ํ•˜๊ณ  ์ž‘์—…์„ ์‹œ์ž‘ํ•  ๋ธŒ๋žœ์น˜๋ฅผ ๋งŒ๋“œ์„ธ์š”. GitHub UI์˜ Sync fork ๋ฒ„ํŠผ์„ ์‚ฌ์šฉํ•˜์—ฌ ํฌํฌ๋ฅผ ๋™๊ธฐํ™”ํ•  ์ˆ˜๋„ ์žˆ์Šต๋‹ˆ๋‹ค.

    git checkout main && git pull upstream main && git push origin main
    git switch -c a-descriptive-name-for-my-branch
  4. ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ํŽธ์ง‘ ๊ฐ€๋Šฅ ๋ชจ๋“œ์—์„œ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค. ์Šคํƒ€์ผ ๋ฐ ํ’ˆ์งˆ ๊ฒ€์‚ฌ์— ํ•„์š”ํ•œ ๊ฐœ๋ฐœ ๋„๊ตฌ๊ฐ€ ํฌํ•จ๋˜์–ด ์žˆ์œผ๋ฏ€๋กœ ๋Œ€๋ถ€๋ถ„์˜ ๊ธฐ์—ฌ์—๋Š” [dev]๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”. ๋ชจ๋ธ ๊ธฐ์—ฌ์—๋Š” [torch,testing]์„, ์ „์ฒด ๊ฐœ๋ฐœ ์˜์กด์„ฑ ์„ธํŠธ๊ฐ€ ํ•„์š”ํ•˜์ง€ ์•Š์€ ๋ฌธ์„œ ์ „์šฉ ๋ณ€๊ฒฝ ์‚ฌํ•ญ ๋ฐ ์ž‘์€ ์ˆ˜์ •์—๋Š” [quality]๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.

    pip install -e ".[dev]"
    
    # for model contributions
    pip install -e ".[torch,testing]"
    
    # for docs-only changes and small fixes
    pip install -e ".[quality]"

Windows

Windows์—์„œ WSL์„ ์‚ฌ์šฉํ•˜์ง€ ์•Š๋Š” ๊ฒฝ์šฐ, git์„ ์„ค์ •ํ•˜์—ฌ CRLF ์ค„ ๋์„ LF๋กœ ๋ณ€ํ™˜ํ•˜๋„๋ก ํ•˜์„ธ์š”.

git config core.autocrlf input

Windows์—์„œ make ๋ช…๋ น์„ ์‹คํ–‰ํ•˜๋Š” ๋ฐฉ๋ฒ• ์ค‘ ํ•˜๋‚˜๋Š” MSYS2๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์ž…๋‹ˆ๋‹ค.

  1. MSYS2 ๋‹ค์šด๋กœ๋“œ (C:\msys64์— ์„ค์น˜๋˜์–ด ์žˆ๋‹ค๊ณ  ๊ฐ€์ •ํ•ฉ๋‹ˆ๋‹ค).
  2. ๋ช…๋ น์ค„ C:\msys64\msys2.exe๋ฅผ ์—ฝ๋‹ˆ๋‹ค(์‹œ์ž‘ ๋ฉ”๋‰ด์—์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค).
  3. ์…ธ์—์„œ pacman -Syu๋ฅผ ์‹คํ–‰ํ•˜๊ณ  pacman -S make๋กœ make๋ฅผ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค.
  4. PATH ํ™˜๊ฒฝ ๋ณ€์ˆ˜์— C:\msys64\usr\bin์„ ์ถ”๊ฐ€ํ•˜์„ธ์š”.

์ด์ œ ์–ด๋–ค ํ„ฐ๋ฏธ๋„(PowerShell, cmd.exe ๋“ฑ)์—์„œ๋“  make๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ด์Šˆ ์—ด๊ธฐ

์ด์Šˆ ํ…œํ”Œ๋ฆฟ์„ ์‚ฌ์šฉํ•˜๊ณ , ํ•ด๋‹น ์ด์Šˆ๊ฐ€ ์ด๋ฏธ ๋ณด๊ณ ๋˜์ง€ ์•Š์•˜๋Š”์ง€ ํ™•์ธํ•˜์„ธ์š”(GitHub์˜ Issues ์•„๋ž˜ ๊ฒ€์ƒ‰ ๋ฐ” ์‚ฌ์šฉ). ๋ฒ„๊ทธ ๋ณด๊ณ ์„œ๋Š” Transformers์˜ ๋ฒ„๊ทธ์— ๊ด€ํ•œ ๊ฒƒ์ด์–ด์•ผ ํ•˜๋ฉฐ, ์‚ฌ์šฉ์ž ์ž์‹ ์˜ ์ฝ”๋“œ์— ๊ด€ํ•œ ๊ฒƒ์ด์–ด์„œ๋Š” ์•ˆ ๋ฉ๋‹ˆ๋‹ค. ๋˜ํ•œ ์‹ค์ œ ์‚ฌ์šฉ๊ณผ ์‹ค์ œ ์ฒดํฌํฌ์ธํŠธ์— ์˜ํ–ฅ์„ ์ฃผ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์ฝ”๋“œ๋ฅผ ์ฝ์–ด์„œ ๋ฐœ๊ฒฌํ•œ โ€œ์ด๋ก ์  ๋ฒ„๊ทธโ€๋กœ, ํŠธ๋ฆฌ๊ฑฐ๋ฅผ ์œ„ํ•ด ๋งค์šฐ ๋น„ํ‘œ์ค€์ ์ธ ์„ค์ •์ด ํ•„์š”ํ•œ ๊ฒฝ์šฐ ๋ณด์•ˆ ๋ฌธ์ œ๊ฐ€ ์•„๋‹Œ ํ•œ ๋ถ„๋ฅ˜(triage)๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์ตœ์‹  ๋ฆด๋ฆฌ์Šค ๋˜๋Š” main์—์„œ ๋ฒ„๊ทธ๋ฅผ ์žฌํ˜„ํ•˜๋Š” ์งง๊ณ  ์ž์ฒด ์™„๊ฒฐ๋œ ์Šคํฌ๋ฆฝํŠธ๋ฅผ ํฌํ•จํ•˜์„ธ์š”. ๊ณต๊ฐœ๋œ ์ฒดํฌํฌ์ธํŠธ๋‚˜ ๊ธฐ๋ณธ ์„ค์ •์„ ์‚ฌ์šฉํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์‹คํ–‰ ๊ฐ€๋Šฅํ•œ ์žฌํ˜„ ์Šคํฌ๋ฆฝํŠธ๊ฐ€ ์—†๋Š” ๋ฒ„๊ทธ ๋ณด๊ณ ์„œ๋Š” ๋ถ„๋ฅ˜๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

๋ฒ„๊ทธ๊ฐ€ ๋‚ด ์ฝ”๋“œ์— ์žˆ๋Š”์ง€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์— ์žˆ๋Š”์ง€ ํ™•์‹คํ•˜์ง€ ์•Š๋‹ค๋ฉด, ๋จผ์ € ํฌ๋Ÿผ์ด๋‚˜ Discord์—์„œ ์งˆ๋ฌธํ•ด ๋ณด์„ธ์š”. ์ด๋ ‡๊ฒŒ ํ•˜๋ฉด GitHub์ด ์‹คํ–‰ ๊ฐ€๋Šฅํ•œ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์ด์Šˆ์— ์ง‘์ค‘ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ƒˆ ๋ชจ๋ธ ์ถ”๊ฐ€

Transformers์— ๋ชจ๋ธ์„ ์ถ”๊ฐ€ํ•˜๋ฉด ๋ˆ„๊ตฌ๋‚˜ ํ•ด๋‹น ๋ชจ๋ธ์„ ๋กœ๋“œํ•˜๊ณ  ํŒŒ์ธํŠœ๋‹ํ•˜๊ฑฐ๋‚˜ ์ถ”๋ก ์„ ์‹คํ–‰ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ตฌํ˜„์„ ์‹œ์ž‘ํ•˜๊ธฐ ์ „์—, Transformers์— ์ด๋ฏธ ํฌํ•จ๋œ ์ตœ์‹  ์ตœ์ฒจ๋‹จ ๋ชจ๋ธ๊ณผ ์ž์‹ ์˜ ์•„ํ‚คํ…์ฒ˜ ๊ฐ„์˜ ์ฐจ์ด๋ฅผ ๋ถ„๋ฆฌํ•ด ๋ณด์„ธ์š”. ์ด์Šˆ๋‚˜ PR์—์„œ ์ด๋Ÿฌํ•œ ์ฐจ์ด๋ฅผ ์„ค๋ช…ํ•˜๋ฉด ๋ฆฌ๋ทฐ์–ด๊ฐ€ ๋ชจ๋ธ์ด ๊ฐ€์ ธ์˜ค๋Š” ๋„์ „ ๊ณผ์ œ, ๊ธฐ์กด ํŒจํ„ด์„ ์žฌ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋Š” ๋ถ€๋ถ„, ๋ชจ๋ธ ๊ฐ„์— ํ‘œ์ค€ํ™”ํ•ด์•ผ ํ•  ๋ถ€๋ถ„์„ ๋น ๋ฅด๊ฒŒ ์ดํ•ดํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์•„๋ž˜ ๊ฐ€์ด๋“œ๋ฅผ ๋”ฐ๋ฅด์„ธ์š”.

  1. ๋ชจ๋“ˆํ˜• Transformers๋กœ ๋ชจ๋ธ ์ถ”๊ฐ€ โ€” ๋ชจ๋“ˆ ํŒŒ์ผ๋กœ ๋ชจ๋ธ์„ ๊ตฌํ˜„ํ•˜๊ณ  ๋…๋ฆฝ์ ์ธ modeling ํŒŒ์ผ์„ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค.
  2. Docstring ์ž๋™ ์ƒ์„ฑ โ€” @auto_docstring ๋ฐ์ฝ”๋ ˆ์ดํ„ฐ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋ถˆํ•„์š”ํ•œ ์ฝ”๋“œ๋ฅผ ์ค„์ด๊ณ  ์ผ๊ด€๋œ docstring์„ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค.
  3. ํ…Œ์ŠคํŠธ โ€” ๋ชจ๋ธ์˜ ์ •ํ™•์„ฑ์„ ๊ฒ€์ฆํ•˜๊ณ  ๊ธฐ์—ฌ๋ฌผ์˜ ์œ ์ง€๋ณด์ˆ˜์„ฑ์„ ์œ ์ง€ํ•˜๊ธฐ ์œ„ํ•ด ๋ชจ๋ธ ํ…Œ์ŠคํŠธ๋ฅผ ์ž‘์„ฑํ•˜๊ณ  ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. ์ธ๊ณผ ์–ธ์–ด ๋ชจ๋ธ์˜ ๊ฒฝ์šฐ, ๊ฐ€๋Šฅํ•œ ํ•œ ์ธ๊ณผ LM ํ…Œ์Šคํ„ฐ๋ฅผ ์ƒ์†๋ฐ›์Šต๋‹ˆ๋‹ค. ์‹ค์ œ ์ฒดํฌํฌ์ธํŠธ์— ๋Œ€ํ•ด ํ”„๋กœ์„ธ์„œ, ํ† ํฌ๋‚˜์ด์ €, ๋ชจ๋ธ์˜ ์ „์ฒด ๊ฒฝ๋กœ๋ฅผ ๊ฒ€์ฆํ•˜๋ฏ€๋กœ ํ†ตํ•ฉ ํ…Œ์ŠคํŠธ๋ฅผ ์šฐ์„ ์‹œํ•ฉ๋‹ˆ๋‹ค.
  4. ๋ชจ๋ธ ๊ตฌ์กฐ ๊ทœ์น™ โ€” make typing์— ์˜ํ•ด ๊ฐ•์ œ๋˜๋Š” ์ •์  ๋ชจ๋ธ ๊ตฌ์กฐ ๊ทœ์น™์„ ํŒŒ์ผ์ด ํ†ต๊ณผํ•˜๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

์ผ๋ถ€ ๋ชจ๋ธ ์ถ”๊ฐ€์—๋Š” ์ถ”๊ฐ€์ ์ธ ํ†ตํ•ฉ ์ž‘์—…์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.

๋ชจ๋ธ ์ถ”๊ฐ€ ํƒ€์ž„๋ผ์ธ

๋ชจ๋ธ ๊ธฐ์—ฌ์ž์™€ ์ปค๋ฎค๋‹ˆํ‹ฐ์˜ ์•„ํ‚คํ…์ฒ˜ ์ˆ˜์š”์— ๋”ฐ๋ผ ๋ชจ๋ธ ์ถ”๊ฐ€๋ฅผ ์œ„ํ•œ ๋„ค ๊ฐ€์ง€ ํƒ€์ž„๋ผ์ธ์ด ์žˆ์Šต๋‹ˆ๋‹ค.

  • Day-0 ํ†ตํ•ฉ: ๋ชจ๋ธ ๋ฆด๋ฆฌ์Šค ๋‹น์ผ ์ƒˆ๋กœ์šด ๋ฒ„์ „ ๋ฆด๋ฆฌ์Šค๋ฅผ ํ†ตํ•ด Transformers์—์„œ ๋ชจ๋ธ์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•ฉ๋‹ˆ๋‹ค. ๊ฐ€์žฅ ์ค‘์š”ํ•œ ํ•ต์‹ฌ ๊ธฐ๋Šฅ(์–‘์žํ™”, FlashAttention, KV-cache ๋“ฑ)์— ๋Œ€ํ•œ ์ง€์›์„ ์ œ๊ณตํ•˜๋ฉฐ, ์ดˆ๊ธฐ ์ดˆ์•ˆ์„ ๊ฒ€ํ† ํ•˜๊ณ , ์ผ์ • ์ƒํ™ฉ์— ๋”ฐ๋ผ ๋ชจ๋ธ ๊ตฌํ˜„๋„ ๋‹ด๋‹นํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

    ์ƒˆ๋กœ์šด ์•„ํ‚คํ…์ฒ˜์˜ ๊ฒฝ์šฐ ํŠนํžˆ ๋ช‡ ์ฃผ ์ „์— transformers@huggingface.co๋กœ ์ด๋ฉ”์ผ์„ ๋ณด๋‚ด ์ฃผ์„ธ์š”. ์ฒดํฌํฌ์ธํŠธ์™€ ๋ฆด๋ฆฌ์Šค๊ฐ€ ์ค€๋น„๋  ๋•Œ๊นŒ์ง€ ๋น„๊ณต๊ฐœ ํฌํฌ๋ฅผ ํ†ตํ•ด ํ•จ๊ป˜ ๋ฐ˜๋ณต ์ž‘์—…์„ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

  • ๊ฐ™์€ ์ฃผ ๋‚ด ํ†ตํ•ฉ: ์ˆ˜์š”๊ฐ€ ๋†’์€ ๋ชจ๋ธ์€ ์ €์ž๊ฐ€ ์ง์ ‘ ์—ฐ๋ฝํ•˜์ง€ ์•Š์•„๋„ ๋ณดํ†ต ์ผ์ฃผ์ผ ์ด๋‚ด์— ๋“ฑ๋ก๋ฉ๋‹ˆ๋‹ค.

    new model template๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์ด์Šˆ๋ฅผ ์—ด์–ด ์š”์ฒญํ•˜์„ธ์š”. ํ™œ๋™์ด ๋งŽ์€ ์ด์Šˆ์ผ์ˆ˜๋ก ๋Œ€๊ธฐ ์ˆœ์„œ๊ฐ€ ๋” ๋นจ๋ฆฌ ์˜ฌ๋ผ๊ฐ‘๋‹ˆ๋‹ค.

  • ๋ฆด๋ฆฌ์Šค ํ›„ ํ†ตํ•ฉ: ์ˆ˜์š”๊ฐ€ ๊ฐ•ํ•˜์ง€ ์•Š๊ฑฐ๋‚˜, ์šฐ๋ฆฌ๊ฐ€ ์ฒ˜๋ฆฌํ•  ์—ฌ์œ ๊ฐ€ ์—†๋Š” ๋ชจ๋ธ์€ ์—…์ŠคํŠธ๋ฆผ ๋ฆด๋ฆฌ์Šค ์ดํ›„์— ๋ฐ˜์˜๋ฉ๋‹ˆ๋‹ค.

    ์™ธ๋ถ€ ๊ธฐ์—ฌ์ž๋Š” ์ด์Šˆ๋ฅผ ๋งŒ๋“ค๊ฑฐ๋‚˜ ๋งŒ๋“ค์ง€ ์•Š๊ณ  ์ƒˆ ๋ชจ๋ธ์— ๋Œ€ํ•œ PR์„ ์ง์ ‘ ์—ด ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์‹œ์ž‘ํ•˜๊ธฐ ์ „์— ์ด๋ฏธ ๋ˆ„๊ตฐ๊ฐ€๊ฐ€ ํ•ด๋‹น ๋ชจ๋ธ์„ ์ถ”๊ฐ€ํ•˜๊ณ  ์žˆ๋Š”์ง€ ํ™•์ธํ•˜๊ธฐ ์œ„ํ•ด ์—ด๋ฆฐ โ€œNew modelโ€ ์ด์Šˆ์™€ ์—ด๋ฆฐ PR์„ ํ™•์ธํ•˜์„ธ์š”. ๊ฒ€ํ† ํ•˜๊ณ  ์•ˆ๋‚ดํ•ด ๋“œ๋ฆฌ๊ฒ ์Šต๋‹ˆ๋‹ค.

  • Hub ์šฐ์„  ๋ฆด๋ฆฌ์Šค: Transformers์˜ remote-code ์ง€์›์„ ํ†ตํ•ด ๋ชจ๋ธ์„ Hub์— ์ง์ ‘ ๋ฐฐํฌํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ, ์—…์ŠคํŠธ๋ฆผ PR์ด ํ•„์š”ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

    Hub-first๋กœ ์ œ๊ณต๋˜๋Š” ์ธ๊ธฐ ์žˆ๋Š” ๋ชจ๋ธ์€ ๋‚˜์ค‘์— Transformers์— ํ†ตํ•ฉ๋˜๋Š” ๊ฒฝ์šฐ๊ฐ€ ๋งŽ์Šต๋‹ˆ๋‹ค. ์ด๋ฅผ ํ†ตํ•ด 1๊ธ‰ ๋ฌธ์„œ, ์œ ์ง€๋ณด์ˆ˜ ๋ฐ ์ตœ์ ํ™” ๊ธฐ๋Šฅ์ด ํ™œ์„ฑํ™”๋ฉ๋‹ˆ๋‹ค. Hub-first๋Š” ๋ชจ๋ธ์„ ์ถ”๊ฐ€ํ•˜๋Š” ๊ฐ€์žฅ ์ ์€ ๋งˆ์ฐฐ์˜ ๋ฐฉ๋ฒ•์ž…๋‹ˆ๋‹ค. ๊ทธ๋Ÿฌ๋‚˜ ๋ชจ๋ธ์ด ๊ฐ€์ค‘์น˜ ๋ณ€ํ™˜์ด๋‚˜ ๊ธฐํƒ€ ํ•˜์œ„ ํ˜ธํ™˜์„ฑ ๋ฌธ์ œ๋ฅผ ์š”๊ตฌํ•˜๋Š” ๊ฒฝ์šฐ ๋” ์ทจ์•ฝํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

Docs

์†Œ์Šค ํŒŒ์ผ์—์„œ ์ƒ์„ฑ๋œ API ์ฐธ์กฐ์˜ ๊ฒฝ์šฐ, ํ•ด๋‹น๋˜๋Š” ๊ฒฝ์šฐ @auto_docstring ๋ฐ์ฝ”๋ ˆ์ดํ„ฐ๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”. ๋ฌธ์„œ ํŽธ์ง‘ ๋ฐฉ๋ฒ•๊ณผ ์šฐ๋ฆฌ๊ฐ€ ์‚ฌ์šฉํ•˜๋Š” ๊ตฌ๋ฌธ์— ๋Œ€ํ•œ ์ž์„ธํ•œ ๋‚ด์šฉ์€ ๋ฌธ์„œ README๋ฅผ ์ฐธ๊ณ ํ•˜์„ธ์š”.

Update on GitHub