demo-generator / README.md
hasune
[FIX] - README.md ์ˆ˜์ •
e5cae5b

A newer version of the Gradio SDK is available: 5.33.1

Upgrade
metadata
title: Demo Generator
emoji: ๐ŸŽฎ
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.31.0
app_file: app.py
pinned: false

๐ŸŽฎ Hugging Face Demo Generator

๋ชจ๋ธ๋ช…๋งŒ ์ž…๋ ฅํ•˜๋ฉด ๋ฐ”๋กœ ์ž‘๋™ํ•˜๋Š” Gradio ๋ฐ๋ชจ Space๋ฅผ ์ž๋™์œผ๋กœ ์ƒ์„ฑํ•ด์ฃผ๋Š” ๋„๊ตฌ์ž…๋‹ˆ๋‹ค.

โœจ ์ฃผ์š” ๊ธฐ๋Šฅ

๐Ÿ” ์Šค๋งˆํŠธ ๋ชจ๋ธ ๋ถ„์„

  • Hugging Face Hub ๋ชจ๋ธ ์ž๋™ ๋ถ„์„
  • ํƒœ์Šคํฌ ํƒ€์ž… ๋ฐ ํ˜ธํ™˜์„ฑ ์ž๋™ ๊ฐ์ง€
  • ์ง€์› ๊ฐ€๋Šฅ ์—ฌ๋ถ€ ์ฆ‰์‹œ ํŒ๋ณ„
  • ๋ชจ๋ธ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ ์ž๋™ ์ถ”์ถœ

๐ŸŽจ ํƒœ์Šคํฌ๋ณ„ ์ตœ์ ํ™”๋œ UI ์ƒ์„ฑ

  • ํ…์ŠคํŠธ ๋ถ„๋ฅ˜: ๊ฒฐ๊ณผ ์‹œ๊ฐํ™” + ์˜ˆ์‹œ ๋ฒ„ํŠผ
  • ์งˆ์˜์‘๋‹ต: ์ปจํ…์ŠคํŠธ/์งˆ๋ฌธ ๋ถ„๋ฆฌ ์ธํ„ฐํŽ˜์ด์Šค
  • ํ…์ŠคํŠธ ์ƒ์„ฑ: ์ฐฝ์˜์„ฑ ์ œ์–ด ์Šฌ๋ผ์ด๋”
  • ์š”์•ฝ: ์••์ถ•๋ฅ  ํ†ต๊ณ„ ํฌํ•จ
  • ๋ฒˆ์—ญ: ๊น”๋”ํ•œ ์ž…์ถœ๋ ฅ UI
  • ๋นˆ์นธ ์ฑ„์šฐ๊ธฐ: [MASK] ์˜ˆ์‹œ ์ œ๊ณต
  • ๊ฐœ์ฒด๋ช… ์ธ์‹: ์œ„์น˜ ์ •๋ณด ํฌํ•จ ๊ฒฐ๊ณผ

๐Ÿ“ฆ ์™„์ „ํ•œ ๋ฐฐํฌ ํŒจํ‚ค์ง€

  • app.py: ์™„์ „ ์ž‘๋™ํ•˜๋Š” Gradio ์•ฑ
  • requirements.txt: ํ•„์š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๋ชฉ๋ก
  • README.md: Space ์„ค์ • ๋ฐ ๋ฌธ์„œ
  • ZIP ๋‹ค์šด๋กœ๋“œ๋กœ ์ฆ‰์‹œ ๋ฐฐํฌ ๊ฐ€๋Šฅ

๐Ÿš€ ์‚ฌ์šฉ๋ฒ•

1๏ธโƒฃ ๋ชจ๋ธ ๋ถ„์„

์›ํ•˜๋Š” ํ—ˆ๊น…ํŽ˜์ด์Šค ๋ชจ๋ธ๋ช…์„ ์ž…๋ ฅํ•˜์„ธ์š”:

์˜ˆ์‹œ ๋ชจ๋ธ๋“ค:

  • klue/bert-base (ํ•œ๊ตญ์–ด ํ…์ŠคํŠธ ๋ถ„๋ฅ˜)
  • klue/roberta-large-ynat (ํ•œ๊ตญ์–ด ์ฃผ์ œ๋ถ„๋ฅ˜)
  • microsoft/DialoGPT-medium (๋Œ€ํ™” ์ƒ์„ฑ)
  • facebook/bart-large-cnn (์š”์•ฝ)
  • Helsinki-NLP/opus-mt-ko-en (ํ•œ์˜ ๋ฒˆ์—ญ)

2๏ธโƒฃ ๋ฐ๋ชจ ์„ค์ •

  • ์ œ๋ชฉ: Space์—์„œ ๋ณด์—ฌ์งˆ ๋ฐ๋ชจ ์ด๋ฆ„
  • ์„ค๋ช…: ๋ฐ๋ชจ์˜ ์šฉ๋„์™€ ๊ธฐ๋Šฅ ์„ค๋ช…

3๏ธโƒฃ ์ฝ”๋“œ ์ƒ์„ฑ ๋ฐ ๋‹ค์šด๋กœ๋“œ

  1. "๋ฐ๋ชจ ์ƒ์„ฑ" ๋ฒ„ํŠผ์œผ๋กœ ์ฝ”๋“œ ๋ฏธ๋ฆฌ๋ณด๊ธฐ
  2. "์™„์ „ํ•œ ํŒจํ‚ค์ง€ ์ƒ์„ฑ" ๋ฒ„ํŠผ์œผ๋กœ ZIP ํŒŒ์ผ ์ƒ์„ฑ
  3. ๋‹ค์šด๋กœ๋“œ ํ›„ ๋ฐ”๋กœ ์ƒˆ Space์— ์—…๋กœ๋“œ

๐ŸŽฏ ์ง€์›ํ•˜๋Š” AI ํƒœ์Šคํฌ

ํ…์ŠคํŠธ ๋ถ„๋ฅ˜ (Text Classification)

๊ฐ์ •๋ถ„์„, ์ฃผ์ œ๋ถ„๋ฅ˜, ์ŠคํŒธ ํƒ์ง€ ๋“ฑ์˜ ๋ถ„๋ฅ˜ ํƒœ์Šคํฌ๋ฅผ ์œ„ํ•œ ์ธํ„ฐํŽ˜์ด์Šค

์ƒ์„ฑ๋˜๋Š” ๊ธฐ๋Šฅ:

  • ํ…์ŠคํŠธ ์ž…๋ ฅ์ฐฝ
  • ๋ถ„๋ฅ˜ ๊ฒฐ๊ณผ ์‹œ๊ฐํ™”
  • ์‹ ๋ขฐ๋„ ํ‘œ์‹œ
  • ์˜ˆ์‹œ ํ…์ŠคํŠธ ๋ฒ„ํŠผ

์งˆ์˜์‘๋‹ต (Question Answering)

๋ฌธ์„œ ๊ธฐ๋ฐ˜ ์งˆ์˜์‘๋‹ต ์‹œ์Šคํ…œ์„ ์œ„ํ•œ ์ธํ„ฐํŽ˜์ด์Šค

์ƒ์„ฑ๋˜๋Š” ๊ธฐ๋Šฅ:

  • ์ปจํ…์ŠคํŠธ ์ž…๋ ฅ์ฐฝ
  • ์งˆ๋ฌธ ์ž…๋ ฅ์ฐฝ
  • ๋‹ต๋ณ€ ์ถ”์ถœ ๋ฐ ์‹ ๋ขฐ๋„ ํ‘œ์‹œ
  • ๋‹ต๋ณ€ ์œ„์น˜ ์ •๋ณด

ํ…์ŠคํŠธ ์ƒ์„ฑ (Text Generation)

์–ธ์–ด๋ชจ๋ธ์„ ์ด์šฉํ•œ ํ…์ŠคํŠธ ์ƒ์„ฑ ์ธํ„ฐํŽ˜์ด์Šค

์ƒ์„ฑ๋˜๋Š” ๊ธฐ๋Šฅ:

  • ํ”„๋กฌํ”„ํŠธ ์ž…๋ ฅ์ฐฝ
  • ์ƒ์„ฑ ์„ค์ • (๊ธธ์ด, ์ฐฝ์˜์„ฑ, ๋‹ค์–‘์„ฑ)
  • ์‹ค์‹œ๊ฐ„ ํ…์ŠคํŠธ ์ƒ์„ฑ
  • ์„ค์ •๊ฐ’ ํ‘œ์‹œ

์š”์•ฝ (Summarization)

๊ธด ํ…์ŠคํŠธ๋ฅผ ์š”์•ฝํ•˜๋Š” ์ธํ„ฐํŽ˜์ด์Šค

์ƒ์„ฑ๋˜๋Š” ๊ธฐ๋Šฅ:

  • ๊ธด ํ…์ŠคํŠธ ์ž…๋ ฅ์ฐฝ
  • ์š”์•ฝ ๊ธธ์ด ์„ค์ •
  • ์š”์•ฝ ๊ฒฐ๊ณผ ํ‘œ์‹œ
  • ์••์ถ•๋ฅ  ํ†ต๊ณ„

๋ฒˆ์—ญ (Translation)

์–ธ์–ด ๊ฐ„ ๋ฒˆ์—ญ์„ ์œ„ํ•œ ์ธํ„ฐํŽ˜์ด์Šค

์ƒ์„ฑ๋˜๋Š” ๊ธฐ๋Šฅ:

  • ์›๋ฌธ ์ž…๋ ฅ์ฐฝ
  • ๋ฒˆ์—ญ ๊ฒฐ๊ณผ ํ‘œ์‹œ
  • ๋ฌธ์ž ์ˆ˜ ๋น„๊ต
  • ๊ฐ„๋‹จ๋ช…๋ฃŒํ•œ UI

๋นˆ์นธ ์ฑ„์šฐ๊ธฐ (Fill Mask)

BERT ์Šคํƒ€์ผ ๋งˆ์Šคํฌ ์˜ˆ์ธก ์ธํ„ฐํŽ˜์ด์Šค

์ƒ์„ฑ๋˜๋Š” ๊ธฐ๋Šฅ:

  • [MASK] ํ† ํฐ ์ž…๋ ฅ์ฐฝ
  • ๋‹ค์ค‘ ํ›„๋ณด ์˜ˆ์ธก ๊ฒฐ๊ณผ
  • ์‹ ๋ขฐ๋„๋ณ„ ์ˆœ์œ„ ํ‘œ์‹œ
  • ์˜ˆ์‹œ ๋ฌธ์žฅ ์ œ๊ณต

๊ฐœ์ฒด๋ช… ์ธ์‹ (Named Entity Recognition)

ํ…์ŠคํŠธ์—์„œ ๊ฐœ์ฒด๋ฅผ ์ธ์‹ํ•˜๋Š” ์ธํ„ฐํŽ˜์ด์Šค

์ƒ์„ฑ๋˜๋Š” ๊ธฐ๋Šฅ:

  • ํ…์ŠคํŠธ ์ž…๋ ฅ์ฐฝ
  • ์ธ์‹๋œ ๊ฐœ์ฒด ๋ฆฌ์ŠคํŠธ
  • ๊ฐœ์ฒด ์œ ํ˜• ๋ฐ ์œ„์น˜ ์ •๋ณด
  • ์‹ ๋ขฐ๋„ ํ‘œ์‹œ

๐Ÿ’ก ์‚ฌ์šฉ ์‚ฌ๋ก€

AI ์—ฐ๊ตฌ์ž

  • ๋…ผ๋ฌธ ๋ฐœํ‘œ์šฉ ๋ผ์ด๋ธŒ ๋ฐ๋ชจ ์ค€๋น„
  • ๋ชจ๋ธ ์„ฑ๋Šฅ ์‹œ์—ฐ ๋ฐ ๊ฒ€์ฆ
  • ์—ฐ๊ตฌ ๊ฒฐ๊ณผ ์‹œ๊ฐ์  ๊ณต์œ 

๊ฐœ๋ฐœ์ž

  • ํด๋ผ์ด์–ธํŠธ ๋ฐ๋ชจ ์ œ์ž‘
  • ํ”„๋กœํ† ํƒ€์ž… ๋น ๋ฅธ ๊ฒ€์ฆ
  • API ํ…Œ์ŠคํŠธ ์ธํ„ฐํŽ˜์ด์Šค

๊ต์œก์ž & ํ•™์ƒ

  • ์ˆ˜์—…์šฉ ์ธํ„ฐ๋ž™ํ‹ฐ๋ธŒ ๋„๊ตฌ
  • AI ๋ชจ๋ธ ํ•™์Šต ์ž๋ฃŒ
  • ๊ณผ์ œ ๊ฒฐ๊ณผ ์‹œ์—ฐ

๊ธฐ์—…

  • ๋‚ด๋ถ€ ๋ชจ๋ธ ๊ฒ€์ฆ ๋„๊ตฌ
  • stakeholder ํ”„๋ ˆ์  ํ…Œ์ด์…˜
  • POC (Proof of Concept) ์ œ์ž‘

๐Ÿ”— ์™„๋ฒฝํ•œ AI ๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ

์ด ๋„๊ตฌ๋Š” ๋‹ค๋ฅธ ๋„๊ตฌ๋“ค๊ณผ ์—ฐ๊ณ„ํ•˜์—ฌ ์™„์ „ํ•œ ๊ฐœ๋ฐœ ๊ฒฝํ—˜์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค:

1๏ธโƒฃ ๋ชจ๋ธ ๊ฒ€์ƒ‰

**Model Search Tool**์—์„œ ์ตœ์ ์˜ ์‚ฌ์ „ ํ›ˆ๋ จ ๋ชจ๋ธ ํƒ์ƒ‰

2๏ธโƒฃ ๋ฐ์ดํ„ฐ ์ค€๋น„

**Dataset Converter**๋กœ ํ•™์Šต ๋ฐ์ดํ„ฐ ํ—ˆ๊น…ํŽ˜์ด์Šค ํฌ๋งท ๋ณ€ํ™˜

3๏ธโƒฃ ๋ฐ๋ชจ ์ƒ์„ฑ

Demo Generator๋กœ ๋ชจ๋ธ ์‹œ์—ฐ์šฉ ์ธํ„ฐ๋ž™ํ‹ฐ๋ธŒ ๋ฐ๋ชจ ์ž๋™ ์ƒ์„ฑ โ† ํ˜„์žฌ ๋„๊ตฌ

4๏ธโƒฃ ๋ฌธ์„œํ™”

**Model Card Generator**๋กœ ์ „๋ฌธ์ ์ธ ๋ชจ๋ธ ๋ฌธ์„œ ์ž‘์„ฑ

๐Ÿ› ๏ธ ๊ธฐ์ˆ ์  ํŠน์ง•

์ž๋™ ์ฝ”๋“œ ์ƒ์„ฑ

  • ํƒœ์Šคํฌ๋ณ„ ์ตœ์ ํ™”๋œ Gradio ์ธํ„ฐํŽ˜์ด์Šค
  • ์—๋Ÿฌ ์ฒ˜๋ฆฌ ๋ฐ ์‚ฌ์šฉ์ž ๊ฐ€์ด๋“œ ํฌํ•จ
  • ์ตœ์‹  transformers ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ํ™œ์šฉ
  • ๋ฐ˜์‘ํ˜• UI ๋ฐ ์˜ˆ์œ ๋””์ž์ธ

๋ฐฐํฌ ์ตœ์ ํ™”

  • ํ—ˆ๊น…ํŽ˜์ด์Šค Space ํ‘œ์ค€ ์ค€์ˆ˜
  • ์ž๋™ requirements.txt ์ƒ์„ฑ
  • ์™„์ „ํ•œ README.md ํ…œํ”Œ๋ฆฟ
  • ํ•œ ๋ฒˆ์˜ ๋‹ค์šด๋กœ๋“œ๋กœ ๋ฐฐํฌ ์ค€๋น„ ์™„๋ฃŒ

ํ™•์žฅ์„ฑ

  • ์ƒˆ๋กœ์šด ํƒœ์Šคํฌ ์‰ฝ๊ฒŒ ์ถ”๊ฐ€ ๊ฐ€๋Šฅ
  • ์ปค์Šคํ„ฐ๋งˆ์ด์ง• ๊ฐ€๋Šฅํ•œ ํ…œํ”Œ๋ฆฟ
  • ๋ชจ๋ธ ํ˜ธํ™˜์„ฑ ์ž๋™ ์ฒดํฌ

๐Ÿ“Š ์ƒ์„ฑ ์˜ˆ์‹œ

์ž…๋ ฅ

๋ชจ๋ธ๋ช…: klue/bert-base
์ œ๋ชฉ: Korean BERT Demo
์„ค๋ช…: ํ•œ๊ตญ์–ด ํ…์ŠคํŠธ ๋ถ„๋ฅ˜๋ฅผ ์œ„ํ•œ BERT ๋ชจ๋ธ

์ถœ๋ ฅ

  • ์™„์ „ํžˆ ์ž‘๋™ํ•˜๋Š” Gradio ์•ฑ
  • ์˜ˆ์‹œ ํ…์ŠคํŠธ ๋ฒ„ํŠผ ํฌํ•จ
  • ํ•œ๊ตญ์–ด ์ตœ์ ํ™” ์ธํ„ฐํŽ˜์ด์Šค
  • ๋ฐ”๋กœ ๋ฐฐํฌ ๊ฐ€๋Šฅํ•œ ํŒจํ‚ค์ง€

๐ŸŽจ UI/UX ์ตœ์ ํ™”

  • ์ง๊ด€์  ์ธํ„ฐํŽ˜์ด์Šค: ๋น„์ „๋ฌธ๊ฐ€๋„ ์‰ฝ๊ฒŒ ์‚ฌ์šฉ
  • ์‹ค์‹œ๊ฐ„ ํ”ผ๋“œ๋ฐฑ: ์ฆ‰์‹œ ๊ฒฐ๊ณผ ํ™•์ธ ๊ฐ€๋Šฅ
  • ๋ชจ๋ฐ”์ผ ํ˜ธํ™˜: ๋ฐ˜์‘ํ˜• ๋””์ž์ธ
  • ์ ‘๊ทผ์„ฑ: ๋ช…ํ™•ํ•œ ๋ผ๋ฒจ ๋ฐ ์„ค๋ช…

๐Ÿ”’ ์•ˆ์ •์„ฑ & ํ˜ธํ™˜์„ฑ

  • ์—๋Ÿฌ ์ฒ˜๋ฆฌ: ๊ฐ•๊ฑดํ•œ ์˜ˆ์™ธ ์ฒ˜๋ฆฌ
  • ๋ชจ๋ธ ํ˜ธํ™˜์„ฑ: ์ž๋™ ๊ฒ€์ฆ ์‹œ์Šคํ…œ
  • ๋ฒ„์ „ ๊ด€๋ฆฌ: ์ตœ์‹  ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์ง€์›
  • ๋ณด์•ˆ: ์•ˆ์ „ํ•œ ๋ชจ๋ธ ๋กœ๋”ฉ

Made with โค๏ธ for the AI community

"๋ณต์žกํ•œ AI ๋ชจ๋ธ์„ ๋ˆ„๊ตฌ๋‚˜ ์‰ฝ๊ฒŒ ์ฒดํ—˜ํ•  ์ˆ˜ ์žˆ๋Š” ์„ธ์ƒ์„ ๋งŒ๋“ค์–ด๊ฐ‘๋‹ˆ๋‹ค"