You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

index.html 41 kB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909
  1. <!doctype html>
  2. <html lang="en" class="no-js">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width,initial-scale=1">
  6. <link rel="prev" href="..">
  7. <link rel="next" href="../Architecture/">
  8. <link rel="icon" href="../assets/images/favicon.png">
  9. <meta name="generator" content="mkdocs-1.4.3, mkdocs-material-9.1.16">
  10. <title>Get Started - LLamaSharp Documentation</title>
  11. <link rel="stylesheet" href="../assets/stylesheets/main.26e3688c.min.css">
  12. <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  13. <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">
  14. <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
  15. <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>
  16. </head>
  17. <body dir="ltr">
  18. <script>var palette=__md_get("__palette");if(palette&&"object"==typeof palette.color)for(var key of Object.keys(palette.color))document.body.setAttribute("data-md-color-"+key,palette.color[key])</script>
  19. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  20. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  21. <label class="md-overlay" for="__drawer"></label>
  22. <div data-md-component="skip">
  23. <a href="#get-started" class="md-skip">
  24. Skip to content
  25. </a>
  26. </div>
  27. <div data-md-component="announce">
  28. </div>
  29. <div data-md-color-scheme="default" data-md-component="outdated" hidden>
  30. </div>
  31. <header class="md-header md-header--shadow" data-md-component="header">
  32. <nav class="md-header__inner md-grid" aria-label="Header">
  33. <a href=".." title="LLamaSharp Documentation" class="md-header__button md-logo" aria-label="LLamaSharp Documentation" data-md-component="logo">
  34. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
  35. </a>
  36. <label class="md-header__button md-icon" for="__drawer">
  37. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
  38. </label>
  39. <div class="md-header__title" data-md-component="header-title">
  40. <div class="md-header__ellipsis">
  41. <div class="md-header__topic">
  42. <span class="md-ellipsis">
  43. LLamaSharp Documentation
  44. </span>
  45. </div>
  46. <div class="md-header__topic" data-md-component="header-topic">
  47. <span class="md-ellipsis">
  48. Get Started
  49. </span>
  50. </div>
  51. </div>
  52. </div>
  53. <label class="md-header__button md-icon" for="__search">
  54. <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.516 6.516 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 5Z"/></svg>
  55. </label>
  56. <div class="md-search" data-md-component="search" role="dialog">
  57. <label class="md-search__overlay" for="__search"></label>
  58. <div class="md-search__inner" role="search">
  59. <form class="md-search__form" name="search">
  60. <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
  61. <label class="md-search__icon md-icon" for="__search">
  62. <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.516 6.516 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 5Z"/></svg>
  63. <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 11h12Z"/></svg>
  64. </label>
  65. <nav class="md-search__options" aria-label="Search">
  66. <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
  67. <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 12 19 6.41Z"/></svg>
  68. </button>
  69. </nav>
  70. </form>
  71. <div class="md-search__output">
  72. <div class="md-search__scrollwrap" data-md-scrollfix>
  73. <div class="md-search-result" data-md-component="search-result">
  74. <div class="md-search-result__meta">
  75. Initializing search
  76. </div>
  77. <ol class="md-search-result__list" role="presentation"></ol>
  78. </div>
  79. </div>
  80. </div>
  81. </div>
  82. </div>
  83. </nav>
  84. </header>
  85. <div class="md-container" data-md-component="container">
  86. <main class="md-main" data-md-component="main">
  87. <div class="md-main__inner md-grid">
  88. <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
  89. <div class="md-sidebar__scrollwrap">
  90. <div class="md-sidebar__inner">
  91. <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
  92. <label class="md-nav__title" for="__drawer">
  93. <a href=".." title="LLamaSharp Documentation" class="md-nav__button md-logo" aria-label="LLamaSharp Documentation" data-md-component="logo">
  94. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
  95. </a>
  96. LLamaSharp Documentation
  97. </label>
  98. <ul class="md-nav__list" data-md-scrollfix>
  99. <li class="md-nav__item">
  100. <a href=".." class="md-nav__link">
  101. Overview
  102. </a>
  103. </li>
  104. <li class="md-nav__item md-nav__item--active">
  105. <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
  106. <label class="md-nav__link md-nav__link--active" for="__toc">
  107. Get Started
  108. <span class="md-nav__icon md-icon"></span>
  109. </label>
  110. <a href="./" class="md-nav__link md-nav__link--active">
  111. Get Started
  112. </a>
  113. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  114. <label class="md-nav__title" for="__toc">
  115. <span class="md-nav__icon md-icon"></span>
  116. Table of contents
  117. </label>
  118. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  119. <li class="md-nav__item">
  120. <a href="#install-packages" class="md-nav__link">
  121. Install packages
  122. </a>
  123. </li>
  124. <li class="md-nav__item">
  125. <a href="#download-a-model" class="md-nav__link">
  126. Download a model
  127. </a>
  128. </li>
  129. <li class="md-nav__item">
  130. <a href="#run-the-program" class="md-nav__link">
  131. Run the program
  132. </a>
  133. </li>
  134. </ul>
  135. </nav>
  136. </li>
  137. <li class="md-nav__item">
  138. <a href="../Architecture/" class="md-nav__link">
  139. Architecture
  140. </a>
  141. </li>
  142. <li class="md-nav__item">
  143. <a href="../Tricks/" class="md-nav__link">
  144. Tricks for FAQ
  145. </a>
  146. </li>
  147. <li class="md-nav__item">
  148. <a href="../ContributingGuide/" class="md-nav__link">
  149. Contributing Guide
  150. </a>
  151. </li>
  152. <li class="md-nav__item md-nav__item--nested">
  153. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
  154. <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
  155. LLamaModel
  156. <span class="md-nav__icon md-icon"></span>
  157. </label>
  158. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
  159. <label class="md-nav__title" for="__nav_6">
  160. <span class="md-nav__icon md-icon"></span>
  161. LLamaModel
  162. </label>
  163. <ul class="md-nav__list" data-md-scrollfix>
  164. <li class="md-nav__item">
  165. <a href="../LLamaModel/parameters/" class="md-nav__link">
  166. Model Parameters
  167. </a>
  168. </li>
  169. <li class="md-nav__item">
  170. <a href="../LLamaModel/tokenization/" class="md-nav__link">
  171. Tokenization
  172. </a>
  173. </li>
  174. <li class="md-nav__item">
  175. <a href="../LLamaModel/embeddings/" class="md-nav__link">
  176. Get Embeddings
  177. </a>
  178. </li>
  179. <li class="md-nav__item">
  180. <a href="../LLamaModel/quantization/" class="md-nav__link">
  181. Quantization
  182. </a>
  183. </li>
  184. <li class="md-nav__item">
  185. <a href="../LLamaModel/save-load-state/" class="md-nav__link">
  186. Save/Load State
  187. </a>
  188. </li>
  189. </ul>
  190. </nav>
  191. </li>
  192. <li class="md-nav__item md-nav__item--nested">
  193. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
  194. <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
  195. LLamaExecutors
  196. <span class="md-nav__icon md-icon"></span>
  197. </label>
  198. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
  199. <label class="md-nav__title" for="__nav_7">
  200. <span class="md-nav__icon md-icon"></span>
  201. LLamaExecutors
  202. </label>
  203. <ul class="md-nav__list" data-md-scrollfix>
  204. <li class="md-nav__item">
  205. <a href="../LLamaExecutors/parameters/" class="md-nav__link">
  206. Inference Parameters
  207. </a>
  208. </li>
  209. <li class="md-nav__item">
  210. <a href="../LLamaExecutors/text-to-text-apis/" class="md-nav__link">
  211. Text-to-Text APIs
  212. </a>
  213. </li>
  214. <li class="md-nav__item">
  215. <a href="../LLamaExecutors/save-load-state/" class="md-nav__link">
  216. Save/Load State
  217. </a>
  218. </li>
  219. <li class="md-nav__item">
  220. <a href="../LLamaExecutors/differences/" class="md-nav__link">
  221. Differences of Executors
  222. </a>
  223. </li>
  224. </ul>
  225. </nav>
  226. </li>
  227. <li class="md-nav__item md-nav__item--nested">
  228. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
  229. <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
  230. ChatSession
  231. <span class="md-nav__icon md-icon"></span>
  232. </label>
  233. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
  234. <label class="md-nav__title" for="__nav_8">
  235. <span class="md-nav__icon md-icon"></span>
  236. ChatSession
  237. </label>
  238. <ul class="md-nav__list" data-md-scrollfix>
  239. <li class="md-nav__item">
  240. <a href="../ChatSession/basic-usages/" class="md-nav__link">
  241. Basic Usages
  242. </a>
  243. </li>
  244. <li class="md-nav__item">
  245. <a href="../ChatSession/transforms/" class="md-nav__link">
  246. Transoforms
  247. </a>
  248. </li>
  249. <li class="md-nav__item">
  250. <a href="../ChatSession/save-load-session/" class="md-nav__link">
  251. Save/Load Session
  252. </a>
  253. </li>
  254. </ul>
  255. </nav>
  256. </li>
  257. <li class="md-nav__item md-nav__item--nested">
  258. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
  259. <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
  260. Non-English Usages
  261. <span class="md-nav__icon md-icon"></span>
  262. </label>
  263. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
  264. <label class="md-nav__title" for="__nav_9">
  265. <span class="md-nav__icon md-icon"></span>
  266. Non-English Usages
  267. </label>
  268. <ul class="md-nav__list" data-md-scrollfix>
  269. <li class="md-nav__item">
  270. <a href="../NonEnglishUsage/Chinese/" class="md-nav__link">
  271. Chinese
  272. </a>
  273. </li>
  274. </ul>
  275. </nav>
  276. </li>
  277. <li class="md-nav__item md-nav__item--nested">
  278. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_10" >
  279. <label class="md-nav__link" for="__nav_10" id="__nav_10_label" tabindex="0">
  280. High-level Applications
  281. <span class="md-nav__icon md-icon"></span>
  282. </label>
  283. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_10_label" aria-expanded="false">
  284. <label class="md-nav__title" for="__nav_10">
  285. <span class="md-nav__icon md-icon"></span>
  286. High-level Applications
  287. </label>
  288. <ul class="md-nav__list" data-md-scrollfix>
  289. <li class="md-nav__item">
  290. <a href="../HighLevelApps/bot-sharp/" class="md-nav__link">
  291. BotSharp
  292. </a>
  293. </li>
  294. </ul>
  295. </nav>
  296. </li>
  297. <li class="md-nav__item md-nav__item--nested">
  298. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_11" >
  299. <label class="md-nav__link" for="__nav_11" id="__nav_11_label" tabindex="0">
  300. More
  301. <span class="md-nav__icon md-icon"></span>
  302. </label>
  303. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_11_label" aria-expanded="false">
  304. <label class="md-nav__title" for="__nav_11">
  305. <span class="md-nav__icon md-icon"></span>
  306. More
  307. </label>
  308. <ul class="md-nav__list" data-md-scrollfix>
  309. <li class="md-nav__item">
  310. <a href="../More/log/" class="md-nav__link">
  311. Logger
  312. </a>
  313. </li>
  314. </ul>
  315. </nav>
  316. </li>
  317. <li class="md-nav__item md-nav__item--nested">
  318. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_12" >
  319. <label class="md-nav__link" for="__nav_12" id="__nav_12_label" tabindex="0">
  320. Examples
  321. <span class="md-nav__icon md-icon"></span>
  322. </label>
  323. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_12_label" aria-expanded="false">
  324. <label class="md-nav__title" for="__nav_12">
  325. <span class="md-nav__icon md-icon"></span>
  326. Examples
  327. </label>
  328. <ul class="md-nav__list" data-md-scrollfix>
  329. <li class="md-nav__item">
  330. <a href="../Examples/ChatSessionStripRoleName/" class="md-nav__link">
  331. Chat session 1
  332. </a>
  333. </li>
  334. <li class="md-nav__item">
  335. <a href="../Examples/ChatSessionWithRoleName/" class="md-nav__link">
  336. Chat session 2
  337. </a>
  338. </li>
  339. <li class="md-nav__item">
  340. <a href="../Examples/GetEmbeddings/" class="md-nav__link">
  341. Get embeddings
  342. </a>
  343. </li>
  344. <li class="md-nav__item">
  345. <a href="../Examples/InstructModeExecute/" class="md-nav__link">
  346. Instruct executor
  347. </a>
  348. </li>
  349. <li class="md-nav__item">
  350. <a href="../Examples/InteractiveModeExecute/" class="md-nav__link">
  351. Interactive executor
  352. </a>
  353. </li>
  354. <li class="md-nav__item">
  355. <a href="../Examples/StatelessModeExecute/" class="md-nav__link">
  356. Stateless exeutor
  357. </a>
  358. </li>
  359. <li class="md-nav__item">
  360. <a href="../Examples/LoadAndSaveSession/" class="md-nav__link">
  361. Load/Save session
  362. </a>
  363. </li>
  364. <li class="md-nav__item">
  365. <a href="../Examples/LoadAndSaveState/" class="md-nav__link">
  366. Load/Save state
  367. </a>
  368. </li>
  369. <li class="md-nav__item">
  370. <a href="../Examples/QuantizeModel/" class="md-nav__link">
  371. Quantize model
  372. </a>
  373. </li>
  374. </ul>
  375. </nav>
  376. </li>
  377. <li class="md-nav__item md-nav__item--nested">
  378. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_13" >
  379. <label class="md-nav__link" for="__nav_13" id="__nav_13_label" tabindex="0">
  380. API Reference
  381. <span class="md-nav__icon md-icon"></span>
  382. </label>
  383. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_13_label" aria-expanded="false">
  384. <label class="md-nav__title" for="__nav_13">
  385. <span class="md-nav__icon md-icon"></span>
  386. API Reference
  387. </label>
  388. <ul class="md-nav__list" data-md-scrollfix>
  389. <li class="md-nav__item">
  390. <a href="../xmldocs/" class="md-nav__link">
  391. index
  392. </a>
  393. </li>
  394. <li class="md-nav__item">
  395. <a href="../xmldocs/llama.abstractions.ihistorytransform/" class="md-nav__link">
  396. llama.abstractions.ihistorytransform
  397. </a>
  398. </li>
  399. <li class="md-nav__item">
  400. <a href="../xmldocs/llama.abstractions.illamaexecutor/" class="md-nav__link">
  401. llama.abstractions.illamaexecutor
  402. </a>
  403. </li>
  404. <li class="md-nav__item">
  405. <a href="../xmldocs/llama.abstractions.itextstreamtransform/" class="md-nav__link">
  406. llama.abstractions.itextstreamtransform
  407. </a>
  408. </li>
  409. <li class="md-nav__item">
  410. <a href="../xmldocs/llama.abstractions.itexttransform/" class="md-nav__link">
  411. llama.abstractions.itexttransform
  412. </a>
  413. </li>
  414. <li class="md-nav__item">
  415. <a href="../xmldocs/llama.chatsession/" class="md-nav__link">
  416. llama.chatsession
  417. </a>
  418. </li>
  419. <li class="md-nav__item">
  420. <a href="../xmldocs/llama.common.authorrole/" class="md-nav__link">
  421. llama.common.authorrole
  422. </a>
  423. </li>
  424. <li class="md-nav__item">
  425. <a href="../xmldocs/llama.common.chathistory/" class="md-nav__link">
  426. llama.common.chathistory
  427. </a>
  428. </li>
  429. <li class="md-nav__item">
  430. <a href="../xmldocs/llama.common.fixedsizequeue-1/" class="md-nav__link">
  431. llama.common.fixedsizequeue-1
  432. </a>
  433. </li>
  434. <li class="md-nav__item">
  435. <a href="../xmldocs/llama.common.illamalogger/" class="md-nav__link">
  436. llama.common.illamalogger
  437. </a>
  438. </li>
  439. <li class="md-nav__item">
  440. <a href="../xmldocs/llama.common.inferenceparams/" class="md-nav__link">
  441. llama.common.inferenceparams
  442. </a>
  443. </li>
  444. <li class="md-nav__item">
  445. <a href="../xmldocs/llama.common.llamadefaultlogger/" class="md-nav__link">
  446. llama.common.llamadefaultlogger
  447. </a>
  448. </li>
  449. <li class="md-nav__item">
  450. <a href="../xmldocs/llama.common.mirostatetype/" class="md-nav__link">
  451. llama.common.mirostatetype
  452. </a>
  453. </li>
  454. <li class="md-nav__item">
  455. <a href="../xmldocs/llama.common.modelparams/" class="md-nav__link">
  456. llama.common.modelparams
  457. </a>
  458. </li>
  459. <li class="md-nav__item">
  460. <a href="../xmldocs/llama.exceptions.runtimeerror/" class="md-nav__link">
  461. llama.exceptions.runtimeerror
  462. </a>
  463. </li>
  464. <li class="md-nav__item">
  465. <a href="../xmldocs/llama.extensions.dictionaryextension/" class="md-nav__link">
  466. llama.extensions.dictionaryextension
  467. </a>
  468. </li>
  469. <li class="md-nav__item">
  470. <a href="../xmldocs/llama.instructexecutor/" class="md-nav__link">
  471. llama.instructexecutor
  472. </a>
  473. </li>
  474. <li class="md-nav__item">
  475. <a href="../xmldocs/llama.interactiveexecutor/" class="md-nav__link">
  476. llama.interactiveexecutor
  477. </a>
  478. </li>
  479. <li class="md-nav__item">
  480. <a href="../xmldocs/llama.llamaembedder/" class="md-nav__link">
  481. llama.llamaembedder
  482. </a>
  483. </li>
  484. <li class="md-nav__item">
  485. <a href="../xmldocs/llama.llamamodel/" class="md-nav__link">
  486. llama.llamamodel
  487. </a>
  488. </li>
  489. <li class="md-nav__item">
  490. <a href="../xmldocs/llama.llamaquantizer/" class="md-nav__link">
  491. llama.llamaquantizer
  492. </a>
  493. </li>
  494. <li class="md-nav__item">
  495. <a href="../xmldocs/llama.llamatransforms/" class="md-nav__link">
  496. llama.llamatransforms
  497. </a>
  498. </li>
  499. <li class="md-nav__item">
  500. <a href="../xmldocs/llama.native.llamacontextparams/" class="md-nav__link">
  501. llama.native.llamacontextparams
  502. </a>
  503. </li>
  504. <li class="md-nav__item">
  505. <a href="../xmldocs/llama.native.llamaftype/" class="md-nav__link">
  506. llama.native.llamaftype
  507. </a>
  508. </li>
  509. <li class="md-nav__item">
  510. <a href="../xmldocs/llama.native.llamatokendata/" class="md-nav__link">
  511. llama.native.llamatokendata
  512. </a>
  513. </li>
  514. <li class="md-nav__item">
  515. <a href="../xmldocs/llama.native.llamatokendataarray/" class="md-nav__link">
  516. llama.native.llamatokendataarray
  517. </a>
  518. </li>
  519. <li class="md-nav__item">
  520. <a href="../xmldocs/llama.native.llamatokendataarraynative/" class="md-nav__link">
  521. llama.native.llamatokendataarraynative
  522. </a>
  523. </li>
  524. <li class="md-nav__item">
  525. <a href="../xmldocs/llama.native.nativeapi/" class="md-nav__link">
  526. llama.native.nativeapi
  527. </a>
  528. </li>
  529. <li class="md-nav__item">
  530. <a href="../xmldocs/llama.native.safellamacontexthandle/" class="md-nav__link">
  531. llama.native.safellamacontexthandle
  532. </a>
  533. </li>
  534. <li class="md-nav__item">
  535. <a href="../xmldocs/llama.native.safellamahandlebase/" class="md-nav__link">
  536. llama.native.safellamahandlebase
  537. </a>
  538. </li>
  539. <li class="md-nav__item">
  540. <a href="../xmldocs/llama.oldversion.chatcompletion/" class="md-nav__link">
  541. llama.oldversion.chatcompletion
  542. </a>
  543. </li>
  544. <li class="md-nav__item">
  545. <a href="../xmldocs/llama.oldversion.chatcompletionchoice/" class="md-nav__link">
  546. llama.oldversion.chatcompletionchoice
  547. </a>
  548. </li>
  549. <li class="md-nav__item">
  550. <a href="../xmldocs/llama.oldversion.chatcompletionchunk/" class="md-nav__link">
  551. llama.oldversion.chatcompletionchunk
  552. </a>
  553. </li>
  554. <li class="md-nav__item">
  555. <a href="../xmldocs/llama.oldversion.chatcompletionchunkchoice/" class="md-nav__link">
  556. llama.oldversion.chatcompletionchunkchoice
  557. </a>
  558. </li>
  559. <li class="md-nav__item">
  560. <a href="../xmldocs/llama.oldversion.chatcompletionchunkdelta/" class="md-nav__link">
  561. llama.oldversion.chatcompletionchunkdelta
  562. </a>
  563. </li>
  564. <li class="md-nav__item">
  565. <a href="../xmldocs/llama.oldversion.chatcompletionmessage/" class="md-nav__link">
  566. llama.oldversion.chatcompletionmessage
  567. </a>
  568. </li>
  569. <li class="md-nav__item">
  570. <a href="../xmldocs/llama.oldversion.chatmessagerecord/" class="md-nav__link">
  571. llama.oldversion.chatmessagerecord
  572. </a>
  573. </li>
  574. <li class="md-nav__item">
  575. <a href="../xmldocs/llama.oldversion.chatrole/" class="md-nav__link">
  576. llama.oldversion.chatrole
  577. </a>
  578. </li>
  579. <li class="md-nav__item">
  580. <a href="../xmldocs/llama.oldversion.chatsession-1/" class="md-nav__link">
  581. llama.oldversion.chatsession-1
  582. </a>
  583. </li>
  584. <li class="md-nav__item">
  585. <a href="../xmldocs/llama.oldversion.completion/" class="md-nav__link">
  586. llama.oldversion.completion
  587. </a>
  588. </li>
  589. <li class="md-nav__item">
  590. <a href="../xmldocs/llama.oldversion.completionchoice/" class="md-nav__link">
  591. llama.oldversion.completionchoice
  592. </a>
  593. </li>
  594. <li class="md-nav__item">
  595. <a href="../xmldocs/llama.oldversion.completionchunk/" class="md-nav__link">
  596. llama.oldversion.completionchunk
  597. </a>
  598. </li>
  599. <li class="md-nav__item">
  600. <a href="../xmldocs/llama.oldversion.completionlogprobs/" class="md-nav__link">
  601. llama.oldversion.completionlogprobs
  602. </a>
  603. </li>
  604. <li class="md-nav__item">
  605. <a href="../xmldocs/llama.oldversion.completionusage/" class="md-nav__link">
  606. llama.oldversion.completionusage
  607. </a>
  608. </li>
  609. <li class="md-nav__item">
  610. <a href="../xmldocs/llama.oldversion.embedding/" class="md-nav__link">
  611. llama.oldversion.embedding
  612. </a>
  613. </li>
  614. <li class="md-nav__item">
  615. <a href="../xmldocs/llama.oldversion.embeddingdata/" class="md-nav__link">
  616. llama.oldversion.embeddingdata
  617. </a>
  618. </li>
  619. <li class="md-nav__item">
  620. <a href="../xmldocs/llama.oldversion.embeddingusage/" class="md-nav__link">
  621. llama.oldversion.embeddingusage
  622. </a>
  623. </li>
  624. <li class="md-nav__item">
  625. <a href="../xmldocs/llama.oldversion.ichatmodel/" class="md-nav__link">
  626. llama.oldversion.ichatmodel
  627. </a>
  628. </li>
  629. <li class="md-nav__item">
  630. <a href="../xmldocs/llama.oldversion.llamaembedder/" class="md-nav__link">
  631. llama.oldversion.llamaembedder
  632. </a>
  633. </li>
  634. <li class="md-nav__item">
  635. <a href="../xmldocs/llama.oldversion.llamamodel/" class="md-nav__link">
  636. llama.oldversion.llamamodel
  637. </a>
  638. </li>
  639. <li class="md-nav__item">
  640. <a href="../xmldocs/llama.oldversion.llamaparams/" class="md-nav__link">
  641. llama.oldversion.llamaparams
  642. </a>
  643. </li>
  644. <li class="md-nav__item">
  645. <a href="../xmldocs/llama.resettablellamamodel/" class="md-nav__link">
  646. llama.resettablellamamodel
  647. </a>
  648. </li>
  649. <li class="md-nav__item">
  650. <a href="../xmldocs/llama.statefulexecutorbase/" class="md-nav__link">
  651. llama.statefulexecutorbase
  652. </a>
  653. </li>
  654. <li class="md-nav__item">
  655. <a href="../xmldocs/llama.statelessexecutor/" class="md-nav__link">
  656. llama.statelessexecutor
  657. </a>
  658. </li>
  659. </ul>
  660. </nav>
  661. </li>
  662. </ul>
  663. </nav>
  664. </div>
  665. </div>
  666. </div>
  667. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  668. <div class="md-sidebar__scrollwrap">
  669. <div class="md-sidebar__inner">
  670. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  671. <label class="md-nav__title" for="__toc">
  672. <span class="md-nav__icon md-icon"></span>
  673. Table of contents
  674. </label>
  675. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  676. <li class="md-nav__item">
  677. <a href="#install-packages" class="md-nav__link">
  678. Install packages
  679. </a>
  680. </li>
  681. <li class="md-nav__item">
  682. <a href="#download-a-model" class="md-nav__link">
  683. Download a model
  684. </a>
  685. </li>
  686. <li class="md-nav__item">
  687. <a href="#run-the-program" class="md-nav__link">
  688. Run the program
  689. </a>
  690. </li>
  691. </ul>
  692. </nav>
  693. </div>
  694. </div>
  695. </div>
  696. <div class="md-content" data-md-component="content">
  697. <article class="md-content__inner md-typeset">
  698. <h1 id="get-started">Get Started</h1>
  699. <h2 id="install-packages">Install packages</h2>
  700. <p>Firstly, search <code>LLamaSharp</code> in nuget package manager and install it.</p>
  701. <pre><code>PM&gt; Install-Package LLamaSharp
  702. </code></pre>
  703. <p>Then, search and install one of the following backends:</p>
  704. <pre><code>LLamaSharp.Backend.Cpu
  705. LLamaSharp.Backend.Cuda11
  706. LLamaSharp.Backend.Cuda12
  707. </code></pre>
  708. <p>Here's the mapping of them and corresponding model samples provided by <code>LLamaSharp</code>. If you're not sure which model is available for a version, please try our sample model.</p>
  709. <table>
  710. <thead>
  711. <tr>
  712. <th>LLamaSharp.Backend</th>
  713. <th>LLamaSharp</th>
  714. <th>Verified Model Resources</th>
  715. <th>llama.cpp commit id</th>
  716. </tr>
  717. </thead>
  718. <tbody>
  719. <tr>
  720. <td>-</td>
  721. <td>v0.2.0</td>
  722. <td>This version is not recommended to use.</td>
  723. <td>-</td>
  724. </tr>
  725. <tr>
  726. <td>-</td>
  727. <td>v0.2.1</td>
  728. <td><a href="https://huggingface.co/TheBloke/wizardLM-7B-GGML/tree/previous_llama">WizardLM</a>, <a href="https://huggingface.co/eachadea/ggml-vicuna-13b-1.1/tree/main">Vicuna (filenames with "old")</a></td>
  729. <td>-</td>
  730. </tr>
  731. <tr>
  732. <td>v0.2.2</td>
  733. <td>v0.2.2, v0.2.3</td>
  734. <td><a href="https://huggingface.co/TheBloke/wizardLM-7B-GGML/tree/previous_llama_ggmlv2">WizardLM</a>, <a href="https://huggingface.co/eachadea/ggml-vicuna-13b-1.1/tree/main">Vicuna (filenames without "old")</a></td>
  735. <td>63d2046</td>
  736. </tr>
  737. <tr>
  738. <td>v0.3.0</td>
  739. <td>v0.3.0</td>
  740. <td><a href="https://huggingface.co/AsakusaRinne/LLamaSharpSamples/tree/v0.3.0">LLamaSharpSamples v0.3.0</a>, <a href="https://huggingface.co/TheBloke/wizardLM-7B-GGML/tree/main">WizardLM</a></td>
  741. <td>7e4ea5b</td>
  742. </tr>
  743. </tbody>
  744. </table>
  745. <h2 id="download-a-model">Download a model</h2>
  746. <p>One of the following models could be okay:</p>
  747. <ul>
  748. <li>LLaMA 🦙</li>
  749. <li><a href="https://github.com/ggerganov/llama.cpp#instruction-mode-with-alpaca">Alpaca</a></li>
  750. <li><a href="https://github.com/ggerganov/llama.cpp#using-gpt4all">GPT4All</a></li>
  751. <li><a href="https://github.com/ymcui/Chinese-LLaMA-Alpaca">Chinese LLaMA / Alpaca</a></li>
  752. <li><a href="https://github.com/bofenghuang/vigogne">Vigogne (French)</a></li>
  753. <li><a href="https://github.com/ggerganov/llama.cpp/discussions/643#discussioncomment-5533894">Vicuna</a></li>
  754. <li><a href="https://bair.berkeley.edu/blog/2023/04/03/koala/">Koala</a></li>
  755. <li><a href="https://github.com/OpenBuddy/OpenBuddy">OpenBuddy 🐶 (Multilingual)</a></li>
  756. <li><a href="#using-pygmalion-7b--metharme-7b">Pygmalion 7B / Metharme 7B</a></li>
  757. <li><a href="https://github.com/nlpxucan/WizardLM">WizardLM</a></li>
  758. </ul>
  759. <p><strong>Note that because <code>llama.cpp</code> is under fast development now and often introduce break changes, some model weights on huggingface which works under a version may be invalid with another version. If it's your first time to configure LLamaSharp, we'd like to suggest for using verified model weights in the table above.</strong></p>
  760. <h2 id="run-the-program">Run the program</h2>
  761. <p>Please create a console program with dotnet runtime &gt;= netstandard 2.0 (&gt;= net6.0 is more recommended). Then, paste the following code to <code>program.cs</code>;</p>
  762. <pre><code class="language-cs">using LLama.Common;
  763. using LLama;
  764. string modelPath = &quot;&lt;Your model path&gt;&quot; // change it to your own model path
  765. var prompt = &quot;Transcript of a dialog, where the User interacts with an Assistant named Bob. Bob is helpful, kind, honest, good at writing, and never fails to answer the User's requests immediately and with precision.\r\n\r\nUser: Hello, Bob.\r\nBob: Hello. How may I help you today?\r\nUser: Please tell me the largest city in Europe.\r\nBob: Sure. The largest city in Europe is Moscow, the capital of Russia.\r\nUser:&quot;; // use the &quot;chat-with-bob&quot; prompt here.
  766. // Initialize a chat session
  767. var ex = new InteractiveExecutor(new LLamaModel(new ModelParams(modelPath, contextSize: 1024, seed: 1337, gpuLayerCount: 5)));
  768. ChatSession session = new ChatSession(ex);
  769. // show the prompt
  770. Console.WriteLine();
  771. Console.Write(prompt);
  772. // run the inference in a loop to chat with LLM
  773. while (true)
  774. {
  775. foreach (var text in session.Chat(prompt, new InferenceParams() { Temperature = 0.6f, AntiPrompts = new List&lt;string&gt; { &quot;User:&quot; } }))
  776. {
  777. Console.Write(text);
  778. }
  779. Console.ForegroundColor = ConsoleColor.Green;
  780. prompt = Console.ReadLine();
  781. Console.ForegroundColor = ConsoleColor.White;
  782. }
  783. </code></pre>
  784. <p>After starting it, you'll see the following outputs.</p>
  785. <pre><code>Please input your model path: D:\development\llama\weights\wizard-vicuna-13B.ggmlv3.q4_1.bin
  786. llama.cpp: loading model from D:\development\llama\weights\wizard-vicuna-13B.ggmlv3.q4_1.bin
  787. llama_model_load_internal: format = ggjt v3 (latest)
  788. llama_model_load_internal: n_vocab = 32000
  789. llama_model_load_internal: n_ctx = 1024
  790. llama_model_load_internal: n_embd = 5120
  791. llama_model_load_internal: n_mult = 256
  792. llama_model_load_internal: n_head = 40
  793. llama_model_load_internal: n_layer = 40
  794. llama_model_load_internal: n_rot = 128
  795. llama_model_load_internal: ftype = 3 (mostly Q4_1)
  796. llama_model_load_internal: n_ff = 13824
  797. llama_model_load_internal: n_parts = 1
  798. llama_model_load_internal: model size = 13B
  799. llama_model_load_internal: ggml ctx size = 7759.48 MB
  800. llama_model_load_internal: mem required = 9807.48 MB (+ 1608.00 MB per state)
  801. ....................................................................................................
  802. llama_init_from_file: kv self size = 800.00 MB
  803. Transcript of a dialog, where the User interacts with an Assistant named Bob. Bob is helpful, kind, honest, good at writing, and never fails to answer the User's requests immediately and with precision.
  804. User: Hello, Bob.
  805. Bob: Hello. How may I help you today?
  806. User: Please tell me the largest city in Europe.
  807. Bob: Sure. The largest city in Europe is Moscow, the capital of Russia.
  808. User:
  809. </code></pre>
  810. <p>Now, enjoy chatting with LLM!</p>
  811. </article>
  812. </div>
  813. </div>
  814. </main>
  815. <footer class="md-footer">
  816. <div class="md-footer-meta md-typeset">
  817. <div class="md-footer-meta__inner md-grid">
  818. <div class="md-copyright">
  819. Made with
  820. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  821. Material for MkDocs
  822. </a>
  823. </div>
  824. </div>
  825. </div>
  826. </footer>
  827. </div>
  828. <div class="md-dialog" data-md-component="dialog">
  829. <div class="md-dialog__inner md-typeset"></div>
  830. </div>
  831. <script id="__config" type="application/json">{"base": "..", "features": [], "search": "../assets/javascripts/workers/search.208ed371.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"provider": "mike"}}</script>
  832. <script src="../assets/javascripts/bundle.a51614de.min.js"></script>
  833. </body>
  834. </html>

C#/.NET上易用的LLM高性能推理框架,支持LLaMA和LLaVA系列模型。

Contributors (1)