Home Explore Help
Sign In
Server
/
fish-speech
41
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Branch: gh-pages
Branches Tags
fish-speech
/
ko
/
install
/
index.html

index.html 54 KB
Permalink History Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205 
  1. 

  2. <!doctype html>
    3. 

  3. <html lang="ko" class="no-js">
    4. 

  4.   <head>
    5. 

  5.     
    6. 

  6.       <meta charset="utf-8">
    7. 

  7.       <meta name="viewport" content="width=device-width,initial-scale=1">
    8. 

  8.       
    9. 

  9.         <meta name="description" content="Targeting SOTA TTS solutions.">
    10. 

  10.       
    11. 

  11.       
    12. 

  12.       
    13. 

  13.         <link rel="canonical" href="https://speech.fish.audio/ko/install/">
    14. 

  14.       
    15. 

  15.       
    16. 

  16.         <link rel="prev" href="../">
    17. 

  17.       
    18. 

  18.       
    19. 

  19.         <link rel="next" href="../finetune/">
    20. 

  20.       
    21. 

  21.       
    22. 

  22.         
    23. 

  23.           <link rel="alternate" href="../../install/" hreflang="en">
    24. 

  24.         
    25. 

  25.           <link rel="alternate" href="../../zh/install/" hreflang="zh">
    26. 

  26.         
    27. 

  27.           <link rel="alternate" href="../../ja/install/" hreflang="ja">
    28. 

  28.         
    29. 

  29.           <link rel="alternate" href="../../pt/install/" hreflang="pt">
    30. 

  30.         
    31. 

  31.           <link rel="alternate" href="./" hreflang="ko">
    32. 

  32.         
    33. 

  33.           <link rel="alternate" href="../../ar/install/" hreflang="ar">
    34. 

  34.         
    35. 

  35.       
    36. 

  36.       
    37. 

  37.       <link rel="icon" href="../../assets/logo.svg">
    38. 

  38.       <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.1">
    39. 

  39.     
    40. 

  40.     
    41. 

  41.       
    42. 

  42.         <title>설치 - Fish Audio</title>
    43. 

  43.       
    44. 

  44.     
    45. 

  45.     
    46. 

  46.       <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
    47. 

  47.       
    48. 

  48.         
    49. 

  49.         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
    50. 

  50.       
    51. 

  51.       
    52. 

  52. 

  53. 

  54.     
    55. 

  55.     
    56. 

  56.       
    57. 

  57.     
    58. 

  58.     
    59. 

  59.       
    60. 

  60.         
    61. 

  61.         
    62. 

  62.         <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
    63. 

  63.         <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
    64. 

  64.         <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
    65. 

  65.       
    66. 

  66.     
    67. 

  67.     
    68. 

  68.       <link rel="stylesheet" href="../../stylesheets/extra.css">
    69. 

  69.     
    70. 

  70.     <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
    71. 

  71.     
    72. 

  72.       
    73. 

  73. 

  74.     
    75. 

  75.     
    76. 

  76.   </head>
    77. 

  77.   
    78. 

  78.   
    79. 

  79.     
    80. 

  80.     
    81. 

  81.       
    82. 

  82.     
    83. 

  83.     
    84. 

  84.     
    85. 

  85.     
    86. 

  86.     <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
    87. 

  87.   
    88. 

  88.     
    89. 

  89.     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
    90. 

  90.     <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
    91. 

  91.     <label class="md-overlay" for="__drawer"></label>
    92. 

  92.     <div data-md-component="skip">
    93. 

  93.       
    94. 

  94.         
    95. 

  95.         <a href="#_1" class="md-skip">
    96. 

  96.           콘텐츠로 이동
    97. 

  97.         </a>
    98. 

  98.       
    99. 

  99.     </div>
    100. 

  100.     <div data-md-component="announce">
    101. 

  101.       
    102. 

  102.     </div>
    103. 

  103.     
    104. 

  104.     
    105. 

  105.       
    106. 

  106. 

  107.   
    108. 

  108. 

  109. <header class="md-header md-header--shadow" data-md-component="header">
    110. 

  110.   <nav class="md-header__inner md-grid" aria-label="상단/헤더">
    111. 

  111.     <a href="https://speech.fish.audio" title="Fish Audio" class="md-header__button md-logo" aria-label="Fish Audio" data-md-component="logo">
    112. 

  112.       
    113. 

  113.   <img src="../../assets/logo.svg" alt="logo">
    114. 

  114. 

  115.     </a>
    116. 

  116.     <label class="md-header__button md-icon" for="__drawer">
    117. 

  117.       
    118. 

  118.       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
    119. 

  119.     </label>
    120. 

  120.     <div class="md-header__title" data-md-component="header-title">
    121. 

  121.       <div class="md-header__ellipsis">
    122. 

  122.         <div class="md-header__topic">
    123. 

  123.           <span class="md-ellipsis">
    124. 

  124.             Fish Audio
    125. 

  125.           </span>
    126. 

  126.         </div>
    127. 

  127.         <div class="md-header__topic" data-md-component="header-topic">
    128. 

  128.           <span class="md-ellipsis">
    129. 

  129.             
    130. 

  130.               설치
    131. 

  131.             
    132. 

  132.           </span>
    133. 

  133.         </div>
    134. 

  134.       </div>
    135. 

  135.     </div>
    136. 

  136.     
    137. 

  137.       
    138. 

  138.         <form class="md-header__option" data-md-component="palette">
    139. 

  139.   
    140. 

  140.     
    141. 

  141.     
    142. 

  142.     
    143. 

  143.     <input class="md-option" data-md-color-media="(prefers-color-scheme)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_0">
    144. 

  144.     
    145. 

  145.       <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
    146. 

  146.         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m14.3 16-.7-2h-3.2l-.7 2H7.8L11 7h2l3.2 9zM20 8.69V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12zm-9.15 3.96h2.3L12 9z"/></svg>
    147. 

  147.       </label>
    148. 

  148.     
    149. 

  149.   
    150. 

  150.     
    151. 

  151.     
    152. 

  152.     
    153. 

  153.     <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="black" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_1">
    154. 

  154.     
    155. 

  155.       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
    156. 

  156.         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
    157. 

  157.       </label>
    158. 

  158.     
    159. 

  159.   
    160. 

  160.     
    161. 

  161.     
    162. 

  162.     
    163. 

  163.     <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="black" data-md-color-accent="indigo"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_2">
    164. 

  164.     
    165. 

  165.       <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
    166. 

  166.         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
    167. 

  167.       </label>
    168. 

  168.     
    169. 

  169.   
    170. 

  170. </form>
    171. 

  171.       
    172. 

  172.     
    173. 

  173.     
    174. 

  174.       <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
    175. 

  175.     
    176. 

  176.     
    177. 

  177.       <div class="md-header__option">
    178. 

  178.   <div class="md-select">
    179. 

  179.     
    180. 

  180.     <button class="md-header__button md-icon" aria-label="언어설정">
    181. 

  181.       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m12.87 15.07-2.54-2.51.03-.03A17.5 17.5 0 0 0 14.07 6H17V4h-7V2H8v2H1v2h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11zM18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2zm-2.62 7 1.62-4.33L19.12 17z"/></svg>
    182. 

  182.     </button>
    183. 

  183.     <div class="md-select__inner">
    184. 

  184.       <ul class="md-select__list">
    185. 

  185.         
    186. 

  186.           <li class="md-select__item">
    187. 

  187.             <a href="../../install/" hreflang="en" class="md-select__link">
    188. 

  188.               English
    189. 

  189.             </a>
    190. 

  190.           </li>
    191. 

  191.         
    192. 

  192.           <li class="md-select__item">
    193. 

  193.             <a href="../../zh/install/" hreflang="zh" class="md-select__link">
    194. 

  194.               简体中文
    195. 

  195.             </a>
    196. 

  196.           </li>
    197. 

  197.         
    198. 

  198.           <li class="md-select__item">
    199. 

  199.             <a href="../../ja/install/" hreflang="ja" class="md-select__link">
    200. 

  200.               日本語
    201. 

  201.             </a>
    202. 

  202.           </li>
    203. 

  203.         
    204. 

  204.           <li class="md-select__item">
    205. 

  205.             <a href="../../pt/install/" hreflang="pt" class="md-select__link">
    206. 

  206.               Português (Brasil)
    207. 

  207.             </a>
    208. 

  208.           </li>
    209. 

  209.         
    210. 

  210.           <li class="md-select__item">
    211. 

  211.             <a href="./" hreflang="ko" class="md-select__link">
    212. 

  212.               한국어
    213. 

  213.             </a>
    214. 

  214.           </li>
    215. 

  215.         
    216. 

  216.           <li class="md-select__item">
    217. 

  217.             <a href="../../ar/install/" hreflang="ar" class="md-select__link">
    218. 

  218.               العربية
    219. 

  219.             </a>
    220. 

  220.           </li>
    221. 

  221.         
    222. 

  222.       </ul>
    223. 

  223.     </div>
    224. 

  224.   </div>
    225. 

  225. </div>
    226. 

  226.     
    227. 

  227.     
    228. 

  228.       
    229. 

  229.       
    230. 

  230.         <label class="md-header__button md-icon" for="__search">
    231. 

  231.           
    232. 

  232.           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
    233. 

  233.         </label>
    234. 

  234.         <div class="md-search" data-md-component="search" role="dialog">
    235. 

  235.   <label class="md-search__overlay" for="__search"></label>
    236. 

  236.   <div class="md-search__inner" role="search">
    237. 

  237.     <form class="md-search__form" name="search">
    238. 

  238.       <input type="text" class="md-search__input" name="query" aria-label="검색" placeholder="검색" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
    239. 

  239.       <label class="md-search__icon md-icon" for="__search">
    240. 

  240.         
    241. 

  241.         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
    242. 

  242.         
    243. 

  243.         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
    244. 

  244.       </label>
    245. 

  245.       <nav class="md-search__options" aria-label="검색">
    246. 

  246.         
    247. 

  247.           <a href="javascript:void(0)" class="md-search__icon md-icon" title="공유" aria-label="공유" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
    248. 

  248.             
    249. 

  249.             <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
    250. 

  250.           </a>
    251. 

  251.         
    252. 

  252.         <button type="reset" class="md-search__icon md-icon" title="지우기" aria-label="지우기" tabindex="-1">
    253. 

  253.           
    254. 

  254.           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
    255. 

  255.         </button>
    256. 

  256.       </nav>
    257. 

  257.       
    258. 

  258.         <div class="md-search__suggest" data-md-component="search-suggest"></div>
    259. 

  259.       
    260. 

  260.     </form>
    261. 

  261.     <div class="md-search__output">
    262. 

  262.       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
    263. 

  263.         <div class="md-search-result" data-md-component="search-result">
    264. 

  264.           <div class="md-search-result__meta">
    265. 

  265.             검색 초기화
    266. 

  266.           </div>
    267. 

  267.           <ol class="md-search-result__list" role="presentation"></ol>
    268. 

  268.         </div>
    269. 

  269.       </div>
    270. 

  270.     </div>
    271. 

  271.   </div>
    272. 

  272. </div>
    273. 

  273.       
    274. 

  274.     
    275. 

  275.     
    276. 

  276.       <div class="md-header__source">
    277. 

  277.         <a href="https://github.com/fishaudio/fish-speech" title="저장소로 이동" class="md-source" data-md-component="source">
    278. 

  278.   <div class="md-source__icon md-icon">
    279. 

  279.     
    280. 

  280.     <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
    281. 

  281.   </div>
    282. 

  282.   <div class="md-source__repository">
    283. 

  283.     fishaudio/fish-speech
    284. 

  284.   </div>
    285. 

  285. </a>
    286. 

  286.       </div>
    287. 

  287.     
    288. 

  288.   </nav>
    289. 

  289.   
    290. 

  290. </header>
    291. 

  291.     
    292. 

  292.     <div class="md-container" data-md-component="container">
    293. 

  293.       
    294. 

  294.       
    295. 

  295.         
    296. 

  296.           
    297. 

  297.         
    298. 

  298.       
    299. 

  299.       <main class="md-main" data-md-component="main">
    300. 

  300.         <div class="md-main__inner md-grid">
    301. 

  301.           
    302. 

  302.             
    303. 

  303.               
    304. 

  304.               <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
    305. 

  305.                 <div class="md-sidebar__scrollwrap">
    306. 

  306.                   <div class="md-sidebar__inner">
    307. 

  307.                     
    308. 

  308. 

  309. 

  310. 

  311. <nav class="md-nav md-nav--primary" aria-label="네비게이션" data-md-level="0">
    312. 

  312.   <label class="md-nav__title" for="__drawer">
    313. 

  313.     <a href="https://speech.fish.audio" title="Fish Audio" class="md-nav__button md-logo" aria-label="Fish Audio" data-md-component="logo">
    314. 

  314.       
    315. 

  315.   <img src="../../assets/logo.svg" alt="logo">
    316. 

  316. 

  317.     </a>
    318. 

  318.     Fish Audio
    319. 

  319.   </label>
    320. 

  320.   
    321. 

  321.     <div class="md-nav__source">
    322. 

  322.       <a href="https://github.com/fishaudio/fish-speech" title="저장소로 이동" class="md-source" data-md-component="source">
    323. 

  323.   <div class="md-source__icon md-icon">
    324. 

  324.     
    325. 

  325.     <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
    326. 

  326.   </div>
    327. 

  327.   <div class="md-source__repository">
    328. 

  328.     fishaudio/fish-speech
    329. 

  329.   </div>
    330. 

  330. </a>
    331. 

  331.     </div>
    332. 

  332.   
    333. 

  333.   <ul class="md-nav__list" data-md-scrollfix>
    334. 

  334.     
    335. 

  335.       
    336. 

  336.       
    337. 

  337.   
    338. 

  338.   
    339. 

  339.   
    340. 

  340.   
    341. 

  341.     <li class="md-nav__item">
    342. 

  342.       <a href="../" class="md-nav__link">
    343. 

  343.         
    344. 

  344.   
    345. 

  345.   
    346. 

  346.   <span class="md-ellipsis">
    347. 

  347.     
    348. 

  348.   
    349. 

  349.     소개
    350. 

  350.   
    351. 

  351. 

  352.     
    353. 

  353.   </span>
    354. 

  354.   
    355. 

  355.   
    356. 

  356. 

  357.       </a>
    358. 

  358.     </li>
    359. 

  359.   
    360. 

  360. 

  361.     
    362. 

  362.       
    363. 

  363.       
    364. 

  364.   
    365. 

  365.   
    366. 

  366.     
    367. 

  367.   
    368. 

  368.   
    369. 

  369.   
    370. 

  370.     <li class="md-nav__item md-nav__item--active">
    371. 

  371.       
    372. 

  372.       <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
    373. 

  373.       
    374. 

  374.       
    375. 

  375.       
    376. 

  376.         <label class="md-nav__link md-nav__link--active" for="__toc">
    377. 

  377.           
    378. 

  378.   
    379. 

  379.   
    380. 

  380.   <span class="md-ellipsis">
    381. 

  381.     
    382. 

  382.   
    383. 

  383.     설치
    384. 

  384.   
    385. 

  385. 

  386.     
    387. 

  387.   </span>
    388. 

  388.   
    389. 

  389.   
    390. 

  390. 

  391.           <span class="md-nav__icon md-icon"></span>
    392. 

  392.         </label>
    393. 

  393.       
    394. 

  394.       <a href="./" class="md-nav__link md-nav__link--active">
    395. 

  395.         
    396. 

  396.   
    397. 

  397.   
    398. 

  398.   <span class="md-ellipsis">
    399. 

  399.     
    400. 

  400.   
    401. 

  401.     설치
    402. 

  402.   
    403. 

  403. 

  404.     
    405. 

  405.   </span>
    406. 

  406.   
    407. 

  407.   
    408. 

  408. 

  409.       </a>
    410. 

  410.       
    411. 

  411.         
    412. 

  412. 

  413. <nav class="md-nav md-nav--secondary" aria-label="목차">
    414. 

  414.   
    415. 

  415.   
    416. 

  416.   
    417. 

  417.   
    418. 

  418.     <label class="md-nav__title" for="__toc">
    419. 

  419.       <span class="md-nav__icon md-icon"></span>
    420. 

  420.       목차
    421. 

  421.     </label>
    422. 

  422.     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
    423. 

  423.       
    424. 

  424.         <li class="md-nav__item">
    425. 

  425.   <a href="#_1" class="md-nav__link">
    426. 

  426.     <span class="md-ellipsis">
    427. 

  427.       
    428. 

  428.         요구 사양
    429. 

  429.       
    430. 

  430.     </span>
    431. 

  431.   </a>
    432. 

  432.   
    433. 

  433. </li>
    434. 

  434.       
    435. 

  435.         <li class="md-nav__item">
    436. 

  436.   <a href="#_2" class="md-nav__link">
    437. 

  437.     <span class="md-ellipsis">
    438. 

  438.       
    439. 

  439.         시스템 설정
    440. 

  440.       
    441. 

  441.     </span>
    442. 

  442.   </a>
    443. 

  443.   
    444. 

  444.     <nav class="md-nav" aria-label="시스템 설정">
    445. 

  445.       <ul class="md-nav__list">
    446. 

  446.         
    447. 

  447.           <li class="md-nav__item">
    448. 

  448.   <a href="#conda" class="md-nav__link">
    449. 

  449.     <span class="md-ellipsis">
    450. 

  450.       
    451. 

  451.         Conda
    452. 

  452.       
    453. 

  453.     </span>
    454. 

  454.   </a>
    455. 

  455.   
    456. 

  456. </li>
    457. 

  457.         
    458. 

  458.           <li class="md-nav__item">
    459. 

  459.   <a href="#uv" class="md-nav__link">
    460. 

  460.     <span class="md-ellipsis">
    461. 

  461.       
    462. 

  462.         UV
    463. 

  463.       
    464. 

  464.     </span>
    465. 

  465.   </a>
    466. 

  466.   
    467. 

  467. </li>
    468. 

  468.         
    469. 

  469.           <li class="md-nav__item">
    470. 

  470.   <a href="#intel-arc-xpu" class="md-nav__link">
    471. 

  471.     <span class="md-ellipsis">
    472. 

  472.       
    473. 

  473.         Intel Arc XPU 지원
    474. 

  474.       
    475. 

  475.     </span>
    476. 

  476.   </a>
    477. 

  477.   
    478. 

  478. </li>
    479. 

  479.         
    480. 

  480.       </ul>
    481. 

  481.     </nav>
    482. 

  482.   
    483. 

  483. </li>
    484. 

  484.       
    485. 

  485.         <li class="md-nav__item">
    486. 

  486.   <a href="#docker" class="md-nav__link">
    487. 

  487.     <span class="md-ellipsis">
    488. 

  488.       
    489. 

  489.         Docker 설정
    490. 

  490.       
    491. 

  491.     </span>
    492. 

  492.   </a>
    493. 

  493.   
    494. 

  494.     <nav class="md-nav" aria-label="Docker 설정">
    495. 

  495.       <ul class="md-nav__list">
    496. 

  496.         
    497. 

  497.           <li class="md-nav__item">
    498. 

  498.   <a href="#_3" class="md-nav__link">
    499. 

  499.     <span class="md-ellipsis">
    500. 

  500.       
    501. 

  501.         사전 요구사항
    502. 

  502.       
    503. 

  503.     </span>
    504. 

  504.   </a>
    505. 

  505.   
    506. 

  506. </li>
    507. 

  507.         
    508. 

  508.           <li class="md-nav__item">
    509. 

  509.   <a href="#docker-compose" class="md-nav__link">
    510. 

  510.     <span class="md-ellipsis">
    511. 

  511.       
    512. 

  512.         Docker Compose 사용
    513. 

  513.       
    514. 

  514.     </span>
    515. 

  515.   </a>
    516. 

  516.   
    517. 

  517.     <nav class="md-nav" aria-label="Docker Compose 사용">
    518. 

  518.       <ul class="md-nav__list">
    519. 

  519.         
    520. 

  520.           <li class="md-nav__item">
    521. 

  521.   <a href="#docker-compose_1" class="md-nav__link">
    522. 

  522.     <span class="md-ellipsis">
    523. 

  523.       
    524. 

  524.         Docker Compose 환경 변수
    525. 

  525.       
    526. 

  526.     </span>
    527. 

  527.   </a>
    528. 

  528.   
    529. 

  529. </li>
    530. 

  530.         
    531. 

  531.       </ul>
    532. 

  532.     </nav>
    533. 

  533.   
    534. 

  534. </li>
    535. 

  535.         
    536. 

  536.           <li class="md-nav__item">
    537. 

  537.   <a href="#docker_1" class="md-nav__link">
    538. 

  538.     <span class="md-ellipsis">
    539. 

  539.       
    540. 

  540.         수동 Docker 빌드
    541. 

  541.       
    542. 

  542.     </span>
    543. 

  543.   </a>
    544. 

  544.   
    545. 

  545.     <nav class="md-nav" aria-label="수동 Docker 빌드">
    546. 

  546.       <ul class="md-nav__list">
    547. 

  547.         
    548. 

  548.           <li class="md-nav__item">
    549. 

  549.   <a href="#_4" class="md-nav__link">
    550. 

  550.     <span class="md-ellipsis">
    551. 

  551.       
    552. 

  552.         빌드 인자
    553. 

  553.       
    554. 

  554.     </span>
    555. 

  555.   </a>
    556. 

  556.   
    557. 

  557. </li>
    558. 

  558.         
    559. 

  559.       </ul>
    560. 

  560.     </nav>
    561. 

  561.   
    562. 

  562. </li>
    563. 

  563.         
    564. 

  564.           <li class="md-nav__item">
    565. 

  565.   <a href="#_5" class="md-nav__link">
    566. 

  566.     <span class="md-ellipsis">
    567. 

  567.       
    568. 

  568.         볼륨 마운트
    569. 

  569.       
    570. 

  570.     </span>
    571. 

  571.   </a>
    572. 

  572.   
    573. 

  573. </li>
    574. 

  574.         
    575. 

  575.           <li class="md-nav__item">
    576. 

  576.   <a href="#_6" class="md-nav__link">
    577. 

  577.     <span class="md-ellipsis">
    578. 

  578.       
    579. 

  579.         환경 변수
    580. 

  580.       
    581. 

  581.     </span>
    582. 

  582.   </a>
    583. 

  583.   
    584. 

  584. </li>
    585. 

  585.         
    586. 

  586.       </ul>
    587. 

  587.     </nav>
    588. 

  588.   
    589. 

  589. </li>
    590. 

  590.       
    591. 

  591.     </ul>
    592. 

  592.   
    593. 

  593. </nav>
    594. 

  594.       
    595. 

  595.     </li>
    596. 

  596.   
    597. 

  597. 

  598.     
    599. 

  599.       
    600. 

  600.       
    601. 

  601.   
    602. 

  602.   
    603. 

  603.   
    604. 

  604.   
    605. 

  605.     <li class="md-nav__item">
    606. 

  606.       <a href="../finetune/" class="md-nav__link">
    607. 

  607.         
    608. 

  608.   
    609. 

  609.   
    610. 

  610.   <span class="md-ellipsis">
    611. 

  611.     
    612. 

  612.   
    613. 

  613.     파인튜닝
    614. 

  614.   
    615. 

  615. 

  616.     
    617. 

  617.   </span>
    618. 

  618.   
    619. 

  619.   
    620. 

  620. 

  621.       </a>
    622. 

  622.     </li>
    623. 

  623.   
    624. 

  624. 

  625.     
    626. 

  626.       
    627. 

  627.       
    628. 

  628.   
    629. 

  629.   
    630. 

  630.   
    631. 

  631.   
    632. 

  632.     <li class="md-nav__item">
    633. 

  633.       <a href="../inference/" class="md-nav__link">
    634. 

  634.         
    635. 

  635.   
    636. 

  636.   
    637. 

  637.   <span class="md-ellipsis">
    638. 

  638.     
    639. 

  639.   
    640. 

  640.     추론
    641. 

  641.   
    642. 

  642. 

  643.     
    644. 

  644.   </span>
    645. 

  645.   
    646. 

  646.   
    647. 

  647. 

  648.       </a>
    649. 

  649.     </li>
    650. 

  650.   
    651. 

  651. 

  652.     
    653. 

  653.       
    654. 

  654.       
    655. 

  655.   
    656. 

  656.   
    657. 

  657.   
    658. 

  658.   
    659. 

  659.     <li class="md-nav__item">
    660. 

  660.       <a href="../samples.md" class="md-nav__link">
    661. 

  661.         
    662. 

  662.   
    663. 

  663.   
    664. 

  664.   <span class="md-ellipsis">
    665. 

  665.     
    666. 

  666.   
    667. 

  667.     샘플
    668. 

  668.   
    669. 

  669. 

  670.     
    671. 

  671.   </span>
    672. 

  672.   
    673. 

  673.   
    674. 

  674. 

  675.       </a>
    676. 

  676.     </li>
    677. 

  677.   
    678. 

  678. 

  679.     
    680. 

  680.   </ul>
    681. 

  681. </nav>
    682. 

  682.                   </div>
    683. 

  683.                 </div>
    684. 

  684.               </div>
    685. 

  685.             
    686. 

  686.             
    687. 

  687.               
    688. 

  688.               <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
    689. 

  689.                 <div class="md-sidebar__scrollwrap">
    690. 

  690.                   <div class="md-sidebar__inner">
    691. 

  691.                     
    692. 

  692. 

  693. <nav class="md-nav md-nav--secondary" aria-label="목차">
    694. 

  694.   
    695. 

  695.   
    696. 

  696.   
    697. 

  697.   
    698. 

  698.     <label class="md-nav__title" for="__toc">
    699. 

  699.       <span class="md-nav__icon md-icon"></span>
    700. 

  700.       목차
    701. 

  701.     </label>
    702. 

  702.     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
    703. 

  703.       
    704. 

  704.         <li class="md-nav__item">
    705. 

  705.   <a href="#_1" class="md-nav__link">
    706. 

  706.     <span class="md-ellipsis">
    707. 

  707.       
    708. 

  708.         요구 사양
    709. 

  709.       
    710. 

  710.     </span>
    711. 

  711.   </a>
    712. 

  712.   
    713. 

  713. </li>
    714. 

  714.       
    715. 

  715.         <li class="md-nav__item">
    716. 

  716.   <a href="#_2" class="md-nav__link">
    717. 

  717.     <span class="md-ellipsis">
    718. 

  718.       
    719. 

  719.         시스템 설정
    720. 

  720.       
    721. 

  721.     </span>
    722. 

  722.   </a>
    723. 

  723.   
    724. 

  724.     <nav class="md-nav" aria-label="시스템 설정">
    725. 

  725.       <ul class="md-nav__list">
    726. 

  726.         
    727. 

  727.           <li class="md-nav__item">
    728. 

  728.   <a href="#conda" class="md-nav__link">
    729. 

  729.     <span class="md-ellipsis">
    730. 

  730.       
    731. 

  731.         Conda
    732. 

  732.       
    733. 

  733.     </span>
    734. 

  734.   </a>
    735. 

  735.   
    736. 

  736. </li>
    737. 

  737.         
    738. 

  738.           <li class="md-nav__item">
    739. 

  739.   <a href="#uv" class="md-nav__link">
    740. 

  740.     <span class="md-ellipsis">
    741. 

  741.       
    742. 

  742.         UV
    743. 

  743.       
    744. 

  744.     </span>
    745. 

  745.   </a>
    746. 

  746.   
    747. 

  747. </li>
    748. 

  748.         
    749. 

  749.           <li class="md-nav__item">
    750. 

  750.   <a href="#intel-arc-xpu" class="md-nav__link">
    751. 

  751.     <span class="md-ellipsis">
    752. 

  752.       
    753. 

  753.         Intel Arc XPU 지원
    754. 

  754.       
    755. 

  755.     </span>
    756. 

  756.   </a>
    757. 

  757.   
    758. 

  758. </li>
    759. 

  759.         
    760. 

  760.       </ul>
    761. 

  761.     </nav>
    762. 

  762.   
    763. 

  763. </li>
    764. 

  764.       
    765. 

  765.         <li class="md-nav__item">
    766. 

  766.   <a href="#docker" class="md-nav__link">
    767. 

  767.     <span class="md-ellipsis">
    768. 

  768.       
    769. 

  769.         Docker 설정
    770. 

  770.       
    771. 

  771.     </span>
    772. 

  772.   </a>
    773. 

  773.   
    774. 

  774.     <nav class="md-nav" aria-label="Docker 설정">
    775. 

  775.       <ul class="md-nav__list">
    776. 

  776.         
    777. 

  777.           <li class="md-nav__item">
    778. 

  778.   <a href="#_3" class="md-nav__link">
    779. 

  779.     <span class="md-ellipsis">
    780. 

  780.       
    781. 

  781.         사전 요구사항
    782. 

  782.       
    783. 

  783.     </span>
    784. 

  784.   </a>
    785. 

  785.   
    786. 

  786. </li>
    787. 

  787.         
    788. 

  788.           <li class="md-nav__item">
    789. 

  789.   <a href="#docker-compose" class="md-nav__link">
    790. 

  790.     <span class="md-ellipsis">
    791. 

  791.       
    792. 

  792.         Docker Compose 사용
    793. 

  793.       
    794. 

  794.     </span>
    795. 

  795.   </a>
    796. 

  796.   
    797. 

  797.     <nav class="md-nav" aria-label="Docker Compose 사용">
    798. 

  798.       <ul class="md-nav__list">
    799. 

  799.         
    800. 

  800.           <li class="md-nav__item">
    801. 

  801.   <a href="#docker-compose_1" class="md-nav__link">
    802. 

  802.     <span class="md-ellipsis">
    803. 

  803.       
    804. 

  804.         Docker Compose 환경 변수
    805. 

  805.       
    806. 

  806.     </span>
    807. 

  807.   </a>
    808. 

  808.   
    809. 

  809. </li>
    810. 

  810.         
    811. 

  811.       </ul>
    812. 

  812.     </nav>
    813. 

  813.   
    814. 

  814. </li>
    815. 

  815.         
    816. 

  816.           <li class="md-nav__item">
    817. 

  817.   <a href="#docker_1" class="md-nav__link">
    818. 

  818.     <span class="md-ellipsis">
    819. 

  819.       
    820. 

  820.         수동 Docker 빌드
    821. 

  821.       
    822. 

  822.     </span>
    823. 

  823.   </a>
    824. 

  824.   
    825. 

  825.     <nav class="md-nav" aria-label="수동 Docker 빌드">
    826. 

  826.       <ul class="md-nav__list">
    827. 

  827.         
    828. 

  828.           <li class="md-nav__item">
    829. 

  829.   <a href="#_4" class="md-nav__link">
    830. 

  830.     <span class="md-ellipsis">
    831. 

  831.       
    832. 

  832.         빌드 인자
    833. 

  833.       
    834. 

  834.     </span>
    835. 

  835.   </a>
    836. 

  836.   
    837. 

  837. </li>
    838. 

  838.         
    839. 

  839.       </ul>
    840. 

  840.     </nav>
    841. 

  841.   
    842. 

  842. </li>
    843. 

  843.         
    844. 

  844.           <li class="md-nav__item">
    845. 

  845.   <a href="#_5" class="md-nav__link">
    846. 

  846.     <span class="md-ellipsis">
    847. 

  847.       
    848. 

  848.         볼륨 마운트
    849. 

  849.       
    850. 

  850.     </span>
    851. 

  851.   </a>
    852. 

  852.   
    853. 

  853. </li>
    854. 

  854.         
    855. 

  855.           <li class="md-nav__item">
    856. 

  856.   <a href="#_6" class="md-nav__link">
    857. 

  857.     <span class="md-ellipsis">
    858. 

  858.       
    859. 

  859.         환경 변수
    860. 

  860.       
    861. 

  861.     </span>
    862. 

  862.   </a>
    863. 

  863.   
    864. 

  864. </li>
    865. 

  865.         
    866. 

  866.       </ul>
    867. 

  867.     </nav>
    868. 

  868.   
    869. 

  869. </li>
    870. 

  870.       
    871. 

  871.     </ul>
    872. 

  872.   
    873. 

  873. </nav>
    874. 

  874.                   </div>
    875. 

  875.                 </div>
    876. 

  876.               </div>
    877. 

  877.             
    878. 

  878.           
    879. 

  879.           
    880. 

  880.             <div class="md-content" data-md-component="content">
    881. 

  881.               
    882. 

  882.               <article class="md-content__inner md-typeset">
    883. 

  883.                 
    884. 

  884.                   
    885. 

  885. 

  886. 

  887.   
    888. 

  888.     <a href="https://github.com/fishaudio/fish-speech/blob/main/docs/ko/install.md" title="이 페이지를 편집" class="md-content__button md-icon" rel="edit">
    889. 

  889.       
    890. 

  890.       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"/></svg>
    891. 

  891.     </a>
    892. 

  892.   
    893. 

  893.   
    894. 

  894.     
    895. 

  895.       
    896. 

  896.     
    897. 

  897.     <a href="https://github.com/fishaudio/fish-speech/raw/main/docs/ko/install.md" title="페이지소스 보기" class="md-content__button md-icon">
    898. 

  898.       
    899. 

  899.       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 18c.56 0 1 .44 1 1s-.44 1-1 1-1-.44-1-1 .44-1 1-1m0-3c-2.73 0-5.06 1.66-6 4 .94 2.34 3.27 4 6 4s5.06-1.66 6-4c-.94-2.34-3.27-4-6-4m0 6.5a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5M9.27 20H6V4h7v5h5v4.07c.7.08 1.36.25 2 .49V8l-6-6H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h4.5a8.2 8.2 0 0 1-1.23-2"/></svg>
    900. 

  900.     </a>
    901. 

  901.   
    902. 

  902. 

  903. 

  904.   <h1>설치</h1>
    905. 

  905. 

  906. <h2 id="_1">요구 사양</h2>
    907. 

  907. <ul>
    908. 

  908. <li>GPU 메모리: 24GB (추론 시)</li>
    909. 

  909. <li>시스템: Linux, WSL</li>
    910. 

  910. </ul>
    911. 

  911. <h2 id="_2">시스템 설정</h2>
    912. 

  912. <p>Fish Audio S2는 다양한 설치 방법을 지원합니다. 자신의 개발 환경에 가장 적합한 방법을 선택하세요.</p>
    913. 

  913. <p><strong>사전 요구사항</strong>: 오디오 처리를 위한 시스템 의존성을 설치합니다:
    914. 

  914. <div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>apt<span class="w"> </span>install<span class="w"> </span>portaudio19-dev<span class="w"> </span>libsox-dev<span class="w"> </span>ffmpeg
    915. 

  915. </span></code></pre></div></p>
    916. 

  916. <h3 id="conda">Conda</h3>
    917. 

  917. <div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>conda<span class="w"> </span>create<span class="w"> </span>-n<span class="w"> </span>fish-speech<span class="w"> </span><span class="nv">python</span><span class="o">=</span><span class="m">3</span>.12
    918. 

  918. </span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>conda<span class="w"> </span>activate<span class="w"> </span>fish-speech
    919. 

  919. </span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a>
    920. 

  920. </span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="c1"># GPU 버전 설치 (CUDA 버전 선택: cu126, cu128, cu129)</span>
    921. 

  921. </span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a>pip<span class="w"> </span>install<span class="w"> </span>-e<span class="w"> </span>.<span class="o">[</span>cu129<span class="o">]</span>
    922. 

  922. </span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a>
    923. 

  923. </span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="c1"># CPU 버전만 설치</span>
    924. 

  924. </span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a>pip<span class="w"> </span>install<span class="w"> </span>-e<span class="w"> </span>.<span class="o">[</span>cpu<span class="o">]</span>
    925. 

  925. </span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a>
    926. 

  926. </span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="c1"># 기본 설치 (PyTorch 기본 인덱스 사용)</span>
    927. 

  927. </span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a>pip<span class="w"> </span>install<span class="w"> </span>-e<span class="w"> </span>.
    928. 

  928. </span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a>
    929. 

  929. </span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="c1"># pyaudio 설치 중 오류가 발생하면 다음 명령을 사용해 보세요:</span>
    930. 

  930. </span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="c1"># conda install pyaudio</span>
    931. 

  931. </span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a><span class="c1"># 그런 다음 pip install -e . 를 다시 실행하세요</span>
    932. 

  932. </span></code></pre></div>
    933. 

  933. <h3 id="uv">UV</h3>
    934. 

  934. <p>UV는 더 빠른 의존성 해결 및 설치를 제공합니다:</p>
    935. 

  935. <div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="c1"># GPU 버전 설치 (CUDA 버전 선택: cu126, cu128, cu129)</span>
    936. 

  936. </span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>uv<span class="w"> </span>sync<span class="w"> </span>--python<span class="w"> </span><span class="m">3</span>.12<span class="w"> </span>--extra<span class="w"> </span>cu129
    937. 

  937. </span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>
    938. 

  938. </span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="c1"># CPU 버전만 설치</span>
    939. 

  939. </span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a>uv<span class="w"> </span>sync<span class="w"> </span>--python<span class="w"> </span><span class="m">3</span>.12<span class="w"> </span>--extra<span class="w"> </span>cpu
    940. 

  940. </span></code></pre></div>
    941. 

  941. <h3 id="intel-arc-xpu">Intel Arc XPU 지원</h3>
    942. 

  942. <p>Intel Arc GPU 사용자는 다음을 통해 XPU 지원을 설치하세요:</p>
    943. 

  943. <div class="language-bash highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>conda<span class="w"> </span>create<span class="w"> </span>-n<span class="w"> </span>fish-speech<span class="w"> </span><span class="nv">python</span><span class="o">=</span><span class="m">3</span>.12
    944. 

  944. </span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>conda<span class="w"> </span>activate<span class="w"> </span>fish-speech
    945. 

  945. </span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a>
    946. 

  946. </span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="c1"># 필요한 C++ 표준 라이브러리 설치</span>
    947. 

  947. </span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a>conda<span class="w"> </span>install<span class="w"> </span>libstdcxx<span class="w"> </span>-c<span class="w"> </span>conda-forge
    948. 

  948. </span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a>
    949. 

  949. </span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="c1"># Intel XPU를 지원하는 PyTorch 설치</span>
    950. 

  950. </span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a>pip<span class="w"> </span>install<span class="w"> </span>--pre<span class="w"> </span>torch<span class="w"> </span>torchvision<span class="w"> </span>torchaudio<span class="w"> </span>--index-url<span class="w"> </span>https://download.pytorch.org/whl/nightly/xpu
    951. 

  951. </span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a>
    952. 

  952. </span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="c1"># Fish Speech 설치</span>
    953. 

  953. </span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a>pip<span class="w"> </span>install<span class="w"> </span>-e<span class="w"> </span>.
    954. 

  954. </span></code></pre></div>
    955. 

  955. <div class="admonition warning">
    956. 

  956. <p class="admonition-title">Warning</p>
    957. 

  957. <p><code>compile</code> 옵션은 Windows와 macOS에서 지원되지 않습니다. 컴파일을 활성화하여 실행하려면 Triton을 직접 설치해야 합니다.</p>
    958. 

  958. </div>
    959. 

  959. <h2 id="docker">Docker 설정</h2>
    960. 

  960. <p>Fish Audio S2 시리즈 모델은 다양한 요구에 부응하기 위해 여러 Docker 배포 옵션을 제공합니다. Docker Hub의 사전 빌드된 이미지를 사용하거나, Docker Compose로 로컬에서 빌드하거나, 수동으로 사용자 정의 이미지를 빌드할 수 있습니다.</p>
    961. 

  961. <p>WebUI와 API 서버 모두에 대해 GPU(기본값 CUDA 12.6) 및 CPU 버전의 Docker 이미지를 제공합니다. Docker Hub의 사전 빌드된 이미지를 사용하거나, Docker Compose로 로컬에서 빌드하거나, 수동으로 사용자 정의 이미지를 빌드할 수 있습니다. 로컬에서 빌드하려면 아래 지침을 따르세요. 사전 빌드된 이미지를 사용하려면 <a href="../inference/">추론 가이드</a>를 직접 참조하세요.</p>
    962. 

  962. <h3 id="_3">사전 요구사항</h3>
    963. 

  963. <ul>
    964. 

  964. <li>Docker 및 Docker Compose 설치</li>
    965. 

  965. <li>NVIDIA Docker 런타임 설치 (GPU 지원용)</li>
    966. 

  966. <li>CUDA 추론을 위한 최소 24GB의 GPU 메모리</li>
    967. 

  967. </ul>
    968. 

  968. <h3 id="docker-compose">Docker Compose 사용</h3>
    969. 

  969. <p>개발 또는 사용자 정의를 위해 Docker Compose를 사용하여 로컬에서 빌드하고 실행할 수 있습니다:</p>
    970. 

  970. <div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="c1"># 먼저 리포지토리를 클론합니다</span>
    971. 

  971. </span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/fishaudio/fish-speech.git
    972. 

  972. </span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="nb">cd</span><span class="w"> </span>fish-speech
    973. 

  973. </span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a>
    974. 

  974. </span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="c1"># CUDA로 WebUI 시작</span>
    975. 

  975. </span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a>docker<span class="w"> </span>compose<span class="w"> </span>--profile<span class="w"> </span>webui<span class="w"> </span>up
    976. 

  976. </span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a>
    977. 

  977. </span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="c1"># 컴파일 최적화로 WebUI 시작</span>
    978. 

  978. </span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="nv">COMPILE</span><span class="o">=</span><span class="m">1</span><span class="w"> </span>docker<span class="w"> </span>compose<span class="w"> </span>--profile<span class="w"> </span>webui<span class="w"> </span>up
    979. 

  979. </span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a>
    980. 

  980. </span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="c1"># API 서버 시작</span>
    981. 

  981. </span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a>docker<span class="w"> </span>compose<span class="w"> </span>--profile<span class="w"> </span>server<span class="w"> </span>up
    982. 

  982. </span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a>
    983. 

  983. </span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a><span class="c1"># 컴파일 최적화로 API 서버 시작</span>
    984. 

  984. </span><span id="__span-4-15"><a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a><span class="nv">COMPILE</span><span class="o">=</span><span class="m">1</span><span class="w"> </span>docker<span class="w"> </span>compose<span class="w"> </span>--profile<span class="w"> </span>server<span class="w"> </span>up
    985. 

  985. </span><span id="__span-4-16"><a id="__codelineno-4-16" name="__codelineno-4-16" href="#__codelineno-4-16"></a>
    986. 

  986. </span><span id="__span-4-17"><a id="__codelineno-4-17" name="__codelineno-4-17" href="#__codelineno-4-17"></a><span class="c1"># CPU 전용 배포</span>
    987. 

  987. </span><span id="__span-4-18"><a id="__codelineno-4-18" name="__codelineno-4-18" href="#__codelineno-4-18"></a><span class="nv">BACKEND</span><span class="o">=</span>cpu<span class="w"> </span>docker<span class="w"> </span>compose<span class="w"> </span>--profile<span class="w"> </span>webui<span class="w"> </span>up
    988. 

  988. </span></code></pre></div>
    989. 

  989. <h4 id="docker-compose_1">Docker Compose 환경 변수</h4>
    990. 

  990. <p>환경 변수를 사용하여 배포를 사용자 정의할 수 있습니다:</p>
    991. 

  991. <div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="c1"># .env 파일 예시</span>
    992. 

  992. </span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="nv">BACKEND</span><span class="o">=</span>cuda<span class="w">              </span><span class="c1"># 또는 cpu</span>
    993. 

  993. </span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="nv">COMPILE</span><span class="o">=</span><span class="m">1</span><span class="w">                 </span><span class="c1"># 컴파일 최적화 활성화</span>
    994. 

  994. </span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="nv">GRADIO_PORT</span><span class="o">=</span><span class="m">7860</span><span class="w">         </span><span class="c1"># WebUI 포트</span>
    995. 

  995. </span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="nv">API_PORT</span><span class="o">=</span><span class="m">8080</span><span class="w">            </span><span class="c1"># API 서버 포트</span>
    996. 

  996. </span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="nv">UV_VERSION</span><span class="o">=</span><span class="m">0</span>.8.15<span class="w">        </span><span class="c1"># UV 패키지 관리자 버전</span>
    997. 

  997. </span></code></pre></div>
    998. 

  998. <p>이 명령은 이미지를 빌드하고 컨테이너를 실행합니다. WebUI는 <code>http://localhost:7860</code>에서, API 서버는 <code>http://localhost:8080</code>에서 접근할 수 있습니다.</p>
    999. 

  999. <h3 id="docker_1">수동 Docker 빌드</h3>
    1000. 

  1000. <p>빌드 프로세스를 사용자 정의하려는 고급 사용자를 위해:</p>
    1001. 

  1001. <div class="language-bash highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="c1"># CUDA를 지원하는 WebUI 이미지 빌드</span>
    1002. 

  1002. </span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>docker<span class="w"> </span>build<span class="w"> </span><span class="se">\</span>
    1003. 

  1003. </span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="w">    </span>--platform<span class="w"> </span>linux/amd64<span class="w"> </span><span class="se">\</span>
    1004. 

  1004. </span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w">    </span>-f<span class="w"> </span>docker/Dockerfile<span class="w"> </span><span class="se">\</span>
    1005. 

  1005. </span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="w">    </span>--build-arg<span class="w"> </span><span class="nv">BACKEND</span><span class="o">=</span>cuda<span class="w"> </span><span class="se">\</span>
    1006. 

  1006. </span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="w">    </span>--build-arg<span class="w"> </span><span class="nv">CUDA_VER</span><span class="o">=</span><span class="m">12</span>.6.0<span class="w"> </span><span class="se">\</span>
    1007. 

  1007. </span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="w">    </span>--build-arg<span class="w"> </span><span class="nv">UV_EXTRA</span><span class="o">=</span>cu126<span class="w"> </span><span class="se">\</span>
    1008. 

  1008. </span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="w">    </span>--target<span class="w"> </span>webui<span class="w"> </span><span class="se">\</span>
    1009. 

  1009. </span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="w">    </span>-t<span class="w"> </span>fish-speech-webui:cuda<span class="w"> </span>.
    1010. 

  1010. </span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a>
    1011. 

  1011. </span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="c1"># CUDA를 지원하는 API 서버 이미지 빌드</span>
    1012. 

  1012. </span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a>docker<span class="w"> </span>build<span class="w"> </span><span class="se">\</span>
    1013. 

  1013. </span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="w">    </span>--platform<span class="w"> </span>linux/amd64<span class="w"> </span><span class="se">\</span>
    1014. 

  1014. </span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="w">    </span>-f<span class="w"> </span>docker/Dockerfile<span class="w"> </span><span class="se">\</span>
    1015. 

  1015. </span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="w">    </span>--build-arg<span class="w"> </span><span class="nv">BACKEND</span><span class="o">=</span>cuda<span class="w"> </span><span class="se">\</span>
    1016. 

  1016. </span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="w">    </span>--build-arg<span class="w"> </span><span class="nv">CUDA_VER</span><span class="o">=</span><span class="m">12</span>.6.0<span class="w"> </span><span class="se">\</span>
    1017. 

  1017. </span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="w">    </span>--build-arg<span class="w"> </span><span class="nv">UV_EXTRA</span><span class="o">=</span>cu126<span class="w"> </span><span class="se">\</span>
    1018. 

  1018. </span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="w">    </span>--target<span class="w"> </span>server<span class="w"> </span><span class="se">\</span>
    1019. 

  1019. </span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="w">    </span>-t<span class="w"> </span>fish-speech-server:cuda<span class="w"> </span>.
    1020. 

  1020. </span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a>
    1021. 

  1021. </span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a><span class="c1"># CPU 전용 이미지 빌드 (멀티 플랫폼 지원)</span>
    1022. 

  1022. </span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a>docker<span class="w"> </span>build<span class="w"> </span><span class="se">\</span>
    1023. 

  1023. </span><span id="__span-6-23"><a id="__codelineno-6-23" name="__codelineno-6-23" href="#__codelineno-6-23"></a><span class="w">    </span>--platform<span class="w"> </span>linux/amd64,linux/arm64<span class="w"> </span><span class="se">\</span>
    1024. 

  1024. </span><span id="__span-6-24"><a id="__codelineno-6-24" name="__codelineno-6-24" href="#__codelineno-6-24"></a><span class="w">    </span>-f<span class="w"> </span>docker/Dockerfile<span class="w"> </span><span class="se">\</span>
    1025. 

  1025. </span><span id="__span-6-25"><a id="__codelineno-6-25" name="__codelineno-6-25" href="#__codelineno-6-25"></a><span class="w">    </span>--build-arg<span class="w"> </span><span class="nv">BACKEND</span><span class="o">=</span>cpu<span class="w"> </span><span class="se">\</span>
    1026. 

  1026. </span><span id="__span-6-26"><a id="__codelineno-6-26" name="__codelineno-6-26" href="#__codelineno-6-26"></a><span class="w">    </span>--target<span class="w"> </span>webui<span class="w"> </span><span class="se">\</span>
    1027. 

  1027. </span><span id="__span-6-27"><a id="__codelineno-6-27" name="__codelineno-6-27" href="#__codelineno-6-27"></a><span class="w">    </span>-t<span class="w"> </span>fish-speech-webui:cpu<span class="w"> </span>.
    1028. 

  1028. </span><span id="__span-6-28"><a id="__codelineno-6-28" name="__codelineno-6-28" href="#__codelineno-6-28"></a>
    1029. 

  1029. </span><span id="__span-6-29"><a id="__codelineno-6-29" name="__codelineno-6-29" href="#__codelineno-6-29"></a><span class="c1"># 개발용 이미지 빌드</span>
    1030. 

  1030. </span><span id="__span-6-30"><a id="__codelineno-6-30" name="__codelineno-6-30" href="#__codelineno-6-30"></a>docker<span class="w"> </span>build<span class="w"> </span><span class="se">\</span>
    1031. 

  1031. </span><span id="__span-6-31"><a id="__codelineno-6-31" name="__codelineno-6-31" href="#__codelineno-6-31"></a><span class="w">    </span>--platform<span class="w"> </span>linux/amd64<span class="w"> </span><span class="se">\</span>
    1032. 

  1032. </span><span id="__span-6-32"><a id="__codelineno-6-32" name="__codelineno-6-32" href="#__codelineno-6-32"></a><span class="w">    </span>-f<span class="w"> </span>docker/Dockerfile<span class="w"> </span><span class="se">\</span>
    1033. 

  1033. </span><span id="__span-6-33"><a id="__codelineno-6-33" name="__codelineno-6-33" href="#__codelineno-6-33"></a><span class="w">    </span>--build-arg<span class="w"> </span><span class="nv">BACKEND</span><span class="o">=</span>cuda<span class="w"> </span><span class="se">\</span>
    1034. 

  1034. </span><span id="__span-6-34"><a id="__codelineno-6-34" name="__codelineno-6-34" href="#__codelineno-6-34"></a><span class="w">    </span>--target<span class="w"> </span>dev<span class="w"> </span><span class="se">\</span>
    1035. 

  1035. </span><span id="__span-6-35"><a id="__codelineno-6-35" name="__codelineno-6-35" href="#__codelineno-6-35"></a><span class="w">    </span>-t<span class="w"> </span>fish-speech-dev:cuda<span class="w"> </span>.
    1036. 

  1036. </span></code></pre></div>
    1037. 

  1037. <h4 id="_4">빌드 인자</h4>
    1038. 

  1038. <ul>
    1039. 

  1039. <li><code>BACKEND</code>: <code>cuda</code> 또는 <code>cpu</code> (기본값: <code>cuda</code>)</li>
    1040. 

  1040. <li><code>CUDA_VER</code>: CUDA 버전 (기본값: <code>12.6.0</code>)</li>
    1041. 

  1041. <li><code>UV_EXTRA</code>: CUDA용 UV 추가 패키지 (기본값: <code>cu126</code>)</li>
    1042. 

  1042. <li><code>UBUNTU_VER</code>: Ubuntu 버전 (기본값: <code>24.04</code>)</li>
    1043. 

  1043. <li><code>PY_VER</code>: Python 버전 (기본값: <code>3.12</code>)</li>
    1044. 

  1044. </ul>
    1045. 

  1045. <h3 id="_5">볼륨 마운트</h3>
    1046. 

  1046. <p>두 방법 모두 다음 디렉토리를 마운트해야 합니다:</p>
    1047. 

  1047. <ul>
    1048. 

  1048. <li><code>./checkpoints:/app/checkpoints</code> - 모델 가중치 디렉토리</li>
    1049. 

  1049. <li><code>./references:/app/references</code> - 참조 오디오 파일 디렉토리</li>
    1050. 

  1050. </ul>
    1051. 

  1051. <h3 id="_6">환경 변수</h3>
    1052. 

  1052. <ul>
    1053. 

  1053. <li><code>COMPILE=1</code> - <code>torch.compile</code>을 활성화하여 추론 속도 향상 (약 10배)</li>
    1054. 

  1054. <li><code>GRADIO_SERVER_NAME=0.0.0.0</code> - WebUI 서버 호스트</li>
    1055. 

  1055. <li><code>GRADIO_SERVER_PORT=7860</code> - WebUI 서버 포트</li>
    1056. 

  1056. <li><code>API_SERVER_NAME=0.0.0.0</code> - API 서버 호스트</li>
    1057. 

  1057. <li><code>API_SERVER_PORT=8080</code> - API 서버 포트</li>
    1058. 

  1058. </ul>
    1059. 

  1059. <div class="admonition note">
    1060. 

  1060. <p class="admonition-title">Note</p>
    1061. 

  1061. <p>Docker 컨테이너는 모델 가중치가 <code>/app/checkpoints</code>에 마운트될 것으로 예상합니다. 컨테이너를 시작하기 전에 필요한 모델 가중치를 다운로드했는지 확인하세요.</p>
    1062. 

  1062. </div>
    1063. 

  1063. <div class="admonition warning">
    1064. 

  1064. <p class="admonition-title">Warning</p>
    1065. 

  1065. <p>GPU 지원에는 NVIDIA Docker 런타임이 필요합니다. CPU 전용 배포의 경우 <code>--gpus all</code> 플래그를 제거하고 CPU 이미지를 사용하세요.</p>
    1066. 

  1066. </div>
    1067. 

  1067. 

  1068. 

  1069. 

  1070. 

  1071. 

  1072. 

  1073. 

  1074. 

  1075. 

  1076. 

  1077. 

  1078. 

  1079.                 
    1080. 

  1080.               </article>
    1081. 

  1081.             </div>
    1082. 

  1082.           
    1083. 

  1083.           
    1084. 

  1084. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
    1085. 

  1085.         </div>
    1086. 

  1086.         
    1087. 

  1087.       </main>
    1088. 

  1088.       
    1089. 

  1089.         <footer class="md-footer">
    1090. 

  1090.   
    1091. 

  1091.     
    1092. 

  1092.       
    1093. 

  1093.       <nav class="md-footer__inner md-grid" aria-label="하단/푸터" >
    1094. 

  1094.         
    1095. 

  1095.           
    1096. 

  1096.           <a href="../" class="md-footer__link md-footer__link--prev" aria-label="이전: 소개">
    1097. 

  1097.             <div class="md-footer__button md-icon">
    1098. 

  1098.               
    1099. 

  1099.               <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
    1100. 

  1100.             </div>
    1101. 

  1101.             <div class="md-footer__title">
    1102. 

  1102.               <span class="md-footer__direction">
    1103. 

  1103.                 이전
    1104. 

  1104.               </span>
    1105. 

  1105.               <div class="md-ellipsis">
    1106. 

  1106.                 소개
    1107. 

  1107.               </div>
    1108. 

  1108.             </div>
    1109. 

  1109.           </a>
    1110. 

  1110.         
    1111. 

  1111.         
    1112. 

  1112.           
    1113. 

  1113.           <a href="../finetune/" class="md-footer__link md-footer__link--next" aria-label="다음: 파인튜닝">
    1114. 

  1114.             <div class="md-footer__title">
    1115. 

  1115.               <span class="md-footer__direction">
    1116. 

  1116.                 다음
    1117. 

  1117.               </span>
    1118. 

  1118.               <div class="md-ellipsis">
    1119. 

  1119.                 파인튜닝
    1120. 

  1120.               </div>
    1121. 

  1121.             </div>
    1122. 

  1122.             <div class="md-footer__button md-icon">
    1123. 

  1123.               
    1124. 

  1124.               <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11z"/></svg>
    1125. 

  1125.             </div>
    1126. 

  1126.           </a>
    1127. 

  1127.         
    1128. 

  1128.       </nav>
    1129. 

  1129.     
    1130. 

  1130.   
    1131. 

  1131.   <div class="md-footer-meta md-typeset">
    1132. 

  1132.     <div class="md-footer-meta__inner md-grid">
    1133. 

  1133.       <div class="md-copyright">
    1134. 

  1134.   
    1135. 

  1135.     <div class="md-copyright__highlight">
    1136. 

  1136.       Copyright &copy; 2023-2025 by Fish Audio
    1137. 

  1137.     </div>
    1138. 

  1138.   
    1139. 

  1139.   
    1140. 

  1140.     Made with
    1141. 

  1141.     <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
    1142. 

  1142.       Material for MkDocs
    1143. 

  1143.     </a>
    1144. 

  1144.   
    1145. 

  1145. </div>
    1146. 

  1146.       
    1147. 

  1147.         
    1148. 

  1148. <div class="md-social">
    1149. 

  1149.   
    1150. 

  1150.     
    1151. 

  1151.     
    1152. 

  1152.     
    1153. 

  1153.     
    1154. 

  1154.       
    1155. 

  1155.       
    1156. 

  1156.     
    1157. 

  1157.     <a href="https://discord.gg/Es5qTB9BcN" target="_blank" rel="noopener" title="discord.gg" class="md-social__link">
    1158. 

  1158.       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M492.5 69.8c-.2-.3-.4-.6-.8-.7-38.1-17.5-78.4-30-119.7-37.1-.4-.1-.8 0-1.1.1s-.6.4-.8.8c-5.5 9.9-10.5 20.2-14.9 30.6-44.6-6.8-89.9-6.8-134.4 0-4.5-10.5-9.5-20.7-15.1-30.6-.2-.3-.5-.6-.8-.8s-.7-.2-1.1-.2C162.5 39 122.2 51.5 84.1 69c-.3.1-.6.4-.8.7C7.1 183.5-13.8 294.6-3.6 404.2c0 .3.1.5.2.8s.3.4.5.6c44.4 32.9 94 58 146.8 74.2.4.1.8.1 1.1 0s.7-.4.9-.7c11.3-15.4 21.4-31.8 30-48.8.1-.2.2-.5.2-.8s0-.5-.1-.8-.2-.5-.4-.6-.4-.3-.7-.4c-15.8-6.1-31.2-13.4-45.9-21.9-.3-.2-.5-.4-.7-.6s-.3-.6-.3-.9 0-.6.2-.9.3-.5.6-.7c3.1-2.3 6.2-4.7 9.1-7.1.3-.2.6-.4.9-.4s.7 0 1 .1c96.2 43.9 200.4 43.9 295.5 0 .3-.1.7-.2 1-.2s.7.2.9.4c2.9 2.4 6 4.9 9.1 7.2.2.2.4.4.6.7s.2.6.2.9-.1.6-.3.9-.4.5-.6.6c-14.7 8.6-30 15.9-45.9 21.8-.2.1-.5.2-.7.4s-.3.4-.4.7-.1.5-.1.8.1.5.2.8c8.8 17 18.8 33.3 30 48.8.2.3.6.6.9.7s.8.1 1.1 0c52.9-16.2 102.6-41.3 147.1-74.2.2-.2.4-.4.5-.6s.2-.5.2-.8c12.3-126.8-20.5-236.9-86.9-334.5zm-302 267.7c-29 0-52.8-26.6-52.8-59.2s23.4-59.2 52.8-59.2c29.7 0 53.3 26.8 52.8 59.2 0 32.7-23.4 59.2-52.8 59.2m195.4 0c-29 0-52.8-26.6-52.8-59.2s23.4-59.2 52.8-59.2c29.7 0 53.3 26.8 52.8 59.2 0 32.7-23.2 59.2-52.8 59.2"/></svg>
    1159. 

  1159.     </a>
    1160. 

  1160.   
    1161. 

  1161.     
    1162. 

  1162.     
    1163. 

  1163.     
    1164. 

  1164.     
    1165. 

  1165.       
    1166. 

  1166.       
    1167. 

  1167.     
    1168. 

  1168.     <a href="https://hub.docker.com/r/fishaudio/fish-speech" target="_blank" rel="noopener" title="hub.docker.com" class="md-social__link">
    1169. 

  1169.       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M349.9 236.3h-66.1v-59.4h66.1zm0-204.3h-66.1v60.7h66.1zm78.2 144.8H362v59.4h66.1zm-156.3-72.1h-66.1v60.1h66.1zm78.1 0h-66.1v60.1h66.1zm276.8 100c-14.4-9.7-47.6-13.2-73.1-8.4-3.3-24-16.7-44.9-41.1-63.7l-14-9.3-9.3 14c-18.4 27.8-23.4 73.6-3.7 103.8-8.7 4.7-25.8 11.1-48.4 10.7H2.4c-8.7 50.8 5.8 116.8 44 162.1 37.1 43.9 92.7 66.2 165.4 66.2 157.4 0 273.9-72.5 328.4-204.2 21.4.4 67.6.1 91.3-45.2 1.5-2.5 6.6-13.2 8.5-17.1zm-511.1-27.9h-66v59.4h66.1v-59.4zm78.1 0h-66.1v59.4h66.1zm78.1 0h-66.1v59.4h66.1zm-78.1-72.1h-66.1v60.1h66.1z"/></svg>
    1170. 

  1170.     </a>
    1171. 

  1171.   
    1172. 

  1172.     
    1173. 

  1173.     
    1174. 

  1174.     
    1175. 

  1175.     
    1176. 

  1176.       
    1177. 

  1177.       
    1178. 

  1178.     
    1179. 

  1179.     <a href="http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=jCKlUP7QgSm9kh95UlBoYv6s1I-Apl1M&authKey=xI5ttVAp3do68IpEYEalwXSYZFdfxZSkah%2BctF5FIMyN2NqAa003vFtLqJyAVRfF&noverify=0&group_code=593946093" target="_blank" rel="noopener" title="qm.qq.com" class="md-social__link">
    1180. 

  1180.       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M434.1 420.4c-11.5 1.4-44.9-52.7-44.9-52.7 0 31.3-16.1 72.2-51 101.8 16.8 5.2 54.8 19.2 45.8 34.4-7.3 12.3-125.5 7.9-159.6 4-34.1 3.8-152.3 8.3-159.6-4-9-15.2 28.9-29.2 45.8-34.4-34.9-29.5-51.1-70.4-51.1-101.8 0 0-33.3 54.1-44.9 52.7-5.4-.6-12.4-29.6 9.3-99.7 10.3-33 22-60.5 40.1-105.8C60.9 98 109.2-.1 224.3-.1 338-.1 387.5 96 384.6 214.9c18.1 45.2 29.9 72.9 40.1 105.8 21.8 70.1 14.7 99.1 9.3 99.7z"/></svg>
    1181. 

  1181.     </a>
    1182. 

  1182.   
    1183. 

  1183. </div>
    1184. 

  1184.       
    1185. 

  1185.     </div>
    1186. 

  1186.   </div>
    1187. 

  1187. </footer>
    1188. 

  1188.       
    1189. 

  1189.     </div>
    1190. 

  1190.     <div class="md-dialog" data-md-component="dialog">
    1191. 

  1191.       <div class="md-dialog__inner md-typeset"></div>
    1192. 

  1192.     </div>
    1193. 

  1193.     
    1194. 

  1194.     
    1195. 

  1195.     
    1196. 

  1196.       
    1197. 

  1197.       
    1198. 

  1198.       <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["content.action.edit", "content.action.view", "navigation.tracking", "navigation.footer", "search", "search.suggest", "search.highlight", "search.share", "content.code.copy"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "\ud074\ub9bd\ubcf4\ub4dc\uc5d0 \ubcf5\uc0ac\ub428", "clipboard.copy": "\ud074\ub9bd\ubcf4\ub4dc\ub85c \ubcf5\uc0ac", "search.result.more.one": "\uc774 \ubb38\uc11c\uc5d0\uc11c 1\uac1c\uc758 \uac80\uc0c9 \uacb0\uacfc \ub354 \ubcf4\uae30", "search.result.more.other": "\uc774 \ubb38\uc11c\uc5d0\uc11c #\uac1c\uc758 \uac80\uc0c9 \uacb0\uacfc \ub354 \ubcf4\uae30", "search.result.none": "\uac80\uc0c9\uc5b4\uc640 \uc77c\uce58\ud558\ub294 \ubb38\uc11c\uac00 \uc5c6\uc2b5\ub2c8\ub2e4", "search.result.one": "1\uac1c\uc758 \uc77c\uce58\ud558\ub294 \ubb38\uc11c", "search.result.other": "#\uac1c\uc758 \uc77c\uce58\ud558\ub294 \ubb38\uc11c", "search.result.placeholder": "\uac80\uc0c9\uc5b4\ub97c \uc785\ub825\ud558\uc138\uc694", "search.result.term.missing": "\ud3ec\ud568\ub418\uc9c0 \uc54a\uc740 \uac80\uc0c9\uc5b4", "select.version": "\ubc84\uc804 \uc120\ud0dd"}, "version": null}</script>
    1199. 

  1199.     
    1200. 

  1200.     
    1201. 

  1201.       <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
    1202. 

  1202.       
    1203. 

  1203.     
    1204. 

  1204.   </body>
    1205. 

  1205. </html>
    1206.