diff --git a/404.html b/404.html
index 04e9e9ee..ac401372 100644
--- a/404.html
+++ b/404.html
@@ -19,7 +19,7 @@
       
       
       <link rel="icon" href="/assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -27,7 +27,7 @@
       
     
     
-      <link rel="stylesheet" href="/assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="/assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="/assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1728,6 +1728,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="/docs/examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2157,7 +2184,7 @@ <h1>404 - Not found</h1>
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="/assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="/assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="/assets/javascripts/extra.js"></script>
       
diff --git a/assets/javascripts/bundle.d249fdc4.min.js b/assets/javascripts/bundle.ef37796b.min.js
similarity index 58%
rename from assets/javascripts/bundle.d249fdc4.min.js
rename to assets/javascripts/bundle.ef37796b.min.js
index e565eb78..e9ffcbe7 100644
--- a/assets/javascripts/bundle.d249fdc4.min.js
+++ b/assets/javascripts/bundle.ef37796b.min.js
@@ -1,3 +1,3 @@
-"use strict";(()=>{var Bi=Object.create;var _r=Object.defineProperty;var Gi=Object.getOwnPropertyDescriptor;var Ji=Object.getOwnPropertyNames,Bt=Object.getOwnPropertySymbols,Xi=Object.getPrototypeOf,Ar=Object.prototype.hasOwnProperty,uo=Object.prototype.propertyIsEnumerable;var fo=(e,t,r)=>t in e?_r(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r,j=(e,t)=>{for(var r in t||(t={}))Ar.call(t,r)&&fo(e,r,t[r]);if(Bt)for(var r of Bt(t))uo.call(t,r)&&fo(e,r,t[r]);return e};var ho=(e,t)=>{var r={};for(var o in e)Ar.call(e,o)&&t.indexOf(o)<0&&(r[o]=e[o]);if(e!=null&&Bt)for(var o of Bt(e))t.indexOf(o)<0&&uo.call(e,o)&&(r[o]=e[o]);return r};var Cr=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports);var Zi=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of Ji(t))!Ar.call(e,n)&&n!==r&&_r(e,n,{get:()=>t[n],enumerable:!(o=Gi(t,n))||o.enumerable});return e};var Gt=(e,t,r)=>(r=e!=null?Bi(Xi(e)):{},Zi(t||!e||!e.__esModule?_r(r,"default",{value:e,enumerable:!0}):r,e));var bo=(e,t,r)=>new Promise((o,n)=>{var i=c=>{try{a(r.next(c))}catch(p){n(p)}},s=c=>{try{a(r.throw(c))}catch(p){n(p)}},a=c=>c.done?o(c.value):Promise.resolve(c.value).then(i,s);a((r=r.apply(e,t)).next())});var go=Cr((Hr,vo)=>{(function(e,t){typeof Hr=="object"&&typeof vo!="undefined"?t():typeof define=="function"&&define.amd?define(t):t()})(Hr,function(){"use strict";function e(r){var o=!0,n=!1,i=null,s={text:!0,search:!0,url:!0,tel:!0,email:!0,password:!0,number:!0,date:!0,month:!0,week:!0,time:!0,datetime:!0,"datetime-local":!0};function a(H){return!!(H&&H!==document&&H.nodeName!=="HTML"&&H.nodeName!=="BODY"&&"classList"in H&&"contains"in H.classList)}function c(H){var ft=H.type,Fe=H.tagName;return!!(Fe==="INPUT"&&s[ft]&&!H.readOnly||Fe==="TEXTAREA"&&!H.readOnly||H.isContentEditable)}function p(H){H.classList.contains("focus-visible")||(H.classList.add("focus-visible"),H.setAttribute("data-focus-visible-added",""))}function l(H){H.hasAttribute("data-focus-visible-added")&&(H.classList.remove("focus-visible"),H.removeAttribute("data-focus-visible-added"))}function f(H){H.metaKey||H.altKey||H.ctrlKey||(a(r.activeElement)&&p(r.activeElement),o=!0)}function u(H){o=!1}function d(H){a(H.target)&&(o||c(H.target))&&p(H.target)}function g(H){a(H.target)&&(H.target.classList.contains("focus-visible")||H.target.hasAttribute("data-focus-visible-added"))&&(n=!0,window.clearTimeout(i),i=window.setTimeout(function(){n=!1},100),l(H.target))}function L(H){document.visibilityState==="hidden"&&(n&&(o=!0),ee())}function ee(){document.addEventListener("mousemove",Z),document.addEventListener("mousedown",Z),document.addEventListener("mouseup",Z),document.addEventListener("pointermove",Z),document.addEventListener("pointerdown",Z),document.addEventListener("pointerup",Z),document.addEventListener("touchmove",Z),document.addEventListener("touchstart",Z),document.addEventListener("touchend",Z)}function ne(){document.removeEventListener("mousemove",Z),document.removeEventListener("mousedown",Z),document.removeEventListener("mouseup",Z),document.removeEventListener("pointermove",Z),document.removeEventListener("pointerdown",Z),document.removeEventListener("pointerup",Z),document.removeEventListener("touchmove",Z),document.removeEventListener("touchstart",Z),document.removeEventListener("touchend",Z)}function Z(H){H.target.nodeName&&H.target.nodeName.toLowerCase()==="html"||(o=!1,ne())}document.addEventListener("keydown",f,!0),document.addEventListener("mousedown",u,!0),document.addEventListener("pointerdown",u,!0),document.addEventListener("touchstart",u,!0),document.addEventListener("visibilitychange",L,!0),ee(),r.addEventListener("focus",d,!0),r.addEventListener("blur",g,!0),r.nodeType===Node.DOCUMENT_FRAGMENT_NODE&&r.host?r.host.setAttribute("data-js-focus-visible",""):r.nodeType===Node.DOCUMENT_NODE&&(document.documentElement.classList.add("js-focus-visible"),document.documentElement.setAttribute("data-js-focus-visible",""))}if(typeof window!="undefined"&&typeof document!="undefined"){window.applyFocusVisiblePolyfill=e;var t;try{t=new CustomEvent("focus-visible-polyfill-ready")}catch(r){t=document.createEvent("CustomEvent"),t.initCustomEvent("focus-visible-polyfill-ready",!1,!1,{})}window.dispatchEvent(t)}typeof document!="undefined"&&e(document)})});var io=Cr((Vt,no)=>{(function(t,r){typeof Vt=="object"&&typeof no=="object"?no.exports=r():typeof define=="function"&&define.amd?define([],r):typeof Vt=="object"?Vt.ClipboardJS=r():t.ClipboardJS=r()})(Vt,function(){return function(){var e={686:function(o,n,i){"use strict";i.d(n,{default:function(){return Yi}});var s=i(279),a=i.n(s),c=i(370),p=i.n(c),l=i(817),f=i.n(l);function u(q){try{return document.execCommand(q)}catch(C){return!1}}var d=function(C){var _=f()(C);return u("cut"),_},g=d;function L(q){var C=document.documentElement.getAttribute("dir")==="rtl",_=document.createElement("textarea");_.style.fontSize="12pt",_.style.border="0",_.style.padding="0",_.style.margin="0",_.style.position="absolute",_.style[C?"right":"left"]="-9999px";var D=window.pageYOffset||document.documentElement.scrollTop;return _.style.top="".concat(D,"px"),_.setAttribute("readonly",""),_.value=q,_}var ee=function(C,_){var D=L(C);_.container.appendChild(D);var V=f()(D);return u("copy"),D.remove(),V},ne=function(C){var _=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body},D="";return typeof C=="string"?D=ee(C,_):C instanceof HTMLInputElement&&!["text","search","url","tel","password"].includes(C==null?void 0:C.type)?D=ee(C.value,_):(D=f()(C),u("copy")),D},Z=ne;function H(q){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?H=function(_){return typeof _}:H=function(_){return _&&typeof Symbol=="function"&&_.constructor===Symbol&&_!==Symbol.prototype?"symbol":typeof _},H(q)}var ft=function(){var C=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{},_=C.action,D=_===void 0?"copy":_,V=C.container,G=C.target,Ue=C.text;if(D!=="copy"&&D!=="cut")throw new Error('Invalid "action" value, use either "copy" or "cut"');if(G!==void 0)if(G&&H(G)==="object"&&G.nodeType===1){if(D==="copy"&&G.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if(D==="cut"&&(G.hasAttribute("readonly")||G.hasAttribute("disabled")))throw new Error(`Invalid "target" attribute. You can't cut text from elements with "readonly" or "disabled" attributes`)}else throw new Error('Invalid "target" value, use a valid Element');if(Ue)return Z(Ue,{container:V});if(G)return D==="cut"?g(G):Z(G,{container:V})},Fe=ft;function R(q){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?R=function(_){return typeof _}:R=function(_){return _&&typeof Symbol=="function"&&_.constructor===Symbol&&_!==Symbol.prototype?"symbol":typeof _},R(q)}function se(q,C){if(!(q instanceof C))throw new TypeError("Cannot call a class as a function")}function ce(q,C){for(var _=0;_<C.length;_++){var D=C[_];D.enumerable=D.enumerable||!1,D.configurable=!0,"value"in D&&(D.writable=!0),Object.defineProperty(q,D.key,D)}}function he(q,C,_){return C&&ce(q.prototype,C),_&&ce(q,_),q}function Se(q,C){if(typeof C!="function"&&C!==null)throw new TypeError("Super expression must either be null or a function");q.prototype=Object.create(C&&C.prototype,{constructor:{value:q,writable:!0,configurable:!0}}),C&&je(q,C)}function je(q,C){return je=Object.setPrototypeOf||function(D,V){return D.__proto__=V,D},je(q,C)}function Vi(q){var C=Ki();return function(){var D=Qt(q),V;if(C){var G=Qt(this).constructor;V=Reflect.construct(D,arguments,G)}else V=D.apply(this,arguments);return zi(this,V)}}function zi(q,C){return C&&(R(C)==="object"||typeof C=="function")?C:qi(q)}function qi(q){if(q===void 0)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return q}function Ki(){if(typeof Reflect=="undefined"||!Reflect.construct||Reflect.construct.sham)return!1;if(typeof Proxy=="function")return!0;try{return Date.prototype.toString.call(Reflect.construct(Date,[],function(){})),!0}catch(q){return!1}}function Qt(q){return Qt=Object.setPrototypeOf?Object.getPrototypeOf:function(_){return _.__proto__||Object.getPrototypeOf(_)},Qt(q)}function Mr(q,C){var _="data-clipboard-".concat(q);if(C.hasAttribute(_))return C.getAttribute(_)}var Qi=function(q){Se(_,q);var C=Vi(_);function _(D,V){var G;return se(this,_),G=C.call(this),G.resolveOptions(V),G.listenClick(D),G}return he(_,[{key:"resolveOptions",value:function(){var V=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{};this.action=typeof V.action=="function"?V.action:this.defaultAction,this.target=typeof V.target=="function"?V.target:this.defaultTarget,this.text=typeof V.text=="function"?V.text:this.defaultText,this.container=R(V.container)==="object"?V.container:document.body}},{key:"listenClick",value:function(V){var G=this;this.listener=p()(V,"click",function(Ue){return G.onClick(Ue)})}},{key:"onClick",value:function(V){var G=V.delegateTarget||V.currentTarget,Ue=this.action(G)||"copy",Yt=Fe({action:Ue,container:this.container,target:this.target(G),text:this.text(G)});this.emit(Yt?"success":"error",{action:Ue,text:Yt,trigger:G,clearSelection:function(){G&&G.focus(),window.getSelection().removeAllRanges()}})}},{key:"defaultAction",value:function(V){return Mr("action",V)}},{key:"defaultTarget",value:function(V){var G=Mr("target",V);if(G)return document.querySelector(G)}},{key:"defaultText",value:function(V){return Mr("text",V)}},{key:"destroy",value:function(){this.listener.destroy()}}],[{key:"copy",value:function(V){var G=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body};return Z(V,G)}},{key:"cut",value:function(V){return g(V)}},{key:"isSupported",value:function(){var V=arguments.length>0&&arguments[0]!==void 0?arguments[0]:["copy","cut"],G=typeof V=="string"?[V]:V,Ue=!!document.queryCommandSupported;return G.forEach(function(Yt){Ue=Ue&&!!document.queryCommandSupported(Yt)}),Ue}}]),_}(a()),Yi=Qi},828:function(o){var n=9;if(typeof Element!="undefined"&&!Element.prototype.matches){var i=Element.prototype;i.matches=i.matchesSelector||i.mozMatchesSelector||i.msMatchesSelector||i.oMatchesSelector||i.webkitMatchesSelector}function s(a,c){for(;a&&a.nodeType!==n;){if(typeof a.matches=="function"&&a.matches(c))return a;a=a.parentNode}}o.exports=s},438:function(o,n,i){var s=i(828);function a(l,f,u,d,g){var L=p.apply(this,arguments);return l.addEventListener(u,L,g),{destroy:function(){l.removeEventListener(u,L,g)}}}function c(l,f,u,d,g){return typeof l.addEventListener=="function"?a.apply(null,arguments):typeof u=="function"?a.bind(null,document).apply(null,arguments):(typeof l=="string"&&(l=document.querySelectorAll(l)),Array.prototype.map.call(l,function(L){return a(L,f,u,d,g)}))}function p(l,f,u,d){return function(g){g.delegateTarget=s(g.target,f),g.delegateTarget&&d.call(l,g)}}o.exports=c},879:function(o,n){n.node=function(i){return i!==void 0&&i instanceof HTMLElement&&i.nodeType===1},n.nodeList=function(i){var s=Object.prototype.toString.call(i);return i!==void 0&&(s==="[object NodeList]"||s==="[object HTMLCollection]")&&"length"in i&&(i.length===0||n.node(i[0]))},n.string=function(i){return typeof i=="string"||i instanceof String},n.fn=function(i){var s=Object.prototype.toString.call(i);return s==="[object Function]"}},370:function(o,n,i){var s=i(879),a=i(438);function c(u,d,g){if(!u&&!d&&!g)throw new Error("Missing required arguments");if(!s.string(d))throw new TypeError("Second argument must be a String");if(!s.fn(g))throw new TypeError("Third argument must be a Function");if(s.node(u))return p(u,d,g);if(s.nodeList(u))return l(u,d,g);if(s.string(u))return f(u,d,g);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList")}function p(u,d,g){return u.addEventListener(d,g),{destroy:function(){u.removeEventListener(d,g)}}}function l(u,d,g){return Array.prototype.forEach.call(u,function(L){L.addEventListener(d,g)}),{destroy:function(){Array.prototype.forEach.call(u,function(L){L.removeEventListener(d,g)})}}}function f(u,d,g){return a(document.body,u,d,g)}o.exports=c},817:function(o){function n(i){var s;if(i.nodeName==="SELECT")i.focus(),s=i.value;else if(i.nodeName==="INPUT"||i.nodeName==="TEXTAREA"){var a=i.hasAttribute("readonly");a||i.setAttribute("readonly",""),i.select(),i.setSelectionRange(0,i.value.length),a||i.removeAttribute("readonly"),s=i.value}else{i.hasAttribute("contenteditable")&&i.focus();var c=window.getSelection(),p=document.createRange();p.selectNodeContents(i),c.removeAllRanges(),c.addRange(p),s=c.toString()}return s}o.exports=n},279:function(o){function n(){}n.prototype={on:function(i,s,a){var c=this.e||(this.e={});return(c[i]||(c[i]=[])).push({fn:s,ctx:a}),this},once:function(i,s,a){var c=this;function p(){c.off(i,p),s.apply(a,arguments)}return p._=s,this.on(i,p,a)},emit:function(i){var s=[].slice.call(arguments,1),a=((this.e||(this.e={}))[i]||[]).slice(),c=0,p=a.length;for(c;c<p;c++)a[c].fn.apply(a[c].ctx,s);return this},off:function(i,s){var a=this.e||(this.e={}),c=a[i],p=[];if(c&&s)for(var l=0,f=c.length;l<f;l++)c[l].fn!==s&&c[l].fn._!==s&&p.push(c[l]);return p.length?a[i]=p:delete a[i],this}},o.exports=n,o.exports.TinyEmitter=n}},t={};function r(o){if(t[o])return t[o].exports;var n=t[o]={exports:{}};return e[o](n,n.exports,r),n.exports}return function(){r.n=function(o){var n=o&&o.__esModule?function(){return o.default}:function(){return o};return r.d(n,{a:n}),n}}(),function(){r.d=function(o,n){for(var i in n)r.o(n,i)&&!r.o(o,i)&&Object.defineProperty(o,i,{enumerable:!0,get:n[i]})}}(),function(){r.o=function(o,n){return Object.prototype.hasOwnProperty.call(o,n)}}(),r(686)}().default})});var hi=Cr((nS,di)=>{"use strict";var fs=/["'&<>]/;di.exports=us;function us(e){var t=""+e,r=fs.exec(t);if(!r)return t;var o,n="",i=0,s=0;for(i=r.index;i<t.length;i++){switch(t.charCodeAt(i)){case 34:o="&quot;";break;case 38:o="&amp;";break;case 39:o="&#39;";break;case 60:o="&lt;";break;case 62:o="&gt;";break;default:continue}s!==i&&(n+=t.substring(s,i)),s=i+1,n+=o}return s!==i?n+t.substring(s,i):n}});var zM=Gt(go());var kr=function(e,t){return kr=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(r,o){r.__proto__=o}||function(r,o){for(var n in o)Object.prototype.hasOwnProperty.call(o,n)&&(r[n]=o[n])},kr(e,t)};function ie(e,t){if(typeof t!="function"&&t!==null)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");kr(e,t);function r(){this.constructor=e}e.prototype=t===null?Object.create(t):(r.prototype=t.prototype,new r)}function xo(e,t,r,o){function n(i){return i instanceof r?i:new r(function(s){s(i)})}return new(r||(r=Promise))(function(i,s){function a(l){try{p(o.next(l))}catch(f){s(f)}}function c(l){try{p(o.throw(l))}catch(f){s(f)}}function p(l){l.done?i(l.value):n(l.value).then(a,c)}p((o=o.apply(e,t||[])).next())})}function Jt(e,t){var r={label:0,sent:function(){if(i[0]&1)throw i[1];return i[1]},trys:[],ops:[]},o,n,i,s;return s={next:a(0),throw:a(1),return:a(2)},typeof Symbol=="function"&&(s[Symbol.iterator]=function(){return this}),s;function a(p){return function(l){return c([p,l])}}function c(p){if(o)throw new TypeError("Generator is already executing.");for(;r;)try{if(o=1,n&&(i=p[0]&2?n.return:p[0]?n.throw||((i=n.return)&&i.call(n),0):n.next)&&!(i=i.call(n,p[1])).done)return i;switch(n=0,i&&(p=[p[0]&2,i.value]),p[0]){case 0:case 1:i=p;break;case 4:return r.label++,{value:p[1],done:!1};case 5:r.label++,n=p[1],p=[0];continue;case 7:p=r.ops.pop(),r.trys.pop();continue;default:if(i=r.trys,!(i=i.length>0&&i[i.length-1])&&(p[0]===6||p[0]===2)){r=0;continue}if(p[0]===3&&(!i||p[1]>i[0]&&p[1]<i[3])){r.label=p[1];break}if(p[0]===6&&r.label<i[1]){r.label=i[1],i=p;break}if(i&&r.label<i[2]){r.label=i[2],r.ops.push(p);break}i[2]&&r.ops.pop(),r.trys.pop();continue}p=t.call(e,r)}catch(l){p=[6,l],n=0}finally{o=i=0}if(p[0]&5)throw p[1];return{value:p[0]?p[1]:void 0,done:!0}}}function Oe(e){var t=typeof Symbol=="function"&&Symbol.iterator,r=t&&e[t],o=0;if(r)return r.call(e);if(e&&typeof e.length=="number")return{next:function(){return e&&o>=e.length&&(e=void 0),{value:e&&e[o++],done:!e}}};throw new TypeError(t?"Object is not iterable.":"Symbol.iterator is not defined.")}function K(e,t){var r=typeof Symbol=="function"&&e[Symbol.iterator];if(!r)return e;var o=r.call(e),n,i=[],s;try{for(;(t===void 0||t-- >0)&&!(n=o.next()).done;)i.push(n.value)}catch(a){s={error:a}}finally{try{n&&!n.done&&(r=o.return)&&r.call(o)}finally{if(s)throw s.error}}return i}function B(e,t,r){if(r||arguments.length===2)for(var o=0,n=t.length,i;o<n;o++)(i||!(o in t))&&(i||(i=Array.prototype.slice.call(t,0,o)),i[o]=t[o]);return e.concat(i||Array.prototype.slice.call(t))}function ut(e){return this instanceof ut?(this.v=e,this):new ut(e)}function yo(e,t,r){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var o=r.apply(e,t||[]),n,i=[];return n={},s("next"),s("throw"),s("return"),n[Symbol.asyncIterator]=function(){return this},n;function s(u){o[u]&&(n[u]=function(d){return new Promise(function(g,L){i.push([u,d,g,L])>1||a(u,d)})})}function a(u,d){try{c(o[u](d))}catch(g){f(i[0][3],g)}}function c(u){u.value instanceof ut?Promise.resolve(u.value.v).then(p,l):f(i[0][2],u)}function p(u){a("next",u)}function l(u){a("throw",u)}function f(u,d){u(d),i.shift(),i.length&&a(i[0][0],i[0][1])}}function Eo(e){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var t=e[Symbol.asyncIterator],r;return t?t.call(e):(e=typeof Oe=="function"?Oe(e):e[Symbol.iterator](),r={},o("next"),o("throw"),o("return"),r[Symbol.asyncIterator]=function(){return this},r);function o(i){r[i]=e[i]&&function(s){return new Promise(function(a,c){s=e[i](s),n(a,c,s.done,s.value)})}}function n(i,s,a,c){Promise.resolve(c).then(function(p){i({value:p,done:a})},s)}}function P(e){return typeof e=="function"}function xt(e){var t=function(o){Error.call(o),o.stack=new Error().stack},r=e(t);return r.prototype=Object.create(Error.prototype),r.prototype.constructor=r,r}var Xt=xt(function(e){return function(r){e(this),this.message=r?r.length+` errors occurred during unsubscription:
+"use strict";(()=>{var Gi=Object.create;var _r=Object.defineProperty;var Ji=Object.getOwnPropertyDescriptor;var Xi=Object.getOwnPropertyNames,Bt=Object.getOwnPropertySymbols,Zi=Object.getPrototypeOf,Ar=Object.prototype.hasOwnProperty,uo=Object.prototype.propertyIsEnumerable;var fo=(e,t,r)=>t in e?_r(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r,j=(e,t)=>{for(var r in t||(t={}))Ar.call(t,r)&&fo(e,r,t[r]);if(Bt)for(var r of Bt(t))uo.call(t,r)&&fo(e,r,t[r]);return e};var ho=(e,t)=>{var r={};for(var o in e)Ar.call(e,o)&&t.indexOf(o)<0&&(r[o]=e[o]);if(e!=null&&Bt)for(var o of Bt(e))t.indexOf(o)<0&&uo.call(e,o)&&(r[o]=e[o]);return r};var Cr=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports);var ea=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of Xi(t))!Ar.call(e,n)&&n!==r&&_r(e,n,{get:()=>t[n],enumerable:!(o=Ji(t,n))||o.enumerable});return e};var Gt=(e,t,r)=>(r=e!=null?Gi(Zi(e)):{},ea(t||!e||!e.__esModule?_r(r,"default",{value:e,enumerable:!0}):r,e));var bo=(e,t,r)=>new Promise((o,n)=>{var i=c=>{try{a(r.next(c))}catch(p){n(p)}},s=c=>{try{a(r.throw(c))}catch(p){n(p)}},a=c=>c.done?o(c.value):Promise.resolve(c.value).then(i,s);a((r=r.apply(e,t)).next())});var go=Cr((Hr,vo)=>{(function(e,t){typeof Hr=="object"&&typeof vo!="undefined"?t():typeof define=="function"&&define.amd?define(t):t()})(Hr,function(){"use strict";function e(r){var o=!0,n=!1,i=null,s={text:!0,search:!0,url:!0,tel:!0,email:!0,password:!0,number:!0,date:!0,month:!0,week:!0,time:!0,datetime:!0,"datetime-local":!0};function a(H){return!!(H&&H!==document&&H.nodeName!=="HTML"&&H.nodeName!=="BODY"&&"classList"in H&&"contains"in H.classList)}function c(H){var ft=H.type,Fe=H.tagName;return!!(Fe==="INPUT"&&s[ft]&&!H.readOnly||Fe==="TEXTAREA"&&!H.readOnly||H.isContentEditable)}function p(H){H.classList.contains("focus-visible")||(H.classList.add("focus-visible"),H.setAttribute("data-focus-visible-added",""))}function l(H){H.hasAttribute("data-focus-visible-added")&&(H.classList.remove("focus-visible"),H.removeAttribute("data-focus-visible-added"))}function f(H){H.metaKey||H.altKey||H.ctrlKey||(a(r.activeElement)&&p(r.activeElement),o=!0)}function u(H){o=!1}function d(H){a(H.target)&&(o||c(H.target))&&p(H.target)}function g(H){a(H.target)&&(H.target.classList.contains("focus-visible")||H.target.hasAttribute("data-focus-visible-added"))&&(n=!0,window.clearTimeout(i),i=window.setTimeout(function(){n=!1},100),l(H.target))}function L(H){document.visibilityState==="hidden"&&(n&&(o=!0),ee())}function ee(){document.addEventListener("mousemove",Z),document.addEventListener("mousedown",Z),document.addEventListener("mouseup",Z),document.addEventListener("pointermove",Z),document.addEventListener("pointerdown",Z),document.addEventListener("pointerup",Z),document.addEventListener("touchmove",Z),document.addEventListener("touchstart",Z),document.addEventListener("touchend",Z)}function ne(){document.removeEventListener("mousemove",Z),document.removeEventListener("mousedown",Z),document.removeEventListener("mouseup",Z),document.removeEventListener("pointermove",Z),document.removeEventListener("pointerdown",Z),document.removeEventListener("pointerup",Z),document.removeEventListener("touchmove",Z),document.removeEventListener("touchstart",Z),document.removeEventListener("touchend",Z)}function Z(H){H.target.nodeName&&H.target.nodeName.toLowerCase()==="html"||(o=!1,ne())}document.addEventListener("keydown",f,!0),document.addEventListener("mousedown",u,!0),document.addEventListener("pointerdown",u,!0),document.addEventListener("touchstart",u,!0),document.addEventListener("visibilitychange",L,!0),ee(),r.addEventListener("focus",d,!0),r.addEventListener("blur",g,!0),r.nodeType===Node.DOCUMENT_FRAGMENT_NODE&&r.host?r.host.setAttribute("data-js-focus-visible",""):r.nodeType===Node.DOCUMENT_NODE&&(document.documentElement.classList.add("js-focus-visible"),document.documentElement.setAttribute("data-js-focus-visible",""))}if(typeof window!="undefined"&&typeof document!="undefined"){window.applyFocusVisiblePolyfill=e;var t;try{t=new CustomEvent("focus-visible-polyfill-ready")}catch(r){t=document.createEvent("CustomEvent"),t.initCustomEvent("focus-visible-polyfill-ready",!1,!1,{})}window.dispatchEvent(t)}typeof document!="undefined"&&e(document)})});var io=Cr((Vt,no)=>{(function(t,r){typeof Vt=="object"&&typeof no=="object"?no.exports=r():typeof define=="function"&&define.amd?define([],r):typeof Vt=="object"?Vt.ClipboardJS=r():t.ClipboardJS=r()})(Vt,function(){return function(){var e={686:function(o,n,i){"use strict";i.d(n,{default:function(){return Bi}});var s=i(279),a=i.n(s),c=i(370),p=i.n(c),l=i(817),f=i.n(l);function u(q){try{return document.execCommand(q)}catch(C){return!1}}var d=function(C){var _=f()(C);return u("cut"),_},g=d;function L(q){var C=document.documentElement.getAttribute("dir")==="rtl",_=document.createElement("textarea");_.style.fontSize="12pt",_.style.border="0",_.style.padding="0",_.style.margin="0",_.style.position="absolute",_.style[C?"right":"left"]="-9999px";var D=window.pageYOffset||document.documentElement.scrollTop;return _.style.top="".concat(D,"px"),_.setAttribute("readonly",""),_.value=q,_}var ee=function(C,_){var D=L(C);_.container.appendChild(D);var V=f()(D);return u("copy"),D.remove(),V},ne=function(C){var _=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body},D="";return typeof C=="string"?D=ee(C,_):C instanceof HTMLInputElement&&!["text","search","url","tel","password"].includes(C==null?void 0:C.type)?D=ee(C.value,_):(D=f()(C),u("copy")),D},Z=ne;function H(q){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?H=function(_){return typeof _}:H=function(_){return _&&typeof Symbol=="function"&&_.constructor===Symbol&&_!==Symbol.prototype?"symbol":typeof _},H(q)}var ft=function(){var C=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{},_=C.action,D=_===void 0?"copy":_,V=C.container,G=C.target,Ue=C.text;if(D!=="copy"&&D!=="cut")throw new Error('Invalid "action" value, use either "copy" or "cut"');if(G!==void 0)if(G&&H(G)==="object"&&G.nodeType===1){if(D==="copy"&&G.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if(D==="cut"&&(G.hasAttribute("readonly")||G.hasAttribute("disabled")))throw new Error(`Invalid "target" attribute. You can't cut text from elements with "readonly" or "disabled" attributes`)}else throw new Error('Invalid "target" value, use a valid Element');if(Ue)return Z(Ue,{container:V});if(G)return D==="cut"?g(G):Z(G,{container:V})},Fe=ft;function R(q){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?R=function(_){return typeof _}:R=function(_){return _&&typeof Symbol=="function"&&_.constructor===Symbol&&_!==Symbol.prototype?"symbol":typeof _},R(q)}function se(q,C){if(!(q instanceof C))throw new TypeError("Cannot call a class as a function")}function ce(q,C){for(var _=0;_<C.length;_++){var D=C[_];D.enumerable=D.enumerable||!1,D.configurable=!0,"value"in D&&(D.writable=!0),Object.defineProperty(q,D.key,D)}}function he(q,C,_){return C&&ce(q.prototype,C),_&&ce(q,_),q}function Se(q,C){if(typeof C!="function"&&C!==null)throw new TypeError("Super expression must either be null or a function");q.prototype=Object.create(C&&C.prototype,{constructor:{value:q,writable:!0,configurable:!0}}),C&&je(q,C)}function je(q,C){return je=Object.setPrototypeOf||function(D,V){return D.__proto__=V,D},je(q,C)}function zi(q){var C=Qi();return function(){var D=Qt(q),V;if(C){var G=Qt(this).constructor;V=Reflect.construct(D,arguments,G)}else V=D.apply(this,arguments);return qi(this,V)}}function qi(q,C){return C&&(R(C)==="object"||typeof C=="function")?C:Ki(q)}function Ki(q){if(q===void 0)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return q}function Qi(){if(typeof Reflect=="undefined"||!Reflect.construct||Reflect.construct.sham)return!1;if(typeof Proxy=="function")return!0;try{return Date.prototype.toString.call(Reflect.construct(Date,[],function(){})),!0}catch(q){return!1}}function Qt(q){return Qt=Object.setPrototypeOf?Object.getPrototypeOf:function(_){return _.__proto__||Object.getPrototypeOf(_)},Qt(q)}function Mr(q,C){var _="data-clipboard-".concat(q);if(C.hasAttribute(_))return C.getAttribute(_)}var Yi=function(q){Se(_,q);var C=zi(_);function _(D,V){var G;return se(this,_),G=C.call(this),G.resolveOptions(V),G.listenClick(D),G}return he(_,[{key:"resolveOptions",value:function(){var V=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{};this.action=typeof V.action=="function"?V.action:this.defaultAction,this.target=typeof V.target=="function"?V.target:this.defaultTarget,this.text=typeof V.text=="function"?V.text:this.defaultText,this.container=R(V.container)==="object"?V.container:document.body}},{key:"listenClick",value:function(V){var G=this;this.listener=p()(V,"click",function(Ue){return G.onClick(Ue)})}},{key:"onClick",value:function(V){var G=V.delegateTarget||V.currentTarget,Ue=this.action(G)||"copy",Yt=Fe({action:Ue,container:this.container,target:this.target(G),text:this.text(G)});this.emit(Yt?"success":"error",{action:Ue,text:Yt,trigger:G,clearSelection:function(){G&&G.focus(),window.getSelection().removeAllRanges()}})}},{key:"defaultAction",value:function(V){return Mr("action",V)}},{key:"defaultTarget",value:function(V){var G=Mr("target",V);if(G)return document.querySelector(G)}},{key:"defaultText",value:function(V){return Mr("text",V)}},{key:"destroy",value:function(){this.listener.destroy()}}],[{key:"copy",value:function(V){var G=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body};return Z(V,G)}},{key:"cut",value:function(V){return g(V)}},{key:"isSupported",value:function(){var V=arguments.length>0&&arguments[0]!==void 0?arguments[0]:["copy","cut"],G=typeof V=="string"?[V]:V,Ue=!!document.queryCommandSupported;return G.forEach(function(Yt){Ue=Ue&&!!document.queryCommandSupported(Yt)}),Ue}}]),_}(a()),Bi=Yi},828:function(o){var n=9;if(typeof Element!="undefined"&&!Element.prototype.matches){var i=Element.prototype;i.matches=i.matchesSelector||i.mozMatchesSelector||i.msMatchesSelector||i.oMatchesSelector||i.webkitMatchesSelector}function s(a,c){for(;a&&a.nodeType!==n;){if(typeof a.matches=="function"&&a.matches(c))return a;a=a.parentNode}}o.exports=s},438:function(o,n,i){var s=i(828);function a(l,f,u,d,g){var L=p.apply(this,arguments);return l.addEventListener(u,L,g),{destroy:function(){l.removeEventListener(u,L,g)}}}function c(l,f,u,d,g){return typeof l.addEventListener=="function"?a.apply(null,arguments):typeof u=="function"?a.bind(null,document).apply(null,arguments):(typeof l=="string"&&(l=document.querySelectorAll(l)),Array.prototype.map.call(l,function(L){return a(L,f,u,d,g)}))}function p(l,f,u,d){return function(g){g.delegateTarget=s(g.target,f),g.delegateTarget&&d.call(l,g)}}o.exports=c},879:function(o,n){n.node=function(i){return i!==void 0&&i instanceof HTMLElement&&i.nodeType===1},n.nodeList=function(i){var s=Object.prototype.toString.call(i);return i!==void 0&&(s==="[object NodeList]"||s==="[object HTMLCollection]")&&"length"in i&&(i.length===0||n.node(i[0]))},n.string=function(i){return typeof i=="string"||i instanceof String},n.fn=function(i){var s=Object.prototype.toString.call(i);return s==="[object Function]"}},370:function(o,n,i){var s=i(879),a=i(438);function c(u,d,g){if(!u&&!d&&!g)throw new Error("Missing required arguments");if(!s.string(d))throw new TypeError("Second argument must be a String");if(!s.fn(g))throw new TypeError("Third argument must be a Function");if(s.node(u))return p(u,d,g);if(s.nodeList(u))return l(u,d,g);if(s.string(u))return f(u,d,g);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList")}function p(u,d,g){return u.addEventListener(d,g),{destroy:function(){u.removeEventListener(d,g)}}}function l(u,d,g){return Array.prototype.forEach.call(u,function(L){L.addEventListener(d,g)}),{destroy:function(){Array.prototype.forEach.call(u,function(L){L.removeEventListener(d,g)})}}}function f(u,d,g){return a(document.body,u,d,g)}o.exports=c},817:function(o){function n(i){var s;if(i.nodeName==="SELECT")i.focus(),s=i.value;else if(i.nodeName==="INPUT"||i.nodeName==="TEXTAREA"){var a=i.hasAttribute("readonly");a||i.setAttribute("readonly",""),i.select(),i.setSelectionRange(0,i.value.length),a||i.removeAttribute("readonly"),s=i.value}else{i.hasAttribute("contenteditable")&&i.focus();var c=window.getSelection(),p=document.createRange();p.selectNodeContents(i),c.removeAllRanges(),c.addRange(p),s=c.toString()}return s}o.exports=n},279:function(o){function n(){}n.prototype={on:function(i,s,a){var c=this.e||(this.e={});return(c[i]||(c[i]=[])).push({fn:s,ctx:a}),this},once:function(i,s,a){var c=this;function p(){c.off(i,p),s.apply(a,arguments)}return p._=s,this.on(i,p,a)},emit:function(i){var s=[].slice.call(arguments,1),a=((this.e||(this.e={}))[i]||[]).slice(),c=0,p=a.length;for(c;c<p;c++)a[c].fn.apply(a[c].ctx,s);return this},off:function(i,s){var a=this.e||(this.e={}),c=a[i],p=[];if(c&&s)for(var l=0,f=c.length;l<f;l++)c[l].fn!==s&&c[l].fn._!==s&&p.push(c[l]);return p.length?a[i]=p:delete a[i],this}},o.exports=n,o.exports.TinyEmitter=n}},t={};function r(o){if(t[o])return t[o].exports;var n=t[o]={exports:{}};return e[o](n,n.exports,r),n.exports}return function(){r.n=function(o){var n=o&&o.__esModule?function(){return o.default}:function(){return o};return r.d(n,{a:n}),n}}(),function(){r.d=function(o,n){for(var i in n)r.o(n,i)&&!r.o(o,i)&&Object.defineProperty(o,i,{enumerable:!0,get:n[i]})}}(),function(){r.o=function(o,n){return Object.prototype.hasOwnProperty.call(o,n)}}(),r(686)}().default})});var bi=Cr((iS,hi)=>{"use strict";var us=/["'&<>]/;hi.exports=ds;function ds(e){var t=""+e,r=us.exec(t);if(!r)return t;var o,n="",i=0,s=0;for(i=r.index;i<t.length;i++){switch(t.charCodeAt(i)){case 34:o="&quot;";break;case 38:o="&amp;";break;case 39:o="&#39;";break;case 60:o="&lt;";break;case 62:o="&gt;";break;default:continue}s!==i&&(n+=t.substring(s,i)),s=i+1,n+=o}return s!==i?n+t.substring(s,i):n}});var qM=Gt(go());var $r=function(e,t){return $r=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(r,o){r.__proto__=o}||function(r,o){for(var n in o)Object.prototype.hasOwnProperty.call(o,n)&&(r[n]=o[n])},$r(e,t)};function ie(e,t){if(typeof t!="function"&&t!==null)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");$r(e,t);function r(){this.constructor=e}e.prototype=t===null?Object.create(t):(r.prototype=t.prototype,new r)}function xo(e,t,r,o){function n(i){return i instanceof r?i:new r(function(s){s(i)})}return new(r||(r=Promise))(function(i,s){function a(l){try{p(o.next(l))}catch(f){s(f)}}function c(l){try{p(o.throw(l))}catch(f){s(f)}}function p(l){l.done?i(l.value):n(l.value).then(a,c)}p((o=o.apply(e,t||[])).next())})}function Jt(e,t){var r={label:0,sent:function(){if(i[0]&1)throw i[1];return i[1]},trys:[],ops:[]},o,n,i,s;return s={next:a(0),throw:a(1),return:a(2)},typeof Symbol=="function"&&(s[Symbol.iterator]=function(){return this}),s;function a(p){return function(l){return c([p,l])}}function c(p){if(o)throw new TypeError("Generator is already executing.");for(;r;)try{if(o=1,n&&(i=p[0]&2?n.return:p[0]?n.throw||((i=n.return)&&i.call(n),0):n.next)&&!(i=i.call(n,p[1])).done)return i;switch(n=0,i&&(p=[p[0]&2,i.value]),p[0]){case 0:case 1:i=p;break;case 4:return r.label++,{value:p[1],done:!1};case 5:r.label++,n=p[1],p=[0];continue;case 7:p=r.ops.pop(),r.trys.pop();continue;default:if(i=r.trys,!(i=i.length>0&&i[i.length-1])&&(p[0]===6||p[0]===2)){r=0;continue}if(p[0]===3&&(!i||p[1]>i[0]&&p[1]<i[3])){r.label=p[1];break}if(p[0]===6&&r.label<i[1]){r.label=i[1],i=p;break}if(i&&r.label<i[2]){r.label=i[2],r.ops.push(p);break}i[2]&&r.ops.pop(),r.trys.pop();continue}p=t.call(e,r)}catch(l){p=[6,l],n=0}finally{o=i=0}if(p[0]&5)throw p[1];return{value:p[0]?p[1]:void 0,done:!0}}}function Oe(e){var t=typeof Symbol=="function"&&Symbol.iterator,r=t&&e[t],o=0;if(r)return r.call(e);if(e&&typeof e.length=="number")return{next:function(){return e&&o>=e.length&&(e=void 0),{value:e&&e[o++],done:!e}}};throw new TypeError(t?"Object is not iterable.":"Symbol.iterator is not defined.")}function K(e,t){var r=typeof Symbol=="function"&&e[Symbol.iterator];if(!r)return e;var o=r.call(e),n,i=[],s;try{for(;(t===void 0||t-- >0)&&!(n=o.next()).done;)i.push(n.value)}catch(a){s={error:a}}finally{try{n&&!n.done&&(r=o.return)&&r.call(o)}finally{if(s)throw s.error}}return i}function B(e,t,r){if(r||arguments.length===2)for(var o=0,n=t.length,i;o<n;o++)(i||!(o in t))&&(i||(i=Array.prototype.slice.call(t,0,o)),i[o]=t[o]);return e.concat(i||Array.prototype.slice.call(t))}function ut(e){return this instanceof ut?(this.v=e,this):new ut(e)}function yo(e,t,r){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var o=r.apply(e,t||[]),n,i=[];return n={},s("next"),s("throw"),s("return"),n[Symbol.asyncIterator]=function(){return this},n;function s(u){o[u]&&(n[u]=function(d){return new Promise(function(g,L){i.push([u,d,g,L])>1||a(u,d)})})}function a(u,d){try{c(o[u](d))}catch(g){f(i[0][3],g)}}function c(u){u.value instanceof ut?Promise.resolve(u.value.v).then(p,l):f(i[0][2],u)}function p(u){a("next",u)}function l(u){a("throw",u)}function f(u,d){u(d),i.shift(),i.length&&a(i[0][0],i[0][1])}}function Eo(e){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var t=e[Symbol.asyncIterator],r;return t?t.call(e):(e=typeof Oe=="function"?Oe(e):e[Symbol.iterator](),r={},o("next"),o("throw"),o("return"),r[Symbol.asyncIterator]=function(){return this},r);function o(i){r[i]=e[i]&&function(s){return new Promise(function(a,c){s=e[i](s),n(a,c,s.done,s.value)})}}function n(i,s,a,c){Promise.resolve(c).then(function(p){i({value:p,done:a})},s)}}function P(e){return typeof e=="function"}function xt(e){var t=function(o){Error.call(o),o.stack=new Error().stack},r=e(t);return r.prototype=Object.create(Error.prototype),r.prototype.constructor=r,r}var Xt=xt(function(e){return function(r){e(this),this.message=r?r.length+` errors occurred during unsubscription:
 `+r.map(function(o,n){return n+1+") "+o.toString()}).join(`
-  `):"",this.name="UnsubscriptionError",this.errors=r}});function Xe(e,t){if(e){var r=e.indexOf(t);0<=r&&e.splice(r,1)}}var ze=function(){function e(t){this.initialTeardown=t,this.closed=!1,this._parentage=null,this._finalizers=null}return e.prototype.unsubscribe=function(){var t,r,o,n,i;if(!this.closed){this.closed=!0;var s=this._parentage;if(s)if(this._parentage=null,Array.isArray(s))try{for(var a=Oe(s),c=a.next();!c.done;c=a.next()){var p=c.value;p.remove(this)}}catch(L){t={error:L}}finally{try{c&&!c.done&&(r=a.return)&&r.call(a)}finally{if(t)throw t.error}}else s.remove(this);var l=this.initialTeardown;if(P(l))try{l()}catch(L){i=L instanceof Xt?L.errors:[L]}var f=this._finalizers;if(f){this._finalizers=null;try{for(var u=Oe(f),d=u.next();!d.done;d=u.next()){var g=d.value;try{wo(g)}catch(L){i=i!=null?i:[],L instanceof Xt?i=B(B([],K(i)),K(L.errors)):i.push(L)}}}catch(L){o={error:L}}finally{try{d&&!d.done&&(n=u.return)&&n.call(u)}finally{if(o)throw o.error}}}if(i)throw new Xt(i)}},e.prototype.add=function(t){var r;if(t&&t!==this)if(this.closed)wo(t);else{if(t instanceof e){if(t.closed||t._hasParent(this))return;t._addParent(this)}(this._finalizers=(r=this._finalizers)!==null&&r!==void 0?r:[]).push(t)}},e.prototype._hasParent=function(t){var r=this._parentage;return r===t||Array.isArray(r)&&r.includes(t)},e.prototype._addParent=function(t){var r=this._parentage;this._parentage=Array.isArray(r)?(r.push(t),r):r?[r,t]:t},e.prototype._removeParent=function(t){var r=this._parentage;r===t?this._parentage=null:Array.isArray(r)&&Xe(r,t)},e.prototype.remove=function(t){var r=this._finalizers;r&&Xe(r,t),t instanceof e&&t._removeParent(this)},e.EMPTY=function(){var t=new e;return t.closed=!0,t}(),e}();var $r=ze.EMPTY;function Zt(e){return e instanceof ze||e&&"closed"in e&&P(e.remove)&&P(e.add)&&P(e.unsubscribe)}function wo(e){P(e)?e():e.unsubscribe()}var We={onUnhandledError:null,onStoppedNotification:null,Promise:void 0,useDeprecatedSynchronousErrorHandling:!1,useDeprecatedNextContext:!1};var yt={setTimeout:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=yt.delegate;return n!=null&&n.setTimeout?n.setTimeout.apply(n,B([e,t],K(r))):setTimeout.apply(void 0,B([e,t],K(r)))},clearTimeout:function(e){var t=yt.delegate;return((t==null?void 0:t.clearTimeout)||clearTimeout)(e)},delegate:void 0};function er(e){yt.setTimeout(function(){var t=We.onUnhandledError;if(t)t(e);else throw e})}function ve(){}var To=function(){return Rr("C",void 0,void 0)}();function So(e){return Rr("E",void 0,e)}function Oo(e){return Rr("N",e,void 0)}function Rr(e,t,r){return{kind:e,value:t,error:r}}var dt=null;function Et(e){if(We.useDeprecatedSynchronousErrorHandling){var t=!dt;if(t&&(dt={errorThrown:!1,error:null}),e(),t){var r=dt,o=r.errorThrown,n=r.error;if(dt=null,o)throw n}}else e()}function Lo(e){We.useDeprecatedSynchronousErrorHandling&&dt&&(dt.errorThrown=!0,dt.error=e)}var Rt=function(e){ie(t,e);function t(r){var o=e.call(this)||this;return o.isStopped=!1,r?(o.destination=r,Zt(r)&&r.add(o)):o.destination=oa,o}return t.create=function(r,o,n){return new ht(r,o,n)},t.prototype.next=function(r){this.isStopped?Ir(Oo(r),this):this._next(r)},t.prototype.error=function(r){this.isStopped?Ir(So(r),this):(this.isStopped=!0,this._error(r))},t.prototype.complete=function(){this.isStopped?Ir(To,this):(this.isStopped=!0,this._complete())},t.prototype.unsubscribe=function(){this.closed||(this.isStopped=!0,e.prototype.unsubscribe.call(this),this.destination=null)},t.prototype._next=function(r){this.destination.next(r)},t.prototype._error=function(r){try{this.destination.error(r)}finally{this.unsubscribe()}},t.prototype._complete=function(){try{this.destination.complete()}finally{this.unsubscribe()}},t}(ze);var ea=Function.prototype.bind;function Pr(e,t){return ea.call(e,t)}var ta=function(){function e(t){this.partialObserver=t}return e.prototype.next=function(t){var r=this.partialObserver;if(r.next)try{r.next(t)}catch(o){tr(o)}},e.prototype.error=function(t){var r=this.partialObserver;if(r.error)try{r.error(t)}catch(o){tr(o)}else tr(t)},e.prototype.complete=function(){var t=this.partialObserver;if(t.complete)try{t.complete()}catch(r){tr(r)}},e}(),ht=function(e){ie(t,e);function t(r,o,n){var i=e.call(this)||this,s;if(P(r)||!r)s={next:r!=null?r:void 0,error:o!=null?o:void 0,complete:n!=null?n:void 0};else{var a;i&&We.useDeprecatedNextContext?(a=Object.create(r),a.unsubscribe=function(){return i.unsubscribe()},s={next:r.next&&Pr(r.next,a),error:r.error&&Pr(r.error,a),complete:r.complete&&Pr(r.complete,a)}):s=r}return i.destination=new ta(s),i}return t}(Rt);function tr(e){We.useDeprecatedSynchronousErrorHandling?Lo(e):er(e)}function ra(e){throw e}function Ir(e,t){var r=We.onStoppedNotification;r&&yt.setTimeout(function(){return r(e,t)})}var oa={closed:!0,next:ve,error:ra,complete:ve};var wt=function(){return typeof Symbol=="function"&&Symbol.observable||"@@observable"}();function be(e){return e}function Mo(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Fr(e)}function Fr(e){return e.length===0?be:e.length===1?e[0]:function(r){return e.reduce(function(o,n){return n(o)},r)}}var I=function(){function e(t){t&&(this._subscribe=t)}return e.prototype.lift=function(t){var r=new e;return r.source=this,r.operator=t,r},e.prototype.subscribe=function(t,r,o){var n=this,i=ia(t)?t:new ht(t,r,o);return Et(function(){var s=n,a=s.operator,c=s.source;i.add(a?a.call(i,c):c?n._subscribe(i):n._trySubscribe(i))}),i},e.prototype._trySubscribe=function(t){try{return this._subscribe(t)}catch(r){t.error(r)}},e.prototype.forEach=function(t,r){var o=this;return r=_o(r),new r(function(n,i){var s=new ht({next:function(a){try{t(a)}catch(c){i(c),s.unsubscribe()}},error:i,complete:n});o.subscribe(s)})},e.prototype._subscribe=function(t){var r;return(r=this.source)===null||r===void 0?void 0:r.subscribe(t)},e.prototype[wt]=function(){return this},e.prototype.pipe=function(){for(var t=[],r=0;r<arguments.length;r++)t[r]=arguments[r];return Fr(t)(this)},e.prototype.toPromise=function(t){var r=this;return t=_o(t),new t(function(o,n){var i;r.subscribe(function(s){return i=s},function(s){return n(s)},function(){return o(i)})})},e.create=function(t){return new e(t)},e}();function _o(e){var t;return(t=e!=null?e:We.Promise)!==null&&t!==void 0?t:Promise}function na(e){return e&&P(e.next)&&P(e.error)&&P(e.complete)}function ia(e){return e&&e instanceof Rt||na(e)&&Zt(e)}function aa(e){return P(e==null?void 0:e.lift)}function E(e){return function(t){if(aa(t))return t.lift(function(r){try{return e(r,this)}catch(o){this.error(o)}});throw new TypeError("Unable to lift unknown Observable type")}}function w(e,t,r,o,n){return new sa(e,t,r,o,n)}var sa=function(e){ie(t,e);function t(r,o,n,i,s,a){var c=e.call(this,r)||this;return c.onFinalize=s,c.shouldUnsubscribe=a,c._next=o?function(p){try{o(p)}catch(l){r.error(l)}}:e.prototype._next,c._error=i?function(p){try{i(p)}catch(l){r.error(l)}finally{this.unsubscribe()}}:e.prototype._error,c._complete=n?function(){try{n()}catch(p){r.error(p)}finally{this.unsubscribe()}}:e.prototype._complete,c}return t.prototype.unsubscribe=function(){var r;if(!this.shouldUnsubscribe||this.shouldUnsubscribe()){var o=this.closed;e.prototype.unsubscribe.call(this),!o&&((r=this.onFinalize)===null||r===void 0||r.call(this))}},t}(Rt);var Tt={schedule:function(e){var t=requestAnimationFrame,r=cancelAnimationFrame,o=Tt.delegate;o&&(t=o.requestAnimationFrame,r=o.cancelAnimationFrame);var n=t(function(i){r=void 0,e(i)});return new ze(function(){return r==null?void 0:r(n)})},requestAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Tt.delegate;return((r==null?void 0:r.requestAnimationFrame)||requestAnimationFrame).apply(void 0,B([],K(e)))},cancelAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Tt.delegate;return((r==null?void 0:r.cancelAnimationFrame)||cancelAnimationFrame).apply(void 0,B([],K(e)))},delegate:void 0};var Ao=xt(function(e){return function(){e(this),this.name="ObjectUnsubscribedError",this.message="object unsubscribed"}});var T=function(e){ie(t,e);function t(){var r=e.call(this)||this;return r.closed=!1,r.currentObservers=null,r.observers=[],r.isStopped=!1,r.hasError=!1,r.thrownError=null,r}return t.prototype.lift=function(r){var o=new Co(this,this);return o.operator=r,o},t.prototype._throwIfClosed=function(){if(this.closed)throw new Ao},t.prototype.next=function(r){var o=this;Et(function(){var n,i;if(o._throwIfClosed(),!o.isStopped){o.currentObservers||(o.currentObservers=Array.from(o.observers));try{for(var s=Oe(o.currentObservers),a=s.next();!a.done;a=s.next()){var c=a.value;c.next(r)}}catch(p){n={error:p}}finally{try{a&&!a.done&&(i=s.return)&&i.call(s)}finally{if(n)throw n.error}}}})},t.prototype.error=function(r){var o=this;Et(function(){if(o._throwIfClosed(),!o.isStopped){o.hasError=o.isStopped=!0,o.thrownError=r;for(var n=o.observers;n.length;)n.shift().error(r)}})},t.prototype.complete=function(){var r=this;Et(function(){if(r._throwIfClosed(),!r.isStopped){r.isStopped=!0;for(var o=r.observers;o.length;)o.shift().complete()}})},t.prototype.unsubscribe=function(){this.isStopped=this.closed=!0,this.observers=this.currentObservers=null},Object.defineProperty(t.prototype,"observed",{get:function(){var r;return((r=this.observers)===null||r===void 0?void 0:r.length)>0},enumerable:!1,configurable:!0}),t.prototype._trySubscribe=function(r){return this._throwIfClosed(),e.prototype._trySubscribe.call(this,r)},t.prototype._subscribe=function(r){return this._throwIfClosed(),this._checkFinalizedStatuses(r),this._innerSubscribe(r)},t.prototype._innerSubscribe=function(r){var o=this,n=this,i=n.hasError,s=n.isStopped,a=n.observers;return i||s?$r:(this.currentObservers=null,a.push(r),new ze(function(){o.currentObservers=null,Xe(a,r)}))},t.prototype._checkFinalizedStatuses=function(r){var o=this,n=o.hasError,i=o.thrownError,s=o.isStopped;n?r.error(i):s&&r.complete()},t.prototype.asObservable=function(){var r=new I;return r.source=this,r},t.create=function(r,o){return new Co(r,o)},t}(I);var Co=function(e){ie(t,e);function t(r,o){var n=e.call(this)||this;return n.destination=r,n.source=o,n}return t.prototype.next=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.next)===null||n===void 0||n.call(o,r)},t.prototype.error=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.error)===null||n===void 0||n.call(o,r)},t.prototype.complete=function(){var r,o;(o=(r=this.destination)===null||r===void 0?void 0:r.complete)===null||o===void 0||o.call(r)},t.prototype._subscribe=function(r){var o,n;return(n=(o=this.source)===null||o===void 0?void 0:o.subscribe(r))!==null&&n!==void 0?n:$r},t}(T);var jr=function(e){ie(t,e);function t(r){var o=e.call(this)||this;return o._value=r,o}return Object.defineProperty(t.prototype,"value",{get:function(){return this.getValue()},enumerable:!1,configurable:!0}),t.prototype._subscribe=function(r){var o=e.prototype._subscribe.call(this,r);return!o.closed&&r.next(this._value),o},t.prototype.getValue=function(){var r=this,o=r.hasError,n=r.thrownError,i=r._value;if(o)throw n;return this._throwIfClosed(),i},t.prototype.next=function(r){e.prototype.next.call(this,this._value=r)},t}(T);var Pt={now:function(){return(Pt.delegate||Date).now()},delegate:void 0};var It=function(e){ie(t,e);function t(r,o,n){r===void 0&&(r=1/0),o===void 0&&(o=1/0),n===void 0&&(n=Pt);var i=e.call(this)||this;return i._bufferSize=r,i._windowTime=o,i._timestampProvider=n,i._buffer=[],i._infiniteTimeWindow=!0,i._infiniteTimeWindow=o===1/0,i._bufferSize=Math.max(1,r),i._windowTime=Math.max(1,o),i}return t.prototype.next=function(r){var o=this,n=o.isStopped,i=o._buffer,s=o._infiniteTimeWindow,a=o._timestampProvider,c=o._windowTime;n||(i.push(r),!s&&i.push(a.now()+c)),this._trimBuffer(),e.prototype.next.call(this,r)},t.prototype._subscribe=function(r){this._throwIfClosed(),this._trimBuffer();for(var o=this._innerSubscribe(r),n=this,i=n._infiniteTimeWindow,s=n._buffer,a=s.slice(),c=0;c<a.length&&!r.closed;c+=i?1:2)r.next(a[c]);return this._checkFinalizedStatuses(r),o},t.prototype._trimBuffer=function(){var r=this,o=r._bufferSize,n=r._timestampProvider,i=r._buffer,s=r._infiniteTimeWindow,a=(s?1:2)*o;if(o<1/0&&a<i.length&&i.splice(0,i.length-a),!s){for(var c=n.now(),p=0,l=1;l<i.length&&i[l]<=c;l+=2)p=l;p&&i.splice(0,p+1)}},t}(T);var Ho=function(e){ie(t,e);function t(r,o){return e.call(this)||this}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),this},t}(ze);var Ft={setInterval:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=Ft.delegate;return n!=null&&n.setInterval?n.setInterval.apply(n,B([e,t],K(r))):setInterval.apply(void 0,B([e,t],K(r)))},clearInterval:function(e){var t=Ft.delegate;return((t==null?void 0:t.clearInterval)||clearInterval)(e)},delegate:void 0};var St=function(e){ie(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n.pending=!1,n}return t.prototype.schedule=function(r,o){var n;if(o===void 0&&(o=0),this.closed)return this;this.state=r;var i=this.id,s=this.scheduler;return i!=null&&(this.id=this.recycleAsyncId(s,i,o)),this.pending=!0,this.delay=o,this.id=(n=this.id)!==null&&n!==void 0?n:this.requestAsyncId(s,this.id,o),this},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),Ft.setInterval(r.flush.bind(r,this),n)},t.prototype.recycleAsyncId=function(r,o,n){if(n===void 0&&(n=0),n!=null&&this.delay===n&&this.pending===!1)return o;o!=null&&Ft.clearInterval(o)},t.prototype.execute=function(r,o){if(this.closed)return new Error("executing a cancelled action");this.pending=!1;var n=this._execute(r,o);if(n)return n;this.pending===!1&&this.id!=null&&(this.id=this.recycleAsyncId(this.scheduler,this.id,null))},t.prototype._execute=function(r,o){var n=!1,i;try{this.work(r)}catch(s){n=!0,i=s||new Error("Scheduled action threw falsy error")}if(n)return this.unsubscribe(),i},t.prototype.unsubscribe=function(){if(!this.closed){var r=this,o=r.id,n=r.scheduler,i=n.actions;this.work=this.state=this.scheduler=null,this.pending=!1,Xe(i,this),o!=null&&(this.id=this.recycleAsyncId(n,o,null)),this.delay=null,e.prototype.unsubscribe.call(this)}},t}(Ho);var Ur=function(){function e(t,r){r===void 0&&(r=e.now),this.schedulerActionCtor=t,this.now=r}return e.prototype.schedule=function(t,r,o){return r===void 0&&(r=0),new this.schedulerActionCtor(this,t).schedule(o,r)},e.now=Pt.now,e}();var Ot=function(e){ie(t,e);function t(r,o){o===void 0&&(o=Ur.now);var n=e.call(this,r,o)||this;return n.actions=[],n._active=!1,n}return t.prototype.flush=function(r){var o=this.actions;if(this._active){o.push(r);return}var n;this._active=!0;do if(n=r.execute(r.state,r.delay))break;while(r=o.shift());if(this._active=!1,n){for(;r=o.shift();)r.unsubscribe();throw n}},t}(Ur);var pe=new Ot(St),Wr=pe;var ko=function(e){ie(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),o>0?e.prototype.schedule.call(this,r,o):(this.delay=o,this.state=r,this.scheduler.flush(this),this)},t.prototype.execute=function(r,o){return o>0||this.closed?e.prototype.execute.call(this,r,o):this._execute(r,o)},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!=null&&n>0||n==null&&this.delay>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.flush(this),0)},t}(St);var $o=function(e){ie(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t}(Ot);var Dr=new $o(ko);var Ro=function(e){ie(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!==null&&n>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.actions.push(this),r._scheduled||(r._scheduled=Tt.requestAnimationFrame(function(){return r.flush(void 0)})))},t.prototype.recycleAsyncId=function(r,o,n){var i;if(n===void 0&&(n=0),n!=null?n>0:this.delay>0)return e.prototype.recycleAsyncId.call(this,r,o,n);var s=r.actions;o!=null&&((i=s[s.length-1])===null||i===void 0?void 0:i.id)!==o&&(Tt.cancelAnimationFrame(o),r._scheduled=void 0)},t}(St);var Po=function(e){ie(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t.prototype.flush=function(r){this._active=!0;var o=this._scheduled;this._scheduled=void 0;var n=this.actions,i;r=r||n.shift();do if(i=r.execute(r.state,r.delay))break;while((r=n[0])&&r.id===o&&n.shift());if(this._active=!1,i){for(;(r=n[0])&&r.id===o&&n.shift();)r.unsubscribe();throw i}},t}(Ot);var ge=new Po(Ro);var x=new I(function(e){return e.complete()});function rr(e){return e&&P(e.schedule)}function Nr(e){return e[e.length-1]}function ct(e){return P(Nr(e))?e.pop():void 0}function Ie(e){return rr(Nr(e))?e.pop():void 0}function or(e,t){return typeof Nr(e)=="number"?e.pop():t}var Lt=function(e){return e&&typeof e.length=="number"&&typeof e!="function"};function nr(e){return P(e==null?void 0:e.then)}function ir(e){return P(e[wt])}function ar(e){return Symbol.asyncIterator&&P(e==null?void 0:e[Symbol.asyncIterator])}function sr(e){return new TypeError("You provided "+(e!==null&&typeof e=="object"?"an invalid object":"'"+e+"'")+" where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.")}function ca(){return typeof Symbol!="function"||!Symbol.iterator?"@@iterator":Symbol.iterator}var cr=ca();function pr(e){return P(e==null?void 0:e[cr])}function lr(e){return yo(this,arguments,function(){var r,o,n,i;return Jt(this,function(s){switch(s.label){case 0:r=e.getReader(),s.label=1;case 1:s.trys.push([1,,9,10]),s.label=2;case 2:return[4,ut(r.read())];case 3:return o=s.sent(),n=o.value,i=o.done,i?[4,ut(void 0)]:[3,5];case 4:return[2,s.sent()];case 5:return[4,ut(n)];case 6:return[4,s.sent()];case 7:return s.sent(),[3,2];case 8:return[3,10];case 9:return r.releaseLock(),[7];case 10:return[2]}})})}function mr(e){return P(e==null?void 0:e.getReader)}function U(e){if(e instanceof I)return e;if(e!=null){if(ir(e))return pa(e);if(Lt(e))return la(e);if(nr(e))return ma(e);if(ar(e))return Io(e);if(pr(e))return fa(e);if(mr(e))return ua(e)}throw sr(e)}function pa(e){return new I(function(t){var r=e[wt]();if(P(r.subscribe))return r.subscribe(t);throw new TypeError("Provided object does not correctly implement Symbol.observable")})}function la(e){return new I(function(t){for(var r=0;r<e.length&&!t.closed;r++)t.next(e[r]);t.complete()})}function ma(e){return new I(function(t){e.then(function(r){t.closed||(t.next(r),t.complete())},function(r){return t.error(r)}).then(null,er)})}function fa(e){return new I(function(t){var r,o;try{for(var n=Oe(e),i=n.next();!i.done;i=n.next()){var s=i.value;if(t.next(s),t.closed)return}}catch(a){r={error:a}}finally{try{i&&!i.done&&(o=n.return)&&o.call(n)}finally{if(r)throw r.error}}t.complete()})}function Io(e){return new I(function(t){da(e,t).catch(function(r){return t.error(r)})})}function ua(e){return Io(lr(e))}function da(e,t){var r,o,n,i;return xo(this,void 0,void 0,function(){var s,a;return Jt(this,function(c){switch(c.label){case 0:c.trys.push([0,5,6,11]),r=Eo(e),c.label=1;case 1:return[4,r.next()];case 2:if(o=c.sent(),!!o.done)return[3,4];if(s=o.value,t.next(s),t.closed)return[2];c.label=3;case 3:return[3,1];case 4:return[3,11];case 5:return a=c.sent(),n={error:a},[3,11];case 6:return c.trys.push([6,,9,10]),o&&!o.done&&(i=r.return)?[4,i.call(r)]:[3,8];case 7:c.sent(),c.label=8;case 8:return[3,10];case 9:if(n)throw n.error;return[7];case 10:return[7];case 11:return t.complete(),[2]}})})}function _e(e,t,r,o,n){o===void 0&&(o=0),n===void 0&&(n=!1);var i=t.schedule(function(){r(),n?e.add(this.schedule(null,o)):this.unsubscribe()},o);if(e.add(i),!n)return i}function xe(e,t){return t===void 0&&(t=0),E(function(r,o){r.subscribe(w(o,function(n){return _e(o,e,function(){return o.next(n)},t)},function(){return _e(o,e,function(){return o.complete()},t)},function(n){return _e(o,e,function(){return o.error(n)},t)}))})}function Ze(e,t){return t===void 0&&(t=0),E(function(r,o){o.add(e.schedule(function(){return r.subscribe(o)},t))})}function Fo(e,t){return U(e).pipe(Ze(t),xe(t))}function jo(e,t){return U(e).pipe(Ze(t),xe(t))}function Uo(e,t){return new I(function(r){var o=0;return t.schedule(function(){o===e.length?r.complete():(r.next(e[o++]),r.closed||this.schedule())})})}function Wo(e,t){return new I(function(r){var o;return _e(r,t,function(){o=e[cr](),_e(r,t,function(){var n,i,s;try{n=o.next(),i=n.value,s=n.done}catch(a){r.error(a);return}s?r.complete():r.next(i)},0,!0)}),function(){return P(o==null?void 0:o.return)&&o.return()}})}function fr(e,t){if(!e)throw new Error("Iterable cannot be null");return new I(function(r){_e(r,t,function(){var o=e[Symbol.asyncIterator]();_e(r,t,function(){o.next().then(function(n){n.done?r.complete():r.next(n.value)})},0,!0)})})}function Do(e,t){return fr(lr(e),t)}function No(e,t){if(e!=null){if(ir(e))return Fo(e,t);if(Lt(e))return Uo(e,t);if(nr(e))return jo(e,t);if(ar(e))return fr(e,t);if(pr(e))return Wo(e,t);if(mr(e))return Do(e,t)}throw sr(e)}function fe(e,t){return t?No(e,t):U(e)}function $(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ie(e);return fe(e,r)}function Vr(e,t){var r=P(e)?e:function(){return e},o=function(n){return n.error(r())};return new I(t?function(n){return t.schedule(o,0,n)}:o)}var ur=xt(function(e){return function(){e(this),this.name="EmptyError",this.message="no elements in sequence"}});function Vo(e){return e instanceof Date&&!isNaN(e)}function m(e,t){return E(function(r,o){var n=0;r.subscribe(w(o,function(i){o.next(e.call(t,i,n++))}))})}var ha=Array.isArray;function ba(e,t){return ha(t)?e.apply(void 0,B([],K(t))):e(t)}function pt(e){return m(function(t){return ba(e,t)})}var va=Array.isArray,ga=Object.getPrototypeOf,xa=Object.prototype,ya=Object.keys;function zo(e){if(e.length===1){var t=e[0];if(va(t))return{args:t,keys:null};if(Ea(t)){var r=ya(t);return{args:r.map(function(o){return t[o]}),keys:r}}}return{args:e,keys:null}}function Ea(e){return e&&typeof e=="object"&&ga(e)===xa}function qo(e,t){return e.reduce(function(r,o,n){return r[o]=t[n],r},{})}function z(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ie(e),o=ct(e),n=zo(e),i=n.args,s=n.keys;if(i.length===0)return fe([],r);var a=new I(zr(i,r,s?function(c){return qo(s,c)}:be));return o?a.pipe(pt(o)):a}function zr(e,t,r){return r===void 0&&(r=be),function(o){Ko(t,function(){for(var n=e.length,i=new Array(n),s=n,a=n,c=function(l){Ko(t,function(){var f=fe(e[l],t),u=!1;f.subscribe(w(o,function(d){i[l]=d,u||(u=!0,a--),a||o.next(r(i.slice()))},function(){--s||o.complete()}))},o)},p=0;p<n;p++)c(p)},o)}}function Ko(e,t,r){e?_e(r,e,t):t()}function Qo(e,t,r,o,n,i,s,a){var c=[],p=0,l=0,f=!1,u=function(){f&&!c.length&&!p&&t.complete()},d=function(L){return p<o?g(L):c.push(L)},g=function(L){i&&t.next(L),p++;var ee=!1;U(r(L,l++)).subscribe(w(t,function(ne){n==null||n(ne),i?d(ne):t.next(ne)},function(){ee=!0},void 0,function(){if(ee)try{p--;for(var ne=function(){var Z=c.shift();s?_e(t,s,function(){return g(Z)}):g(Z)};c.length&&p<o;)ne();u()}catch(Z){t.error(Z)}}))};return e.subscribe(w(t,d,function(){f=!0,u()})),function(){a==null||a()}}function J(e,t,r){return r===void 0&&(r=1/0),P(t)?J(function(o,n){return m(function(i,s){return t(o,i,n,s)})(U(e(o,n)))},r):(typeof t=="number"&&(r=t),E(function(o,n){return Qo(o,n,e,r)}))}function Mt(e){return e===void 0&&(e=1/0),J(be,e)}function Yo(){return Mt(1)}function qe(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Yo()(fe(e,Ie(e)))}function k(e){return new I(function(t){U(e()).subscribe(t)})}var wa=["addListener","removeListener"],Ta=["addEventListener","removeEventListener"],Sa=["on","off"];function h(e,t,r,o){if(P(r)&&(o=r,r=void 0),o)return h(e,t,r).pipe(pt(o));var n=K(Ma(e)?Ta.map(function(a){return function(c){return e[a](t,c,r)}}):Oa(e)?wa.map(Bo(e,t)):La(e)?Sa.map(Bo(e,t)):[],2),i=n[0],s=n[1];if(!i&&Lt(e))return J(function(a){return h(a,t,r)})(U(e));if(!i)throw new TypeError("Invalid event target");return new I(function(a){var c=function(){for(var p=[],l=0;l<arguments.length;l++)p[l]=arguments[l];return a.next(1<p.length?p:p[0])};return i(c),function(){return s(c)}})}function Bo(e,t){return function(r){return function(o){return e[r](t,o)}}}function Oa(e){return P(e.addListener)&&P(e.removeListener)}function La(e){return P(e.on)&&P(e.off)}function Ma(e){return P(e.addEventListener)&&P(e.removeEventListener)}function dr(e,t,r){return r?dr(e,t).pipe(pt(r)):new I(function(o){var n=function(){for(var s=[],a=0;a<arguments.length;a++)s[a]=arguments[a];return o.next(s.length===1?s[0]:s)},i=e(n);return P(t)?function(){return t(n,i)}:void 0})}function ke(e,t,r){e===void 0&&(e=0),r===void 0&&(r=Wr);var o=-1;return t!=null&&(rr(t)?r=t:o=t),new I(function(n){var i=Vo(e)?+e-r.now():e;i<0&&(i=0);var s=0;return r.schedule(function(){n.closed||(n.next(s++),0<=o?this.schedule(void 0,o):n.complete())},i)})}function O(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ie(e),o=or(e,1/0),n=e;return n.length?n.length===1?U(n[0]):Mt(o)(fe(n,r)):x}var et=new I(ve);var _a=Array.isArray;function _t(e){return e.length===1&&_a(e[0])?e[0]:e}function v(e,t){return E(function(r,o){var n=0;r.subscribe(w(o,function(i){return e.call(t,i,n++)&&o.next(i)}))})}function bt(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ct(e),o=_t(e);return o.length?new I(function(n){var i=o.map(function(){return[]}),s=o.map(function(){return!1});n.add(function(){i=s=null});for(var a=function(p){U(o[p]).subscribe(w(n,function(l){if(i[p].push(l),i.every(function(u){return u.length})){var f=i.map(function(u){return u.shift()});n.next(r?r.apply(void 0,B([],K(f))):f),i.some(function(u,d){return!u.length&&s[d]})&&n.complete()}},function(){s[p]=!0,!i[p].length&&n.complete()}))},c=0;!n.closed&&c<o.length;c++)a(c);return function(){i=s=null}}):x}function Go(e){return E(function(t,r){var o=!1,n=null,i=null,s=!1,a=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var p=n;n=null,r.next(p)}s&&r.complete()},c=function(){i=null,s&&r.complete()};t.subscribe(w(r,function(p){o=!0,n=p,i||U(e(p)).subscribe(i=w(r,a,c))},function(){s=!0,(!o||!i||i.closed)&&r.complete()}))})}function $e(e,t){return t===void 0&&(t=pe),Go(function(){return ke(e,t)})}function tt(e,t){return t===void 0&&(t=null),t=t!=null?t:e,E(function(r,o){var n=[],i=0;r.subscribe(w(o,function(s){var a,c,p,l,f=null;i++%t===0&&n.push([]);try{for(var u=Oe(n),d=u.next();!d.done;d=u.next()){var g=d.value;g.push(s),e<=g.length&&(f=f!=null?f:[],f.push(g))}}catch(ne){a={error:ne}}finally{try{d&&!d.done&&(c=u.return)&&c.call(u)}finally{if(a)throw a.error}}if(f)try{for(var L=Oe(f),ee=L.next();!ee.done;ee=L.next()){var g=ee.value;Xe(n,g),o.next(g)}}catch(ne){p={error:ne}}finally{try{ee&&!ee.done&&(l=L.return)&&l.call(L)}finally{if(p)throw p.error}}},function(){var s,a;try{for(var c=Oe(n),p=c.next();!p.done;p=c.next()){var l=p.value;o.next(l)}}catch(f){s={error:f}}finally{try{p&&!p.done&&(a=c.return)&&a.call(c)}finally{if(s)throw s.error}}o.complete()},void 0,function(){n=null}))})}function ye(e){return E(function(t,r){var o=null,n=!1,i;o=t.subscribe(w(r,void 0,void 0,function(s){i=U(e(s,ye(e)(t))),o?(o.unsubscribe(),o=null,i.subscribe(r)):n=!0})),n&&(o.unsubscribe(),o=null,i.subscribe(r))})}function Jo(e,t,r,o,n){return function(i,s){var a=r,c=t,p=0;i.subscribe(w(s,function(l){var f=p++;c=a?e(c,l,f):(a=!0,l),o&&s.next(c)},n&&function(){a&&s.next(c),s.complete()}))}}function qr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ct(e);return r?Mo(qr.apply(void 0,B([],K(e))),pt(r)):E(function(o,n){zr(B([o],K(_t(e))))(n)})}function De(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return qr.apply(void 0,B([],K(e)))}function jt(e){return E(function(t,r){var o=!1,n=null,i=null,s=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var a=n;n=null,r.next(a)}};t.subscribe(w(r,function(a){i==null||i.unsubscribe(),o=!0,n=a,i=w(r,s,ve),U(e(a)).subscribe(i)},function(){s(),r.complete()},void 0,function(){n=i=null}))})}function Ae(e,t){return t===void 0&&(t=pe),E(function(r,o){var n=null,i=null,s=null,a=function(){if(n){n.unsubscribe(),n=null;var p=i;i=null,o.next(p)}};function c(){var p=s+e,l=t.now();if(l<p){n=this.schedule(void 0,p-l),o.add(n);return}a()}r.subscribe(w(o,function(p){i=p,s=t.now(),n||(n=t.schedule(c,e),o.add(n))},function(){a(),o.complete()},void 0,function(){i=n=null}))})}function rt(e){return E(function(t,r){var o=!1;t.subscribe(w(r,function(n){o=!0,r.next(n)},function(){o||r.next(e),r.complete()}))})}function Ee(e){return e<=0?function(){return x}:E(function(t,r){var o=0;t.subscribe(w(r,function(n){++o<=e&&(r.next(n),e<=o&&r.complete())}))})}function re(){return E(function(e,t){e.subscribe(w(t,ve))})}function Xo(e){return m(function(){return e})}function Kr(e,t){return t?function(r){return qe(t.pipe(Ee(1),re()),r.pipe(Kr(e)))}:J(function(r,o){return U(e(r,o)).pipe(Ee(1),Xo(r))})}function ot(e,t){t===void 0&&(t=pe);var r=ke(e,t);return Kr(function(){return r})}function Qr(e,t){return E(function(r,o){var n=new Set;r.subscribe(w(o,function(i){var s=e?e(i):i;n.has(s)||(n.add(s),o.next(i))})),t&&U(t).subscribe(w(o,function(){return n.clear()},ve))})}function Y(e,t){return t===void 0&&(t=be),e=e!=null?e:Aa,E(function(r,o){var n,i=!0;r.subscribe(w(o,function(s){var a=t(s);(i||!e(n,a))&&(i=!1,n=a,o.next(s))}))})}function Aa(e,t){return e===t}function oe(e,t){return Y(function(r,o){return t?t(r[e],o[e]):r[e]===o[e]})}function Zo(e){return e===void 0&&(e=Ca),E(function(t,r){var o=!1;t.subscribe(w(r,function(n){o=!0,r.next(n)},function(){return o?r.complete():r.error(e())}))})}function Ca(){return new ur}function ae(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return function(r){return qe(r,$.apply(void 0,B([],K(e))))}}function hr(e,t){return t?function(r){return r.pipe(hr(function(o,n){return U(e(o,n)).pipe(m(function(i,s){return t(o,i,n,s)}))}))}:E(function(r,o){var n=0,i=null,s=!1;r.subscribe(w(o,function(a){i||(i=w(o,void 0,function(){i=null,s&&o.complete()}),U(e(a,n++)).subscribe(i))},function(){s=!0,!i&&o.complete()}))})}function A(e){return E(function(t,r){try{t.subscribe(r)}finally{r.add(e)}})}function Re(e,t){var r=arguments.length>=2;return function(o){return o.pipe(e?v(function(n,i){return e(n,i,o)}):be,Ee(1),r?rt(t):Zo(function(){return new ur}))}}function Yr(e){return e<=0?function(){return x}:E(function(t,r){var o=[];t.subscribe(w(r,function(n){o.push(n),e<o.length&&o.shift()},function(){var n,i;try{for(var s=Oe(o),a=s.next();!a.done;a=s.next()){var c=a.value;r.next(c)}}catch(p){n={error:p}}finally{try{a&&!a.done&&(i=s.return)&&i.call(s)}finally{if(n)throw n.error}}r.complete()},void 0,function(){o=null}))})}function en(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ie(e),o=or(e,1/0);return e=_t(e),E(function(n,i){Mt(o)(fe(B([n],K(e)),r)).subscribe(i)})}function Ne(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return en.apply(void 0,B([],K(e)))}function vt(e){var t,r=1/0,o;return e!=null&&(typeof e=="object"?(t=e.count,r=t===void 0?1/0:t,o=e.delay):r=e),r<=0?function(){return x}:E(function(n,i){var s=0,a,c=function(){if(a==null||a.unsubscribe(),a=null,o!=null){var l=typeof o=="number"?ke(o):U(o(s)),f=w(i,function(){f.unsubscribe(),p()});l.subscribe(f)}else p()},p=function(){var l=!1;a=n.subscribe(w(i,void 0,function(){++s<r?a?c():l=!0:i.complete()})),l&&c()};p()})}function Ut(e,t){return E(Jo(e,t,arguments.length>=2,!0))}function le(e){e===void 0&&(e={});var t=e.connector,r=t===void 0?function(){return new T}:t,o=e.resetOnError,n=o===void 0?!0:o,i=e.resetOnComplete,s=i===void 0?!0:i,a=e.resetOnRefCountZero,c=a===void 0?!0:a;return function(p){var l,f,u,d=0,g=!1,L=!1,ee=function(){f==null||f.unsubscribe(),f=void 0},ne=function(){ee(),l=u=void 0,g=L=!1},Z=function(){var H=l;ne(),H==null||H.unsubscribe()};return E(function(H,ft){d++,!L&&!g&&ee();var Fe=u=u!=null?u:r();ft.add(function(){d--,d===0&&!L&&!g&&(f=Br(Z,c))}),Fe.subscribe(ft),!l&&d>0&&(l=new ht({next:function(R){return Fe.next(R)},error:function(R){L=!0,ee(),f=Br(ne,n,R),Fe.error(R)},complete:function(){g=!0,ee(),f=Br(ne,s),Fe.complete()}}),U(H).subscribe(l))})(p)}}function Br(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];if(t===!0){e();return}if(t!==!1){var n=new ht({next:function(){n.unsubscribe(),e()}});return U(t.apply(void 0,B([],K(r)))).subscribe(n)}}function X(e,t,r){var o,n,i,s,a=!1;return e&&typeof e=="object"?(o=e.bufferSize,s=o===void 0?1/0:o,n=e.windowTime,t=n===void 0?1/0:n,i=e.refCount,a=i===void 0?!1:i,r=e.scheduler):s=e!=null?e:1/0,le({connector:function(){return new It(s,t,r)},resetOnError:!0,resetOnComplete:!1,resetOnRefCountZero:a})}function Pe(e){return v(function(t,r){return e<=r})}function Gr(e){return E(function(t,r){var o=!1,n=w(r,function(){n==null||n.unsubscribe(),o=!0},ve);U(e).subscribe(n),t.subscribe(w(r,function(i){return o&&r.next(i)}))})}function Q(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ie(e);return E(function(o,n){(r?qe(e,o,r):qe(e,o)).subscribe(n)})}function b(e,t){return E(function(r,o){var n=null,i=0,s=!1,a=function(){return s&&!n&&o.complete()};r.subscribe(w(o,function(c){n==null||n.unsubscribe();var p=0,l=i++;U(e(c,l)).subscribe(n=w(o,function(f){return o.next(t?t(c,f,l,p++):f)},function(){n=null,a()}))},function(){s=!0,a()}))})}function W(e){return E(function(t,r){U(e).subscribe(w(r,function(){return r.complete()},ve)),!r.closed&&t.subscribe(r)})}function Jr(e,t){return t===void 0&&(t=!1),E(function(r,o){var n=0;r.subscribe(w(o,function(i){var s=e(i,n++);(s||t)&&o.next(i),!s&&o.complete()}))})}function S(e,t,r){var o=P(e)||t||r?{next:e,error:t,complete:r}:e;return o?E(function(n,i){var s;(s=o.subscribe)===null||s===void 0||s.call(o);var a=!0;n.subscribe(w(i,function(c){var p;(p=o.next)===null||p===void 0||p.call(o,c),i.next(c)},function(){var c;a=!1,(c=o.complete)===null||c===void 0||c.call(o),i.complete()},function(c){var p;a=!1,(p=o.error)===null||p===void 0||p.call(o,c),i.error(c)},function(){var c,p;a&&((c=o.unsubscribe)===null||c===void 0||c.call(o)),(p=o.finalize)===null||p===void 0||p.call(o)}))}):be}function tn(e,t){return E(function(r,o){var n=t!=null?t:{},i=n.leading,s=i===void 0?!0:i,a=n.trailing,c=a===void 0?!1:a,p=!1,l=null,f=null,u=!1,d=function(){f==null||f.unsubscribe(),f=null,c&&(ee(),u&&o.complete())},g=function(){f=null,u&&o.complete()},L=function(ne){return f=U(e(ne)).subscribe(w(o,d,g))},ee=function(){if(p){p=!1;var ne=l;l=null,o.next(ne),!u&&L(ne)}};r.subscribe(w(o,function(ne){p=!0,l=ne,!(f&&!f.closed)&&(s?ee():L(ne))},function(){u=!0,!(c&&p&&f&&!f.closed)&&o.complete()}))})}function gt(e,t,r){t===void 0&&(t=pe);var o=ke(e,t);return tn(function(){return o},r)}function te(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ct(e);return E(function(o,n){for(var i=e.length,s=new Array(i),a=e.map(function(){return!1}),c=!1,p=function(f){U(e[f]).subscribe(w(n,function(u){s[f]=u,!c&&!a[f]&&(a[f]=!0,(c=a.every(be))&&(a=null))},ve))},l=0;l<i;l++)p(l);o.subscribe(w(n,function(f){if(c){var u=B([f],K(s));n.next(r?r.apply(void 0,B([],K(u))):u)}}))})}function rn(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return E(function(r,o){bt.apply(void 0,B([r],K(e))).subscribe(o)})}function Xr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return rn.apply(void 0,B([],K(e)))}function on(){let e=new It(1);return h(document,"DOMContentLoaded",{once:!0}).subscribe(()=>e.next(document)),e}function M(e,t=document){return Array.from(t.querySelectorAll(e))}function F(e,t=document){let r=ue(e,t);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${e}" to be present`);return r}function ue(e,t=document){return t.querySelector(e)||void 0}function Ve(){var e,t,r,o;return(o=(r=(t=(e=document.activeElement)==null?void 0:e.shadowRoot)==null?void 0:t.activeElement)!=null?r:document.activeElement)!=null?o:void 0}var Ha=O(h(document.body,"focusin"),h(document.body,"focusout")).pipe(Ae(1),Q(void 0),m(()=>Ve()||document.body),X(1));function Ke(e){return Ha.pipe(m(t=>e.contains(t)),Y())}function nt(e,t){return k(()=>O(h(e,"mouseenter").pipe(m(()=>!0)),h(e,"mouseleave").pipe(m(()=>!1))).pipe(t?jt(r=>ke(+!r*t)):be,Q(e.matches(":hover"))))}function nn(e,t){if(typeof t=="string"||typeof t=="number")e.innerHTML+=t.toString();else if(t instanceof Node)e.appendChild(t);else if(Array.isArray(t))for(let r of t)nn(e,r)}function y(e,t,...r){let o=document.createElement(e);if(t)for(let n of Object.keys(t))typeof t[n]!="undefined"&&(typeof t[n]!="boolean"?o.setAttribute(n,t[n]):o.setAttribute(n,""));for(let n of r)nn(o,n);return o}function br(e){if(e>999){let t=+((e-950)%1e3>99);return`${((e+1e-6)/1e3).toFixed(t)}k`}else return e.toString()}function At(e){let t=y("script",{src:e});return k(()=>(document.head.appendChild(t),O(h(t,"load"),h(t,"error").pipe(b(()=>Vr(()=>new ReferenceError(`Invalid script: ${e}`))))).pipe(m(()=>{}),A(()=>document.head.removeChild(t)),Ee(1))))}var an=new T,ka=k(()=>typeof ResizeObserver=="undefined"?At("https://unpkg.com/resize-observer-polyfill"):$(void 0)).pipe(m(()=>new ResizeObserver(e=>e.forEach(t=>an.next(t)))),b(e=>O(et,$(e)).pipe(A(()=>e.disconnect()))),X(1));function de(e){return{width:e.offsetWidth,height:e.offsetHeight}}function Le(e){let t=e;for(;t.clientWidth===0&&t.parentElement;)t=t.parentElement;return ka.pipe(S(r=>r.observe(t)),b(r=>an.pipe(v(o=>o.target===t),A(()=>r.unobserve(t)))),m(()=>de(e)),Q(de(e)))}function Ct(e){return{width:e.scrollWidth,height:e.scrollHeight}}function vr(e){let t=e.parentElement;for(;t&&(e.scrollWidth<=t.scrollWidth&&e.scrollHeight<=t.scrollHeight);)t=(e=t).parentElement;return t?e:void 0}function sn(e){let t=[],r=e.parentElement;for(;r;)(e.clientWidth>r.clientWidth||e.clientHeight>r.clientHeight)&&t.push(r),r=(e=r).parentElement;return t.length===0&&t.push(document.documentElement),t}function Qe(e){return{x:e.offsetLeft,y:e.offsetTop}}function cn(e){let t=e.getBoundingClientRect();return{x:t.x+window.scrollX,y:t.y+window.scrollY}}function pn(e){return O(h(window,"load"),h(window,"resize")).pipe($e(0,ge),m(()=>Qe(e)),Q(Qe(e)))}function gr(e){return{x:e.scrollLeft,y:e.scrollTop}}function Ye(e){return O(h(e,"scroll"),h(window,"scroll"),h(window,"resize")).pipe($e(0,ge),m(()=>gr(e)),Q(gr(e)))}var ln=new T,$a=k(()=>$(new IntersectionObserver(e=>{for(let t of e)ln.next(t)},{threshold:0}))).pipe(b(e=>O(et,$(e)).pipe(A(()=>e.disconnect()))),X(1));function lt(e){return $a.pipe(S(t=>t.observe(e)),b(t=>ln.pipe(v(({target:r})=>r===e),A(()=>t.unobserve(e)),m(({isIntersecting:r})=>r))))}function mn(e,t=16){return Ye(e).pipe(m(({y:r})=>{let o=de(e),n=Ct(e);return r>=n.height-o.height-t}),Y())}var xr={drawer:F("[data-md-toggle=drawer]"),search:F("[data-md-toggle=search]")};function fn(e){return xr[e].checked}function it(e,t){xr[e].checked!==t&&xr[e].click()}function Be(e){let t=xr[e];return h(t,"change").pipe(m(()=>t.checked),Q(t.checked))}function Ra(e,t){switch(e.constructor){case HTMLInputElement:return e.type==="radio"?/^Arrow/.test(t):!0;case HTMLSelectElement:case HTMLTextAreaElement:return!0;default:return e.isContentEditable}}function Pa(){return O(h(window,"compositionstart").pipe(m(()=>!0)),h(window,"compositionend").pipe(m(()=>!1))).pipe(Q(!1))}function un(){let e=h(window,"keydown").pipe(v(t=>!(t.metaKey||t.ctrlKey)),m(t=>({mode:fn("search")?"search":"global",type:t.key,claim(){t.preventDefault(),t.stopPropagation()}})),v(({mode:t,type:r})=>{if(t==="global"){let o=Ve();if(typeof o!="undefined")return!Ra(o,r)}return!0}),le());return Pa().pipe(b(t=>t?x:e))}function we(){return new URL(location.href)}function at(e,t=!1){if(N("navigation.instant")&&!t){let r=y("a",{href:e.href});document.body.appendChild(r),r.click(),r.remove()}else location.href=e.href}function dn(){return new T}function hn(){return location.hash.slice(1)}function bn(e){let t=y("a",{href:e});t.addEventListener("click",r=>r.stopPropagation()),t.click()}function Zr(e){return O(h(window,"hashchange"),e).pipe(m(hn),Q(hn()),v(t=>t.length>0),X(1))}function vn(e){return Zr(e).pipe(m(t=>ue(`[id="${t}"]`)),v(t=>typeof t!="undefined"))}function Wt(e){let t=matchMedia(e);return dr(r=>t.addListener(()=>r(t.matches))).pipe(Q(t.matches))}function gn(){let e=matchMedia("print");return O(h(window,"beforeprint").pipe(m(()=>!0)),h(window,"afterprint").pipe(m(()=>!1))).pipe(Q(e.matches))}function eo(e,t){return e.pipe(b(r=>r?t():x))}function to(e,t){return new I(r=>{let o=new XMLHttpRequest;return o.open("GET",`${e}`),o.responseType="blob",o.addEventListener("load",()=>{o.status>=200&&o.status<300?(r.next(o.response),r.complete()):r.error(new Error(o.statusText))}),o.addEventListener("error",()=>{r.error(new Error("Network error"))}),o.addEventListener("abort",()=>{r.complete()}),typeof(t==null?void 0:t.progress$)!="undefined"&&(o.addEventListener("progress",n=>{var i;if(n.lengthComputable)t.progress$.next(n.loaded/n.total*100);else{let s=(i=o.getResponseHeader("Content-Length"))!=null?i:0;t.progress$.next(n.loaded/+s*100)}}),t.progress$.next(5)),o.send(),()=>o.abort()})}function Ge(e,t){return to(e,t).pipe(b(r=>r.text()),m(r=>JSON.parse(r)),X(1))}function yr(e,t){let r=new DOMParser;return to(e,t).pipe(b(o=>o.text()),m(o=>r.parseFromString(o,"text/html")),X(1))}function xn(e,t){let r=new DOMParser;return to(e,t).pipe(b(o=>o.text()),m(o=>r.parseFromString(o,"text/xml")),X(1))}function yn(){return{x:Math.max(0,scrollX),y:Math.max(0,scrollY)}}function En(){return O(h(window,"scroll",{passive:!0}),h(window,"resize",{passive:!0})).pipe(m(yn),Q(yn()))}function wn(){return{width:innerWidth,height:innerHeight}}function Tn(){return h(window,"resize",{passive:!0}).pipe(m(wn),Q(wn()))}function Sn(){return z([En(),Tn()]).pipe(m(([e,t])=>({offset:e,size:t})),X(1))}function Er(e,{viewport$:t,header$:r}){let o=t.pipe(oe("size")),n=z([o,r]).pipe(m(()=>Qe(e)));return z([r,t,n]).pipe(m(([{height:i},{offset:s,size:a},{x:c,y:p}])=>({offset:{x:s.x-c,y:s.y-p+i},size:a})))}function Ia(e){return h(e,"message",t=>t.data)}function Fa(e){let t=new T;return t.subscribe(r=>e.postMessage(r)),t}function On(e,t=new Worker(e)){let r=Ia(t),o=Fa(t),n=new T;n.subscribe(o);let i=o.pipe(re(),ae(!0));return n.pipe(re(),Ne(r.pipe(W(i))),le())}var ja=F("#__config"),Ht=JSON.parse(ja.textContent);Ht.base=`${new URL(Ht.base,we())}`;function Te(){return Ht}function N(e){return Ht.features.includes(e)}function Me(e,t){return typeof t!="undefined"?Ht.translations[e].replace("#",t.toString()):Ht.translations[e]}function Ce(e,t=document){return F(`[data-md-component=${e}]`,t)}function me(e,t=document){return M(`[data-md-component=${e}]`,t)}function Ua(e){let t=F(".md-typeset > :first-child",e);return h(t,"click",{once:!0}).pipe(m(()=>F(".md-typeset",e)),m(r=>({hash:__md_hash(r.innerHTML)})))}function Ln(e){if(!N("announce.dismiss")||!e.childElementCount)return x;if(!e.hidden){let t=F(".md-typeset",e);__md_hash(t.innerHTML)===__md_get("__announce")&&(e.hidden=!0)}return k(()=>{let t=new T;return t.subscribe(({hash:r})=>{e.hidden=!0,__md_set("__announce",r)}),Ua(e).pipe(S(r=>t.next(r)),A(()=>t.complete()),m(r=>j({ref:e},r)))})}function Wa(e,{target$:t}){return t.pipe(m(r=>({hidden:r!==e})))}function Mn(e,t){let r=new T;return r.subscribe(({hidden:o})=>{e.hidden=o}),Wa(e,t).pipe(S(o=>r.next(o)),A(()=>r.complete()),m(o=>j({ref:e},o)))}function Dt(e,t){return t==="inline"?y("div",{class:"md-tooltip md-tooltip--inline",id:e,role:"tooltip"},y("div",{class:"md-tooltip__inner md-typeset"})):y("div",{class:"md-tooltip",id:e,role:"tooltip"},y("div",{class:"md-tooltip__inner md-typeset"}))}function wr(...e){return y("div",{class:"md-tooltip2",role:"dialog"},y("div",{class:"md-tooltip2__inner md-typeset"},e))}function _n(...e){return y("div",{class:"md-tooltip2",role:"tooltip"},y("div",{class:"md-tooltip2__inner md-typeset"},e))}function An(e,t){if(t=t?`${t}_annotation_${e}`:void 0,t){let r=t?`#${t}`:void 0;return y("aside",{class:"md-annotation",tabIndex:0},Dt(t),y("a",{href:r,class:"md-annotation__index",tabIndex:-1},y("span",{"data-md-annotation-id":e})))}else return y("aside",{class:"md-annotation",tabIndex:0},Dt(t),y("span",{class:"md-annotation__index",tabIndex:-1},y("span",{"data-md-annotation-id":e})))}function Cn(e){return y("button",{class:"md-code__button",title:Me("clipboard.copy"),"data-clipboard-target":`#${e} > code`,"data-md-type":"copy"})}function Hn(){return y("button",{class:"md-code__button",title:"Toggle line selection","data-md-type":"select"})}function kn(){return y("nav",{class:"md-code__nav"})}function ro(e,t){let r=t&2,o=t&1,n=Object.keys(e.terms).filter(c=>!e.terms[c]).reduce((c,p)=>[...c,y("del",null,p)," "],[]).slice(0,-1),i=Te(),s=new URL(e.location,i.base);N("search.highlight")&&s.searchParams.set("h",Object.entries(e.terms).filter(([,c])=>c).reduce((c,[p])=>`${c} ${p}`.trim(),""));let{tags:a}=Te();return y("a",{href:`${s}`,class:"md-search-result__link",tabIndex:-1},y("article",{class:"md-search-result__article md-typeset","data-md-score":e.score.toFixed(2)},r>0&&y("div",{class:"md-search-result__icon md-icon"}),r>0&&y("h1",null,e.title),r<=0&&y("h2",null,e.title),o>0&&e.text.length>0&&e.text,e.tags&&e.tags.map(c=>{let p=a?c in a?`md-tag-icon md-tag--${a[c]}`:"md-tag-icon":"";return y("span",{class:`md-tag ${p}`},c)}),o>0&&n.length>0&&y("p",{class:"md-search-result__terms"},Me("search.result.term.missing"),": ",...n)))}function $n(e){let t=e[0].score,r=[...e],o=Te(),n=r.findIndex(l=>!`${new URL(l.location,o.base)}`.includes("#")),[i]=r.splice(n,1),s=r.findIndex(l=>l.score<t);s===-1&&(s=r.length);let a=r.slice(0,s),c=r.slice(s),p=[ro(i,2|+(!n&&s===0)),...a.map(l=>ro(l,1)),...c.length?[y("details",{class:"md-search-result__more"},y("summary",{tabIndex:-1},y("div",null,c.length>0&&c.length===1?Me("search.result.more.one"):Me("search.result.more.other",c.length))),...c.map(l=>ro(l,1)))]:[]];return y("li",{class:"md-search-result__item"},p)}function Rn(e){return y("ul",{class:"md-source__facts"},Object.entries(e).map(([t,r])=>y("li",{class:`md-source__fact md-source__fact--${t}`},typeof r=="number"?br(r):r)))}function oo(e){let t=`tabbed-control tabbed-control--${e}`;return y("div",{class:t,hidden:!0},y("button",{class:"tabbed-button",tabIndex:-1,"aria-hidden":"true"}))}function Pn(e){return y("div",{class:"md-typeset__scrollwrap"},y("div",{class:"md-typeset__table"},e))}function Da(e){var o;let t=Te(),r=new URL(`../${e.version}/`,t.base);return y("li",{class:"md-version__item"},y("a",{href:`${r}`,class:"md-version__link"},e.title,((o=t.version)==null?void 0:o.alias)&&e.aliases.length>0&&y("span",{class:"md-version__alias"},e.aliases[0])))}function In(e,t){var o;let r=Te();return e=e.filter(n=>{var i;return!((i=n.properties)!=null&&i.hidden)}),y("div",{class:"md-version"},y("button",{class:"md-version__current","aria-label":Me("select.version")},t.title,((o=r.version)==null?void 0:o.alias)&&t.aliases.length>0&&y("span",{class:"md-version__alias"},t.aliases[0])),y("ul",{class:"md-version__list"},e.map(Da)))}var Na=0;function Va(e,t=250){let r=z([Ke(e),nt(e,t)]).pipe(m(([n,i])=>n||i),Y()),o=k(()=>sn(e)).pipe(J(Ye),gt(1),m(()=>cn(e)));return r.pipe(Re(n=>n),b(()=>z([r,o])),m(([n,i])=>({active:n,offset:i})),le())}function Nt(e,t,r=250){let{content$:o,viewport$:n}=t,i=`__tooltip2_${Na++}`;return k(()=>{let s=new T,a=new jr(!1);s.pipe(re(),ae(!1)).subscribe(a);let c=a.pipe(jt(l=>ke(+!l*250,Dr)),Y(),b(l=>l?o:x),S(l=>l.id=i),le());z([s.pipe(m(({active:l})=>l)),c.pipe(b(l=>nt(l,250)),Q(!1))]).pipe(m(l=>l.some(f=>f))).subscribe(a);let p=a.pipe(v(l=>l),te(c,n),m(([l,f,{size:u}])=>{let d=e.getBoundingClientRect(),g=d.width/2;if(f.role==="tooltip")return{x:g,y:8+d.height};if(d.y>=u.height/2){let{height:L}=de(f);return{x:g,y:-16-L}}else return{x:g,y:16+d.height}}));return z([c,s,p]).subscribe(([l,{offset:f},u])=>{l.style.setProperty("--md-tooltip-host-x",`${f.x}px`),l.style.setProperty("--md-tooltip-host-y",`${f.y}px`),l.style.setProperty("--md-tooltip-x",`${u.x}px`),l.style.setProperty("--md-tooltip-y",`${u.y}px`),l.classList.toggle("md-tooltip2--top",u.y<0),l.classList.toggle("md-tooltip2--bottom",u.y>=0)}),a.pipe(v(l=>l),te(c,(l,f)=>f),v(l=>l.role==="tooltip")).subscribe(l=>{let f=de(F(":scope > *",l));l.style.setProperty("--md-tooltip-width",`${f.width}px`),l.style.setProperty("--md-tooltip-tail","0px")}),a.pipe(Y(),xe(ge),te(c)).subscribe(([l,f])=>{f.classList.toggle("md-tooltip2--active",l)}),z([a.pipe(v(l=>l)),c]).subscribe(([l,f])=>{f.role==="dialog"?(e.setAttribute("aria-controls",i),e.setAttribute("aria-haspopup","dialog")):e.setAttribute("aria-describedby",i)}),a.pipe(v(l=>!l)).subscribe(()=>{e.removeAttribute("aria-controls"),e.removeAttribute("aria-describedby"),e.removeAttribute("aria-haspopup")}),Va(e,r).pipe(S(l=>s.next(l)),A(()=>s.complete()),m(l=>j({ref:e},l)))})}function Je(e,{viewport$:t},r=document.body){return Nt(e,{content$:new I(o=>{let n=e.title,i=_n(n);return o.next(i),e.removeAttribute("title"),r.append(i),()=>{i.remove(),e.setAttribute("title",n)}}),viewport$:t},0)}function za(e,t){let r=k(()=>z([pn(e),Ye(t)])).pipe(m(([{x:o,y:n},i])=>{let{width:s,height:a}=de(e);return{x:o-i.x+s/2,y:n-i.y+a/2}}));return Ke(e).pipe(b(o=>r.pipe(m(n=>({active:o,offset:n})),Ee(+!o||1/0))))}function Fn(e,t,{target$:r}){let[o,n]=Array.from(e.children);return k(()=>{let i=new T,s=i.pipe(re(),ae(!0));return i.subscribe({next({offset:a}){e.style.setProperty("--md-tooltip-x",`${a.x}px`),e.style.setProperty("--md-tooltip-y",`${a.y}px`)},complete(){e.style.removeProperty("--md-tooltip-x"),e.style.removeProperty("--md-tooltip-y")}}),lt(e).pipe(W(s)).subscribe(a=>{e.toggleAttribute("data-md-visible",a)}),O(i.pipe(v(({active:a})=>a)),i.pipe(Ae(250),v(({active:a})=>!a))).subscribe({next({active:a}){a?e.prepend(o):o.remove()},complete(){e.prepend(o)}}),i.pipe($e(16,ge)).subscribe(({active:a})=>{o.classList.toggle("md-tooltip--active",a)}),i.pipe(gt(125,ge),v(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:a})=>a)).subscribe({next(a){a?e.style.setProperty("--md-tooltip-0",`${-a}px`):e.style.removeProperty("--md-tooltip-0")},complete(){e.style.removeProperty("--md-tooltip-0")}}),h(n,"click").pipe(W(s),v(a=>!(a.metaKey||a.ctrlKey))).subscribe(a=>{a.stopPropagation(),a.preventDefault()}),h(n,"mousedown").pipe(W(s),te(i)).subscribe(([a,{active:c}])=>{var p;if(a.button!==0||a.metaKey||a.ctrlKey)a.preventDefault();else if(c){a.preventDefault();let l=e.parentElement.closest(".md-annotation");l instanceof HTMLElement?l.focus():(p=Ve())==null||p.blur()}}),r.pipe(W(s),v(a=>a===o),ot(125)).subscribe(()=>e.focus()),za(e,t).pipe(S(a=>i.next(a)),A(()=>i.complete()),m(a=>j({ref:e},a)))})}function qa(e){let t=Te();if(e.tagName!=="CODE")return[e];let r=[".c",".c1",".cm"];if(typeof t.annotate!="undefined"){let o=e.closest("[class|=language]");if(o)for(let n of Array.from(o.classList)){if(!n.startsWith("language-"))continue;let[,i]=n.split("-");i in t.annotate&&r.push(...t.annotate[i])}}return M(r.join(", "),e)}function Ka(e){let t=[];for(let r of qa(e)){let o=[],n=document.createNodeIterator(r,NodeFilter.SHOW_TEXT);for(let i=n.nextNode();i;i=n.nextNode())o.push(i);for(let i of o){let s;for(;s=/(\(\d+\))(!)?/.exec(i.textContent);){let[,a,c]=s;if(typeof c=="undefined"){let p=i.splitText(s.index);i=p.splitText(a.length),t.push(p)}else{i.textContent=a,t.push(i);break}}}}return t}function jn(e,t){t.append(...Array.from(e.childNodes))}function Tr(e,t,{target$:r,print$:o}){let n=t.closest("[id]"),i=n==null?void 0:n.id,s=new Map;for(let a of Ka(t)){let[,c]=a.textContent.match(/\((\d+)\)/);ue(`:scope > li:nth-child(${c})`,e)&&(s.set(c,An(c,i)),a.replaceWith(s.get(c)))}return s.size===0?x:k(()=>{let a=new T,c=a.pipe(re(),ae(!0)),p=[];for(let[l,f]of s)p.push([F(".md-typeset",f),F(`:scope > li:nth-child(${l})`,e)]);return o.pipe(W(c)).subscribe(l=>{e.hidden=!l,e.classList.toggle("md-annotation-list",l);for(let[f,u]of p)l?jn(f,u):jn(u,f)}),O(...[...s].map(([,l])=>Fn(l,t,{target$:r}))).pipe(A(()=>a.complete()),le())})}function Un(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return Un(t)}}function Wn(e,t){return k(()=>{let r=Un(e);return typeof r!="undefined"?Tr(r,e,t):x})}var Nn=Gt(io());var Qa=0,Dn=O(h(window,"keydown").pipe(m(()=>!0)),O(h(window,"keyup"),h(window,"contextmenu")).pipe(m(()=>!1))).pipe(Q(!1),X(1));function Vn(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return Vn(t)}}function Ya(e){return Le(e).pipe(m(({width:t})=>({scrollable:Ct(e).width>t})),oe("scrollable"))}function zn(e,t){let{matches:r}=matchMedia("(hover)"),o=k(()=>{let n=new T,i=n.pipe(Yr(1));n.subscribe(({scrollable:d})=>{d&&r?e.setAttribute("tabindex","0"):e.removeAttribute("tabindex")});let s=[],a=e.closest("pre"),c=a.closest("[id]"),p=c?c.id:Qa++;a.id=`__code_${p}`;let l=[],f=e.closest(".highlight");if(f instanceof HTMLElement){let d=Vn(f);if(typeof d!="undefined"&&(f.classList.contains("annotate")||N("content.code.annotate"))){let g=Tr(d,e,t);l.push(Le(f).pipe(W(i),m(({width:L,height:ee})=>L&&ee),Y(),b(L=>L?g:x)))}}let u=M(":scope > span[id]",e);if(u.length&&(e.classList.add("md-code__content"),e.closest(".select")||N("content.code.select")&&!e.closest(".no-select"))){let d=+u[0].id.split("-").pop(),g=Hn();s.push(g),N("content.tooltips")&&l.push(Je(g,{viewport$}));let L=h(g,"click").pipe(Ut(R=>!R,!1),S(()=>g.blur()),le());L.subscribe(R=>{g.classList.toggle("md-code__button--active",R)});let ee=fe(u).pipe(J(R=>nt(R).pipe(m(se=>[R,se]))));L.pipe(b(R=>R?ee:x)).subscribe(([R,se])=>{let ce=ue(".hll.select",R);if(ce&&!se)ce.replaceWith(...Array.from(ce.childNodes));else if(!ce&&se){let he=document.createElement("span");he.className="hll select",he.append(...Array.from(R.childNodes).slice(1)),R.append(he)}});let ne=fe(u).pipe(J(R=>h(R,"mousedown").pipe(S(se=>se.preventDefault()),m(()=>R)))),Z=L.pipe(b(R=>R?ne:x),te(Dn),m(([R,se])=>{var he;let ce=u.indexOf(R)+d;if(se===!1)return[ce,ce];{let Se=M(".hll",e).map(je=>u.indexOf(je.parentElement)+d);return(he=window.getSelection())==null||he.removeAllRanges(),[Math.min(ce,...Se),Math.max(ce,...Se)]}})),H=Zr(x).pipe(v(R=>R.startsWith(`__codelineno-${p}-`)));H.subscribe(R=>{let[,,se]=R.split("-"),ce=se.split(":").map(Se=>+Se-d+1);ce.length===1&&ce.push(ce[0]);for(let Se of M(".hll:not(.select)",e))Se.replaceWith(...Array.from(Se.childNodes));let he=u.slice(ce[0]-1,ce[1]);for(let Se of he){let je=document.createElement("span");je.className="hll",je.append(...Array.from(Se.childNodes).slice(1)),Se.append(je)}}),H.pipe(Ee(1),xe(pe)).subscribe(R=>{if(R.includes(":")){let se=document.getElementById(R.split(":")[0]);se&&setTimeout(()=>{let ce=se,he=-64;for(;ce!==document.body;)he+=ce.offsetTop,ce=ce.offsetParent;window.scrollTo({top:he})},1)}});let Fe=fe(M('a[href^="#__codelineno"]',f)).pipe(J(R=>h(R,"click").pipe(S(se=>se.preventDefault()),m(()=>R)))).pipe(W(i),te(Dn),m(([R,se])=>{let he=+F(`[id="${R.hash.slice(1)}"]`).parentElement.id.split("-").pop();if(se===!1)return[he,he];{let Se=M(".hll",e).map(je=>+je.parentElement.id.split("-").pop());return[Math.min(he,...Se),Math.max(he,...Se)]}}));O(Z,Fe).subscribe(R=>{let se=`#__codelineno-${p}-`;R[0]===R[1]?se+=R[0]:se+=`${R[0]}:${R[1]}`,history.replaceState({},"",se),window.dispatchEvent(new HashChangeEvent("hashchange",{newURL:window.location.origin+window.location.pathname+se,oldURL:window.location.href}))})}if(Nn.default.isSupported()&&(e.closest(".copy")||N("content.code.copy")&&!e.closest(".no-copy"))){let d=Cn(a.id);s.push(d),N("content.tooltips")&&l.push(Je(d,{viewport$}))}if(s.length){let d=kn();d.append(...s),a.insertBefore(d,e)}return Ya(e).pipe(S(d=>n.next(d)),A(()=>n.complete()),m(d=>j({ref:e},d)),Ne(O(...l).pipe(W(i))))});return N("content.lazy")?lt(e).pipe(v(n=>n),Ee(1),b(()=>o)):o}function Ba(e,{target$:t,print$:r}){let o=!0;return O(t.pipe(m(n=>n.closest("details:not([open])")),v(n=>e===n),m(()=>({action:"open",reveal:!0}))),r.pipe(v(n=>n||!o),S(()=>o=e.open),m(n=>({action:n?"open":"close"}))))}function qn(e,t){return k(()=>{let r=new T;return r.subscribe(({action:o,reveal:n})=>{e.toggleAttribute("open",o==="open"),n&&e.scrollIntoView()}),Ba(e,t).pipe(S(o=>r.next(o)),A(()=>r.complete()),m(o=>j({ref:e},o)))})}function Ga(e){let t=document.createElement("h3");t.innerHTML=e.innerHTML;let r=[t],o=e.nextElementSibling;for(;o&&!(o instanceof HTMLHeadingElement);)r.push(o),o=o.nextElementSibling;return r}function Ja(e,t){for(let r of M("[href], [src]",e))for(let o of["href","src"]){let n=r.getAttribute(o);if(n&&!/^(?:[a-z]+:)?\/\//i.test(n)){r[o]=new URL(r.getAttribute(o),t).toString();break}}return $(e)}function Kn(e,t){let{sitemap$:r}=t;if(!(e instanceof HTMLAnchorElement))return x;if(!(N("navigation.instant.preview")||e.hasAttribute("data-preview")))return x;let o=z([Ke(e),nt(e)]).pipe(m(([i,s])=>i||s),Y(),v(i=>i));return bt([r,o]).pipe(b(([i])=>{let s=new URL(e.href);return s.search=s.hash="",i.has(`${s}`)?$(s):x}),b(i=>yr(i).pipe(b(s=>Ja(s,i)))),b(i=>{let s=e.hash?`article [id="${e.hash.slice(1)}"]`:"article h1",a=ue(s,i);return typeof a=="undefined"?x:$(Ga(a))})).pipe(b(i=>{let s=new I(a=>{let c=wr(...i);return a.next(c),document.body.append(c),()=>c.remove()});return Nt(e,j({content$:s},t))}))}var Qn=".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel rect,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel rect{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}a .nodeLabel{text-decoration:underline}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}";var ao,Za=0;function es(){return typeof mermaid=="undefined"||mermaid instanceof Element?At("https://unpkg.com/mermaid@10/dist/mermaid.min.js"):$(void 0)}function Yn(e){return e.classList.remove("mermaid"),ao||(ao=es().pipe(S(()=>mermaid.initialize({startOnLoad:!1,themeCSS:Qn,sequence:{actorFontSize:"16px",messageFontSize:"16px",noteFontSize:"16px"}})),m(()=>{}),X(1))),ao.subscribe(()=>bo(this,null,function*(){e.classList.add("mermaid");let t=`__mermaid_${Za++}`,r=y("div",{class:"mermaid"}),o=e.textContent,{svg:n,fn:i}=yield mermaid.render(t,o),s=r.attachShadow({mode:"closed"});s.innerHTML=n,e.replaceWith(r),i==null||i(s)})),ao.pipe(m(()=>({ref:e})))}var Bn=y("table");function Gn(e){return e.replaceWith(Bn),Bn.replaceWith(Pn(e)),$({ref:e})}function ts(e){let t=e.find(r=>r.checked)||e[0];return O(...e.map(r=>h(r,"change").pipe(m(()=>F(`label[for="${r.id}"]`))))).pipe(Q(F(`label[for="${t.id}"]`)),m(r=>({active:r})))}function Jn(e,{viewport$:t,target$:r}){let o=F(".tabbed-labels",e),n=M(":scope > input",e),i=oo("prev");e.append(i);let s=oo("next");return e.append(s),k(()=>{let a=new T,c=a.pipe(re(),ae(!0));z([a,Le(e),lt(e)]).pipe(W(c),$e(1,ge)).subscribe({next([{active:p},l]){let f=Qe(p),{width:u}=de(p);e.style.setProperty("--md-indicator-x",`${f.x}px`),e.style.setProperty("--md-indicator-width",`${u}px`);let d=gr(o);(f.x<d.x||f.x+u>d.x+l.width)&&o.scrollTo({left:Math.max(0,f.x-16),behavior:"smooth"})},complete(){e.style.removeProperty("--md-indicator-x"),e.style.removeProperty("--md-indicator-width")}}),z([Ye(o),Le(o)]).pipe(W(c)).subscribe(([p,l])=>{let f=Ct(o);i.hidden=p.x<16,s.hidden=p.x>f.width-l.width-16}),O(h(i,"click").pipe(m(()=>-1)),h(s,"click").pipe(m(()=>1))).pipe(W(c)).subscribe(p=>{let{width:l}=de(o);o.scrollBy({left:l*p,behavior:"smooth"})}),r.pipe(W(c),v(p=>n.includes(p))).subscribe(p=>p.click()),o.classList.add("tabbed-labels--linked");for(let p of n){let l=F(`label[for="${p.id}"]`);l.replaceChildren(y("a",{href:`#${l.htmlFor}`,tabIndex:-1},...Array.from(l.childNodes))),h(l.firstElementChild,"click").pipe(W(c),v(f=>!(f.metaKey||f.ctrlKey)),S(f=>{f.preventDefault(),f.stopPropagation()})).subscribe(()=>{history.replaceState({},"",`#${l.htmlFor}`),l.click()})}return N("content.tabs.link")&&a.pipe(Pe(1),te(t)).subscribe(([{active:p},{offset:l}])=>{let f=p.innerText.trim();if(p.hasAttribute("data-md-switching"))p.removeAttribute("data-md-switching");else{let u=e.offsetTop-l.y;for(let g of M("[data-tabs]"))for(let L of M(":scope > input",g)){let ee=F(`label[for="${L.id}"]`);if(ee!==p&&ee.innerText.trim()===f){ee.setAttribute("data-md-switching",""),L.click();break}}window.scrollTo({top:e.offsetTop-u});let d=__md_get("__tabs")||[];__md_set("__tabs",[...new Set([f,...d])])}}),a.pipe(W(c)).subscribe(()=>{for(let p of M("audio, video",e))p.pause()}),ts(n).pipe(S(p=>a.next(p)),A(()=>a.complete()),m(p=>j({ref:e},p)))}).pipe(Ze(pe))}function Xn(e,t){let{viewport$:r,target$:o,print$:n}=t;return O(...M(".annotate:not(.highlight)",e).map(i=>Wn(i,{target$:o,print$:n})),...M("pre:not(.mermaid) > code",e).map(i=>zn(i,{target$:o,print$:n})),...M("a:not([title])",e).map(i=>Kn(i,t)),...M("pre.mermaid",e).map(i=>Yn(i)),...M("table:not([class])",e).map(i=>Gn(i)),...M("details",e).map(i=>qn(i,{target$:o,print$:n})),...M("[data-tabs]",e).map(i=>Jn(i,{viewport$:r,target$:o})),...M("[title]",e).filter(()=>N("content.tooltips")).map(i=>Je(i,{viewport$:r})),...M(".footnote-ref",e).filter(()=>N("content.footnote.tooltips")).map(i=>Nt(i,{content$:new I(s=>{let a=new URL(i.href).hash.slice(1),c=Array.from(document.getElementById(a).cloneNode(!0).children),p=wr(...c);return s.next(p),document.body.append(p),()=>p.remove()}),viewport$:r})))}function rs(e,{alert$:t}){return t.pipe(b(r=>O($(!0),$(!1).pipe(ot(2e3))).pipe(m(o=>({message:r,active:o})))))}function Zn(e,t){let r=F(".md-typeset",e);return k(()=>{let o=new T;return o.subscribe(({message:n,active:i})=>{e.classList.toggle("md-dialog--active",i),r.textContent=n}),rs(e,t).pipe(S(n=>o.next(n)),A(()=>o.complete()),m(n=>j({ref:e},n)))})}var os=0;function ns(e,t){document.body.append(e);let{width:r}=de(e);e.style.setProperty("--md-tooltip-width",`${r}px`),e.remove();let o=vr(t),n=typeof o!="undefined"?Ye(o):$({x:0,y:0}),i=O(Ke(t),nt(t)).pipe(Y());return z([i,n]).pipe(m(([s,a])=>{let{x:c,y:p}=Qe(t),l=de(t),f=t.closest("table");return f&&t.parentElement&&(c+=f.offsetLeft+t.parentElement.offsetLeft,p+=f.offsetTop+t.parentElement.offsetTop),{active:s,offset:{x:c-a.x+l.width/2-r/2,y:p-a.y+l.height+8}}}))}function ei(e){let t=e.title;if(!t.length)return x;let r=`__tooltip_${os++}`,o=Dt(r,"inline"),n=F(".md-typeset",o);return n.innerHTML=t,k(()=>{let i=new T;return i.subscribe({next({offset:s}){o.style.setProperty("--md-tooltip-x",`${s.x}px`),o.style.setProperty("--md-tooltip-y",`${s.y}px`)},complete(){o.style.removeProperty("--md-tooltip-x"),o.style.removeProperty("--md-tooltip-y")}}),O(i.pipe(v(({active:s})=>s)),i.pipe(Ae(250),v(({active:s})=>!s))).subscribe({next({active:s}){s?(e.insertAdjacentElement("afterend",o),e.setAttribute("aria-describedby",r),e.removeAttribute("title")):(o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t))},complete(){o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t)}}),i.pipe($e(16,ge)).subscribe(({active:s})=>{o.classList.toggle("md-tooltip--active",s)}),i.pipe(gt(125,ge),v(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:s})=>s)).subscribe({next(s){s?o.style.setProperty("--md-tooltip-0",`${-s}px`):o.style.removeProperty("--md-tooltip-0")},complete(){o.style.removeProperty("--md-tooltip-0")}}),ns(o,e).pipe(S(s=>i.next(s)),A(()=>i.complete()),m(s=>j({ref:e},s)))}).pipe(Ze(pe))}function is({viewport$:e}){if(!N("header.autohide"))return $(!1);let t=e.pipe(m(({offset:{y:n}})=>n),tt(2,1),m(([n,i])=>[n<i,i]),oe(0)),r=z([e,t]).pipe(v(([{offset:n},[,i]])=>Math.abs(i-n.y)>100),m(([,[n]])=>n),Y()),o=Be("search");return z([e,o]).pipe(m(([{offset:n},i])=>n.y>400&&!i),Y(),b(n=>n?r:$(!1)),Q(!1))}function ti(e,t){return k(()=>z([Le(e),is(t)])).pipe(m(([{height:r},o])=>({height:r,hidden:o})),Y((r,o)=>r.height===o.height&&r.hidden===o.hidden),X(1))}function ri(e,{header$:t,main$:r}){return k(()=>{let o=new T,n=o.pipe(re(),ae(!0));o.pipe(oe("active"),De(t)).subscribe(([{active:s},{hidden:a}])=>{e.classList.toggle("md-header--shadow",s&&!a),e.hidden=a});let i=fe(M("[title]",e)).pipe(v(()=>N("content.tooltips")),J(s=>ei(s)));return r.subscribe(o),t.pipe(W(n),m(s=>j({ref:e},s)),Ne(i.pipe(W(n))))})}function as(e,{viewport$:t,header$:r}){return Er(e,{viewport$:t,header$:r}).pipe(m(({offset:{y:o}})=>{let{height:n}=de(e);return{active:o>=n}}),oe("active"))}function oi(e,t){return k(()=>{let r=new T;r.subscribe({next({active:n}){e.classList.toggle("md-header__title--active",n)},complete(){e.classList.remove("md-header__title--active")}});let o=ue(".md-content h1");return typeof o=="undefined"?x:as(o,t).pipe(S(n=>r.next(n)),A(()=>r.complete()),m(n=>j({ref:e},n)))})}function ni(e,{viewport$:t,header$:r}){let o=r.pipe(m(({height:i})=>i),Y()),n=o.pipe(b(()=>Le(e).pipe(m(({height:i})=>({top:e.offsetTop,bottom:e.offsetTop+i})),oe("bottom"))));return z([o,n,t]).pipe(m(([i,{top:s,bottom:a},{offset:{y:c},size:{height:p}}])=>(p=Math.max(0,p-Math.max(0,s-c,i)-Math.max(0,p+c-a)),{offset:s-i,height:p,active:s-i<=c})),Y((i,s)=>i.offset===s.offset&&i.height===s.height&&i.active===s.active))}function ss(e){let t=__md_get("__palette")||{index:e.findIndex(o=>matchMedia(o.getAttribute("data-md-color-media")).matches)},r=Math.max(0,Math.min(t.index,e.length-1));return $(...e).pipe(J(o=>h(o,"change").pipe(m(()=>o))),Q(e[r]),m(o=>({index:e.indexOf(o),color:{media:o.getAttribute("data-md-color-media"),scheme:o.getAttribute("data-md-color-scheme"),primary:o.getAttribute("data-md-color-primary"),accent:o.getAttribute("data-md-color-accent")}})),X(1))}function ii(e){let t=M("input",e),r=y("meta",{name:"theme-color"});document.head.appendChild(r);let o=y("meta",{name:"color-scheme"});document.head.appendChild(o);let n=Wt("(prefers-color-scheme: light)");return k(()=>{let i=new T;return i.subscribe(s=>{if(document.body.setAttribute("data-md-color-switching",""),s.color.media==="(prefers-color-scheme)"){let a=matchMedia("(prefers-color-scheme: light)"),c=document.querySelector(a.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");s.color.scheme=c.getAttribute("data-md-color-scheme"),s.color.primary=c.getAttribute("data-md-color-primary"),s.color.accent=c.getAttribute("data-md-color-accent")}for(let[a,c]of Object.entries(s.color))document.body.setAttribute(`data-md-color-${a}`,c);for(let a=0;a<t.length;a++){let c=t[a].nextElementSibling;c instanceof HTMLElement&&(c.hidden=s.index!==a)}__md_set("__palette",s)}),h(e,"keydown").pipe(v(s=>s.key==="Enter"),te(i,(s,a)=>a)).subscribe(({index:s})=>{s=(s+1)%t.length,t[s].click(),t[s].focus()}),i.pipe(m(()=>{let s=Ce("header"),a=window.getComputedStyle(s);return o.content=a.colorScheme,a.backgroundColor.match(/\d+/g).map(c=>(+c).toString(16).padStart(2,"0")).join("")})).subscribe(s=>r.content=`#${s}`),i.pipe(xe(pe)).subscribe(()=>{document.body.removeAttribute("data-md-color-switching")}),ss(t).pipe(W(n.pipe(Pe(1))),vt(),S(s=>i.next(s)),A(()=>i.complete()),m(s=>j({ref:e},s)))})}function ai(e,{progress$:t}){return k(()=>{let r=new T;return r.subscribe(({value:o})=>{e.style.setProperty("--md-progress-value",`${o}`)}),t.pipe(S(o=>r.next({value:o})),A(()=>r.complete()),m(o=>({ref:e,value:o})))})}function si(e,t){return e.protocol=t.protocol,e.hostname=t.hostname,e}function cs(e,t){let r=new Map;for(let o of M("url",e)){let n=F("loc",o),i=[si(new URL(n.textContent),t)];r.set(`${i[0]}`,i);for(let s of M("[rel=alternate]",o)){let a=s.getAttribute("href");a!=null&&i.push(si(new URL(a),t))}}return r}function kt(e){return xn(new URL("sitemap.xml",e)).pipe(m(t=>cs(t,new URL(e))),ye(()=>$(new Map)),le())}function ci({document$:e}){let t=new Map;e.pipe(b(()=>M("link[rel=alternate]")),m(r=>new URL(r.href)),v(r=>!t.has(r.toString())),J(r=>kt(r).pipe(m(o=>[r,o]),ye(()=>x)))).subscribe(([r,o])=>{t.set(r.toString().replace(/\/$/,""),o)}),h(document.body,"click").pipe(v(r=>!r.metaKey&&!r.ctrlKey),b(r=>{if(r.target instanceof Element){let o=r.target.closest("a");if(o&&!o.target){let n=[...t].find(([f])=>o.href.startsWith(`${f}/`));if(typeof n=="undefined")return x;let[i,s]=n,a=we();if(a.href.startsWith(i))return x;let c=Te(),p=a.href.replace(c.base,"");p=`${i}/${p}`;let l=s.has(p.split("#")[0])?new URL(p,c.base):new URL(i);return r.preventDefault(),$(l)}}return x})).subscribe(r=>at(r,!0))}var so=Gt(io());function ps(e){e.setAttribute("data-md-copying","");let t=e.closest("[data-copy]"),r=t?t.getAttribute("data-copy"):e.innerText;return e.removeAttribute("data-md-copying"),r.trimEnd()}function pi({alert$:e}){so.default.isSupported()&&new I(t=>{new so.default("[data-clipboard-target], [data-clipboard-text]",{text:r=>r.getAttribute("data-clipboard-text")||ps(F(r.getAttribute("data-clipboard-target")))}).on("success",r=>t.next(r))}).pipe(S(t=>{t.trigger.focus()}),m(()=>Me("clipboard.copied"))).subscribe(e)}function li(e,t){if(!(e.target instanceof Element))return x;let r=e.target.closest("a");if(r===null)return x;if(r.target||e.metaKey||e.ctrlKey)return x;let o=new URL(r.href);return o.search=o.hash="",t.has(`${o}`)?(e.preventDefault(),$(r)):x}function mi(e){let t=new Map;for(let r of M(":scope > *",e.head))t.set(r.outerHTML,r);return t}function fi(e){for(let t of M("[href], [src]",e))for(let r of["href","src"]){let o=t.getAttribute(r);if(o&&!/^(?:[a-z]+:)?\/\//i.test(o)){t[r]=t[r];break}}return $(e)}function ls(e){for(let o of["[data-md-component=announce]","[data-md-component=container]","[data-md-component=header-topic]","[data-md-component=outdated]","[data-md-component=logo]","[data-md-component=skip]",...N("navigation.tabs.sticky")?["[data-md-component=tabs]"]:[]]){let n=ue(o),i=ue(o,e);typeof n!="undefined"&&typeof i!="undefined"&&n.replaceWith(i)}let t=mi(document);for(let[o,n]of mi(e))t.has(o)?t.delete(o):document.head.appendChild(n);for(let o of t.values()){let n=o.getAttribute("name");n!=="theme-color"&&n!=="color-scheme"&&o.remove()}let r=Ce("container");return qe(M("script",r)).pipe(b(o=>{let n=e.createElement("script");if(o.src){for(let i of o.getAttributeNames())n.setAttribute(i,o.getAttribute(i));return o.replaceWith(n),new I(i=>{n.onload=()=>i.complete()})}else return n.textContent=o.textContent,o.replaceWith(n),x}),re(),ae(document))}function ui({sitemap$:e,location$:t,viewport$:r,progress$:o}){if(location.protocol==="file:")return x;$(document).subscribe(fi);let n=h(document.body,"click").pipe(De(e),b(([a,c])=>li(a,c)),m(({href:a})=>new URL(a)),le()),i=h(window,"popstate").pipe(m(we),le());n.pipe(te(r)).subscribe(([a,{offset:c}])=>{history.replaceState(c,""),history.pushState(null,"",a)}),O(n,i).subscribe(t);let s=t.pipe(oe("pathname"),b(a=>yr(a,{progress$:o}).pipe(ye(()=>(at(a,!0),x)))),b(fi),b(ls),le());return O(s.pipe(te(t,(a,c)=>c)),s.pipe(b(()=>t),oe("pathname"),b(()=>t),oe("hash")),t.pipe(Y((a,c)=>a.pathname===c.pathname&&a.hash===c.hash),b(()=>n),S(()=>history.back()))).subscribe(a=>{var c,p;history.state!==null||!a.hash?window.scrollTo(0,(p=(c=history.state)==null?void 0:c.y)!=null?p:0):(history.scrollRestoration="auto",bn(a.hash),history.scrollRestoration="manual")}),t.subscribe(()=>{history.scrollRestoration="manual"}),h(window,"beforeunload").subscribe(()=>{history.scrollRestoration="auto"}),r.pipe(oe("offset"),Ae(100)).subscribe(({offset:a})=>{history.replaceState(a,"")}),N("navigation.instant.prefetch")&&O(h(document.body,"mousemove"),h(document.body,"focusin")).pipe(De(e),b(([a,c])=>li(a,c)),Ae(25),Qr(({href:a})=>a),hr(a=>{let c=document.createElement("link");return c.rel="prefetch",c.href=a.toString(),document.head.appendChild(c),h(c,"load").pipe(m(()=>c),Ee(1))})).subscribe(a=>a.remove()),s}var bi=Gt(hi());function vi(e){let t=e.separator.split("|").map(n=>n.replace(/(\(\?[!=<][^)]+\))/g,"").length===0?"\uFFFD":n).join("|"),r=new RegExp(t,"img"),o=(n,i,s)=>`${i}<mark data-md-highlight>${s}</mark>`;return n=>{n=n.replace(/[\s*+\-:~^]+/g," ").trim();let i=new RegExp(`(^|${e.separator}|)(${n.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(r,"|")})`,"img");return s=>(0,bi.default)(s).replace(i,o).replace(/<\/mark>(\s+)<mark[^>]*>/img,"$1")}}function zt(e){return e.type===1}function Sr(e){return e.type===3}function gi(e,t){let r=On(e);return O($(location.protocol!=="file:"),Be("search")).pipe(Re(o=>o),b(()=>t)).subscribe(({config:o,docs:n})=>r.next({type:0,data:{config:o,docs:n,options:{suggest:N("search.suggest")}}})),r}function xi({document$:e}){let t=Te(),r=Ge(new URL("../versions.json",t.base)).pipe(ye(()=>x)),o=r.pipe(m(n=>{let[,i]=t.base.match(/([^/]+)\/?$/);return n.find(({version:s,aliases:a})=>s===i||a.includes(i))||n[0]}));r.pipe(m(n=>new Map(n.map(i=>[`${new URL(`../${i.version}/`,t.base)}`,i]))),b(n=>h(document.body,"click").pipe(v(i=>!i.metaKey&&!i.ctrlKey),te(o),b(([i,s])=>{if(i.target instanceof Element){let a=i.target.closest("a");if(a&&!a.target&&n.has(a.href)){let c=a.href;return!i.target.closest(".md-version")&&n.get(c)===s?x:(i.preventDefault(),$(c))}}return x}),b(i=>kt(new URL(i)).pipe(m(s=>{let c=we().href.replace(t.base,i);return s.has(c.split("#")[0])?new URL(c):new URL(i)})))))).subscribe(n=>at(n,!0)),z([r,o]).subscribe(([n,i])=>{F(".md-header__topic").appendChild(In(n,i))}),e.pipe(b(()=>o)).subscribe(n=>{var s;let i=__md_get("__outdated",sessionStorage);if(i===null){i=!0;let a=((s=t.version)==null?void 0:s.default)||"latest";Array.isArray(a)||(a=[a]);e:for(let c of a)for(let p of n.aliases.concat(n.version))if(new RegExp(c,"i").test(p)){i=!1;break e}__md_set("__outdated",i,sessionStorage)}if(i)for(let a of me("outdated"))a.hidden=!1})}function hs(e,{worker$:t}){let{searchParams:r}=we();r.has("q")&&(it("search",!0),e.value=r.get("q"),e.focus(),Be("search").pipe(Re(i=>!i)).subscribe(()=>{let i=we();i.searchParams.delete("q"),history.replaceState({},"",`${i}`)}));let o=Ke(e),n=O(t.pipe(Re(zt)),h(e,"keyup"),o).pipe(m(()=>e.value),Y());return z([n,o]).pipe(m(([i,s])=>({value:i,focus:s})),X(1))}function yi(e,{worker$:t}){let r=new T,o=r.pipe(re(),ae(!0));z([t.pipe(Re(zt)),r],(i,s)=>s).pipe(oe("value")).subscribe(({value:i})=>t.next({type:2,data:i})),r.pipe(oe("focus")).subscribe(({focus:i})=>{i&&it("search",i)}),h(e.form,"reset").pipe(W(o)).subscribe(()=>e.focus());let n=F("header [for=__search]");return h(n,"click").subscribe(()=>e.focus()),hs(e,{worker$:t}).pipe(S(i=>r.next(i)),A(()=>r.complete()),m(i=>j({ref:e},i)),X(1))}function Ei(e,{worker$:t,query$:r}){let o=new T,n=mn(e.parentElement).pipe(v(Boolean)),i=e.parentElement,s=F(":scope > :first-child",e),a=F(":scope > :last-child",e);Be("search").subscribe(l=>a.setAttribute("role",l?"list":"presentation")),o.pipe(te(r),Gr(t.pipe(Re(zt)))).subscribe(([{items:l},{value:f}])=>{switch(l.length){case 0:s.textContent=f.length?Me("search.result.none"):Me("search.result.placeholder");break;case 1:s.textContent=Me("search.result.one");break;default:let u=br(l.length);s.textContent=Me("search.result.other",u)}});let c=o.pipe(S(()=>a.innerHTML=""),b(({items:l})=>O($(...l.slice(0,10)),$(...l.slice(10)).pipe(tt(4),Xr(n),b(([f])=>f)))),m($n),le());return c.subscribe(l=>a.appendChild(l)),c.pipe(J(l=>{let f=ue("details",l);return typeof f=="undefined"?x:h(f,"toggle").pipe(W(o),m(()=>f))})).subscribe(l=>{l.open===!1&&l.offsetTop<=i.scrollTop&&i.scrollTo({top:l.offsetTop})}),t.pipe(v(Sr),m(({data:l})=>l)).pipe(S(l=>o.next(l)),A(()=>o.complete()),m(l=>j({ref:e},l)))}function bs(e,{query$:t}){return t.pipe(m(({value:r})=>{let o=we();return o.hash="",r=r.replace(/\s+/g,"+").replace(/&/g,"%26").replace(/=/g,"%3D"),o.search=`q=${r}`,{url:o}}))}function wi(e,t){let r=new T,o=r.pipe(re(),ae(!0));return r.subscribe(({url:n})=>{e.setAttribute("data-clipboard-text",e.href),e.href=`${n}`}),h(e,"click").pipe(W(o)).subscribe(n=>n.preventDefault()),bs(e,t).pipe(S(n=>r.next(n)),A(()=>r.complete()),m(n=>j({ref:e},n)))}function Ti(e,{worker$:t,keyboard$:r}){let o=new T,n=Ce("search-query"),i=O(h(n,"keydown"),h(n,"focus")).pipe(xe(pe),m(()=>n.value),Y());return o.pipe(De(i),m(([{suggest:a},c])=>{let p=c.split(/([\s-]+)/);if(a!=null&&a.length&&p[p.length-1]){let l=a[a.length-1];l.startsWith(p[p.length-1])&&(p[p.length-1]=l)}else p.length=0;return p})).subscribe(a=>e.innerHTML=a.join("").replace(/\s/g,"&nbsp;")),r.pipe(v(({mode:a})=>a==="search")).subscribe(a=>{switch(a.type){case"ArrowRight":e.innerText.length&&n.selectionStart===n.value.length&&(n.value=e.innerText);break}}),t.pipe(v(Sr),m(({data:a})=>a)).pipe(S(a=>o.next(a)),A(()=>o.complete()),m(()=>({ref:e})))}function Si(e,{index$:t,keyboard$:r}){let o=Te();try{let n=gi(o.search,t),i=Ce("search-query",e),s=Ce("search-result",e);h(e,"click").pipe(v(({target:c})=>c instanceof Element&&!!c.closest("a"))).subscribe(()=>it("search",!1)),r.pipe(v(({mode:c})=>c==="search")).subscribe(c=>{let p=Ve();switch(c.type){case"Enter":if(p===i){let l=new Map;for(let f of M(":first-child [href]",s)){let u=f.firstElementChild;l.set(f,parseFloat(u.getAttribute("data-md-score")))}if(l.size){let[[f]]=[...l].sort(([,u],[,d])=>d-u);f.click()}c.claim()}break;case"Escape":case"Tab":it("search",!1),i.blur();break;case"ArrowUp":case"ArrowDown":if(typeof p=="undefined")i.focus();else{let l=[i,...M(":not(details) > [href], summary, details[open] [href]",s)],f=Math.max(0,(Math.max(0,l.indexOf(p))+l.length+(c.type==="ArrowUp"?-1:1))%l.length);l[f].focus()}c.claim();break;default:i!==Ve()&&i.focus()}}),r.pipe(v(({mode:c})=>c==="global")).subscribe(c=>{switch(c.type){case"f":case"s":case"/":i.focus(),i.select(),c.claim();break}});let a=yi(i,{worker$:n});return O(a,Ei(s,{worker$:n,query$:a})).pipe(Ne(...me("search-share",e).map(c=>wi(c,{query$:a})),...me("search-suggest",e).map(c=>Ti(c,{worker$:n,keyboard$:r}))))}catch(n){return e.hidden=!0,et}}function Oi(e,{index$:t,location$:r}){return z([t,r.pipe(Q(we()),v(o=>!!o.searchParams.get("h")))]).pipe(m(([o,n])=>vi(o.config)(n.searchParams.get("h"))),m(o=>{var s;let n=new Map,i=document.createNodeIterator(e,NodeFilter.SHOW_TEXT);for(let a=i.nextNode();a;a=i.nextNode())if((s=a.parentElement)!=null&&s.offsetHeight){let c=a.textContent,p=o(c);p.length>c.length&&n.set(a,p)}for(let[a,c]of n){let{childNodes:p}=y("span",null,c);a.replaceWith(...Array.from(p))}return{ref:e,nodes:n}}))}function vs(e,{viewport$:t,main$:r}){let o=e.closest(".md-grid"),n=o.offsetTop-o.parentElement.offsetTop;return z([r,t]).pipe(m(([{offset:i,height:s},{offset:{y:a}}])=>(s=s+Math.min(n,Math.max(0,a-i))-n,{height:s,locked:a>=i+n})),Y((i,s)=>i.height===s.height&&i.locked===s.locked))}function co(e,o){var n=o,{header$:t}=n,r=ho(n,["header$"]);let i=F(".md-sidebar__scrollwrap",e),{y:s}=Qe(i);return k(()=>{let a=new T,c=a.pipe(re(),ae(!0)),p=a.pipe($e(0,ge));return p.pipe(te(t)).subscribe({next([{height:l},{height:f}]){i.style.height=`${l-2*s}px`,e.style.top=`${f}px`},complete(){i.style.height="",e.style.top=""}}),p.pipe(Re()).subscribe(()=>{for(let l of M(".md-nav__link--active[href]",e)){if(!l.clientHeight)continue;let f=l.closest(".md-sidebar__scrollwrap");if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:d}=de(f);f.scrollTo({top:u-d/2})}}}),fe(M("label[tabindex]",e)).pipe(J(l=>h(l,"click").pipe(xe(pe),m(()=>l),W(c)))).subscribe(l=>{let f=F(`[id="${l.htmlFor}"]`);F(`[aria-labelledby="${l.id}"]`).setAttribute("aria-expanded",`${f.checked}`)}),N("content.tooltips")&&fe(M("abbr[title]",e)).pipe(J(l=>Je(l,{viewport$})),W(c)).subscribe(),vs(e,r).pipe(S(l=>a.next(l)),A(()=>a.complete()),m(l=>j({ref:e},l)))})}function Li(e,t){if(typeof t!="undefined"){let r=`https://api.github.com/repos/${e}/${t}`;return bt(Ge(`${r}/releases/latest`).pipe(ye(()=>x),m(o=>({version:o.tag_name})),rt({})),Ge(r).pipe(ye(()=>x),m(o=>({stars:o.stargazers_count,forks:o.forks_count})),rt({}))).pipe(m(([o,n])=>j(j({},o),n)))}else{let r=`https://api.github.com/users/${e}`;return Ge(r).pipe(m(o=>({repositories:o.public_repos})),rt({}))}}function Mi(e,t){let r=`https://${e}/api/v4/projects/${encodeURIComponent(t)}`;return Ge(r).pipe(ye(()=>x),m(({star_count:o,forks_count:n})=>({stars:o,forks:n})),rt({}))}function _i(e){let t=e.match(/^.+github\.com\/([^/]+)\/?([^/]+)?/i);if(t){let[,r,o]=t;return Li(r,o)}if(t=e.match(/^.+?([^/]*gitlab[^/]+)\/(.+?)\/?$/i),t){let[,r,o]=t;return Mi(r,o)}return x}var gs;function xs(e){return gs||(gs=k(()=>{let t=__md_get("__source",sessionStorage);if(t)return $(t);if(me("consent").length){let o=__md_get("__consent");if(!(o&&o.github))return x}return _i(e.href).pipe(S(o=>__md_set("__source",o,sessionStorage)))}).pipe(ye(()=>x),v(t=>Object.keys(t).length>0),m(t=>({facts:t})),X(1)))}function Ai(e){let t=F(":scope > :last-child",e);return k(()=>{let r=new T;return r.subscribe(({facts:o})=>{t.appendChild(Rn(o)),t.classList.add("md-source__repository--active")}),xs(e).pipe(S(o=>r.next(o)),A(()=>r.complete()),m(o=>j({ref:e},o)))})}function ys(e,{viewport$:t,header$:r}){return Le(document.body).pipe(b(()=>Er(e,{header$:r,viewport$:t})),m(({offset:{y:o}})=>({hidden:o>=10})),oe("hidden"))}function Ci(e,t){return k(()=>{let r=new T;return r.subscribe({next({hidden:o}){e.hidden=o},complete(){e.hidden=!1}}),(N("navigation.tabs.sticky")?$({hidden:!1}):ys(e,t)).pipe(S(o=>r.next(o)),A(()=>r.complete()),m(o=>j({ref:e},o)))})}function Es(e,{viewport$:t,header$:r}){let o=new Map,n=M(".md-nav__link",e);for(let a of n){let c=decodeURIComponent(a.hash.substring(1)),p=ue(`[id="${c}"]`);typeof p!="undefined"&&o.set(a,p)}let i=r.pipe(oe("height"),m(({height:a})=>{let c=Ce("main"),p=F(":scope > :first-child",c);return a+.8*(p.offsetTop-c.offsetTop)}),le());return Le(document.body).pipe(oe("height"),b(a=>k(()=>{let c=[];return $([...o].reduce((p,[l,f])=>{for(;c.length&&o.get(c[c.length-1]).tagName>=f.tagName;)c.pop();let u=f.offsetTop;for(;!u&&f.parentElement;)f=f.parentElement,u=f.offsetTop;let d=f.offsetParent;for(;d;d=d.offsetParent)u+=d.offsetTop;return p.set([...c=[...c,l]].reverse(),u)},new Map))}).pipe(m(c=>new Map([...c].sort(([,p],[,l])=>p-l))),De(i),b(([c,p])=>t.pipe(Ut(([l,f],{offset:{y:u},size:d})=>{let g=u+d.height>=Math.floor(a.height);for(;f.length;){let[,L]=f[0];if(L-p<u||g)l=[...l,f.shift()];else break}for(;l.length;){let[,L]=l[l.length-1];if(L-p>=u&&!g)f=[l.pop(),...f];else break}return[l,f]},[[],[...c]]),Y((l,f)=>l[0]===f[0]&&l[1]===f[1])))))).pipe(m(([a,c])=>({prev:a.map(([p])=>p),next:c.map(([p])=>p)})),Q({prev:[],next:[]}),tt(2,1),m(([a,c])=>a.prev.length<c.prev.length?{prev:c.prev.slice(Math.max(0,a.prev.length-1),c.prev.length),next:[]}:{prev:c.prev.slice(-1),next:c.next.slice(0,c.next.length-a.next.length)}))}function Hi(e,{viewport$:t,header$:r,main$:o,target$:n}){return k(()=>{let i=new T,s=i.pipe(re(),ae(!0));if(i.subscribe(({prev:a,next:c})=>{for(let[p]of c)p.classList.remove("md-nav__link--passed"),p.classList.remove("md-nav__link--active");for(let[p,[l]]of a.entries())l.classList.add("md-nav__link--passed"),l.classList.toggle("md-nav__link--active",p===a.length-1)}),N("toc.follow")){let a=O(t.pipe(Ae(1),m(()=>{})),t.pipe(Ae(250),m(()=>"smooth")));i.pipe(v(({prev:c})=>c.length>0),De(o.pipe(xe(pe))),te(a)).subscribe(([[{prev:c}],p])=>{let[l]=c[c.length-1];if(l.offsetHeight){let f=vr(l);if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:d}=de(f);f.scrollTo({top:u-d/2,behavior:p})}}})}return N("navigation.tracking")&&t.pipe(W(s),oe("offset"),Ae(250),Pe(1),W(n.pipe(Pe(1))),vt({delay:250}),te(i)).subscribe(([,{prev:a}])=>{let c=we(),p=a[a.length-1];if(p&&p.length){let[l]=p,{hash:f}=new URL(l.href);c.hash!==f&&(c.hash=f,history.replaceState({},"",`${c}`))}else c.hash="",history.replaceState({},"",`${c}`)}),Es(e,{viewport$:t,header$:r}).pipe(S(a=>i.next(a)),A(()=>i.complete()),m(a=>j({ref:e},a)))})}function ws(e,{viewport$:t,main$:r,target$:o}){let n=t.pipe(m(({offset:{y:s}})=>s),tt(2,1),m(([s,a])=>s>a&&a>0),Y()),i=r.pipe(m(({active:s})=>s));return z([i,n]).pipe(m(([s,a])=>!(s&&a)),Y(),W(o.pipe(Pe(1))),ae(!0),vt({delay:250}),m(s=>({hidden:s})))}function ki(e,{viewport$:t,header$:r,main$:o,target$:n}){let i=new T,s=i.pipe(re(),ae(!0));return i.subscribe({next({hidden:a}){e.hidden=a,a?(e.setAttribute("tabindex","-1"),e.blur()):e.removeAttribute("tabindex")},complete(){e.style.top="",e.hidden=!0,e.removeAttribute("tabindex")}}),r.pipe(W(s),oe("height")).subscribe(({height:a})=>{e.style.top=`${a+16}px`}),h(e,"click").subscribe(a=>{a.preventDefault(),window.scrollTo({top:0})}),ws(e,{viewport$:t,main$:o,target$:n}).pipe(S(a=>i.next(a)),A(()=>i.complete()),m(a=>j({ref:e},a)))}function $i({document$:e,viewport$:t}){e.pipe(b(()=>M(".md-ellipsis")),J(r=>lt(r).pipe(W(e.pipe(Pe(1))),v(o=>o),m(()=>r),Ee(1))),v(r=>r.offsetWidth<r.scrollWidth),J(r=>{let o=r.innerText,n=r.closest("a")||r;return n.title=o,N("content.tooltips")?Je(n,{viewport$:t}).pipe(W(e.pipe(Pe(1))),A(()=>n.removeAttribute("title"))):x})).subscribe(),N("content.tooltips")&&e.pipe(b(()=>M(".md-status")),J(r=>Je(r,{viewport$:t}))).subscribe()}function Ri({document$:e,tablet$:t}){e.pipe(b(()=>M(".md-toggle--indeterminate")),S(r=>{r.indeterminate=!0,r.checked=!1}),J(r=>h(r,"change").pipe(Jr(()=>r.classList.contains("md-toggle--indeterminate")),m(()=>r))),te(t)).subscribe(([r,o])=>{r.classList.remove("md-toggle--indeterminate"),o&&(r.checked=!1)})}function Ts(){return/(iPad|iPhone|iPod)/.test(navigator.userAgent)}function Pi({document$:e}){e.pipe(b(()=>M("[data-md-scrollfix]")),S(t=>t.removeAttribute("data-md-scrollfix")),v(Ts),J(t=>h(t,"touchstart").pipe(m(()=>t)))).subscribe(t=>{let r=t.scrollTop;r===0?t.scrollTop=1:r+t.offsetHeight===t.scrollHeight&&(t.scrollTop=r-1)})}function Ii({viewport$:e,tablet$:t}){z([Be("search"),t]).pipe(m(([r,o])=>r&&!o),b(r=>$(r).pipe(ot(r?400:100))),te(e)).subscribe(([r,{offset:{y:o}}])=>{if(r)document.body.setAttribute("data-md-scrolllock",""),document.body.style.top=`-${o}px`;else{let n=-1*parseInt(document.body.style.top,10);document.body.removeAttribute("data-md-scrolllock"),document.body.style.top="",n&&window.scrollTo(0,n)}})}Object.entries||(Object.entries=function(e){let t=[];for(let r of Object.keys(e))t.push([r,e[r]]);return t});Object.values||(Object.values=function(e){let t=[];for(let r of Object.keys(e))t.push(e[r]);return t});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(e,t){typeof e=="object"?(this.scrollLeft=e.left,this.scrollTop=e.top):(this.scrollLeft=e,this.scrollTop=t)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...e){let t=this.parentNode;if(t){e.length===0&&t.removeChild(this);for(let r=e.length-1;r>=0;r--){let o=e[r];typeof o=="string"?o=document.createTextNode(o):o.parentNode&&o.parentNode.removeChild(o),r?t.insertBefore(this.previousSibling,o):t.replaceChild(o,this)}}}));function Ss(){return location.protocol==="file:"?At(`${new URL("search/search_index.js",Or.base)}`).pipe(m(()=>__index),X(1)):Ge(new URL("search/search_index.json",Or.base))}document.documentElement.classList.remove("no-js");document.documentElement.classList.add("js");var st=on(),Kt=dn(),$t=vn(Kt),po=un(),He=Sn(),Lr=Wt("(min-width: 960px)"),ji=Wt("(min-width: 1220px)"),Ui=gn(),Or=Te(),Wi=document.forms.namedItem("search")?Ss():et,lo=new T;pi({alert$:lo});ci({document$:st});var mo=new T,Di=kt(Or.base);N("navigation.instant")&&ui({sitemap$:Di,location$:Kt,viewport$:He,progress$:mo}).subscribe(st);var Fi;((Fi=Or.version)==null?void 0:Fi.provider)==="mike"&&xi({document$:st});O(Kt,$t).pipe(ot(125)).subscribe(()=>{it("drawer",!1),it("search",!1)});po.pipe(v(({mode:e})=>e==="global")).subscribe(e=>{switch(e.type){case"p":case",":let t=ue("link[rel=prev]");typeof t!="undefined"&&at(t);break;case"n":case".":let r=ue("link[rel=next]");typeof r!="undefined"&&at(r);break;case"Enter":let o=Ve();o instanceof HTMLLabelElement&&o.click()}});$i({viewport$:He,document$:st});Ri({document$:st,tablet$:Lr});Pi({document$:st});Ii({viewport$:He,tablet$:Lr});var mt=ti(Ce("header"),{viewport$:He}),qt=st.pipe(m(()=>Ce("main")),b(e=>ni(e,{viewport$:He,header$:mt})),X(1)),Os=O(...me("consent").map(e=>Mn(e,{target$:$t})),...me("dialog").map(e=>Zn(e,{alert$:lo})),...me("header").map(e=>ri(e,{viewport$:He,header$:mt,main$:qt})),...me("palette").map(e=>ii(e)),...me("progress").map(e=>ai(e,{progress$:mo})),...me("search").map(e=>Si(e,{index$:Wi,keyboard$:po})),...me("source").map(e=>Ai(e))),Ls=k(()=>O(...me("announce").map(e=>Ln(e)),...me("content").map(e=>Xn(e,{sitemap$:Di,viewport$:He,target$:$t,print$:Ui})),...me("content").map(e=>N("search.highlight")?Oi(e,{index$:Wi,location$:Kt}):x),...me("header-title").map(e=>oi(e,{viewport$:He,header$:mt})),...me("sidebar").map(e=>e.getAttribute("data-md-type")==="navigation"?eo(ji,()=>co(e,{viewport$:He,header$:mt,main$:qt})):eo(Lr,()=>co(e,{viewport$:He,header$:mt,main$:qt}))),...me("tabs").map(e=>Ci(e,{viewport$:He,header$:mt})),...me("toc").map(e=>Hi(e,{viewport$:He,header$:mt,main$:qt,target$:$t})),...me("top").map(e=>ki(e,{viewport$:He,header$:mt,main$:qt,target$:$t})))),Ni=st.pipe(b(()=>Ls),Ne(Os),X(1));Ni.subscribe();window.document$=st;window.location$=Kt;window.target$=$t;window.keyboard$=po;window.viewport$=He;window.tablet$=Lr;window.screen$=ji;window.print$=Ui;window.alert$=lo;window.progress$=mo;window.component$=Ni;})();
+  `):"",this.name="UnsubscriptionError",this.errors=r}});function Xe(e,t){if(e){var r=e.indexOf(t);0<=r&&e.splice(r,1)}}var ze=function(){function e(t){this.initialTeardown=t,this.closed=!1,this._parentage=null,this._finalizers=null}return e.prototype.unsubscribe=function(){var t,r,o,n,i;if(!this.closed){this.closed=!0;var s=this._parentage;if(s)if(this._parentage=null,Array.isArray(s))try{for(var a=Oe(s),c=a.next();!c.done;c=a.next()){var p=c.value;p.remove(this)}}catch(L){t={error:L}}finally{try{c&&!c.done&&(r=a.return)&&r.call(a)}finally{if(t)throw t.error}}else s.remove(this);var l=this.initialTeardown;if(P(l))try{l()}catch(L){i=L instanceof Xt?L.errors:[L]}var f=this._finalizers;if(f){this._finalizers=null;try{for(var u=Oe(f),d=u.next();!d.done;d=u.next()){var g=d.value;try{wo(g)}catch(L){i=i!=null?i:[],L instanceof Xt?i=B(B([],K(i)),K(L.errors)):i.push(L)}}}catch(L){o={error:L}}finally{try{d&&!d.done&&(n=u.return)&&n.call(u)}finally{if(o)throw o.error}}}if(i)throw new Xt(i)}},e.prototype.add=function(t){var r;if(t&&t!==this)if(this.closed)wo(t);else{if(t instanceof e){if(t.closed||t._hasParent(this))return;t._addParent(this)}(this._finalizers=(r=this._finalizers)!==null&&r!==void 0?r:[]).push(t)}},e.prototype._hasParent=function(t){var r=this._parentage;return r===t||Array.isArray(r)&&r.includes(t)},e.prototype._addParent=function(t){var r=this._parentage;this._parentage=Array.isArray(r)?(r.push(t),r):r?[r,t]:t},e.prototype._removeParent=function(t){var r=this._parentage;r===t?this._parentage=null:Array.isArray(r)&&Xe(r,t)},e.prototype.remove=function(t){var r=this._finalizers;r&&Xe(r,t),t instanceof e&&t._removeParent(this)},e.EMPTY=function(){var t=new e;return t.closed=!0,t}(),e}();var kr=ze.EMPTY;function Zt(e){return e instanceof ze||e&&"closed"in e&&P(e.remove)&&P(e.add)&&P(e.unsubscribe)}function wo(e){P(e)?e():e.unsubscribe()}var We={onUnhandledError:null,onStoppedNotification:null,Promise:void 0,useDeprecatedSynchronousErrorHandling:!1,useDeprecatedNextContext:!1};var yt={setTimeout:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=yt.delegate;return n!=null&&n.setTimeout?n.setTimeout.apply(n,B([e,t],K(r))):setTimeout.apply(void 0,B([e,t],K(r)))},clearTimeout:function(e){var t=yt.delegate;return((t==null?void 0:t.clearTimeout)||clearTimeout)(e)},delegate:void 0};function er(e){yt.setTimeout(function(){var t=We.onUnhandledError;if(t)t(e);else throw e})}function ve(){}var To=function(){return Rr("C",void 0,void 0)}();function So(e){return Rr("E",void 0,e)}function Oo(e){return Rr("N",e,void 0)}function Rr(e,t,r){return{kind:e,value:t,error:r}}var dt=null;function Et(e){if(We.useDeprecatedSynchronousErrorHandling){var t=!dt;if(t&&(dt={errorThrown:!1,error:null}),e(),t){var r=dt,o=r.errorThrown,n=r.error;if(dt=null,o)throw n}}else e()}function Lo(e){We.useDeprecatedSynchronousErrorHandling&&dt&&(dt.errorThrown=!0,dt.error=e)}var Rt=function(e){ie(t,e);function t(r){var o=e.call(this)||this;return o.isStopped=!1,r?(o.destination=r,Zt(r)&&r.add(o)):o.destination=na,o}return t.create=function(r,o,n){return new ht(r,o,n)},t.prototype.next=function(r){this.isStopped?Ir(Oo(r),this):this._next(r)},t.prototype.error=function(r){this.isStopped?Ir(So(r),this):(this.isStopped=!0,this._error(r))},t.prototype.complete=function(){this.isStopped?Ir(To,this):(this.isStopped=!0,this._complete())},t.prototype.unsubscribe=function(){this.closed||(this.isStopped=!0,e.prototype.unsubscribe.call(this),this.destination=null)},t.prototype._next=function(r){this.destination.next(r)},t.prototype._error=function(r){try{this.destination.error(r)}finally{this.unsubscribe()}},t.prototype._complete=function(){try{this.destination.complete()}finally{this.unsubscribe()}},t}(ze);var ta=Function.prototype.bind;function Pr(e,t){return ta.call(e,t)}var ra=function(){function e(t){this.partialObserver=t}return e.prototype.next=function(t){var r=this.partialObserver;if(r.next)try{r.next(t)}catch(o){tr(o)}},e.prototype.error=function(t){var r=this.partialObserver;if(r.error)try{r.error(t)}catch(o){tr(o)}else tr(t)},e.prototype.complete=function(){var t=this.partialObserver;if(t.complete)try{t.complete()}catch(r){tr(r)}},e}(),ht=function(e){ie(t,e);function t(r,o,n){var i=e.call(this)||this,s;if(P(r)||!r)s={next:r!=null?r:void 0,error:o!=null?o:void 0,complete:n!=null?n:void 0};else{var a;i&&We.useDeprecatedNextContext?(a=Object.create(r),a.unsubscribe=function(){return i.unsubscribe()},s={next:r.next&&Pr(r.next,a),error:r.error&&Pr(r.error,a),complete:r.complete&&Pr(r.complete,a)}):s=r}return i.destination=new ra(s),i}return t}(Rt);function tr(e){We.useDeprecatedSynchronousErrorHandling?Lo(e):er(e)}function oa(e){throw e}function Ir(e,t){var r=We.onStoppedNotification;r&&yt.setTimeout(function(){return r(e,t)})}var na={closed:!0,next:ve,error:oa,complete:ve};var wt=function(){return typeof Symbol=="function"&&Symbol.observable||"@@observable"}();function be(e){return e}function Mo(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Fr(e)}function Fr(e){return e.length===0?be:e.length===1?e[0]:function(r){return e.reduce(function(o,n){return n(o)},r)}}var I=function(){function e(t){t&&(this._subscribe=t)}return e.prototype.lift=function(t){var r=new e;return r.source=this,r.operator=t,r},e.prototype.subscribe=function(t,r,o){var n=this,i=aa(t)?t:new ht(t,r,o);return Et(function(){var s=n,a=s.operator,c=s.source;i.add(a?a.call(i,c):c?n._subscribe(i):n._trySubscribe(i))}),i},e.prototype._trySubscribe=function(t){try{return this._subscribe(t)}catch(r){t.error(r)}},e.prototype.forEach=function(t,r){var o=this;return r=_o(r),new r(function(n,i){var s=new ht({next:function(a){try{t(a)}catch(c){i(c),s.unsubscribe()}},error:i,complete:n});o.subscribe(s)})},e.prototype._subscribe=function(t){var r;return(r=this.source)===null||r===void 0?void 0:r.subscribe(t)},e.prototype[wt]=function(){return this},e.prototype.pipe=function(){for(var t=[],r=0;r<arguments.length;r++)t[r]=arguments[r];return Fr(t)(this)},e.prototype.toPromise=function(t){var r=this;return t=_o(t),new t(function(o,n){var i;r.subscribe(function(s){return i=s},function(s){return n(s)},function(){return o(i)})})},e.create=function(t){return new e(t)},e}();function _o(e){var t;return(t=e!=null?e:We.Promise)!==null&&t!==void 0?t:Promise}function ia(e){return e&&P(e.next)&&P(e.error)&&P(e.complete)}function aa(e){return e&&e instanceof Rt||ia(e)&&Zt(e)}function sa(e){return P(e==null?void 0:e.lift)}function E(e){return function(t){if(sa(t))return t.lift(function(r){try{return e(r,this)}catch(o){this.error(o)}});throw new TypeError("Unable to lift unknown Observable type")}}function w(e,t,r,o,n){return new ca(e,t,r,o,n)}var ca=function(e){ie(t,e);function t(r,o,n,i,s,a){var c=e.call(this,r)||this;return c.onFinalize=s,c.shouldUnsubscribe=a,c._next=o?function(p){try{o(p)}catch(l){r.error(l)}}:e.prototype._next,c._error=i?function(p){try{i(p)}catch(l){r.error(l)}finally{this.unsubscribe()}}:e.prototype._error,c._complete=n?function(){try{n()}catch(p){r.error(p)}finally{this.unsubscribe()}}:e.prototype._complete,c}return t.prototype.unsubscribe=function(){var r;if(!this.shouldUnsubscribe||this.shouldUnsubscribe()){var o=this.closed;e.prototype.unsubscribe.call(this),!o&&((r=this.onFinalize)===null||r===void 0||r.call(this))}},t}(Rt);var Tt={schedule:function(e){var t=requestAnimationFrame,r=cancelAnimationFrame,o=Tt.delegate;o&&(t=o.requestAnimationFrame,r=o.cancelAnimationFrame);var n=t(function(i){r=void 0,e(i)});return new ze(function(){return r==null?void 0:r(n)})},requestAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Tt.delegate;return((r==null?void 0:r.requestAnimationFrame)||requestAnimationFrame).apply(void 0,B([],K(e)))},cancelAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Tt.delegate;return((r==null?void 0:r.cancelAnimationFrame)||cancelAnimationFrame).apply(void 0,B([],K(e)))},delegate:void 0};var Ao=xt(function(e){return function(){e(this),this.name="ObjectUnsubscribedError",this.message="object unsubscribed"}});var T=function(e){ie(t,e);function t(){var r=e.call(this)||this;return r.closed=!1,r.currentObservers=null,r.observers=[],r.isStopped=!1,r.hasError=!1,r.thrownError=null,r}return t.prototype.lift=function(r){var o=new Co(this,this);return o.operator=r,o},t.prototype._throwIfClosed=function(){if(this.closed)throw new Ao},t.prototype.next=function(r){var o=this;Et(function(){var n,i;if(o._throwIfClosed(),!o.isStopped){o.currentObservers||(o.currentObservers=Array.from(o.observers));try{for(var s=Oe(o.currentObservers),a=s.next();!a.done;a=s.next()){var c=a.value;c.next(r)}}catch(p){n={error:p}}finally{try{a&&!a.done&&(i=s.return)&&i.call(s)}finally{if(n)throw n.error}}}})},t.prototype.error=function(r){var o=this;Et(function(){if(o._throwIfClosed(),!o.isStopped){o.hasError=o.isStopped=!0,o.thrownError=r;for(var n=o.observers;n.length;)n.shift().error(r)}})},t.prototype.complete=function(){var r=this;Et(function(){if(r._throwIfClosed(),!r.isStopped){r.isStopped=!0;for(var o=r.observers;o.length;)o.shift().complete()}})},t.prototype.unsubscribe=function(){this.isStopped=this.closed=!0,this.observers=this.currentObservers=null},Object.defineProperty(t.prototype,"observed",{get:function(){var r;return((r=this.observers)===null||r===void 0?void 0:r.length)>0},enumerable:!1,configurable:!0}),t.prototype._trySubscribe=function(r){return this._throwIfClosed(),e.prototype._trySubscribe.call(this,r)},t.prototype._subscribe=function(r){return this._throwIfClosed(),this._checkFinalizedStatuses(r),this._innerSubscribe(r)},t.prototype._innerSubscribe=function(r){var o=this,n=this,i=n.hasError,s=n.isStopped,a=n.observers;return i||s?kr:(this.currentObservers=null,a.push(r),new ze(function(){o.currentObservers=null,Xe(a,r)}))},t.prototype._checkFinalizedStatuses=function(r){var o=this,n=o.hasError,i=o.thrownError,s=o.isStopped;n?r.error(i):s&&r.complete()},t.prototype.asObservable=function(){var r=new I;return r.source=this,r},t.create=function(r,o){return new Co(r,o)},t}(I);var Co=function(e){ie(t,e);function t(r,o){var n=e.call(this)||this;return n.destination=r,n.source=o,n}return t.prototype.next=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.next)===null||n===void 0||n.call(o,r)},t.prototype.error=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.error)===null||n===void 0||n.call(o,r)},t.prototype.complete=function(){var r,o;(o=(r=this.destination)===null||r===void 0?void 0:r.complete)===null||o===void 0||o.call(r)},t.prototype._subscribe=function(r){var o,n;return(n=(o=this.source)===null||o===void 0?void 0:o.subscribe(r))!==null&&n!==void 0?n:kr},t}(T);var jr=function(e){ie(t,e);function t(r){var o=e.call(this)||this;return o._value=r,o}return Object.defineProperty(t.prototype,"value",{get:function(){return this.getValue()},enumerable:!1,configurable:!0}),t.prototype._subscribe=function(r){var o=e.prototype._subscribe.call(this,r);return!o.closed&&r.next(this._value),o},t.prototype.getValue=function(){var r=this,o=r.hasError,n=r.thrownError,i=r._value;if(o)throw n;return this._throwIfClosed(),i},t.prototype.next=function(r){e.prototype.next.call(this,this._value=r)},t}(T);var Pt={now:function(){return(Pt.delegate||Date).now()},delegate:void 0};var It=function(e){ie(t,e);function t(r,o,n){r===void 0&&(r=1/0),o===void 0&&(o=1/0),n===void 0&&(n=Pt);var i=e.call(this)||this;return i._bufferSize=r,i._windowTime=o,i._timestampProvider=n,i._buffer=[],i._infiniteTimeWindow=!0,i._infiniteTimeWindow=o===1/0,i._bufferSize=Math.max(1,r),i._windowTime=Math.max(1,o),i}return t.prototype.next=function(r){var o=this,n=o.isStopped,i=o._buffer,s=o._infiniteTimeWindow,a=o._timestampProvider,c=o._windowTime;n||(i.push(r),!s&&i.push(a.now()+c)),this._trimBuffer(),e.prototype.next.call(this,r)},t.prototype._subscribe=function(r){this._throwIfClosed(),this._trimBuffer();for(var o=this._innerSubscribe(r),n=this,i=n._infiniteTimeWindow,s=n._buffer,a=s.slice(),c=0;c<a.length&&!r.closed;c+=i?1:2)r.next(a[c]);return this._checkFinalizedStatuses(r),o},t.prototype._trimBuffer=function(){var r=this,o=r._bufferSize,n=r._timestampProvider,i=r._buffer,s=r._infiniteTimeWindow,a=(s?1:2)*o;if(o<1/0&&a<i.length&&i.splice(0,i.length-a),!s){for(var c=n.now(),p=0,l=1;l<i.length&&i[l]<=c;l+=2)p=l;p&&i.splice(0,p+1)}},t}(T);var Ho=function(e){ie(t,e);function t(r,o){return e.call(this)||this}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),this},t}(ze);var Ft={setInterval:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=Ft.delegate;return n!=null&&n.setInterval?n.setInterval.apply(n,B([e,t],K(r))):setInterval.apply(void 0,B([e,t],K(r)))},clearInterval:function(e){var t=Ft.delegate;return((t==null?void 0:t.clearInterval)||clearInterval)(e)},delegate:void 0};var St=function(e){ie(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n.pending=!1,n}return t.prototype.schedule=function(r,o){var n;if(o===void 0&&(o=0),this.closed)return this;this.state=r;var i=this.id,s=this.scheduler;return i!=null&&(this.id=this.recycleAsyncId(s,i,o)),this.pending=!0,this.delay=o,this.id=(n=this.id)!==null&&n!==void 0?n:this.requestAsyncId(s,this.id,o),this},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),Ft.setInterval(r.flush.bind(r,this),n)},t.prototype.recycleAsyncId=function(r,o,n){if(n===void 0&&(n=0),n!=null&&this.delay===n&&this.pending===!1)return o;o!=null&&Ft.clearInterval(o)},t.prototype.execute=function(r,o){if(this.closed)return new Error("executing a cancelled action");this.pending=!1;var n=this._execute(r,o);if(n)return n;this.pending===!1&&this.id!=null&&(this.id=this.recycleAsyncId(this.scheduler,this.id,null))},t.prototype._execute=function(r,o){var n=!1,i;try{this.work(r)}catch(s){n=!0,i=s||new Error("Scheduled action threw falsy error")}if(n)return this.unsubscribe(),i},t.prototype.unsubscribe=function(){if(!this.closed){var r=this,o=r.id,n=r.scheduler,i=n.actions;this.work=this.state=this.scheduler=null,this.pending=!1,Xe(i,this),o!=null&&(this.id=this.recycleAsyncId(n,o,null)),this.delay=null,e.prototype.unsubscribe.call(this)}},t}(Ho);var Ur=function(){function e(t,r){r===void 0&&(r=e.now),this.schedulerActionCtor=t,this.now=r}return e.prototype.schedule=function(t,r,o){return r===void 0&&(r=0),new this.schedulerActionCtor(this,t).schedule(o,r)},e.now=Pt.now,e}();var Ot=function(e){ie(t,e);function t(r,o){o===void 0&&(o=Ur.now);var n=e.call(this,r,o)||this;return n.actions=[],n._active=!1,n}return t.prototype.flush=function(r){var o=this.actions;if(this._active){o.push(r);return}var n;this._active=!0;do if(n=r.execute(r.state,r.delay))break;while(r=o.shift());if(this._active=!1,n){for(;r=o.shift();)r.unsubscribe();throw n}},t}(Ur);var pe=new Ot(St),Wr=pe;var $o=function(e){ie(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),o>0?e.prototype.schedule.call(this,r,o):(this.delay=o,this.state=r,this.scheduler.flush(this),this)},t.prototype.execute=function(r,o){return o>0||this.closed?e.prototype.execute.call(this,r,o):this._execute(r,o)},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!=null&&n>0||n==null&&this.delay>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.flush(this),0)},t}(St);var ko=function(e){ie(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t}(Ot);var Dr=new ko($o);var Ro=function(e){ie(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!==null&&n>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.actions.push(this),r._scheduled||(r._scheduled=Tt.requestAnimationFrame(function(){return r.flush(void 0)})))},t.prototype.recycleAsyncId=function(r,o,n){var i;if(n===void 0&&(n=0),n!=null?n>0:this.delay>0)return e.prototype.recycleAsyncId.call(this,r,o,n);var s=r.actions;o!=null&&((i=s[s.length-1])===null||i===void 0?void 0:i.id)!==o&&(Tt.cancelAnimationFrame(o),r._scheduled=void 0)},t}(St);var Po=function(e){ie(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t.prototype.flush=function(r){this._active=!0;var o=this._scheduled;this._scheduled=void 0;var n=this.actions,i;r=r||n.shift();do if(i=r.execute(r.state,r.delay))break;while((r=n[0])&&r.id===o&&n.shift());if(this._active=!1,i){for(;(r=n[0])&&r.id===o&&n.shift();)r.unsubscribe();throw i}},t}(Ot);var ge=new Po(Ro);var x=new I(function(e){return e.complete()});function rr(e){return e&&P(e.schedule)}function Nr(e){return e[e.length-1]}function ct(e){return P(Nr(e))?e.pop():void 0}function Ie(e){return rr(Nr(e))?e.pop():void 0}function or(e,t){return typeof Nr(e)=="number"?e.pop():t}var Lt=function(e){return e&&typeof e.length=="number"&&typeof e!="function"};function nr(e){return P(e==null?void 0:e.then)}function ir(e){return P(e[wt])}function ar(e){return Symbol.asyncIterator&&P(e==null?void 0:e[Symbol.asyncIterator])}function sr(e){return new TypeError("You provided "+(e!==null&&typeof e=="object"?"an invalid object":"'"+e+"'")+" where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.")}function pa(){return typeof Symbol!="function"||!Symbol.iterator?"@@iterator":Symbol.iterator}var cr=pa();function pr(e){return P(e==null?void 0:e[cr])}function lr(e){return yo(this,arguments,function(){var r,o,n,i;return Jt(this,function(s){switch(s.label){case 0:r=e.getReader(),s.label=1;case 1:s.trys.push([1,,9,10]),s.label=2;case 2:return[4,ut(r.read())];case 3:return o=s.sent(),n=o.value,i=o.done,i?[4,ut(void 0)]:[3,5];case 4:return[2,s.sent()];case 5:return[4,ut(n)];case 6:return[4,s.sent()];case 7:return s.sent(),[3,2];case 8:return[3,10];case 9:return r.releaseLock(),[7];case 10:return[2]}})})}function mr(e){return P(e==null?void 0:e.getReader)}function U(e){if(e instanceof I)return e;if(e!=null){if(ir(e))return la(e);if(Lt(e))return ma(e);if(nr(e))return fa(e);if(ar(e))return Io(e);if(pr(e))return ua(e);if(mr(e))return da(e)}throw sr(e)}function la(e){return new I(function(t){var r=e[wt]();if(P(r.subscribe))return r.subscribe(t);throw new TypeError("Provided object does not correctly implement Symbol.observable")})}function ma(e){return new I(function(t){for(var r=0;r<e.length&&!t.closed;r++)t.next(e[r]);t.complete()})}function fa(e){return new I(function(t){e.then(function(r){t.closed||(t.next(r),t.complete())},function(r){return t.error(r)}).then(null,er)})}function ua(e){return new I(function(t){var r,o;try{for(var n=Oe(e),i=n.next();!i.done;i=n.next()){var s=i.value;if(t.next(s),t.closed)return}}catch(a){r={error:a}}finally{try{i&&!i.done&&(o=n.return)&&o.call(n)}finally{if(r)throw r.error}}t.complete()})}function Io(e){return new I(function(t){ha(e,t).catch(function(r){return t.error(r)})})}function da(e){return Io(lr(e))}function ha(e,t){var r,o,n,i;return xo(this,void 0,void 0,function(){var s,a;return Jt(this,function(c){switch(c.label){case 0:c.trys.push([0,5,6,11]),r=Eo(e),c.label=1;case 1:return[4,r.next()];case 2:if(o=c.sent(),!!o.done)return[3,4];if(s=o.value,t.next(s),t.closed)return[2];c.label=3;case 3:return[3,1];case 4:return[3,11];case 5:return a=c.sent(),n={error:a},[3,11];case 6:return c.trys.push([6,,9,10]),o&&!o.done&&(i=r.return)?[4,i.call(r)]:[3,8];case 7:c.sent(),c.label=8;case 8:return[3,10];case 9:if(n)throw n.error;return[7];case 10:return[7];case 11:return t.complete(),[2]}})})}function _e(e,t,r,o,n){o===void 0&&(o=0),n===void 0&&(n=!1);var i=t.schedule(function(){r(),n?e.add(this.schedule(null,o)):this.unsubscribe()},o);if(e.add(i),!n)return i}function xe(e,t){return t===void 0&&(t=0),E(function(r,o){r.subscribe(w(o,function(n){return _e(o,e,function(){return o.next(n)},t)},function(){return _e(o,e,function(){return o.complete()},t)},function(n){return _e(o,e,function(){return o.error(n)},t)}))})}function Ze(e,t){return t===void 0&&(t=0),E(function(r,o){o.add(e.schedule(function(){return r.subscribe(o)},t))})}function Fo(e,t){return U(e).pipe(Ze(t),xe(t))}function jo(e,t){return U(e).pipe(Ze(t),xe(t))}function Uo(e,t){return new I(function(r){var o=0;return t.schedule(function(){o===e.length?r.complete():(r.next(e[o++]),r.closed||this.schedule())})})}function Wo(e,t){return new I(function(r){var o;return _e(r,t,function(){o=e[cr](),_e(r,t,function(){var n,i,s;try{n=o.next(),i=n.value,s=n.done}catch(a){r.error(a);return}s?r.complete():r.next(i)},0,!0)}),function(){return P(o==null?void 0:o.return)&&o.return()}})}function fr(e,t){if(!e)throw new Error("Iterable cannot be null");return new I(function(r){_e(r,t,function(){var o=e[Symbol.asyncIterator]();_e(r,t,function(){o.next().then(function(n){n.done?r.complete():r.next(n.value)})},0,!0)})})}function Do(e,t){return fr(lr(e),t)}function No(e,t){if(e!=null){if(ir(e))return Fo(e,t);if(Lt(e))return Uo(e,t);if(nr(e))return jo(e,t);if(ar(e))return fr(e,t);if(pr(e))return Wo(e,t);if(mr(e))return Do(e,t)}throw sr(e)}function fe(e,t){return t?No(e,t):U(e)}function k(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ie(e);return fe(e,r)}function Vr(e,t){var r=P(e)?e:function(){return e},o=function(n){return n.error(r())};return new I(t?function(n){return t.schedule(o,0,n)}:o)}var ur=xt(function(e){return function(){e(this),this.name="EmptyError",this.message="no elements in sequence"}});function Vo(e){return e instanceof Date&&!isNaN(e)}function m(e,t){return E(function(r,o){var n=0;r.subscribe(w(o,function(i){o.next(e.call(t,i,n++))}))})}var ba=Array.isArray;function va(e,t){return ba(t)?e.apply(void 0,B([],K(t))):e(t)}function pt(e){return m(function(t){return va(e,t)})}var ga=Array.isArray,xa=Object.getPrototypeOf,ya=Object.prototype,Ea=Object.keys;function zo(e){if(e.length===1){var t=e[0];if(ga(t))return{args:t,keys:null};if(wa(t)){var r=Ea(t);return{args:r.map(function(o){return t[o]}),keys:r}}}return{args:e,keys:null}}function wa(e){return e&&typeof e=="object"&&xa(e)===ya}function qo(e,t){return e.reduce(function(r,o,n){return r[o]=t[n],r},{})}function z(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ie(e),o=ct(e),n=zo(e),i=n.args,s=n.keys;if(i.length===0)return fe([],r);var a=new I(zr(i,r,s?function(c){return qo(s,c)}:be));return o?a.pipe(pt(o)):a}function zr(e,t,r){return r===void 0&&(r=be),function(o){Ko(t,function(){for(var n=e.length,i=new Array(n),s=n,a=n,c=function(l){Ko(t,function(){var f=fe(e[l],t),u=!1;f.subscribe(w(o,function(d){i[l]=d,u||(u=!0,a--),a||o.next(r(i.slice()))},function(){--s||o.complete()}))},o)},p=0;p<n;p++)c(p)},o)}}function Ko(e,t,r){e?_e(r,e,t):t()}function Qo(e,t,r,o,n,i,s,a){var c=[],p=0,l=0,f=!1,u=function(){f&&!c.length&&!p&&t.complete()},d=function(L){return p<o?g(L):c.push(L)},g=function(L){i&&t.next(L),p++;var ee=!1;U(r(L,l++)).subscribe(w(t,function(ne){n==null||n(ne),i?d(ne):t.next(ne)},function(){ee=!0},void 0,function(){if(ee)try{p--;for(var ne=function(){var Z=c.shift();s?_e(t,s,function(){return g(Z)}):g(Z)};c.length&&p<o;)ne();u()}catch(Z){t.error(Z)}}))};return e.subscribe(w(t,d,function(){f=!0,u()})),function(){a==null||a()}}function J(e,t,r){return r===void 0&&(r=1/0),P(t)?J(function(o,n){return m(function(i,s){return t(o,i,n,s)})(U(e(o,n)))},r):(typeof t=="number"&&(r=t),E(function(o,n){return Qo(o,n,e,r)}))}function Mt(e){return e===void 0&&(e=1/0),J(be,e)}function Yo(){return Mt(1)}function qe(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Yo()(fe(e,Ie(e)))}function $(e){return new I(function(t){U(e()).subscribe(t)})}var Ta=["addListener","removeListener"],Sa=["addEventListener","removeEventListener"],Oa=["on","off"];function h(e,t,r,o){if(P(r)&&(o=r,r=void 0),o)return h(e,t,r).pipe(pt(o));var n=K(_a(e)?Sa.map(function(a){return function(c){return e[a](t,c,r)}}):La(e)?Ta.map(Bo(e,t)):Ma(e)?Oa.map(Bo(e,t)):[],2),i=n[0],s=n[1];if(!i&&Lt(e))return J(function(a){return h(a,t,r)})(U(e));if(!i)throw new TypeError("Invalid event target");return new I(function(a){var c=function(){for(var p=[],l=0;l<arguments.length;l++)p[l]=arguments[l];return a.next(1<p.length?p:p[0])};return i(c),function(){return s(c)}})}function Bo(e,t){return function(r){return function(o){return e[r](t,o)}}}function La(e){return P(e.addListener)&&P(e.removeListener)}function Ma(e){return P(e.on)&&P(e.off)}function _a(e){return P(e.addEventListener)&&P(e.removeEventListener)}function dr(e,t,r){return r?dr(e,t).pipe(pt(r)):new I(function(o){var n=function(){for(var s=[],a=0;a<arguments.length;a++)s[a]=arguments[a];return o.next(s.length===1?s[0]:s)},i=e(n);return P(t)?function(){return t(n,i)}:void 0})}function $e(e,t,r){e===void 0&&(e=0),r===void 0&&(r=Wr);var o=-1;return t!=null&&(rr(t)?r=t:o=t),new I(function(n){var i=Vo(e)?+e-r.now():e;i<0&&(i=0);var s=0;return r.schedule(function(){n.closed||(n.next(s++),0<=o?this.schedule(void 0,o):n.complete())},i)})}function O(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ie(e),o=or(e,1/0),n=e;return n.length?n.length===1?U(n[0]):Mt(o)(fe(n,r)):x}var et=new I(ve);var Aa=Array.isArray;function _t(e){return e.length===1&&Aa(e[0])?e[0]:e}function v(e,t){return E(function(r,o){var n=0;r.subscribe(w(o,function(i){return e.call(t,i,n++)&&o.next(i)}))})}function bt(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ct(e),o=_t(e);return o.length?new I(function(n){var i=o.map(function(){return[]}),s=o.map(function(){return!1});n.add(function(){i=s=null});for(var a=function(p){U(o[p]).subscribe(w(n,function(l){if(i[p].push(l),i.every(function(u){return u.length})){var f=i.map(function(u){return u.shift()});n.next(r?r.apply(void 0,B([],K(f))):f),i.some(function(u,d){return!u.length&&s[d]})&&n.complete()}},function(){s[p]=!0,!i[p].length&&n.complete()}))},c=0;!n.closed&&c<o.length;c++)a(c);return function(){i=s=null}}):x}function Go(e){return E(function(t,r){var o=!1,n=null,i=null,s=!1,a=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var p=n;n=null,r.next(p)}s&&r.complete()},c=function(){i=null,s&&r.complete()};t.subscribe(w(r,function(p){o=!0,n=p,i||U(e(p)).subscribe(i=w(r,a,c))},function(){s=!0,(!o||!i||i.closed)&&r.complete()}))})}function ke(e,t){return t===void 0&&(t=pe),Go(function(){return $e(e,t)})}function tt(e,t){return t===void 0&&(t=null),t=t!=null?t:e,E(function(r,o){var n=[],i=0;r.subscribe(w(o,function(s){var a,c,p,l,f=null;i++%t===0&&n.push([]);try{for(var u=Oe(n),d=u.next();!d.done;d=u.next()){var g=d.value;g.push(s),e<=g.length&&(f=f!=null?f:[],f.push(g))}}catch(ne){a={error:ne}}finally{try{d&&!d.done&&(c=u.return)&&c.call(u)}finally{if(a)throw a.error}}if(f)try{for(var L=Oe(f),ee=L.next();!ee.done;ee=L.next()){var g=ee.value;Xe(n,g),o.next(g)}}catch(ne){p={error:ne}}finally{try{ee&&!ee.done&&(l=L.return)&&l.call(L)}finally{if(p)throw p.error}}},function(){var s,a;try{for(var c=Oe(n),p=c.next();!p.done;p=c.next()){var l=p.value;o.next(l)}}catch(f){s={error:f}}finally{try{p&&!p.done&&(a=c.return)&&a.call(c)}finally{if(s)throw s.error}}o.complete()},void 0,function(){n=null}))})}function ye(e){return E(function(t,r){var o=null,n=!1,i;o=t.subscribe(w(r,void 0,void 0,function(s){i=U(e(s,ye(e)(t))),o?(o.unsubscribe(),o=null,i.subscribe(r)):n=!0})),n&&(o.unsubscribe(),o=null,i.subscribe(r))})}function Jo(e,t,r,o,n){return function(i,s){var a=r,c=t,p=0;i.subscribe(w(s,function(l){var f=p++;c=a?e(c,l,f):(a=!0,l),o&&s.next(c)},n&&function(){a&&s.next(c),s.complete()}))}}function qr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ct(e);return r?Mo(qr.apply(void 0,B([],K(e))),pt(r)):E(function(o,n){zr(B([o],K(_t(e))))(n)})}function De(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return qr.apply(void 0,B([],K(e)))}function jt(e){return E(function(t,r){var o=!1,n=null,i=null,s=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var a=n;n=null,r.next(a)}};t.subscribe(w(r,function(a){i==null||i.unsubscribe(),o=!0,n=a,i=w(r,s,ve),U(e(a)).subscribe(i)},function(){s(),r.complete()},void 0,function(){n=i=null}))})}function Ae(e,t){return t===void 0&&(t=pe),E(function(r,o){var n=null,i=null,s=null,a=function(){if(n){n.unsubscribe(),n=null;var p=i;i=null,o.next(p)}};function c(){var p=s+e,l=t.now();if(l<p){n=this.schedule(void 0,p-l),o.add(n);return}a()}r.subscribe(w(o,function(p){i=p,s=t.now(),n||(n=t.schedule(c,e),o.add(n))},function(){a(),o.complete()},void 0,function(){i=n=null}))})}function rt(e){return E(function(t,r){var o=!1;t.subscribe(w(r,function(n){o=!0,r.next(n)},function(){o||r.next(e),r.complete()}))})}function Ee(e){return e<=0?function(){return x}:E(function(t,r){var o=0;t.subscribe(w(r,function(n){++o<=e&&(r.next(n),e<=o&&r.complete())}))})}function re(){return E(function(e,t){e.subscribe(w(t,ve))})}function Xo(e){return m(function(){return e})}function Kr(e,t){return t?function(r){return qe(t.pipe(Ee(1),re()),r.pipe(Kr(e)))}:J(function(r,o){return U(e(r,o)).pipe(Ee(1),Xo(r))})}function ot(e,t){t===void 0&&(t=pe);var r=$e(e,t);return Kr(function(){return r})}function Qr(e,t){return E(function(r,o){var n=new Set;r.subscribe(w(o,function(i){var s=e?e(i):i;n.has(s)||(n.add(s),o.next(i))})),t&&U(t).subscribe(w(o,function(){return n.clear()},ve))})}function Y(e,t){return t===void 0&&(t=be),e=e!=null?e:Ca,E(function(r,o){var n,i=!0;r.subscribe(w(o,function(s){var a=t(s);(i||!e(n,a))&&(i=!1,n=a,o.next(s))}))})}function Ca(e,t){return e===t}function oe(e,t){return Y(function(r,o){return t?t(r[e],o[e]):r[e]===o[e]})}function Zo(e){return e===void 0&&(e=Ha),E(function(t,r){var o=!1;t.subscribe(w(r,function(n){o=!0,r.next(n)},function(){return o?r.complete():r.error(e())}))})}function Ha(){return new ur}function ae(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return function(r){return qe(r,k.apply(void 0,B([],K(e))))}}function hr(e,t){return t?function(r){return r.pipe(hr(function(o,n){return U(e(o,n)).pipe(m(function(i,s){return t(o,i,n,s)}))}))}:E(function(r,o){var n=0,i=null,s=!1;r.subscribe(w(o,function(a){i||(i=w(o,void 0,function(){i=null,s&&o.complete()}),U(e(a,n++)).subscribe(i))},function(){s=!0,!i&&o.complete()}))})}function A(e){return E(function(t,r){try{t.subscribe(r)}finally{r.add(e)}})}function Re(e,t){var r=arguments.length>=2;return function(o){return o.pipe(e?v(function(n,i){return e(n,i,o)}):be,Ee(1),r?rt(t):Zo(function(){return new ur}))}}function Yr(e){return e<=0?function(){return x}:E(function(t,r){var o=[];t.subscribe(w(r,function(n){o.push(n),e<o.length&&o.shift()},function(){var n,i;try{for(var s=Oe(o),a=s.next();!a.done;a=s.next()){var c=a.value;r.next(c)}}catch(p){n={error:p}}finally{try{a&&!a.done&&(i=s.return)&&i.call(s)}finally{if(n)throw n.error}}r.complete()},void 0,function(){o=null}))})}function en(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ie(e),o=or(e,1/0);return e=_t(e),E(function(n,i){Mt(o)(fe(B([n],K(e)),r)).subscribe(i)})}function Ne(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return en.apply(void 0,B([],K(e)))}function vt(e){var t,r=1/0,o;return e!=null&&(typeof e=="object"?(t=e.count,r=t===void 0?1/0:t,o=e.delay):r=e),r<=0?function(){return x}:E(function(n,i){var s=0,a,c=function(){if(a==null||a.unsubscribe(),a=null,o!=null){var l=typeof o=="number"?$e(o):U(o(s)),f=w(i,function(){f.unsubscribe(),p()});l.subscribe(f)}else p()},p=function(){var l=!1;a=n.subscribe(w(i,void 0,function(){++s<r?a?c():l=!0:i.complete()})),l&&c()};p()})}function Ut(e,t){return E(Jo(e,t,arguments.length>=2,!0))}function le(e){e===void 0&&(e={});var t=e.connector,r=t===void 0?function(){return new T}:t,o=e.resetOnError,n=o===void 0?!0:o,i=e.resetOnComplete,s=i===void 0?!0:i,a=e.resetOnRefCountZero,c=a===void 0?!0:a;return function(p){var l,f,u,d=0,g=!1,L=!1,ee=function(){f==null||f.unsubscribe(),f=void 0},ne=function(){ee(),l=u=void 0,g=L=!1},Z=function(){var H=l;ne(),H==null||H.unsubscribe()};return E(function(H,ft){d++,!L&&!g&&ee();var Fe=u=u!=null?u:r();ft.add(function(){d--,d===0&&!L&&!g&&(f=Br(Z,c))}),Fe.subscribe(ft),!l&&d>0&&(l=new ht({next:function(R){return Fe.next(R)},error:function(R){L=!0,ee(),f=Br(ne,n,R),Fe.error(R)},complete:function(){g=!0,ee(),f=Br(ne,s),Fe.complete()}}),U(H).subscribe(l))})(p)}}function Br(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];if(t===!0){e();return}if(t!==!1){var n=new ht({next:function(){n.unsubscribe(),e()}});return U(t.apply(void 0,B([],K(r)))).subscribe(n)}}function X(e,t,r){var o,n,i,s,a=!1;return e&&typeof e=="object"?(o=e.bufferSize,s=o===void 0?1/0:o,n=e.windowTime,t=n===void 0?1/0:n,i=e.refCount,a=i===void 0?!1:i,r=e.scheduler):s=e!=null?e:1/0,le({connector:function(){return new It(s,t,r)},resetOnError:!0,resetOnComplete:!1,resetOnRefCountZero:a})}function Pe(e){return v(function(t,r){return e<=r})}function Gr(e){return E(function(t,r){var o=!1,n=w(r,function(){n==null||n.unsubscribe(),o=!0},ve);U(e).subscribe(n),t.subscribe(w(r,function(i){return o&&r.next(i)}))})}function Q(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ie(e);return E(function(o,n){(r?qe(e,o,r):qe(e,o)).subscribe(n)})}function b(e,t){return E(function(r,o){var n=null,i=0,s=!1,a=function(){return s&&!n&&o.complete()};r.subscribe(w(o,function(c){n==null||n.unsubscribe();var p=0,l=i++;U(e(c,l)).subscribe(n=w(o,function(f){return o.next(t?t(c,f,l,p++):f)},function(){n=null,a()}))},function(){s=!0,a()}))})}function W(e){return E(function(t,r){U(e).subscribe(w(r,function(){return r.complete()},ve)),!r.closed&&t.subscribe(r)})}function Jr(e,t){return t===void 0&&(t=!1),E(function(r,o){var n=0;r.subscribe(w(o,function(i){var s=e(i,n++);(s||t)&&o.next(i),!s&&o.complete()}))})}function S(e,t,r){var o=P(e)||t||r?{next:e,error:t,complete:r}:e;return o?E(function(n,i){var s;(s=o.subscribe)===null||s===void 0||s.call(o);var a=!0;n.subscribe(w(i,function(c){var p;(p=o.next)===null||p===void 0||p.call(o,c),i.next(c)},function(){var c;a=!1,(c=o.complete)===null||c===void 0||c.call(o),i.complete()},function(c){var p;a=!1,(p=o.error)===null||p===void 0||p.call(o,c),i.error(c)},function(){var c,p;a&&((c=o.unsubscribe)===null||c===void 0||c.call(o)),(p=o.finalize)===null||p===void 0||p.call(o)}))}):be}function tn(e,t){return E(function(r,o){var n=t!=null?t:{},i=n.leading,s=i===void 0?!0:i,a=n.trailing,c=a===void 0?!1:a,p=!1,l=null,f=null,u=!1,d=function(){f==null||f.unsubscribe(),f=null,c&&(ee(),u&&o.complete())},g=function(){f=null,u&&o.complete()},L=function(ne){return f=U(e(ne)).subscribe(w(o,d,g))},ee=function(){if(p){p=!1;var ne=l;l=null,o.next(ne),!u&&L(ne)}};r.subscribe(w(o,function(ne){p=!0,l=ne,!(f&&!f.closed)&&(s?ee():L(ne))},function(){u=!0,!(c&&p&&f&&!f.closed)&&o.complete()}))})}function gt(e,t,r){t===void 0&&(t=pe);var o=$e(e,t);return tn(function(){return o},r)}function te(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ct(e);return E(function(o,n){for(var i=e.length,s=new Array(i),a=e.map(function(){return!1}),c=!1,p=function(f){U(e[f]).subscribe(w(n,function(u){s[f]=u,!c&&!a[f]&&(a[f]=!0,(c=a.every(be))&&(a=null))},ve))},l=0;l<i;l++)p(l);o.subscribe(w(n,function(f){if(c){var u=B([f],K(s));n.next(r?r.apply(void 0,B([],K(u))):u)}}))})}function rn(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return E(function(r,o){bt.apply(void 0,B([r],K(e))).subscribe(o)})}function Xr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return rn.apply(void 0,B([],K(e)))}function on(){let e=new It(1);return h(document,"DOMContentLoaded",{once:!0}).subscribe(()=>e.next(document)),e}function M(e,t=document){return Array.from(t.querySelectorAll(e))}function F(e,t=document){let r=ue(e,t);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${e}" to be present`);return r}function ue(e,t=document){return t.querySelector(e)||void 0}function Ve(){var e,t,r,o;return(o=(r=(t=(e=document.activeElement)==null?void 0:e.shadowRoot)==null?void 0:t.activeElement)!=null?r:document.activeElement)!=null?o:void 0}var $a=O(h(document.body,"focusin"),h(document.body,"focusout")).pipe(Ae(1),Q(void 0),m(()=>Ve()||document.body),X(1));function Ke(e){return $a.pipe(m(t=>e.contains(t)),Y())}function nt(e,t){return $(()=>O(h(e,"mouseenter").pipe(m(()=>!0)),h(e,"mouseleave").pipe(m(()=>!1))).pipe(t?jt(r=>$e(+!r*t)):be,Q(e.matches(":hover"))))}function nn(e,t){if(typeof t=="string"||typeof t=="number")e.innerHTML+=t.toString();else if(t instanceof Node)e.appendChild(t);else if(Array.isArray(t))for(let r of t)nn(e,r)}function y(e,t,...r){let o=document.createElement(e);if(t)for(let n of Object.keys(t))typeof t[n]!="undefined"&&(typeof t[n]!="boolean"?o.setAttribute(n,t[n]):o.setAttribute(n,""));for(let n of r)nn(o,n);return o}function br(e){if(e>999){let t=+((e-950)%1e3>99);return`${((e+1e-6)/1e3).toFixed(t)}k`}else return e.toString()}function At(e){let t=y("script",{src:e});return $(()=>(document.head.appendChild(t),O(h(t,"load"),h(t,"error").pipe(b(()=>Vr(()=>new ReferenceError(`Invalid script: ${e}`))))).pipe(m(()=>{}),A(()=>document.head.removeChild(t)),Ee(1))))}var an=new T,ka=$(()=>typeof ResizeObserver=="undefined"?At("https://unpkg.com/resize-observer-polyfill"):k(void 0)).pipe(m(()=>new ResizeObserver(e=>e.forEach(t=>an.next(t)))),b(e=>O(et,k(e)).pipe(A(()=>e.disconnect()))),X(1));function de(e){return{width:e.offsetWidth,height:e.offsetHeight}}function Le(e){let t=e;for(;t.clientWidth===0&&t.parentElement;)t=t.parentElement;return ka.pipe(S(r=>r.observe(t)),b(r=>an.pipe(v(o=>o.target===t),A(()=>r.unobserve(t)))),m(()=>de(e)),Q(de(e)))}function Ct(e){return{width:e.scrollWidth,height:e.scrollHeight}}function vr(e){let t=e.parentElement;for(;t&&(e.scrollWidth<=t.scrollWidth&&e.scrollHeight<=t.scrollHeight);)t=(e=t).parentElement;return t?e:void 0}function sn(e){let t=[],r=e.parentElement;for(;r;)(e.clientWidth>r.clientWidth||e.clientHeight>r.clientHeight)&&t.push(r),r=(e=r).parentElement;return t.length===0&&t.push(document.documentElement),t}function Qe(e){return{x:e.offsetLeft,y:e.offsetTop}}function cn(e){let t=e.getBoundingClientRect();return{x:t.x+window.scrollX,y:t.y+window.scrollY}}function pn(e){return O(h(window,"load"),h(window,"resize")).pipe(ke(0,ge),m(()=>Qe(e)),Q(Qe(e)))}function gr(e){return{x:e.scrollLeft,y:e.scrollTop}}function Ye(e){return O(h(e,"scroll"),h(window,"scroll"),h(window,"resize")).pipe(ke(0,ge),m(()=>gr(e)),Q(gr(e)))}var ln=new T,Ra=$(()=>k(new IntersectionObserver(e=>{for(let t of e)ln.next(t)},{threshold:0}))).pipe(b(e=>O(et,k(e)).pipe(A(()=>e.disconnect()))),X(1));function lt(e){return Ra.pipe(S(t=>t.observe(e)),b(t=>ln.pipe(v(({target:r})=>r===e),A(()=>t.unobserve(e)),m(({isIntersecting:r})=>r))))}function mn(e,t=16){return Ye(e).pipe(m(({y:r})=>{let o=de(e),n=Ct(e);return r>=n.height-o.height-t}),Y())}var xr={drawer:F("[data-md-toggle=drawer]"),search:F("[data-md-toggle=search]")};function fn(e){return xr[e].checked}function it(e,t){xr[e].checked!==t&&xr[e].click()}function Be(e){let t=xr[e];return h(t,"change").pipe(m(()=>t.checked),Q(t.checked))}function Pa(e,t){switch(e.constructor){case HTMLInputElement:return e.type==="radio"?/^Arrow/.test(t):!0;case HTMLSelectElement:case HTMLTextAreaElement:return!0;default:return e.isContentEditable}}function Ia(){return O(h(window,"compositionstart").pipe(m(()=>!0)),h(window,"compositionend").pipe(m(()=>!1))).pipe(Q(!1))}function un(){let e=h(window,"keydown").pipe(v(t=>!(t.metaKey||t.ctrlKey)),m(t=>({mode:fn("search")?"search":"global",type:t.key,claim(){t.preventDefault(),t.stopPropagation()}})),v(({mode:t,type:r})=>{if(t==="global"){let o=Ve();if(typeof o!="undefined")return!Pa(o,r)}return!0}),le());return Ia().pipe(b(t=>t?x:e))}function we(){return new URL(location.href)}function at(e,t=!1){if(N("navigation.instant")&&!t){let r=y("a",{href:e.href});document.body.appendChild(r),r.click(),r.remove()}else location.href=e.href}function dn(){return new T}function hn(){return location.hash.slice(1)}function bn(e){let t=y("a",{href:e});t.addEventListener("click",r=>r.stopPropagation()),t.click()}function Zr(e){return O(h(window,"hashchange"),e).pipe(m(hn),Q(hn()),v(t=>t.length>0),X(1))}function vn(e){return Zr(e).pipe(m(t=>ue(`[id="${t}"]`)),v(t=>typeof t!="undefined"))}function Wt(e){let t=matchMedia(e);return dr(r=>t.addListener(()=>r(t.matches))).pipe(Q(t.matches))}function gn(){let e=matchMedia("print");return O(h(window,"beforeprint").pipe(m(()=>!0)),h(window,"afterprint").pipe(m(()=>!1))).pipe(Q(e.matches))}function eo(e,t){return e.pipe(b(r=>r?t():x))}function to(e,t){return new I(r=>{let o=new XMLHttpRequest;return o.open("GET",`${e}`),o.responseType="blob",o.addEventListener("load",()=>{o.status>=200&&o.status<300?(r.next(o.response),r.complete()):r.error(new Error(o.statusText))}),o.addEventListener("error",()=>{r.error(new Error("Network error"))}),o.addEventListener("abort",()=>{r.complete()}),typeof(t==null?void 0:t.progress$)!="undefined"&&(o.addEventListener("progress",n=>{var i;if(n.lengthComputable)t.progress$.next(n.loaded/n.total*100);else{let s=(i=o.getResponseHeader("Content-Length"))!=null?i:0;t.progress$.next(n.loaded/+s*100)}}),t.progress$.next(5)),o.send(),()=>o.abort()})}function Ge(e,t){return to(e,t).pipe(b(r=>r.text()),m(r=>JSON.parse(r)),X(1))}function yr(e,t){let r=new DOMParser;return to(e,t).pipe(b(o=>o.text()),m(o=>r.parseFromString(o,"text/html")),X(1))}function xn(e,t){let r=new DOMParser;return to(e,t).pipe(b(o=>o.text()),m(o=>r.parseFromString(o,"text/xml")),X(1))}function yn(){return{x:Math.max(0,scrollX),y:Math.max(0,scrollY)}}function En(){return O(h(window,"scroll",{passive:!0}),h(window,"resize",{passive:!0})).pipe(m(yn),Q(yn()))}function wn(){return{width:innerWidth,height:innerHeight}}function Tn(){return h(window,"resize",{passive:!0}).pipe(m(wn),Q(wn()))}function Sn(){return z([En(),Tn()]).pipe(m(([e,t])=>({offset:e,size:t})),X(1))}function Er(e,{viewport$:t,header$:r}){let o=t.pipe(oe("size")),n=z([o,r]).pipe(m(()=>Qe(e)));return z([r,t,n]).pipe(m(([{height:i},{offset:s,size:a},{x:c,y:p}])=>({offset:{x:s.x-c,y:s.y-p+i},size:a})))}function Fa(e){return h(e,"message",t=>t.data)}function ja(e){let t=new T;return t.subscribe(r=>e.postMessage(r)),t}function On(e,t=new Worker(e)){let r=Fa(t),o=ja(t),n=new T;n.subscribe(o);let i=o.pipe(re(),ae(!0));return n.pipe(re(),Ne(r.pipe(W(i))),le())}var Ua=F("#__config"),Ht=JSON.parse(Ua.textContent);Ht.base=`${new URL(Ht.base,we())}`;function Te(){return Ht}function N(e){return Ht.features.includes(e)}function Me(e,t){return typeof t!="undefined"?Ht.translations[e].replace("#",t.toString()):Ht.translations[e]}function Ce(e,t=document){return F(`[data-md-component=${e}]`,t)}function me(e,t=document){return M(`[data-md-component=${e}]`,t)}function Wa(e){let t=F(".md-typeset > :first-child",e);return h(t,"click",{once:!0}).pipe(m(()=>F(".md-typeset",e)),m(r=>({hash:__md_hash(r.innerHTML)})))}function Ln(e){if(!N("announce.dismiss")||!e.childElementCount)return x;if(!e.hidden){let t=F(".md-typeset",e);__md_hash(t.innerHTML)===__md_get("__announce")&&(e.hidden=!0)}return $(()=>{let t=new T;return t.subscribe(({hash:r})=>{e.hidden=!0,__md_set("__announce",r)}),Wa(e).pipe(S(r=>t.next(r)),A(()=>t.complete()),m(r=>j({ref:e},r)))})}function Da(e,{target$:t}){return t.pipe(m(r=>({hidden:r!==e})))}function Mn(e,t){let r=new T;return r.subscribe(({hidden:o})=>{e.hidden=o}),Da(e,t).pipe(S(o=>r.next(o)),A(()=>r.complete()),m(o=>j({ref:e},o)))}function Dt(e,t){return t==="inline"?y("div",{class:"md-tooltip md-tooltip--inline",id:e,role:"tooltip"},y("div",{class:"md-tooltip__inner md-typeset"})):y("div",{class:"md-tooltip",id:e,role:"tooltip"},y("div",{class:"md-tooltip__inner md-typeset"}))}function wr(...e){return y("div",{class:"md-tooltip2",role:"dialog"},y("div",{class:"md-tooltip2__inner md-typeset"},e))}function _n(...e){return y("div",{class:"md-tooltip2",role:"tooltip"},y("div",{class:"md-tooltip2__inner md-typeset"},e))}function An(e,t){if(t=t?`${t}_annotation_${e}`:void 0,t){let r=t?`#${t}`:void 0;return y("aside",{class:"md-annotation",tabIndex:0},Dt(t),y("a",{href:r,class:"md-annotation__index",tabIndex:-1},y("span",{"data-md-annotation-id":e})))}else return y("aside",{class:"md-annotation",tabIndex:0},Dt(t),y("span",{class:"md-annotation__index",tabIndex:-1},y("span",{"data-md-annotation-id":e})))}function Cn(e){return y("button",{class:"md-code__button",title:Me("clipboard.copy"),"data-clipboard-target":`#${e} > code`,"data-md-type":"copy"})}function Hn(){return y("button",{class:"md-code__button",title:"Toggle line selection","data-md-type":"select"})}function $n(){return y("nav",{class:"md-code__nav"})}function ro(e,t){let r=t&2,o=t&1,n=Object.keys(e.terms).filter(c=>!e.terms[c]).reduce((c,p)=>[...c,y("del",null,p)," "],[]).slice(0,-1),i=Te(),s=new URL(e.location,i.base);N("search.highlight")&&s.searchParams.set("h",Object.entries(e.terms).filter(([,c])=>c).reduce((c,[p])=>`${c} ${p}`.trim(),""));let{tags:a}=Te();return y("a",{href:`${s}`,class:"md-search-result__link",tabIndex:-1},y("article",{class:"md-search-result__article md-typeset","data-md-score":e.score.toFixed(2)},r>0&&y("div",{class:"md-search-result__icon md-icon"}),r>0&&y("h1",null,e.title),r<=0&&y("h2",null,e.title),o>0&&e.text.length>0&&e.text,e.tags&&e.tags.map(c=>{let p=a?c in a?`md-tag-icon md-tag--${a[c]}`:"md-tag-icon":"";return y("span",{class:`md-tag ${p}`},c)}),o>0&&n.length>0&&y("p",{class:"md-search-result__terms"},Me("search.result.term.missing"),": ",...n)))}function kn(e){let t=e[0].score,r=[...e],o=Te(),n=r.findIndex(l=>!`${new URL(l.location,o.base)}`.includes("#")),[i]=r.splice(n,1),s=r.findIndex(l=>l.score<t);s===-1&&(s=r.length);let a=r.slice(0,s),c=r.slice(s),p=[ro(i,2|+(!n&&s===0)),...a.map(l=>ro(l,1)),...c.length?[y("details",{class:"md-search-result__more"},y("summary",{tabIndex:-1},y("div",null,c.length>0&&c.length===1?Me("search.result.more.one"):Me("search.result.more.other",c.length))),...c.map(l=>ro(l,1)))]:[]];return y("li",{class:"md-search-result__item"},p)}function Rn(e){return y("ul",{class:"md-source__facts"},Object.entries(e).map(([t,r])=>y("li",{class:`md-source__fact md-source__fact--${t}`},typeof r=="number"?br(r):r)))}function oo(e){let t=`tabbed-control tabbed-control--${e}`;return y("div",{class:t,hidden:!0},y("button",{class:"tabbed-button",tabIndex:-1,"aria-hidden":"true"}))}function Pn(e){return y("div",{class:"md-typeset__scrollwrap"},y("div",{class:"md-typeset__table"},e))}function Na(e){var o;let t=Te(),r=new URL(`../${e.version}/`,t.base);return y("li",{class:"md-version__item"},y("a",{href:`${r}`,class:"md-version__link"},e.title,((o=t.version)==null?void 0:o.alias)&&e.aliases.length>0&&y("span",{class:"md-version__alias"},e.aliases[0])))}function In(e,t){var o;let r=Te();return e=e.filter(n=>{var i;return!((i=n.properties)!=null&&i.hidden)}),y("div",{class:"md-version"},y("button",{class:"md-version__current","aria-label":Me("select.version")},t.title,((o=r.version)==null?void 0:o.alias)&&t.aliases.length>0&&y("span",{class:"md-version__alias"},t.aliases[0])),y("ul",{class:"md-version__list"},e.map(Na)))}var Va=0;function za(e,t=250){let r=z([Ke(e),nt(e,t)]).pipe(m(([n,i])=>n||i),Y()),o=$(()=>sn(e)).pipe(J(Ye),gt(1),m(()=>cn(e)));return r.pipe(Re(n=>n),b(()=>z([r,o])),m(([n,i])=>({active:n,offset:i})),le())}function Nt(e,t,r=250){let{content$:o,viewport$:n}=t,i=`__tooltip2_${Va++}`;return $(()=>{let s=new T,a=new jr(!1);s.pipe(re(),ae(!1)).subscribe(a);let c=a.pipe(jt(l=>$e(+!l*250,Dr)),Y(),b(l=>l?o:x),S(l=>l.id=i),le());z([s.pipe(m(({active:l})=>l)),c.pipe(b(l=>nt(l,250)),Q(!1))]).pipe(m(l=>l.some(f=>f))).subscribe(a);let p=a.pipe(v(l=>l),te(c,n),m(([l,f,{size:u}])=>{let d=e.getBoundingClientRect(),g=d.width/2;if(f.role==="tooltip")return{x:g,y:8+d.height};if(d.y>=u.height/2){let{height:L}=de(f);return{x:g,y:-16-L}}else return{x:g,y:16+d.height}}));return z([c,s,p]).subscribe(([l,{offset:f},u])=>{l.style.setProperty("--md-tooltip-host-x",`${f.x}px`),l.style.setProperty("--md-tooltip-host-y",`${f.y}px`),l.style.setProperty("--md-tooltip-x",`${u.x}px`),l.style.setProperty("--md-tooltip-y",`${u.y}px`),l.classList.toggle("md-tooltip2--top",u.y<0),l.classList.toggle("md-tooltip2--bottom",u.y>=0)}),a.pipe(v(l=>l),te(c,(l,f)=>f),v(l=>l.role==="tooltip")).subscribe(l=>{let f=de(F(":scope > *",l));l.style.setProperty("--md-tooltip-width",`${f.width}px`),l.style.setProperty("--md-tooltip-tail","0px")}),a.pipe(Y(),xe(ge),te(c)).subscribe(([l,f])=>{f.classList.toggle("md-tooltip2--active",l)}),z([a.pipe(v(l=>l)),c]).subscribe(([l,f])=>{f.role==="dialog"?(e.setAttribute("aria-controls",i),e.setAttribute("aria-haspopup","dialog")):e.setAttribute("aria-describedby",i)}),a.pipe(v(l=>!l)).subscribe(()=>{e.removeAttribute("aria-controls"),e.removeAttribute("aria-describedby"),e.removeAttribute("aria-haspopup")}),za(e,r).pipe(S(l=>s.next(l)),A(()=>s.complete()),m(l=>j({ref:e},l)))})}function Je(e,{viewport$:t},r=document.body){return Nt(e,{content$:new I(o=>{let n=e.title,i=_n(n);return o.next(i),e.removeAttribute("title"),r.append(i),()=>{i.remove(),e.setAttribute("title",n)}}),viewport$:t},0)}function qa(e,t){let r=$(()=>z([pn(e),Ye(t)])).pipe(m(([{x:o,y:n},i])=>{let{width:s,height:a}=de(e);return{x:o-i.x+s/2,y:n-i.y+a/2}}));return Ke(e).pipe(b(o=>r.pipe(m(n=>({active:o,offset:n})),Ee(+!o||1/0))))}function Fn(e,t,{target$:r}){let[o,n]=Array.from(e.children);return $(()=>{let i=new T,s=i.pipe(re(),ae(!0));return i.subscribe({next({offset:a}){e.style.setProperty("--md-tooltip-x",`${a.x}px`),e.style.setProperty("--md-tooltip-y",`${a.y}px`)},complete(){e.style.removeProperty("--md-tooltip-x"),e.style.removeProperty("--md-tooltip-y")}}),lt(e).pipe(W(s)).subscribe(a=>{e.toggleAttribute("data-md-visible",a)}),O(i.pipe(v(({active:a})=>a)),i.pipe(Ae(250),v(({active:a})=>!a))).subscribe({next({active:a}){a?e.prepend(o):o.remove()},complete(){e.prepend(o)}}),i.pipe(ke(16,ge)).subscribe(({active:a})=>{o.classList.toggle("md-tooltip--active",a)}),i.pipe(gt(125,ge),v(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:a})=>a)).subscribe({next(a){a?e.style.setProperty("--md-tooltip-0",`${-a}px`):e.style.removeProperty("--md-tooltip-0")},complete(){e.style.removeProperty("--md-tooltip-0")}}),h(n,"click").pipe(W(s),v(a=>!(a.metaKey||a.ctrlKey))).subscribe(a=>{a.stopPropagation(),a.preventDefault()}),h(n,"mousedown").pipe(W(s),te(i)).subscribe(([a,{active:c}])=>{var p;if(a.button!==0||a.metaKey||a.ctrlKey)a.preventDefault();else if(c){a.preventDefault();let l=e.parentElement.closest(".md-annotation");l instanceof HTMLElement?l.focus():(p=Ve())==null||p.blur()}}),r.pipe(W(s),v(a=>a===o),ot(125)).subscribe(()=>e.focus()),qa(e,t).pipe(S(a=>i.next(a)),A(()=>i.complete()),m(a=>j({ref:e},a)))})}function Ka(e){let t=Te();if(e.tagName!=="CODE")return[e];let r=[".c",".c1",".cm"];if(typeof t.annotate!="undefined"){let o=e.closest("[class|=language]");if(o)for(let n of Array.from(o.classList)){if(!n.startsWith("language-"))continue;let[,i]=n.split("-");i in t.annotate&&r.push(...t.annotate[i])}}return M(r.join(", "),e)}function Qa(e){let t=[];for(let r of Ka(e)){let o=[],n=document.createNodeIterator(r,NodeFilter.SHOW_TEXT);for(let i=n.nextNode();i;i=n.nextNode())o.push(i);for(let i of o){let s;for(;s=/(\(\d+\))(!)?/.exec(i.textContent);){let[,a,c]=s;if(typeof c=="undefined"){let p=i.splitText(s.index);i=p.splitText(a.length),t.push(p)}else{i.textContent=a,t.push(i);break}}}}return t}function jn(e,t){t.append(...Array.from(e.childNodes))}function Tr(e,t,{target$:r,print$:o}){let n=t.closest("[id]"),i=n==null?void 0:n.id,s=new Map;for(let a of Qa(t)){let[,c]=a.textContent.match(/\((\d+)\)/);ue(`:scope > li:nth-child(${c})`,e)&&(s.set(c,An(c,i)),a.replaceWith(s.get(c)))}return s.size===0?x:$(()=>{let a=new T,c=a.pipe(re(),ae(!0)),p=[];for(let[l,f]of s)p.push([F(".md-typeset",f),F(`:scope > li:nth-child(${l})`,e)]);return o.pipe(W(c)).subscribe(l=>{e.hidden=!l,e.classList.toggle("md-annotation-list",l);for(let[f,u]of p)l?jn(f,u):jn(u,f)}),O(...[...s].map(([,l])=>Fn(l,t,{target$:r}))).pipe(A(()=>a.complete()),le())})}function Un(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return Un(t)}}function Wn(e,t){return $(()=>{let r=Un(e);return typeof r!="undefined"?Tr(r,e,t):x})}var Nn=Gt(io());var Ya=0,Dn=O(h(window,"keydown").pipe(m(()=>!0)),O(h(window,"keyup"),h(window,"contextmenu")).pipe(m(()=>!1))).pipe(Q(!1),X(1));function Vn(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return Vn(t)}}function Ba(e){return Le(e).pipe(m(({width:t})=>({scrollable:Ct(e).width>t})),oe("scrollable"))}function zn(e,t){let{matches:r}=matchMedia("(hover)"),o=$(()=>{let n=new T,i=n.pipe(Yr(1));n.subscribe(({scrollable:d})=>{d&&r?e.setAttribute("tabindex","0"):e.removeAttribute("tabindex")});let s=[],a=e.closest("pre"),c=a.closest("[id]"),p=c?c.id:Ya++;a.id=`__code_${p}`;let l=[],f=e.closest(".highlight");if(f instanceof HTMLElement){let d=Vn(f);if(typeof d!="undefined"&&(f.classList.contains("annotate")||N("content.code.annotate"))){let g=Tr(d,e,t);l.push(Le(f).pipe(W(i),m(({width:L,height:ee})=>L&&ee),Y(),b(L=>L?g:x)))}}let u=M(":scope > span[id]",e);if(u.length&&(e.classList.add("md-code__content"),e.closest(".select")||N("content.code.select")&&!e.closest(".no-select"))){let d=+u[0].id.split("-").pop(),g=Hn();s.push(g),N("content.tooltips")&&l.push(Je(g,{viewport$}));let L=h(g,"click").pipe(Ut(R=>!R,!1),S(()=>g.blur()),le());L.subscribe(R=>{g.classList.toggle("md-code__button--active",R)});let ee=fe(u).pipe(J(R=>nt(R).pipe(m(se=>[R,se]))));L.pipe(b(R=>R?ee:x)).subscribe(([R,se])=>{let ce=ue(".hll.select",R);if(ce&&!se)ce.replaceWith(...Array.from(ce.childNodes));else if(!ce&&se){let he=document.createElement("span");he.className="hll select",he.append(...Array.from(R.childNodes).slice(1)),R.append(he)}});let ne=fe(u).pipe(J(R=>h(R,"mousedown").pipe(S(se=>se.preventDefault()),m(()=>R)))),Z=L.pipe(b(R=>R?ne:x),te(Dn),m(([R,se])=>{var he;let ce=u.indexOf(R)+d;if(se===!1)return[ce,ce];{let Se=M(".hll",e).map(je=>u.indexOf(je.parentElement)+d);return(he=window.getSelection())==null||he.removeAllRanges(),[Math.min(ce,...Se),Math.max(ce,...Se)]}})),H=Zr(x).pipe(v(R=>R.startsWith(`__codelineno-${p}-`)));H.subscribe(R=>{let[,,se]=R.split("-"),ce=se.split(":").map(Se=>+Se-d+1);ce.length===1&&ce.push(ce[0]);for(let Se of M(".hll:not(.select)",e))Se.replaceWith(...Array.from(Se.childNodes));let he=u.slice(ce[0]-1,ce[1]);for(let Se of he){let je=document.createElement("span");je.className="hll",je.append(...Array.from(Se.childNodes).slice(1)),Se.append(je)}}),H.pipe(Ee(1),xe(pe)).subscribe(R=>{if(R.includes(":")){let se=document.getElementById(R.split(":")[0]);se&&setTimeout(()=>{let ce=se,he=-64;for(;ce!==document.body;)he+=ce.offsetTop,ce=ce.offsetParent;window.scrollTo({top:he})},1)}});let Fe=fe(M('a[href^="#__codelineno"]',f)).pipe(J(R=>h(R,"click").pipe(S(se=>se.preventDefault()),m(()=>R)))).pipe(W(i),te(Dn),m(([R,se])=>{let he=+F(`[id="${R.hash.slice(1)}"]`).parentElement.id.split("-").pop();if(se===!1)return[he,he];{let Se=M(".hll",e).map(je=>+je.parentElement.id.split("-").pop());return[Math.min(he,...Se),Math.max(he,...Se)]}}));O(Z,Fe).subscribe(R=>{let se=`#__codelineno-${p}-`;R[0]===R[1]?se+=R[0]:se+=`${R[0]}:${R[1]}`,history.replaceState({},"",se),window.dispatchEvent(new HashChangeEvent("hashchange",{newURL:window.location.origin+window.location.pathname+se,oldURL:window.location.href}))})}if(Nn.default.isSupported()&&(e.closest(".copy")||N("content.code.copy")&&!e.closest(".no-copy"))){let d=Cn(a.id);s.push(d),N("content.tooltips")&&l.push(Je(d,{viewport$}))}if(s.length){let d=$n();d.append(...s),a.insertBefore(d,e)}return Ba(e).pipe(S(d=>n.next(d)),A(()=>n.complete()),m(d=>j({ref:e},d)),Ne(O(...l).pipe(W(i))))});return N("content.lazy")?lt(e).pipe(v(n=>n),Ee(1),b(()=>o)):o}function Ga(e,{target$:t,print$:r}){let o=!0;return O(t.pipe(m(n=>n.closest("details:not([open])")),v(n=>e===n),m(()=>({action:"open",reveal:!0}))),r.pipe(v(n=>n||!o),S(()=>o=e.open),m(n=>({action:n?"open":"close"}))))}function qn(e,t){return $(()=>{let r=new T;return r.subscribe(({action:o,reveal:n})=>{e.toggleAttribute("open",o==="open"),n&&e.scrollIntoView()}),Ga(e,t).pipe(S(o=>r.next(o)),A(()=>r.complete()),m(o=>j({ref:e},o)))})}var Kn=0;function Ja(e){let t=document.createElement("h3");t.innerHTML=e.innerHTML;let r=[t],o=e.nextElementSibling;for(;o&&!(o instanceof HTMLHeadingElement);)r.push(o),o=o.nextElementSibling;return r}function Xa(e,t){for(let r of M("[href], [src]",e))for(let o of["href","src"]){let n=r.getAttribute(o);if(n&&!/^(?:[a-z]+:)?\/\//i.test(n)){r[o]=new URL(r.getAttribute(o),t).toString();break}}for(let r of M("[name^=__], [for]",e))for(let o of["id","for","name"]){let n=r.getAttribute(o);n&&r.setAttribute(o,`${n}$preview_${Kn}`)}return Kn++,k(e)}function Qn(e,t){let{sitemap$:r}=t;if(!(e instanceof HTMLAnchorElement))return x;if(!(N("navigation.instant.preview")||e.hasAttribute("data-preview")))return x;let o=z([Ke(e),nt(e)]).pipe(m(([i,s])=>i||s),Y(),v(i=>i));return bt([r,o]).pipe(b(([i])=>{let s=new URL(e.href);return s.search=s.hash="",i.has(`${s}`)?k(s):x}),b(i=>yr(i).pipe(b(s=>Xa(s,i)))),b(i=>{let s=e.hash?`article [id="${e.hash.slice(1)}"]`:"article h1",a=ue(s,i);return typeof a=="undefined"?x:k(Ja(a))})).pipe(b(i=>{let s=new I(a=>{let c=wr(...i);return a.next(c),document.body.append(c),()=>c.remove()});return Nt(e,j({content$:s},t))}))}var Yn=".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel rect,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel rect{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}a .nodeLabel{text-decoration:underline}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}";var ao,es=0;function ts(){return typeof mermaid=="undefined"||mermaid instanceof Element?At("https://unpkg.com/mermaid@10/dist/mermaid.min.js"):k(void 0)}function Bn(e){return e.classList.remove("mermaid"),ao||(ao=ts().pipe(S(()=>mermaid.initialize({startOnLoad:!1,themeCSS:Yn,sequence:{actorFontSize:"16px",messageFontSize:"16px",noteFontSize:"16px"}})),m(()=>{}),X(1))),ao.subscribe(()=>bo(this,null,function*(){e.classList.add("mermaid");let t=`__mermaid_${es++}`,r=y("div",{class:"mermaid"}),o=e.textContent,{svg:n,fn:i}=yield mermaid.render(t,o),s=r.attachShadow({mode:"closed"});s.innerHTML=n,e.replaceWith(r),i==null||i(s)})),ao.pipe(m(()=>({ref:e})))}var Gn=y("table");function Jn(e){return e.replaceWith(Gn),Gn.replaceWith(Pn(e)),k({ref:e})}function rs(e){let t=e.find(r=>r.checked)||e[0];return O(...e.map(r=>h(r,"change").pipe(m(()=>F(`label[for="${r.id}"]`))))).pipe(Q(F(`label[for="${t.id}"]`)),m(r=>({active:r})))}function Xn(e,{viewport$:t,target$:r}){let o=F(".tabbed-labels",e),n=M(":scope > input",e),i=oo("prev");e.append(i);let s=oo("next");return e.append(s),$(()=>{let a=new T,c=a.pipe(re(),ae(!0));z([a,Le(e),lt(e)]).pipe(W(c),ke(1,ge)).subscribe({next([{active:p},l]){let f=Qe(p),{width:u}=de(p);e.style.setProperty("--md-indicator-x",`${f.x}px`),e.style.setProperty("--md-indicator-width",`${u}px`);let d=gr(o);(f.x<d.x||f.x+u>d.x+l.width)&&o.scrollTo({left:Math.max(0,f.x-16),behavior:"smooth"})},complete(){e.style.removeProperty("--md-indicator-x"),e.style.removeProperty("--md-indicator-width")}}),z([Ye(o),Le(o)]).pipe(W(c)).subscribe(([p,l])=>{let f=Ct(o);i.hidden=p.x<16,s.hidden=p.x>f.width-l.width-16}),O(h(i,"click").pipe(m(()=>-1)),h(s,"click").pipe(m(()=>1))).pipe(W(c)).subscribe(p=>{let{width:l}=de(o);o.scrollBy({left:l*p,behavior:"smooth"})}),r.pipe(W(c),v(p=>n.includes(p))).subscribe(p=>p.click()),o.classList.add("tabbed-labels--linked");for(let p of n){let l=F(`label[for="${p.id}"]`);l.replaceChildren(y("a",{href:`#${l.htmlFor}`,tabIndex:-1},...Array.from(l.childNodes))),h(l.firstElementChild,"click").pipe(W(c),v(f=>!(f.metaKey||f.ctrlKey)),S(f=>{f.preventDefault(),f.stopPropagation()})).subscribe(()=>{history.replaceState({},"",`#${l.htmlFor}`),l.click()})}return N("content.tabs.link")&&a.pipe(Pe(1),te(t)).subscribe(([{active:p},{offset:l}])=>{let f=p.innerText.trim();if(p.hasAttribute("data-md-switching"))p.removeAttribute("data-md-switching");else{let u=e.offsetTop-l.y;for(let g of M("[data-tabs]"))for(let L of M(":scope > input",g)){let ee=F(`label[for="${L.id}"]`);if(ee!==p&&ee.innerText.trim()===f){ee.setAttribute("data-md-switching",""),L.click();break}}window.scrollTo({top:e.offsetTop-u});let d=__md_get("__tabs")||[];__md_set("__tabs",[...new Set([f,...d])])}}),a.pipe(W(c)).subscribe(()=>{for(let p of M("audio, video",e))p.pause()}),rs(n).pipe(S(p=>a.next(p)),A(()=>a.complete()),m(p=>j({ref:e},p)))}).pipe(Ze(pe))}function Zn(e,t){let{viewport$:r,target$:o,print$:n}=t;return O(...M(".annotate:not(.highlight)",e).map(i=>Wn(i,{target$:o,print$:n})),...M("pre:not(.mermaid) > code",e).map(i=>zn(i,{target$:o,print$:n})),...M("a:not([title])",e).map(i=>Qn(i,t)),...M("pre.mermaid",e).map(i=>Bn(i)),...M("table:not([class])",e).map(i=>Jn(i)),...M("details",e).map(i=>qn(i,{target$:o,print$:n})),...M("[data-tabs]",e).map(i=>Xn(i,{viewport$:r,target$:o})),...M("[title]",e).filter(()=>N("content.tooltips")).map(i=>Je(i,{viewport$:r})),...M(".footnote-ref",e).filter(()=>N("content.footnote.tooltips")).map(i=>Nt(i,{content$:new I(s=>{let a=new URL(i.href).hash.slice(1),c=Array.from(document.getElementById(a).cloneNode(!0).children),p=wr(...c);return s.next(p),document.body.append(p),()=>p.remove()}),viewport$:r})))}function os(e,{alert$:t}){return t.pipe(b(r=>O(k(!0),k(!1).pipe(ot(2e3))).pipe(m(o=>({message:r,active:o})))))}function ei(e,t){let r=F(".md-typeset",e);return $(()=>{let o=new T;return o.subscribe(({message:n,active:i})=>{e.classList.toggle("md-dialog--active",i),r.textContent=n}),os(e,t).pipe(S(n=>o.next(n)),A(()=>o.complete()),m(n=>j({ref:e},n)))})}var ns=0;function is(e,t){document.body.append(e);let{width:r}=de(e);e.style.setProperty("--md-tooltip-width",`${r}px`),e.remove();let o=vr(t),n=typeof o!="undefined"?Ye(o):k({x:0,y:0}),i=O(Ke(t),nt(t)).pipe(Y());return z([i,n]).pipe(m(([s,a])=>{let{x:c,y:p}=Qe(t),l=de(t),f=t.closest("table");return f&&t.parentElement&&(c+=f.offsetLeft+t.parentElement.offsetLeft,p+=f.offsetTop+t.parentElement.offsetTop),{active:s,offset:{x:c-a.x+l.width/2-r/2,y:p-a.y+l.height+8}}}))}function ti(e){let t=e.title;if(!t.length)return x;let r=`__tooltip_${ns++}`,o=Dt(r,"inline"),n=F(".md-typeset",o);return n.innerHTML=t,$(()=>{let i=new T;return i.subscribe({next({offset:s}){o.style.setProperty("--md-tooltip-x",`${s.x}px`),o.style.setProperty("--md-tooltip-y",`${s.y}px`)},complete(){o.style.removeProperty("--md-tooltip-x"),o.style.removeProperty("--md-tooltip-y")}}),O(i.pipe(v(({active:s})=>s)),i.pipe(Ae(250),v(({active:s})=>!s))).subscribe({next({active:s}){s?(e.insertAdjacentElement("afterend",o),e.setAttribute("aria-describedby",r),e.removeAttribute("title")):(o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t))},complete(){o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t)}}),i.pipe(ke(16,ge)).subscribe(({active:s})=>{o.classList.toggle("md-tooltip--active",s)}),i.pipe(gt(125,ge),v(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:s})=>s)).subscribe({next(s){s?o.style.setProperty("--md-tooltip-0",`${-s}px`):o.style.removeProperty("--md-tooltip-0")},complete(){o.style.removeProperty("--md-tooltip-0")}}),is(o,e).pipe(S(s=>i.next(s)),A(()=>i.complete()),m(s=>j({ref:e},s)))}).pipe(Ze(pe))}function as({viewport$:e}){if(!N("header.autohide"))return k(!1);let t=e.pipe(m(({offset:{y:n}})=>n),tt(2,1),m(([n,i])=>[n<i,i]),oe(0)),r=z([e,t]).pipe(v(([{offset:n},[,i]])=>Math.abs(i-n.y)>100),m(([,[n]])=>n),Y()),o=Be("search");return z([e,o]).pipe(m(([{offset:n},i])=>n.y>400&&!i),Y(),b(n=>n?r:k(!1)),Q(!1))}function ri(e,t){return $(()=>z([Le(e),as(t)])).pipe(m(([{height:r},o])=>({height:r,hidden:o})),Y((r,o)=>r.height===o.height&&r.hidden===o.hidden),X(1))}function oi(e,{header$:t,main$:r}){return $(()=>{let o=new T,n=o.pipe(re(),ae(!0));o.pipe(oe("active"),De(t)).subscribe(([{active:s},{hidden:a}])=>{e.classList.toggle("md-header--shadow",s&&!a),e.hidden=a});let i=fe(M("[title]",e)).pipe(v(()=>N("content.tooltips")),J(s=>ti(s)));return r.subscribe(o),t.pipe(W(n),m(s=>j({ref:e},s)),Ne(i.pipe(W(n))))})}function ss(e,{viewport$:t,header$:r}){return Er(e,{viewport$:t,header$:r}).pipe(m(({offset:{y:o}})=>{let{height:n}=de(e);return{active:o>=n}}),oe("active"))}function ni(e,t){return $(()=>{let r=new T;r.subscribe({next({active:n}){e.classList.toggle("md-header__title--active",n)},complete(){e.classList.remove("md-header__title--active")}});let o=ue(".md-content h1");return typeof o=="undefined"?x:ss(o,t).pipe(S(n=>r.next(n)),A(()=>r.complete()),m(n=>j({ref:e},n)))})}function ii(e,{viewport$:t,header$:r}){let o=r.pipe(m(({height:i})=>i),Y()),n=o.pipe(b(()=>Le(e).pipe(m(({height:i})=>({top:e.offsetTop,bottom:e.offsetTop+i})),oe("bottom"))));return z([o,n,t]).pipe(m(([i,{top:s,bottom:a},{offset:{y:c},size:{height:p}}])=>(p=Math.max(0,p-Math.max(0,s-c,i)-Math.max(0,p+c-a)),{offset:s-i,height:p,active:s-i<=c})),Y((i,s)=>i.offset===s.offset&&i.height===s.height&&i.active===s.active))}function cs(e){let t=__md_get("__palette")||{index:e.findIndex(o=>matchMedia(o.getAttribute("data-md-color-media")).matches)},r=Math.max(0,Math.min(t.index,e.length-1));return k(...e).pipe(J(o=>h(o,"change").pipe(m(()=>o))),Q(e[r]),m(o=>({index:e.indexOf(o),color:{media:o.getAttribute("data-md-color-media"),scheme:o.getAttribute("data-md-color-scheme"),primary:o.getAttribute("data-md-color-primary"),accent:o.getAttribute("data-md-color-accent")}})),X(1))}function ai(e){let t=M("input",e),r=y("meta",{name:"theme-color"});document.head.appendChild(r);let o=y("meta",{name:"color-scheme"});document.head.appendChild(o);let n=Wt("(prefers-color-scheme: light)");return $(()=>{let i=new T;return i.subscribe(s=>{if(document.body.setAttribute("data-md-color-switching",""),s.color.media==="(prefers-color-scheme)"){let a=matchMedia("(prefers-color-scheme: light)"),c=document.querySelector(a.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");s.color.scheme=c.getAttribute("data-md-color-scheme"),s.color.primary=c.getAttribute("data-md-color-primary"),s.color.accent=c.getAttribute("data-md-color-accent")}for(let[a,c]of Object.entries(s.color))document.body.setAttribute(`data-md-color-${a}`,c);for(let a=0;a<t.length;a++){let c=t[a].nextElementSibling;c instanceof HTMLElement&&(c.hidden=s.index!==a)}__md_set("__palette",s)}),h(e,"keydown").pipe(v(s=>s.key==="Enter"),te(i,(s,a)=>a)).subscribe(({index:s})=>{s=(s+1)%t.length,t[s].click(),t[s].focus()}),i.pipe(m(()=>{let s=Ce("header"),a=window.getComputedStyle(s);return o.content=a.colorScheme,a.backgroundColor.match(/\d+/g).map(c=>(+c).toString(16).padStart(2,"0")).join("")})).subscribe(s=>r.content=`#${s}`),i.pipe(xe(pe)).subscribe(()=>{document.body.removeAttribute("data-md-color-switching")}),cs(t).pipe(W(n.pipe(Pe(1))),vt(),S(s=>i.next(s)),A(()=>i.complete()),m(s=>j({ref:e},s)))})}function si(e,{progress$:t}){return $(()=>{let r=new T;return r.subscribe(({value:o})=>{e.style.setProperty("--md-progress-value",`${o}`)}),t.pipe(S(o=>r.next({value:o})),A(()=>r.complete()),m(o=>({ref:e,value:o})))})}function ci(e,t){return e.protocol=t.protocol,e.hostname=t.hostname,e}function ps(e,t){let r=new Map;for(let o of M("url",e)){let n=F("loc",o),i=[ci(new URL(n.textContent),t)];r.set(`${i[0]}`,i);for(let s of M("[rel=alternate]",o)){let a=s.getAttribute("href");a!=null&&i.push(ci(new URL(a),t))}}return r}function $t(e){return xn(new URL("sitemap.xml",e)).pipe(m(t=>ps(t,new URL(e))),ye(()=>k(new Map)),le())}function pi({document$:e}){let t=new Map;e.pipe(b(()=>M("link[rel=alternate]")),m(r=>new URL(r.href)),v(r=>!t.has(r.toString())),J(r=>$t(r).pipe(m(o=>[r,o]),ye(()=>x)))).subscribe(([r,o])=>{t.set(r.toString().replace(/\/$/,""),o)}),h(document.body,"click").pipe(v(r=>!r.metaKey&&!r.ctrlKey),b(r=>{if(r.target instanceof Element){let o=r.target.closest("a");if(o&&!o.target){let n=[...t].find(([f])=>o.href.startsWith(`${f}/`));if(typeof n=="undefined")return x;let[i,s]=n,a=we();if(a.href.startsWith(i))return x;let c=Te(),p=a.href.replace(c.base,"");p=`${i}/${p}`;let l=s.has(p.split("#")[0])?new URL(p,c.base):new URL(i);return r.preventDefault(),k(l)}}return x})).subscribe(r=>at(r,!0))}var so=Gt(io());function ls(e){e.setAttribute("data-md-copying","");let t=e.closest("[data-copy]"),r=t?t.getAttribute("data-copy"):e.innerText;return e.removeAttribute("data-md-copying"),r.trimEnd()}function li({alert$:e}){so.default.isSupported()&&new I(t=>{new so.default("[data-clipboard-target], [data-clipboard-text]",{text:r=>r.getAttribute("data-clipboard-text")||ls(F(r.getAttribute("data-clipboard-target")))}).on("success",r=>t.next(r))}).pipe(S(t=>{t.trigger.focus()}),m(()=>Me("clipboard.copied"))).subscribe(e)}function mi(e,t){if(!(e.target instanceof Element))return x;let r=e.target.closest("a");if(r===null)return x;if(r.target||e.metaKey||e.ctrlKey)return x;let o=new URL(r.href);return o.search=o.hash="",t.has(`${o}`)?(e.preventDefault(),k(r)):x}function fi(e){let t=new Map;for(let r of M(":scope > *",e.head))t.set(r.outerHTML,r);return t}function ui(e){for(let t of M("[href], [src]",e))for(let r of["href","src"]){let o=t.getAttribute(r);if(o&&!/^(?:[a-z]+:)?\/\//i.test(o)){t[r]=t[r];break}}return k(e)}function ms(e){for(let o of["[data-md-component=announce]","[data-md-component=container]","[data-md-component=header-topic]","[data-md-component=outdated]","[data-md-component=logo]","[data-md-component=skip]",...N("navigation.tabs.sticky")?["[data-md-component=tabs]"]:[]]){let n=ue(o),i=ue(o,e);typeof n!="undefined"&&typeof i!="undefined"&&n.replaceWith(i)}let t=fi(document);for(let[o,n]of fi(e))t.has(o)?t.delete(o):document.head.appendChild(n);for(let o of t.values()){let n=o.getAttribute("name");n!=="theme-color"&&n!=="color-scheme"&&o.remove()}let r=Ce("container");return qe(M("script",r)).pipe(b(o=>{let n=e.createElement("script");if(o.src){for(let i of o.getAttributeNames())n.setAttribute(i,o.getAttribute(i));return o.replaceWith(n),new I(i=>{n.onload=()=>i.complete()})}else return n.textContent=o.textContent,o.replaceWith(n),x}),re(),ae(document))}function di({sitemap$:e,location$:t,viewport$:r,progress$:o}){if(location.protocol==="file:")return x;k(document).subscribe(ui);let n=h(document.body,"click").pipe(De(e),b(([a,c])=>mi(a,c)),m(({href:a})=>new URL(a)),le()),i=h(window,"popstate").pipe(m(we),le());n.pipe(te(r)).subscribe(([a,{offset:c}])=>{history.replaceState(c,""),history.pushState(null,"",a)}),O(n,i).subscribe(t);let s=t.pipe(oe("pathname"),b(a=>yr(a,{progress$:o}).pipe(ye(()=>(at(a,!0),x)))),b(ui),b(ms),le());return O(s.pipe(te(t,(a,c)=>c)),s.pipe(b(()=>t),oe("pathname"),b(()=>t),oe("hash")),t.pipe(Y((a,c)=>a.pathname===c.pathname&&a.hash===c.hash),b(()=>n),S(()=>history.back()))).subscribe(a=>{var c,p;history.state!==null||!a.hash?window.scrollTo(0,(p=(c=history.state)==null?void 0:c.y)!=null?p:0):(history.scrollRestoration="auto",bn(a.hash),history.scrollRestoration="manual")}),t.subscribe(()=>{history.scrollRestoration="manual"}),h(window,"beforeunload").subscribe(()=>{history.scrollRestoration="auto"}),r.pipe(oe("offset"),Ae(100)).subscribe(({offset:a})=>{history.replaceState(a,"")}),N("navigation.instant.prefetch")&&O(h(document.body,"mousemove"),h(document.body,"focusin")).pipe(De(e),b(([a,c])=>mi(a,c)),Ae(25),Qr(({href:a})=>a),hr(a=>{let c=document.createElement("link");return c.rel="prefetch",c.href=a.toString(),document.head.appendChild(c),h(c,"load").pipe(m(()=>c),Ee(1))})).subscribe(a=>a.remove()),s}var vi=Gt(bi());function gi(e){let t=e.separator.split("|").map(n=>n.replace(/(\(\?[!=<][^)]+\))/g,"").length===0?"\uFFFD":n).join("|"),r=new RegExp(t,"img"),o=(n,i,s)=>`${i}<mark data-md-highlight>${s}</mark>`;return n=>{n=n.replace(/[\s*+\-:~^]+/g," ").trim();let i=new RegExp(`(^|${e.separator}|)(${n.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(r,"|")})`,"img");return s=>(0,vi.default)(s).replace(i,o).replace(/<\/mark>(\s+)<mark[^>]*>/img,"$1")}}function zt(e){return e.type===1}function Sr(e){return e.type===3}function xi(e,t){let r=On(e);return O(k(location.protocol!=="file:"),Be("search")).pipe(Re(o=>o),b(()=>t)).subscribe(({config:o,docs:n})=>r.next({type:0,data:{config:o,docs:n,options:{suggest:N("search.suggest")}}})),r}function yi({document$:e}){let t=Te(),r=Ge(new URL("../versions.json",t.base)).pipe(ye(()=>x)),o=r.pipe(m(n=>{let[,i]=t.base.match(/([^/]+)\/?$/);return n.find(({version:s,aliases:a})=>s===i||a.includes(i))||n[0]}));r.pipe(m(n=>new Map(n.map(i=>[`${new URL(`../${i.version}/`,t.base)}`,i]))),b(n=>h(document.body,"click").pipe(v(i=>!i.metaKey&&!i.ctrlKey),te(o),b(([i,s])=>{if(i.target instanceof Element){let a=i.target.closest("a");if(a&&!a.target&&n.has(a.href)){let c=a.href;return!i.target.closest(".md-version")&&n.get(c)===s?x:(i.preventDefault(),k(c))}}return x}),b(i=>$t(new URL(i)).pipe(m(s=>{let c=we().href.replace(t.base,i);return s.has(c.split("#")[0])?new URL(c):new URL(i)})))))).subscribe(n=>at(n,!0)),z([r,o]).subscribe(([n,i])=>{F(".md-header__topic").appendChild(In(n,i))}),e.pipe(b(()=>o)).subscribe(n=>{var s;let i=__md_get("__outdated",sessionStorage);if(i===null){i=!0;let a=((s=t.version)==null?void 0:s.default)||"latest";Array.isArray(a)||(a=[a]);e:for(let c of a)for(let p of n.aliases.concat(n.version))if(new RegExp(c,"i").test(p)){i=!1;break e}__md_set("__outdated",i,sessionStorage)}if(i)for(let a of me("outdated"))a.hidden=!1})}function bs(e,{worker$:t}){let{searchParams:r}=we();r.has("q")&&(it("search",!0),e.value=r.get("q"),e.focus(),Be("search").pipe(Re(i=>!i)).subscribe(()=>{let i=we();i.searchParams.delete("q"),history.replaceState({},"",`${i}`)}));let o=Ke(e),n=O(t.pipe(Re(zt)),h(e,"keyup"),o).pipe(m(()=>e.value),Y());return z([n,o]).pipe(m(([i,s])=>({value:i,focus:s})),X(1))}function Ei(e,{worker$:t}){let r=new T,o=r.pipe(re(),ae(!0));z([t.pipe(Re(zt)),r],(i,s)=>s).pipe(oe("value")).subscribe(({value:i})=>t.next({type:2,data:i})),r.pipe(oe("focus")).subscribe(({focus:i})=>{i&&it("search",i)}),h(e.form,"reset").pipe(W(o)).subscribe(()=>e.focus());let n=F("header [for=__search]");return h(n,"click").subscribe(()=>e.focus()),bs(e,{worker$:t}).pipe(S(i=>r.next(i)),A(()=>r.complete()),m(i=>j({ref:e},i)),X(1))}function wi(e,{worker$:t,query$:r}){let o=new T,n=mn(e.parentElement).pipe(v(Boolean)),i=e.parentElement,s=F(":scope > :first-child",e),a=F(":scope > :last-child",e);Be("search").subscribe(l=>a.setAttribute("role",l?"list":"presentation")),o.pipe(te(r),Gr(t.pipe(Re(zt)))).subscribe(([{items:l},{value:f}])=>{switch(l.length){case 0:s.textContent=f.length?Me("search.result.none"):Me("search.result.placeholder");break;case 1:s.textContent=Me("search.result.one");break;default:let u=br(l.length);s.textContent=Me("search.result.other",u)}});let c=o.pipe(S(()=>a.innerHTML=""),b(({items:l})=>O(k(...l.slice(0,10)),k(...l.slice(10)).pipe(tt(4),Xr(n),b(([f])=>f)))),m(kn),le());return c.subscribe(l=>a.appendChild(l)),c.pipe(J(l=>{let f=ue("details",l);return typeof f=="undefined"?x:h(f,"toggle").pipe(W(o),m(()=>f))})).subscribe(l=>{l.open===!1&&l.offsetTop<=i.scrollTop&&i.scrollTo({top:l.offsetTop})}),t.pipe(v(Sr),m(({data:l})=>l)).pipe(S(l=>o.next(l)),A(()=>o.complete()),m(l=>j({ref:e},l)))}function vs(e,{query$:t}){return t.pipe(m(({value:r})=>{let o=we();return o.hash="",r=r.replace(/\s+/g,"+").replace(/&/g,"%26").replace(/=/g,"%3D"),o.search=`q=${r}`,{url:o}}))}function Ti(e,t){let r=new T,o=r.pipe(re(),ae(!0));return r.subscribe(({url:n})=>{e.setAttribute("data-clipboard-text",e.href),e.href=`${n}`}),h(e,"click").pipe(W(o)).subscribe(n=>n.preventDefault()),vs(e,t).pipe(S(n=>r.next(n)),A(()=>r.complete()),m(n=>j({ref:e},n)))}function Si(e,{worker$:t,keyboard$:r}){let o=new T,n=Ce("search-query"),i=O(h(n,"keydown"),h(n,"focus")).pipe(xe(pe),m(()=>n.value),Y());return o.pipe(De(i),m(([{suggest:a},c])=>{let p=c.split(/([\s-]+)/);if(a!=null&&a.length&&p[p.length-1]){let l=a[a.length-1];l.startsWith(p[p.length-1])&&(p[p.length-1]=l)}else p.length=0;return p})).subscribe(a=>e.innerHTML=a.join("").replace(/\s/g,"&nbsp;")),r.pipe(v(({mode:a})=>a==="search")).subscribe(a=>{switch(a.type){case"ArrowRight":e.innerText.length&&n.selectionStart===n.value.length&&(n.value=e.innerText);break}}),t.pipe(v(Sr),m(({data:a})=>a)).pipe(S(a=>o.next(a)),A(()=>o.complete()),m(()=>({ref:e})))}function Oi(e,{index$:t,keyboard$:r}){let o=Te();try{let n=xi(o.search,t),i=Ce("search-query",e),s=Ce("search-result",e);h(e,"click").pipe(v(({target:c})=>c instanceof Element&&!!c.closest("a"))).subscribe(()=>it("search",!1)),r.pipe(v(({mode:c})=>c==="search")).subscribe(c=>{let p=Ve();switch(c.type){case"Enter":if(p===i){let l=new Map;for(let f of M(":first-child [href]",s)){let u=f.firstElementChild;l.set(f,parseFloat(u.getAttribute("data-md-score")))}if(l.size){let[[f]]=[...l].sort(([,u],[,d])=>d-u);f.click()}c.claim()}break;case"Escape":case"Tab":it("search",!1),i.blur();break;case"ArrowUp":case"ArrowDown":if(typeof p=="undefined")i.focus();else{let l=[i,...M(":not(details) > [href], summary, details[open] [href]",s)],f=Math.max(0,(Math.max(0,l.indexOf(p))+l.length+(c.type==="ArrowUp"?-1:1))%l.length);l[f].focus()}c.claim();break;default:i!==Ve()&&i.focus()}}),r.pipe(v(({mode:c})=>c==="global")).subscribe(c=>{switch(c.type){case"f":case"s":case"/":i.focus(),i.select(),c.claim();break}});let a=Ei(i,{worker$:n});return O(a,wi(s,{worker$:n,query$:a})).pipe(Ne(...me("search-share",e).map(c=>Ti(c,{query$:a})),...me("search-suggest",e).map(c=>Si(c,{worker$:n,keyboard$:r}))))}catch(n){return e.hidden=!0,et}}function Li(e,{index$:t,location$:r}){return z([t,r.pipe(Q(we()),v(o=>!!o.searchParams.get("h")))]).pipe(m(([o,n])=>gi(o.config)(n.searchParams.get("h"))),m(o=>{var s;let n=new Map,i=document.createNodeIterator(e,NodeFilter.SHOW_TEXT);for(let a=i.nextNode();a;a=i.nextNode())if((s=a.parentElement)!=null&&s.offsetHeight){let c=a.textContent,p=o(c);p.length>c.length&&n.set(a,p)}for(let[a,c]of n){let{childNodes:p}=y("span",null,c);a.replaceWith(...Array.from(p))}return{ref:e,nodes:n}}))}function gs(e,{viewport$:t,main$:r}){let o=e.closest(".md-grid"),n=o.offsetTop-o.parentElement.offsetTop;return z([r,t]).pipe(m(([{offset:i,height:s},{offset:{y:a}}])=>(s=s+Math.min(n,Math.max(0,a-i))-n,{height:s,locked:a>=i+n})),Y((i,s)=>i.height===s.height&&i.locked===s.locked))}function co(e,o){var n=o,{header$:t}=n,r=ho(n,["header$"]);let i=F(".md-sidebar__scrollwrap",e),{y:s}=Qe(i);return $(()=>{let a=new T,c=a.pipe(re(),ae(!0)),p=a.pipe(ke(0,ge));return p.pipe(te(t)).subscribe({next([{height:l},{height:f}]){i.style.height=`${l-2*s}px`,e.style.top=`${f}px`},complete(){i.style.height="",e.style.top=""}}),p.pipe(Re()).subscribe(()=>{for(let l of M(".md-nav__link--active[href]",e)){if(!l.clientHeight)continue;let f=l.closest(".md-sidebar__scrollwrap");if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:d}=de(f);f.scrollTo({top:u-d/2})}}}),fe(M("label[tabindex]",e)).pipe(J(l=>h(l,"click").pipe(xe(pe),m(()=>l),W(c)))).subscribe(l=>{let f=F(`[id="${l.htmlFor}"]`);F(`[aria-labelledby="${l.id}"]`).setAttribute("aria-expanded",`${f.checked}`)}),N("content.tooltips")&&fe(M("abbr[title]",e)).pipe(J(l=>Je(l,{viewport$})),W(c)).subscribe(),gs(e,r).pipe(S(l=>a.next(l)),A(()=>a.complete()),m(l=>j({ref:e},l)))})}function Mi(e,t){if(typeof t!="undefined"){let r=`https://api.github.com/repos/${e}/${t}`;return bt(Ge(`${r}/releases/latest`).pipe(ye(()=>x),m(o=>({version:o.tag_name})),rt({})),Ge(r).pipe(ye(()=>x),m(o=>({stars:o.stargazers_count,forks:o.forks_count})),rt({}))).pipe(m(([o,n])=>j(j({},o),n)))}else{let r=`https://api.github.com/users/${e}`;return Ge(r).pipe(m(o=>({repositories:o.public_repos})),rt({}))}}function _i(e,t){let r=`https://${e}/api/v4/projects/${encodeURIComponent(t)}`;return Ge(r).pipe(ye(()=>x),m(({star_count:o,forks_count:n})=>({stars:o,forks:n})),rt({}))}function Ai(e){let t=e.match(/^.+github\.com\/([^/]+)\/?([^/]+)?/i);if(t){let[,r,o]=t;return Mi(r,o)}if(t=e.match(/^.+?([^/]*gitlab[^/]+)\/(.+?)\/?$/i),t){let[,r,o]=t;return _i(r,o)}return x}var xs;function ys(e){return xs||(xs=$(()=>{let t=__md_get("__source",sessionStorage);if(t)return k(t);if(me("consent").length){let o=__md_get("__consent");if(!(o&&o.github))return x}return Ai(e.href).pipe(S(o=>__md_set("__source",o,sessionStorage)))}).pipe(ye(()=>x),v(t=>Object.keys(t).length>0),m(t=>({facts:t})),X(1)))}function Ci(e){let t=F(":scope > :last-child",e);return $(()=>{let r=new T;return r.subscribe(({facts:o})=>{t.appendChild(Rn(o)),t.classList.add("md-source__repository--active")}),ys(e).pipe(S(o=>r.next(o)),A(()=>r.complete()),m(o=>j({ref:e},o)))})}function Es(e,{viewport$:t,header$:r}){return Le(document.body).pipe(b(()=>Er(e,{header$:r,viewport$:t})),m(({offset:{y:o}})=>({hidden:o>=10})),oe("hidden"))}function Hi(e,t){return $(()=>{let r=new T;return r.subscribe({next({hidden:o}){e.hidden=o},complete(){e.hidden=!1}}),(N("navigation.tabs.sticky")?k({hidden:!1}):Es(e,t)).pipe(S(o=>r.next(o)),A(()=>r.complete()),m(o=>j({ref:e},o)))})}function ws(e,{viewport$:t,header$:r}){let o=new Map,n=M(".md-nav__link",e);for(let a of n){let c=decodeURIComponent(a.hash.substring(1)),p=ue(`[id="${c}"]`);typeof p!="undefined"&&o.set(a,p)}let i=r.pipe(oe("height"),m(({height:a})=>{let c=Ce("main"),p=F(":scope > :first-child",c);return a+.8*(p.offsetTop-c.offsetTop)}),le());return Le(document.body).pipe(oe("height"),b(a=>$(()=>{let c=[];return k([...o].reduce((p,[l,f])=>{for(;c.length&&o.get(c[c.length-1]).tagName>=f.tagName;)c.pop();let u=f.offsetTop;for(;!u&&f.parentElement;)f=f.parentElement,u=f.offsetTop;let d=f.offsetParent;for(;d;d=d.offsetParent)u+=d.offsetTop;return p.set([...c=[...c,l]].reverse(),u)},new Map))}).pipe(m(c=>new Map([...c].sort(([,p],[,l])=>p-l))),De(i),b(([c,p])=>t.pipe(Ut(([l,f],{offset:{y:u},size:d})=>{let g=u+d.height>=Math.floor(a.height);for(;f.length;){let[,L]=f[0];if(L-p<u||g)l=[...l,f.shift()];else break}for(;l.length;){let[,L]=l[l.length-1];if(L-p>=u&&!g)f=[l.pop(),...f];else break}return[l,f]},[[],[...c]]),Y((l,f)=>l[0]===f[0]&&l[1]===f[1])))))).pipe(m(([a,c])=>({prev:a.map(([p])=>p),next:c.map(([p])=>p)})),Q({prev:[],next:[]}),tt(2,1),m(([a,c])=>a.prev.length<c.prev.length?{prev:c.prev.slice(Math.max(0,a.prev.length-1),c.prev.length),next:[]}:{prev:c.prev.slice(-1),next:c.next.slice(0,c.next.length-a.next.length)}))}function $i(e,{viewport$:t,header$:r,main$:o,target$:n}){return $(()=>{let i=new T,s=i.pipe(re(),ae(!0));if(i.subscribe(({prev:a,next:c})=>{for(let[p]of c)p.classList.remove("md-nav__link--passed"),p.classList.remove("md-nav__link--active");for(let[p,[l]]of a.entries())l.classList.add("md-nav__link--passed"),l.classList.toggle("md-nav__link--active",p===a.length-1)}),N("toc.follow")){let a=O(t.pipe(Ae(1),m(()=>{})),t.pipe(Ae(250),m(()=>"smooth")));i.pipe(v(({prev:c})=>c.length>0),De(o.pipe(xe(pe))),te(a)).subscribe(([[{prev:c}],p])=>{let[l]=c[c.length-1];if(l.offsetHeight){let f=vr(l);if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:d}=de(f);f.scrollTo({top:u-d/2,behavior:p})}}})}return N("navigation.tracking")&&t.pipe(W(s),oe("offset"),Ae(250),Pe(1),W(n.pipe(Pe(1))),vt({delay:250}),te(i)).subscribe(([,{prev:a}])=>{let c=we(),p=a[a.length-1];if(p&&p.length){let[l]=p,{hash:f}=new URL(l.href);c.hash!==f&&(c.hash=f,history.replaceState({},"",`${c}`))}else c.hash="",history.replaceState({},"",`${c}`)}),ws(e,{viewport$:t,header$:r}).pipe(S(a=>i.next(a)),A(()=>i.complete()),m(a=>j({ref:e},a)))})}function Ts(e,{viewport$:t,main$:r,target$:o}){let n=t.pipe(m(({offset:{y:s}})=>s),tt(2,1),m(([s,a])=>s>a&&a>0),Y()),i=r.pipe(m(({active:s})=>s));return z([i,n]).pipe(m(([s,a])=>!(s&&a)),Y(),W(o.pipe(Pe(1))),ae(!0),vt({delay:250}),m(s=>({hidden:s})))}function ki(e,{viewport$:t,header$:r,main$:o,target$:n}){let i=new T,s=i.pipe(re(),ae(!0));return i.subscribe({next({hidden:a}){e.hidden=a,a?(e.setAttribute("tabindex","-1"),e.blur()):e.removeAttribute("tabindex")},complete(){e.style.top="",e.hidden=!0,e.removeAttribute("tabindex")}}),r.pipe(W(s),oe("height")).subscribe(({height:a})=>{e.style.top=`${a+16}px`}),h(e,"click").subscribe(a=>{a.preventDefault(),window.scrollTo({top:0})}),Ts(e,{viewport$:t,main$:o,target$:n}).pipe(S(a=>i.next(a)),A(()=>i.complete()),m(a=>j({ref:e},a)))}function Ri({document$:e,viewport$:t}){e.pipe(b(()=>M(".md-ellipsis")),J(r=>lt(r).pipe(W(e.pipe(Pe(1))),v(o=>o),m(()=>r),Ee(1))),v(r=>r.offsetWidth<r.scrollWidth),J(r=>{let o=r.innerText,n=r.closest("a")||r;return n.title=o,N("content.tooltips")?Je(n,{viewport$:t}).pipe(W(e.pipe(Pe(1))),A(()=>n.removeAttribute("title"))):x})).subscribe(),N("content.tooltips")&&e.pipe(b(()=>M(".md-status")),J(r=>Je(r,{viewport$:t}))).subscribe()}function Pi({document$:e,tablet$:t}){e.pipe(b(()=>M(".md-toggle--indeterminate")),S(r=>{r.indeterminate=!0,r.checked=!1}),J(r=>h(r,"change").pipe(Jr(()=>r.classList.contains("md-toggle--indeterminate")),m(()=>r))),te(t)).subscribe(([r,o])=>{r.classList.remove("md-toggle--indeterminate"),o&&(r.checked=!1)})}function Ss(){return/(iPad|iPhone|iPod)/.test(navigator.userAgent)}function Ii({document$:e}){e.pipe(b(()=>M("[data-md-scrollfix]")),S(t=>t.removeAttribute("data-md-scrollfix")),v(Ss),J(t=>h(t,"touchstart").pipe(m(()=>t)))).subscribe(t=>{let r=t.scrollTop;r===0?t.scrollTop=1:r+t.offsetHeight===t.scrollHeight&&(t.scrollTop=r-1)})}function Fi({viewport$:e,tablet$:t}){z([Be("search"),t]).pipe(m(([r,o])=>r&&!o),b(r=>k(r).pipe(ot(r?400:100))),te(e)).subscribe(([r,{offset:{y:o}}])=>{if(r)document.body.setAttribute("data-md-scrolllock",""),document.body.style.top=`-${o}px`;else{let n=-1*parseInt(document.body.style.top,10);document.body.removeAttribute("data-md-scrolllock"),document.body.style.top="",n&&window.scrollTo(0,n)}})}Object.entries||(Object.entries=function(e){let t=[];for(let r of Object.keys(e))t.push([r,e[r]]);return t});Object.values||(Object.values=function(e){let t=[];for(let r of Object.keys(e))t.push(e[r]);return t});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(e,t){typeof e=="object"?(this.scrollLeft=e.left,this.scrollTop=e.top):(this.scrollLeft=e,this.scrollTop=t)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...e){let t=this.parentNode;if(t){e.length===0&&t.removeChild(this);for(let r=e.length-1;r>=0;r--){let o=e[r];typeof o=="string"?o=document.createTextNode(o):o.parentNode&&o.parentNode.removeChild(o),r?t.insertBefore(this.previousSibling,o):t.replaceChild(o,this)}}}));function Os(){return location.protocol==="file:"?At(`${new URL("search/search_index.js",Or.base)}`).pipe(m(()=>__index),X(1)):Ge(new URL("search/search_index.json",Or.base))}document.documentElement.classList.remove("no-js");document.documentElement.classList.add("js");var st=on(),Kt=dn(),kt=vn(Kt),po=un(),He=Sn(),Lr=Wt("(min-width: 960px)"),Ui=Wt("(min-width: 1220px)"),Wi=gn(),Or=Te(),Di=document.forms.namedItem("search")?Os():et,lo=new T;li({alert$:lo});pi({document$:st});var mo=new T,Ni=$t(Or.base);N("navigation.instant")&&di({sitemap$:Ni,location$:Kt,viewport$:He,progress$:mo}).subscribe(st);var ji;((ji=Or.version)==null?void 0:ji.provider)==="mike"&&yi({document$:st});O(Kt,kt).pipe(ot(125)).subscribe(()=>{it("drawer",!1),it("search",!1)});po.pipe(v(({mode:e})=>e==="global")).subscribe(e=>{switch(e.type){case"p":case",":let t=ue("link[rel=prev]");typeof t!="undefined"&&at(t);break;case"n":case".":let r=ue("link[rel=next]");typeof r!="undefined"&&at(r);break;case"Enter":let o=Ve();o instanceof HTMLLabelElement&&o.click()}});Ri({viewport$:He,document$:st});Pi({document$:st,tablet$:Lr});Ii({document$:st});Fi({viewport$:He,tablet$:Lr});var mt=ri(Ce("header"),{viewport$:He}),qt=st.pipe(m(()=>Ce("main")),b(e=>ii(e,{viewport$:He,header$:mt})),X(1)),Ls=O(...me("consent").map(e=>Mn(e,{target$:kt})),...me("dialog").map(e=>ei(e,{alert$:lo})),...me("header").map(e=>oi(e,{viewport$:He,header$:mt,main$:qt})),...me("palette").map(e=>ai(e)),...me("progress").map(e=>si(e,{progress$:mo})),...me("search").map(e=>Oi(e,{index$:Di,keyboard$:po})),...me("source").map(e=>Ci(e))),Ms=$(()=>O(...me("announce").map(e=>Ln(e)),...me("content").map(e=>Zn(e,{sitemap$:Ni,viewport$:He,target$:kt,print$:Wi})),...me("content").map(e=>N("search.highlight")?Li(e,{index$:Di,location$:Kt}):x),...me("header-title").map(e=>ni(e,{viewport$:He,header$:mt})),...me("sidebar").map(e=>e.getAttribute("data-md-type")==="navigation"?eo(Ui,()=>co(e,{viewport$:He,header$:mt,main$:qt})):eo(Lr,()=>co(e,{viewport$:He,header$:mt,main$:qt}))),...me("tabs").map(e=>Hi(e,{viewport$:He,header$:mt})),...me("toc").map(e=>$i(e,{viewport$:He,header$:mt,main$:qt,target$:kt})),...me("top").map(e=>ki(e,{viewport$:He,header$:mt,main$:qt,target$:kt})))),Vi=st.pipe(b(()=>Ms),Ne(Ls),X(1));Vi.subscribe();window.document$=st;window.location$=Kt;window.target$=kt;window.keyboard$=po;window.viewport$=He;window.tablet$=Lr;window.screen$=Ui;window.print$=Wi;window.alert$=lo;window.progress$=mo;window.component$=Vi;})();
diff --git a/assets/stylesheets/main.0e8c34cb.min.css b/assets/stylesheets/main.dad623df.min.css
similarity index 89%
rename from assets/stylesheets/main.0e8c34cb.min.css
rename to assets/stylesheets/main.dad623df.min.css
index 79963bac..02b3c720 100644
--- a/assets/stylesheets/main.0e8c34cb.min.css
+++ b/assets/stylesheets/main.dad623df.min.css
@@ -1 +1 @@
-@charset "UTF-8";html{-webkit-text-size-adjust:none;-moz-text-size-adjust:none;text-size-adjust:none;box-sizing:border-box}*,:after,:before{box-sizing:inherit}@media (prefers-reduced-motion){*,:after,:before{transition:none!important}}body{margin:0}a,button,input,label{-webkit-tap-highlight-color:transparent}a{color:inherit;text-decoration:none}hr{border:0;box-sizing:initial;display:block;height:.05rem;overflow:visible;padding:0}small{font-size:80%}sub,sup{line-height:1em}img{border-style:none}table{border-collapse:initial;border-spacing:0}td,th{font-weight:400;vertical-align:top}button{background:#0000;border:0;font-family:inherit;font-size:inherit;margin:0;padding:0}input{border:0;outline:none}:root{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:#526cfe1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-scheme=default]{color-scheme:light}[data-md-color-scheme=default] img[src$="#gh-dark-mode-only"],[data-md-color-scheme=default] img[src$="#only-dark"]{display:none}:root,[data-md-color-scheme=default]{--md-hue:225deg;--md-default-fg-color:#000000de;--md-default-fg-color--light:#0000008a;--md-default-fg-color--lighter:#00000052;--md-default-fg-color--lightest:#00000012;--md-default-bg-color:#fff;--md-default-bg-color--light:#ffffffb3;--md-default-bg-color--lighter:#ffffff4d;--md-default-bg-color--lightest:#ffffff1f;--md-code-fg-color:#36464e;--md-code-bg-color:#f5f5f5;--md-code-bg-color--light:#f5f5f5b3;--md-code-bg-color--lighter:#f5f5f54d;--md-code-hl-color:#4287ff;--md-code-hl-color--light:#4287ff1a;--md-code-hl-number-color:#d52a2a;--md-code-hl-special-color:#db1457;--md-code-hl-function-color:#a846b9;--md-code-hl-constant-color:#6e59d9;--md-code-hl-keyword-color:#3f6ec6;--md-code-hl-string-color:#1c7d4d;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-del-color:#f5503d26;--md-typeset-ins-color:#0bd57026;--md-typeset-kbd-color:#fafafa;--md-typeset-kbd-accent-color:#fff;--md-typeset-kbd-border-color:#b8b8b8;--md-typeset-mark-color:#ffff0080;--md-typeset-table-color:#0000001f;--md-typeset-table-color--light:rgba(0,0,0,.035);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-warning-fg-color:#000000de;--md-warning-bg-color:#ff9;--md-footer-fg-color:#fff;--md-footer-fg-color--light:#ffffffb3;--md-footer-fg-color--lighter:#ffffff73;--md-footer-bg-color:#000000de;--md-footer-bg-color--dark:#00000052;--md-shadow-z1:0 0.2rem 0.5rem #0000000d,0 0 0.05rem #0000001a;--md-shadow-z2:0 0.2rem 0.5rem #0000001a,0 0 0.05rem #00000040;--md-shadow-z3:0 0.2rem 0.5rem #0003,0 0 0.05rem #00000059}.md-icon svg{fill:currentcolor;display:block;height:1.2rem;width:1.2rem}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;--md-text-font-family:var(--md-text-font,_),-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif;--md-code-font-family:var(--md-code-font,_),SFMono-Regular,Consolas,Menlo,monospace}aside,body,input{font-feature-settings:"kern","liga";color:var(--md-typeset-color);font-family:var(--md-text-font-family)}code,kbd,pre{font-feature-settings:"kern";font-family:var(--md-code-font-family)}:root{--md-typeset-table-sort-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m18 21-4-4h3V7h-3l4-4 4 4h-3v10h3M2 19v-2h10v2M2 13v-2h7v2M2 7V5h4v2H2Z"/></svg>');--md-typeset-table-sort-icon--asc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 17h3l-4 4-4-4h3V3h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2v-2Z"/></svg>');--md-typeset-table-sort-icon--desc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7h3l-4-4-4 4h3v14h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2v-2Z"/></svg>')}.md-typeset{-webkit-print-color-adjust:exact;color-adjust:exact;font-size:.8rem;line-height:1.6}@media print{.md-typeset{font-size:.68rem}}.md-typeset blockquote,.md-typeset dl,.md-typeset figure,.md-typeset ol,.md-typeset pre,.md-typeset ul{margin-bottom:1em;margin-top:1em}.md-typeset h1{color:var(--md-default-fg-color--light);font-size:2em;line-height:1.3;margin:0 0 1.25em}.md-typeset h1,.md-typeset h2{font-weight:300;letter-spacing:-.01em}.md-typeset h2{font-size:1.5625em;line-height:1.4;margin:1.6em 0 .64em}.md-typeset h3{font-size:1.25em;font-weight:400;letter-spacing:-.01em;line-height:1.5;margin:1.6em 0 .8em}.md-typeset h2+h3{margin-top:.8em}.md-typeset h4{font-weight:700;letter-spacing:-.01em;margin:1em 0}.md-typeset h5,.md-typeset h6{color:var(--md-default-fg-color--light);font-size:.8em;font-weight:700;letter-spacing:-.01em;margin:1.25em 0}.md-typeset h5{text-transform:uppercase}.md-typeset hr{border-bottom:.05rem solid var(--md-default-fg-color--lightest);display:flow-root;margin:1.5em 0}.md-typeset a{color:var(--md-typeset-a-color);word-break:break-word}.md-typeset a,.md-typeset a:before{transition:color 125ms}.md-typeset a:focus,.md-typeset a:hover{color:var(--md-accent-fg-color)}.md-typeset a:focus code,.md-typeset a:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset a code{color:var(--md-typeset-a-color)}.md-typeset a.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset code,.md-typeset kbd,.md-typeset pre{color:var(--md-code-fg-color);direction:ltr;font-variant-ligatures:none;transition:background-color 125ms}@media print{.md-typeset code,.md-typeset kbd,.md-typeset pre{white-space:pre-wrap}}.md-typeset code{background-color:var(--md-code-bg-color);border-radius:.1rem;-webkit-box-decoration-break:clone;box-decoration-break:clone;font-size:.85em;padding:0 .2941176471em;transition:color 125ms,background-color 125ms;word-break:break-word}.md-typeset code:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-typeset pre{display:flow-root;line-height:1.4;position:relative}.md-typeset pre>code{-webkit-box-decoration-break:slice;box-decoration-break:slice;box-shadow:none;display:block;margin:0;outline-color:var(--md-accent-fg-color);overflow:auto;padding:.7720588235em 1.1764705882em;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin;touch-action:auto;word-break:normal}.md-typeset pre>code:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-typeset pre>code::-webkit-scrollbar{height:.2rem;width:.2rem}.md-typeset pre>code::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-typeset pre>code::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}.md-typeset kbd{background-color:var(--md-typeset-kbd-color);border-radius:.1rem;box-shadow:0 .1rem 0 .05rem var(--md-typeset-kbd-border-color),0 .1rem 0 var(--md-typeset-kbd-border-color),0 -.1rem .2rem var(--md-typeset-kbd-accent-color) inset;color:var(--md-default-fg-color);display:inline-block;font-size:.75em;padding:0 .6666666667em;vertical-align:text-top;word-break:break-word}.md-typeset mark{background-color:var(--md-typeset-mark-color);-webkit-box-decoration-break:clone;box-decoration-break:clone;color:inherit;word-break:break-word}.md-typeset abbr{cursor:help;text-decoration:none}.md-typeset [data-preview],.md-typeset abbr{border-bottom:.05rem dotted var(--md-default-fg-color--light)}.md-typeset small{opacity:.75}[dir=ltr] .md-typeset sub,[dir=ltr] .md-typeset sup{margin-left:.078125em}[dir=rtl] .md-typeset sub,[dir=rtl] .md-typeset sup{margin-right:.078125em}[dir=ltr] .md-typeset blockquote{padding-left:.6rem}[dir=rtl] .md-typeset blockquote{padding-right:.6rem}[dir=ltr] .md-typeset blockquote{border-left:.2rem solid var(--md-default-fg-color--lighter)}[dir=rtl] .md-typeset blockquote{border-right:.2rem solid var(--md-default-fg-color--lighter)}.md-typeset blockquote{color:var(--md-default-fg-color--light);margin-left:0;margin-right:0}.md-typeset ul{list-style-type:disc}[dir=ltr] .md-typeset ol,[dir=ltr] .md-typeset ul{margin-left:.625em}[dir=rtl] .md-typeset ol,[dir=rtl] .md-typeset ul{margin-right:.625em}.md-typeset ol,.md-typeset ul{padding:0}.md-typeset ol:not([hidden]),.md-typeset ul:not([hidden]){display:flow-root}.md-typeset ol ol,.md-typeset ul ol{list-style-type:lower-alpha}.md-typeset ol ol ol,.md-typeset ul ol ol{list-style-type:lower-roman}[dir=ltr] .md-typeset ol li,[dir=ltr] .md-typeset ul li{margin-left:1.25em}[dir=rtl] .md-typeset ol li,[dir=rtl] .md-typeset ul li{margin-right:1.25em}.md-typeset ol li,.md-typeset ul li{margin-bottom:.5em}.md-typeset ol li blockquote,.md-typeset ol li p,.md-typeset ul li blockquote,.md-typeset ul li p{margin:.5em 0}.md-typeset ol li:last-child,.md-typeset ul li:last-child{margin-bottom:0}[dir=ltr] .md-typeset ol li ol,[dir=ltr] .md-typeset ol li ul,[dir=ltr] .md-typeset ul li ol,[dir=ltr] .md-typeset ul li ul{margin-left:.625em}[dir=rtl] .md-typeset ol li ol,[dir=rtl] .md-typeset ol li ul,[dir=rtl] .md-typeset ul li ol,[dir=rtl] .md-typeset ul li ul{margin-right:.625em}.md-typeset ol li ol,.md-typeset ol li ul,.md-typeset ul li ol,.md-typeset ul li ul{margin-bottom:.5em;margin-top:.5em}[dir=ltr] .md-typeset dd{margin-left:1.875em}[dir=rtl] .md-typeset dd{margin-right:1.875em}.md-typeset dd{margin-bottom:1.5em;margin-top:1em}.md-typeset img,.md-typeset svg,.md-typeset video{height:auto;max-width:100%}.md-typeset img[align=left]{margin:1em 1em 1em 0}.md-typeset img[align=right]{margin:1em 0 1em 1em}.md-typeset img[align]:only-child{margin-top:0}.md-typeset figure{display:flow-root;margin:1em auto;max-width:100%;text-align:center;width:-moz-fit-content;width:fit-content}.md-typeset figure img{display:block;margin:0 auto}.md-typeset figcaption{font-style:italic;margin:1em auto;max-width:24rem}.md-typeset iframe{max-width:100%}.md-typeset table:not([class]){background-color:var(--md-default-bg-color);border:.05rem solid var(--md-typeset-table-color);border-radius:.1rem;display:inline-block;font-size:.64rem;max-width:100%;overflow:auto;touch-action:auto}@media print{.md-typeset table:not([class]){display:table}}.md-typeset table:not([class])+*{margin-top:1.5em}.md-typeset table:not([class]) td>:first-child,.md-typeset table:not([class]) th>:first-child{margin-top:0}.md-typeset table:not([class]) td>:last-child,.md-typeset table:not([class]) th>:last-child{margin-bottom:0}.md-typeset table:not([class]) td:not([align]),.md-typeset table:not([class]) th:not([align]){text-align:left}[dir=rtl] .md-typeset table:not([class]) td:not([align]),[dir=rtl] .md-typeset table:not([class]) th:not([align]){text-align:right}.md-typeset table:not([class]) th{font-weight:700;min-width:5rem;padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) td{border-top:.05rem solid var(--md-typeset-table-color);padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) tbody tr{transition:background-color 125ms}.md-typeset table:not([class]) tbody tr:hover{background-color:var(--md-typeset-table-color--light);box-shadow:0 .05rem 0 var(--md-default-bg-color) inset}.md-typeset table:not([class]) a{word-break:normal}.md-typeset table th[role=columnheader]{cursor:pointer}[dir=ltr] .md-typeset table th[role=columnheader]:after{margin-left:.5em}[dir=rtl] .md-typeset table th[role=columnheader]:after{margin-right:.5em}.md-typeset table th[role=columnheader]:after{content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-typeset-table-sort-icon);mask-image:var(--md-typeset-table-sort-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset table th[role=columnheader]:hover:after{background-color:var(--md-default-fg-color--lighter)}.md-typeset table th[role=columnheader][aria-sort=ascending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--asc);mask-image:var(--md-typeset-table-sort-icon--asc)}.md-typeset table th[role=columnheader][aria-sort=descending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--desc);mask-image:var(--md-typeset-table-sort-icon--desc)}.md-typeset__scrollwrap{margin:1em -.8rem;overflow-x:auto;touch-action:auto}.md-typeset__table{display:inline-block;margin-bottom:.5em;padding:0 .8rem}@media print{.md-typeset__table{display:block}}html .md-typeset__table table{display:table;margin:0;overflow:hidden;width:100%}@media screen and (max-width:44.984375em){.md-content__inner>pre{margin:1em -.8rem}.md-content__inner>pre code{border-radius:0}}.md-typeset .md-author{border-radius:100%;display:block;flex-shrink:0;height:1.6rem;overflow:hidden;position:relative;transition:color 125ms,transform 125ms;width:1.6rem}.md-typeset .md-author img{display:block}.md-typeset .md-author--more{background:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--lighter);font-size:.6rem;font-weight:700;line-height:1.6rem;text-align:center}.md-typeset .md-author--long{height:2.4rem;width:2.4rem}.md-typeset a.md-author{transform:scale(1)}.md-typeset a.md-author img{border-radius:100%;filter:grayscale(100%) opacity(75%);transition:filter 125ms}.md-typeset a.md-author:focus,.md-typeset a.md-author:hover{transform:scale(1.1);z-index:1}.md-typeset a.md-author:focus img,.md-typeset a.md-author:hover img{filter:grayscale(0)}.md-banner{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color);overflow:auto}@media print{.md-banner{display:none}}.md-banner--warning{background-color:var(--md-warning-bg-color);color:var(--md-warning-fg-color)}.md-banner__inner{font-size:.7rem;margin:.6rem auto;padding:0 .8rem}[dir=ltr] .md-banner__button{float:right}[dir=rtl] .md-banner__button{float:left}.md-banner__button{color:inherit;cursor:pointer;transition:opacity .25s}.no-js .md-banner__button{display:none}.md-banner__button:hover{opacity:.7}html{font-size:125%;height:100%;overflow-x:hidden}@media screen and (min-width:100em){html{font-size:137.5%}}@media screen and (min-width:125em){html{font-size:150%}}body{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;font-size:.5rem;min-height:100%;position:relative;width:100%}@media print{body{display:block}}@media screen and (max-width:59.984375em){body[data-md-scrolllock]{position:fixed}}.md-grid{margin-left:auto;margin-right:auto;max-width:61rem}.md-container{display:flex;flex-direction:column;flex-grow:1}@media print{.md-container{display:block}}.md-main{flex-grow:1}.md-main__inner{display:flex;height:100%;margin-top:1.5rem}.md-ellipsis{overflow:hidden;text-overflow:ellipsis}.md-toggle{display:none}.md-option{height:0;opacity:0;position:absolute;width:0}.md-option:checked+label:not([hidden]){display:block}.md-option.focus-visible+label{outline-color:var(--md-accent-fg-color);outline-style:auto}.md-skip{background-color:var(--md-default-fg-color);border-radius:.1rem;color:var(--md-default-bg-color);font-size:.64rem;margin:.5rem;opacity:0;outline-color:var(--md-accent-fg-color);padding:.3rem .5rem;position:fixed;transform:translateY(.4rem);z-index:-1}.md-skip:focus{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 175ms 75ms;z-index:10}@page{margin:25mm}:root{--md-clipboard-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 21H8V7h11m0-2H8a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2m-3-4H4a2 2 0 0 0-2 2v14h2V3h12V1Z"/></svg>')}.md-clipboard{border-radius:.1rem;color:var(--md-default-fg-color--lightest);cursor:pointer;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;transition:color .25s;width:1.5em;z-index:1}@media print{.md-clipboard{display:none}}.md-clipboard:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}:hover>.md-clipboard{color:var(--md-default-fg-color--light)}.md-clipboard:focus,.md-clipboard:hover{color:var(--md-accent-fg-color)}.md-clipboard:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-image:var(--md-clipboard-icon);mask-image:var(--md-clipboard-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-clipboard--inline{cursor:pointer}.md-clipboard--inline code{transition:color .25s,background-color .25s}.md-clipboard--inline:focus code,.md-clipboard--inline:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}:root{--md-code-select-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 19h-4v2h4c1.1 0 2-.9 2-2v-4h-2m0-12h-4v2h4v4h2V5c0-1.1-.9-2-2-2M5 5h4V3H5c-1.1 0-2 .9-2 2v4h2m0 6H3v4c0 1.1.9 2 2 2h4v-2H5v-4m2-4h2v2H7v-2m4 0h2v2h-2v-2m4 0h2v2h-2v-2M7 7h2v2H7V7m4 0h2v2h-2V7m4 0h2v2h-2V7m-8 8h2v2H7v-2m4 0h2v2h-2v-2m4 0h2v2h-2v-2Z"/></svg>');--md-code-copy-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 21H8V7h11m0-2H8a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2m-3-4H4a2 2 0 0 0-2 2v14h2V3h12V1Z"/></svg>')}.md-typeset .md-code__content{display:grid}.md-code__nav{background-color:var(--md-code-bg-color--lighter);border-radius:.1rem;display:flex;gap:.2rem;padding:.2rem;position:absolute;right:.25em;top:.25em;transition:background-color .25s;z-index:1}:hover>.md-code__nav{background-color:var(--md-code-bg-color--light)}.md-code__button{color:var(--md-default-fg-color--lightest);cursor:pointer;display:block;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;transition:color .25s;width:1.5em}:hover>*>.md-code__button{color:var(--md-default-fg-color--light)}.md-code__button.focus-visible,.md-code__button:hover{color:var(--md-accent-fg-color)}.md-code__button--active{color:var(--md-default-fg-color)!important}.md-code__button:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-code__button[data-md-type=select]:after{-webkit-mask-image:var(--md-code-select-icon);mask-image:var(--md-code-select-icon)}.md-code__button[data-md-type=copy]:after{-webkit-mask-image:var(--md-code-copy-icon);mask-image:var(--md-code-copy-icon)}@keyframes consent{0%{opacity:0;transform:translateY(100%)}to{opacity:1;transform:translateY(0)}}@keyframes overlay{0%{opacity:0}to{opacity:1}}.md-consent__overlay{animation:overlay .25s both;-webkit-backdrop-filter:blur(.1rem);backdrop-filter:blur(.1rem);background-color:#0000008a;height:100%;opacity:1;position:fixed;top:0;width:100%;z-index:5}.md-consent__inner{animation:consent .5s cubic-bezier(.1,.7,.1,1) both;background-color:var(--md-default-bg-color);border:0;border-radius:.1rem;bottom:0;box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;max-height:100%;overflow:auto;padding:0;position:fixed;width:100%;z-index:5}.md-consent__form{padding:.8rem}.md-consent__settings{display:none;margin:1em 0}input:checked+.md-consent__settings{display:block}.md-consent__controls{margin-bottom:.8rem}.md-typeset .md-consent__controls .md-button{display:inline}@media screen and (max-width:44.984375em){.md-typeset .md-consent__controls .md-button{display:block;margin-top:.4rem;text-align:center;width:100%}}.md-consent label{cursor:pointer}.md-content{flex-grow:1;min-width:0}.md-content__inner{margin:0 .8rem 1.2rem;padding-top:.6rem}@media screen and (min-width:76.25em){[dir=ltr] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}[dir=ltr] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner,[dir=rtl] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-right:1.2rem}[dir=rtl] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}}.md-content__inner:before{content:"";display:block;height:.4rem}.md-content__inner>:last-child{margin-bottom:0}[dir=ltr] .md-content__button{float:right}[dir=rtl] .md-content__button{float:left}[dir=ltr] .md-content__button{margin-left:.4rem}[dir=rtl] .md-content__button{margin-right:.4rem}.md-content__button{margin:.4rem 0;padding:0}@media print{.md-content__button{display:none}}.md-typeset .md-content__button{color:var(--md-default-fg-color--lighter)}.md-content__button svg{display:inline;vertical-align:top}[dir=rtl] .md-content__button svg{transform:scaleX(-1)}[dir=ltr] .md-dialog{right:.8rem}[dir=rtl] .md-dialog{left:.8rem}.md-dialog{background-color:var(--md-default-fg-color);border-radius:.1rem;bottom:.8rem;box-shadow:var(--md-shadow-z3);min-width:11.1rem;opacity:0;padding:.4rem .6rem;pointer-events:none;position:fixed;transform:translateY(100%);transition:transform 0ms .4s,opacity .4s;z-index:4}@media print{.md-dialog{display:none}}.md-dialog--active{opacity:1;pointer-events:auto;transform:translateY(0);transition:transform .4s cubic-bezier(.075,.85,.175,1),opacity .4s}.md-dialog__inner{color:var(--md-default-bg-color);font-size:.7rem}.md-feedback{margin:2em 0 1em;text-align:center}.md-feedback fieldset{border:none;margin:0;padding:0}.md-feedback__title{font-weight:700;margin:1em auto}.md-feedback__inner{position:relative}.md-feedback__list{display:flex;flex-wrap:wrap;place-content:baseline center;position:relative}.md-feedback__list:hover .md-icon:not(:disabled){color:var(--md-default-fg-color--lighter)}:disabled .md-feedback__list{min-height:1.8rem}.md-feedback__icon{color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;margin:0 .1rem;transition:color 125ms}.md-feedback__icon:not(:disabled).md-icon:hover{color:var(--md-accent-fg-color)}.md-feedback__icon:disabled{color:var(--md-default-fg-color--lightest);pointer-events:none}.md-feedback__note{opacity:0;position:relative;transform:translateY(.4rem);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-feedback__note>*{margin:0 auto;max-width:16rem}:disabled .md-feedback__note{opacity:1;transform:translateY(0)}.md-footer{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color)}@media print{.md-footer{display:none}}.md-footer__inner{justify-content:space-between;overflow:auto;padding:.2rem}.md-footer__inner:not([hidden]){display:flex}.md-footer__link{align-items:end;display:flex;flex-grow:0.01;margin-bottom:.4rem;margin-top:1rem;max-width:100%;outline-color:var(--md-accent-fg-color);overflow:hidden;transition:opacity .25s}.md-footer__link:focus,.md-footer__link:hover{opacity:.7}[dir=rtl] .md-footer__link svg{transform:scaleX(-1)}@media screen and (max-width:44.984375em){.md-footer__link--prev{flex-shrink:0}.md-footer__link--prev .md-footer__title{display:none}}[dir=ltr] .md-footer__link--next{margin-left:auto}[dir=rtl] .md-footer__link--next{margin-right:auto}.md-footer__link--next{text-align:right}[dir=rtl] .md-footer__link--next{text-align:left}.md-footer__title{flex-grow:1;font-size:.9rem;margin-bottom:.7rem;max-width:calc(100% - 2.4rem);padding:0 1rem;white-space:nowrap}.md-footer__button{margin:.2rem;padding:.4rem}.md-footer__direction{font-size:.64rem;opacity:.7}.md-footer-meta{background-color:var(--md-footer-bg-color--dark)}.md-footer-meta__inner{display:flex;flex-wrap:wrap;justify-content:space-between;padding:.2rem}html .md-footer-meta.md-typeset a{color:var(--md-footer-fg-color--light)}html .md-footer-meta.md-typeset a:focus,html .md-footer-meta.md-typeset a:hover{color:var(--md-footer-fg-color)}.md-copyright{color:var(--md-footer-fg-color--lighter);font-size:.64rem;margin:auto .6rem;padding:.4rem 0;width:100%}@media screen and (min-width:45em){.md-copyright{width:auto}}.md-copyright__highlight{color:var(--md-footer-fg-color--light)}.md-social{display:inline-flex;gap:.2rem;margin:0 .4rem;padding:.2rem 0 .6rem}@media screen and (min-width:45em){.md-social{padding:.6rem 0}}.md-social__link{display:inline-block;height:1.6rem;text-align:center;width:1.6rem}.md-social__link:before{line-height:1.9}.md-social__link svg{fill:currentcolor;max-height:.8rem;vertical-align:-25%}.md-typeset .md-button{border:.1rem solid;border-radius:.1rem;color:var(--md-primary-fg-color);cursor:pointer;display:inline-block;font-weight:700;padding:.625em 2em;transition:color 125ms,background-color 125ms,border-color 125ms}.md-typeset .md-button--primary{background-color:var(--md-primary-fg-color);border-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color)}.md-typeset .md-button:focus,.md-typeset .md-button:hover{background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[dir=ltr] .md-typeset .md-input{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .md-input,[dir=rtl] .md-typeset .md-input{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .md-input{border-top-left-radius:.1rem}.md-typeset .md-input{border-bottom:.1rem solid var(--md-default-fg-color--lighter);box-shadow:var(--md-shadow-z1);font-size:.8rem;height:1.8rem;padding:0 .6rem;transition:border .25s,box-shadow .25s}.md-typeset .md-input:focus,.md-typeset .md-input:hover{border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input--stretch{width:100%}.md-header{background-color:var(--md-primary-fg-color);box-shadow:0 0 .2rem #0000,0 .2rem .4rem #0000;color:var(--md-primary-bg-color);display:block;left:0;position:sticky;right:0;top:0;z-index:4}@media print{.md-header{display:none}}.md-header[hidden]{transform:translateY(-100%);transition:transform .25s cubic-bezier(.8,0,.6,1),box-shadow .25s}.md-header--shadow{box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;transition:transform .25s cubic-bezier(.1,.7,.1,1),box-shadow .25s}.md-header__inner{align-items:center;display:flex;padding:0 .2rem}.md-header__button{color:currentcolor;cursor:pointer;margin:.2rem;outline-color:var(--md-accent-fg-color);padding:.4rem;position:relative;transition:opacity .25s;vertical-align:middle;z-index:1}.md-header__button:hover{opacity:.7}.md-header__button:not([hidden]){display:inline-block}.md-header__button:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-header__button.md-logo{margin:.2rem;padding:.4rem}@media screen and (max-width:76.234375em){.md-header__button.md-logo{display:none}}.md-header__button.md-logo img,.md-header__button.md-logo svg{fill:currentcolor;display:block;height:1.2rem;width:auto}@media screen and (min-width:60em){.md-header__button[for=__search]{display:none}}.no-js .md-header__button[for=__search]{display:none}[dir=rtl] .md-header__button[for=__search] svg{transform:scaleX(-1)}@media screen and (min-width:76.25em){.md-header__button[for=__drawer]{display:none}}.md-header__topic{display:flex;max-width:100%;position:absolute;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;white-space:nowrap}.md-header__topic+.md-header__topic{opacity:0;pointer-events:none;transform:translateX(1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__topic+.md-header__topic{transform:translateX(-1.25rem)}.md-header__topic:first-child{font-weight:700}[dir=ltr] .md-header__title{margin-left:1rem;margin-right:.4rem}[dir=rtl] .md-header__title{margin-left:.4rem;margin-right:1rem}.md-header__title{flex-grow:1;font-size:.9rem;height:2.4rem;line-height:2.4rem}.md-header__title--active .md-header__topic{opacity:0;pointer-events:none;transform:translateX(-1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__title--active .md-header__topic{transform:translateX(1.25rem)}.md-header__title--active .md-header__topic+.md-header__topic{opacity:1;pointer-events:auto;transform:translateX(0);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;z-index:0}.md-header__title>.md-header__ellipsis{height:100%;position:relative;width:100%}.md-header__option{display:flex;flex-shrink:0;max-width:100%;transition:max-width 0ms .25s,opacity .25s .25s;white-space:nowrap}[data-md-toggle=search]:checked~.md-header .md-header__option{max-width:0;opacity:0;transition:max-width 0ms,opacity 0ms}.md-header__option>input{bottom:0}.md-header__source{display:none}@media screen and (min-width:60em){[dir=ltr] .md-header__source{margin-left:1rem}[dir=rtl] .md-header__source{margin-right:1rem}.md-header__source{display:block;max-width:11.7rem;width:11.7rem}}@media screen and (min-width:76.25em){[dir=ltr] .md-header__source{margin-left:1.4rem}[dir=rtl] .md-header__source{margin-right:1.4rem}}.md-meta{color:var(--md-default-fg-color--light);font-size:.7rem;line-height:1.3}.md-meta__list{display:inline-flex;flex-wrap:wrap;list-style:none;margin:0;padding:0}.md-meta__item:not(:last-child):after{content:"·";margin-left:.2rem;margin-right:.2rem}.md-meta__link{color:var(--md-typeset-a-color)}.md-meta__link:focus,.md-meta__link:hover{color:var(--md-accent-fg-color)}.md-draft{background-color:#ff1744;border-radius:.125em;color:#fff;display:inline-block;font-weight:700;padding-left:.5714285714em;padding-right:.5714285714em}:root{--md-nav-icon--prev:url('data:image/svg+xml;charset=utf-8,<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>');--md-nav-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>');--md-toc-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 9h14V7H3v2m0 4h14v-2H3v2m0 4h14v-2H3v2m16 0h2v-2h-2v2m0-10v2h2V7h-2m0 6h2v-2h-2v2Z"/></svg>')}.md-nav{font-size:.7rem;line-height:1.3}.md-nav__title{color:var(--md-default-fg-color--light);display:block;font-weight:700;overflow:hidden;padding:0 .6rem;text-overflow:ellipsis}.md-nav__title .md-nav__button{display:none}.md-nav__title .md-nav__button img{height:100%;width:auto}.md-nav__title .md-nav__button.md-logo img,.md-nav__title .md-nav__button.md-logo svg{fill:currentcolor;display:block;height:2.4rem;max-width:100%;object-fit:contain;width:auto}.md-nav__list{list-style:none;margin:0;padding:0}.md-nav__link{align-items:flex-start;display:flex;gap:.4rem;margin-top:.625em;scroll-snap-align:start;transition:color 125ms}.md-nav__link--passed,.md-nav__link--passed code{color:var(--md-default-fg-color--light)}.md-nav__item .md-nav__link--active,.md-nav__item .md-nav__link--active code{color:var(--md-typeset-a-color)}.md-nav__link .md-ellipsis{position:relative}.md-nav__link .md-ellipsis code{word-break:normal}[dir=ltr] .md-nav__link .md-icon:last-child{margin-left:auto}[dir=rtl] .md-nav__link .md-icon:last-child{margin-right:auto}.md-nav__link .md-typeset{font-size:.7rem;line-height:1.3}.md-nav__link svg{fill:currentcolor;flex-shrink:0;height:1.3em;position:relative}.md-nav__link[for]:focus,.md-nav__link[for]:hover,.md-nav__link[href]:focus,.md-nav__link[href]:hover{color:var(--md-accent-fg-color);cursor:pointer}.md-nav__link[for]:focus code,.md-nav__link[for]:hover code,.md-nav__link[href]:focus code,.md-nav__link[href]:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-nav__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-nav--primary .md-nav__link[for=__toc]{display:none}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{background-color:currentcolor;display:block;height:100%;-webkit-mask-image:var(--md-toc-icon);mask-image:var(--md-toc-icon);width:100%}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:none}.md-nav__container>.md-nav__link{margin-top:0}.md-nav__container>.md-nav__link:first-child{flex-grow:1;min-width:0}.md-nav__icon{flex-shrink:0}.md-nav__source{display:none}@media screen and (max-width:76.234375em){.md-nav--primary,.md-nav--primary .md-nav{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;height:100%;left:0;position:absolute;right:0;top:0;z-index:1}.md-nav--primary .md-nav__item,.md-nav--primary .md-nav__title{font-size:.8rem;line-height:1.5}.md-nav--primary .md-nav__title{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);cursor:pointer;height:5.6rem;line-height:2.4rem;padding:3rem .8rem .2rem;position:relative;white-space:nowrap}[dir=ltr] .md-nav--primary .md-nav__title .md-nav__icon{left:.4rem}[dir=rtl] .md-nav--primary .md-nav__title .md-nav__icon{right:.4rem}.md-nav--primary .md-nav__title .md-nav__icon{display:block;height:1.2rem;margin:.2rem;position:absolute;top:.4rem;width:1.2rem}.md-nav--primary .md-nav__title .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--prev);mask-image:var(--md-nav-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}.md-nav--primary .md-nav__title~.md-nav__list{background-color:var(--md-default-bg-color);box-shadow:0 .05rem 0 var(--md-default-fg-color--lightest) inset;overflow-y:auto;scroll-snap-type:y mandatory;touch-action:pan-y}.md-nav--primary .md-nav__title~.md-nav__list>:first-child{border-top:0}.md-nav--primary .md-nav__title[for=__drawer]{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);font-weight:700}.md-nav--primary .md-nav__title .md-logo{display:block;left:.2rem;margin:.2rem;padding:.4rem;position:absolute;right:.2rem;top:.2rem}.md-nav--primary .md-nav__list{flex:1}.md-nav--primary .md-nav__item{border-top:.05rem solid var(--md-default-fg-color--lightest)}.md-nav--primary .md-nav__item--active>.md-nav__link{color:var(--md-typeset-a-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:focus,.md-nav--primary .md-nav__item--active>.md-nav__link:hover{color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__link{margin-top:0;padding:.6rem .8rem}.md-nav--primary .md-nav__link svg{margin-top:.1em}.md-nav--primary .md-nav__link>.md-nav__link{padding:0}[dir=ltr] .md-nav--primary .md-nav__link .md-nav__icon{margin-right:-.2rem}[dir=rtl] .md-nav--primary .md-nav__link .md-nav__icon{margin-left:-.2rem}.md-nav--primary .md-nav__link .md-nav__icon{font-size:1.2rem;height:1.2rem;width:1.2rem}.md-nav--primary .md-nav__link .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-nav--primary .md-nav__icon:after{transform:scale(-1)}.md-nav--primary .md-nav--secondary .md-nav{background-color:initial;position:static}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-left:1.4rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-right:1.4rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-left:2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-right:2rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-left:2.6rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-right:2.6rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-left:3.2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-right:3.2rem}.md-nav--secondary{background-color:initial}.md-nav__toggle~.md-nav{display:flex;opacity:0;transform:translateX(100%);transition:transform .25s cubic-bezier(.8,0,.6,1),opacity 125ms 50ms}[dir=rtl] .md-nav__toggle~.md-nav{transform:translateX(-100%)}.md-nav__toggle:checked~.md-nav{opacity:1;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 125ms 125ms}.md-nav__toggle:checked~.md-nav>.md-nav__list{-webkit-backface-visibility:hidden;backface-visibility:hidden}}@media screen and (max-width:59.984375em){.md-nav--primary .md-nav__link[for=__toc]{display:flex}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--primary .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:flex}.md-nav__source{background-color:var(--md-primary-fg-color--dark);color:var(--md-primary-bg-color);display:block;padding:0 .2rem}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-nav--integrated .md-nav__link[for=__toc]{display:flex}.md-nav--integrated .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--integrated .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--integrated .md-nav__link[for=__toc]~.md-nav{display:flex}}@media screen and (min-width:60em){.md-nav{margin-bottom:-.4rem}.md-nav--secondary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--secondary .md-nav__title[for=__toc]{scroll-snap-align:start}.md-nav--secondary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--secondary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--secondary .md-nav__list{padding-right:.6rem}.md-nav--secondary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--secondary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--secondary .md-nav__item>.md-nav__link{margin-left:.4rem}}@media screen and (min-width:76.25em){.md-nav{margin-bottom:-.4rem;transition:max-height .25s cubic-bezier(.86,0,.07,1)}.md-nav--primary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--primary .md-nav__title[for=__drawer]{scroll-snap-align:start}.md-nav--primary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--primary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--primary .md-nav__list{padding-right:.6rem}.md-nav--primary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--primary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--primary .md-nav__item>.md-nav__link{margin-left:.4rem}.md-nav__toggle~.md-nav{display:grid;grid-template-rows:0fr;opacity:0;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .25s,visibility 0ms .25s;visibility:collapse}.md-nav__toggle~.md-nav>.md-nav__list{overflow:hidden}.md-nav__toggle.md-toggle--indeterminate~.md-nav,.md-nav__toggle:checked~.md-nav{grid-template-rows:1fr;opacity:1;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .15s .1s,visibility 0ms;visibility:visible}.md-nav__toggle.md-toggle--indeterminate~.md-nav{transition:none}.md-nav__item--nested>.md-nav>.md-nav__title{display:none}.md-nav__item--section{display:block;margin:1.25em 0}.md-nav__item--section:last-child{margin-bottom:0}.md-nav__item--section>.md-nav__link{font-weight:700}.md-nav__item--section>.md-nav__link[for]{color:var(--md-default-fg-color--light)}.md-nav__item--section>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav__item--section>.md-nav__link .md-icon,.md-nav__item--section>.md-nav__link>[for]{display:none}[dir=ltr] .md-nav__item--section>.md-nav{margin-left:-.6rem}[dir=rtl] .md-nav__item--section>.md-nav{margin-right:-.6rem}.md-nav__item--section>.md-nav{display:block;opacity:1;visibility:visible}.md-nav__item--section>.md-nav>.md-nav__list>.md-nav__item{padding:0}.md-nav__icon{border-radius:100%;height:.9rem;transition:background-color .25s;width:.9rem}.md-nav__icon:hover{background-color:var(--md-accent-fg-color--transparent)}.md-nav__icon:after{background-color:currentcolor;border-radius:100%;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:transform .25s;vertical-align:-.1rem;width:100%}[dir=rtl] .md-nav__icon:after{transform:rotate(180deg)}.md-nav__item--nested .md-nav__toggle:checked~.md-nav__link .md-nav__icon:after,.md-nav__item--nested .md-toggle--indeterminate~.md-nav__link .md-nav__icon:after{transform:rotate(90deg)}.md-nav--lifted>.md-nav__list>.md-nav__item,.md-nav--lifted>.md-nav__title{display:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active{display:block}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);margin-top:0;position:sticky;top:0;z-index:1}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active.md-nav__item--section{margin:0}[dir=ltr] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-left:-.6rem}[dir=rtl] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-right:-.6rem}.md-nav--lifted>.md-nav__list>.md-nav__item>[for]{color:var(--md-default-fg-color--light)}.md-nav--lifted .md-nav[data-md-level="1"]{grid-template-rows:1fr;opacity:1;visibility:visible}[dir=ltr] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-left:.05rem solid var(--md-primary-fg-color)}[dir=rtl] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-right:.05rem solid var(--md-primary-fg-color)}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{display:block;margin-bottom:1.25em;opacity:1;visibility:visible}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__list{overflow:visible;padding-bottom:0}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__title{display:none}}.md-pagination{font-size:.8rem;font-weight:700;gap:.4rem}.md-pagination,.md-pagination>*{align-items:center;display:flex;justify-content:center}.md-pagination>*{border-radius:.2rem;height:1.8rem;min-width:1.8rem;text-align:center}.md-pagination__current{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light)}.md-pagination__link{transition:color 125ms,background-color 125ms}.md-pagination__link:focus,.md-pagination__link:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-pagination__link:focus svg,.md-pagination__link:hover svg{color:var(--md-accent-fg-color)}.md-pagination__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-pagination__link svg{fill:currentcolor;color:var(--md-default-fg-color--lighter);display:block;max-height:100%;width:1.2rem}:root{--md-path-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>')}.md-path{font-size:.7rem;margin:0 .8rem;overflow:auto;padding-top:1.2rem}.md-path:not([hidden]){display:block}@media screen and (min-width:76.25em){.md-path{margin:0 1.2rem}}.md-path__list{align-items:center;display:flex;gap:.2rem;list-style:none;margin:0;padding:0}.md-path__item:not(:first-child){display:inline-flex;gap:.2rem;white-space:nowrap}.md-path__item:not(:first-child):before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline;height:.8rem;-webkit-mask-image:var(--md-path-icon);mask-image:var(--md-path-icon);width:.8rem}.md-path__link{align-items:center;color:var(--md-default-fg-color--light);display:flex}.md-path__link:focus,.md-path__link:hover{color:var(--md-accent-fg-color)}:root{--md-post-pin-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M16 12V4h1V2H7v2h1v8l-2 2v2h5.2v6h1.6v-6H18v-2l-2-2Z"/></svg>')}.md-post__back{border-bottom:.05rem solid var(--md-default-fg-color--lightest);margin-bottom:1.2rem;padding-bottom:1.2rem}@media screen and (max-width:76.234375em){.md-post__back{display:none}}[dir=rtl] .md-post__back svg{transform:scaleX(-1)}.md-post__authors{display:flex;flex-direction:column;gap:.6rem;margin:0 .6rem 1.2rem}.md-post .md-post__meta a{transition:color 125ms}.md-post .md-post__meta a:focus,.md-post .md-post__meta a:hover{color:var(--md-accent-fg-color)}.md-post__title{color:var(--md-default-fg-color--light);font-weight:700}.md-post--excerpt{margin-bottom:3.2rem}.md-post--excerpt .md-post__header{align-items:center;display:flex;gap:.6rem;min-height:1.6rem}.md-post--excerpt .md-post__authors{align-items:center;display:inline-flex;flex-direction:row;gap:.2rem;margin:0;min-height:2.4rem}[dir=ltr] .md-post--excerpt .md-post__meta .md-meta__list{margin-right:.4rem}[dir=rtl] .md-post--excerpt .md-post__meta .md-meta__list{margin-left:.4rem}.md-post--excerpt .md-post__content>:first-child{--md-scroll-margin:6rem;margin-top:0}.md-post>.md-nav--secondary{margin:1em 0}.md-pin{background:var(--md-default-fg-color--lightest);border-radius:1rem;margin-top:-.05rem;padding:.2rem}.md-pin:after{background-color:currentcolor;content:"";display:block;height:.6rem;margin:0 auto;-webkit-mask-image:var(--md-post-pin-icon);mask-image:var(--md-post-pin-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.6rem}.md-profile{align-items:center;display:flex;font-size:.7rem;gap:.6rem;line-height:1.4;width:100%}.md-profile__description{flex-grow:1}.md-content--post{display:flex}@media screen and (max-width:76.234375em){.md-content--post{flex-flow:column-reverse}}.md-content--post>.md-content__inner{min-width:0}@media screen and (min-width:76.25em){[dir=ltr] .md-content--post>.md-content__inner{margin-left:1.2rem}[dir=rtl] .md-content--post>.md-content__inner{margin-right:1.2rem}}@media screen and (max-width:76.234375em){.md-sidebar.md-sidebar--post{padding:0;position:static;width:100%}.md-sidebar.md-sidebar--post .md-sidebar__scrollwrap{overflow:visible}.md-sidebar.md-sidebar--post .md-sidebar__inner{padding:0}.md-sidebar.md-sidebar--post .md-post__meta{margin-left:.6rem;margin-right:.6rem}.md-sidebar.md-sidebar--post .md-nav__item{border:none;display:inline}.md-sidebar.md-sidebar--post .md-nav__list{display:inline-flex;flex-wrap:wrap;gap:.6rem;padding-bottom:.6rem;padding-top:.6rem}.md-sidebar.md-sidebar--post .md-nav__link{padding:0}.md-sidebar.md-sidebar--post .md-nav{height:auto;margin-bottom:0;position:static}}:root{--md-progress-value:0;--md-progress-delay:400ms}.md-progress{background:var(--md-primary-bg-color);height:.075rem;opacity:min(clamp(0,var(--md-progress-value),1),clamp(0,100 - var(--md-progress-value),1));position:fixed;top:0;transform:scaleX(calc(var(--md-progress-value)*1%));transform-origin:left;transition:transform .5s cubic-bezier(.19,1,.22,1),opacity .25s var(--md-progress-delay);width:100%;z-index:4}:root{--md-search-result-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h7c-.41-.25-.8-.56-1.14-.9-.33-.33-.61-.7-.86-1.1H6V4h7v5h5v1.18c.71.16 1.39.43 2 .82V8l-6-6m6.31 16.9c1.33-2.11.69-4.9-1.4-6.22-2.11-1.33-4.91-.68-6.22 1.4-1.34 2.11-.69 4.89 1.4 6.22 1.46.93 3.32.93 4.79.02L22 23.39 23.39 22l-3.08-3.1m-3.81.1a2.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.5Z"/></svg>')}.md-search{position:relative}@media screen and (min-width:60em){.md-search{padding:.2rem 0}}.no-js .md-search{display:none}.md-search__overlay{opacity:0;z-index:1}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__overlay{left:-2.2rem}[dir=rtl] .md-search__overlay{right:-2.2rem}.md-search__overlay{background-color:var(--md-default-bg-color);border-radius:1rem;height:2rem;overflow:hidden;pointer-events:none;position:absolute;top:-1rem;transform-origin:center;transition:transform .3s .1s,opacity .2s .2s;width:2rem}[data-md-toggle=search]:checked~.md-header .md-search__overlay{opacity:1;transition:transform .4s,opacity .1s}}@media screen and (min-width:60em){[dir=ltr] .md-search__overlay{left:0}[dir=rtl] .md-search__overlay{right:0}.md-search__overlay{background-color:#0000008a;cursor:pointer;height:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0}[data-md-toggle=search]:checked~.md-header .md-search__overlay{height:200vh;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@media screen and (max-width:29.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(45)}}@media screen and (min-width:30em) and (max-width:44.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(60)}}@media screen and (min-width:45em) and (max-width:59.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(75)}}.md-search__inner{-webkit-backface-visibility:hidden;backface-visibility:hidden}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__inner{left:0}[dir=rtl] .md-search__inner{right:0}.md-search__inner{height:0;opacity:0;overflow:hidden;position:fixed;top:0;transform:translateX(5%);transition:width 0ms .3s,height 0ms .3s,transform .15s cubic-bezier(.4,0,.2,1) .15s,opacity .15s .15s;width:0;z-index:2}[dir=rtl] .md-search__inner{transform:translateX(-5%)}[data-md-toggle=search]:checked~.md-header .md-search__inner{height:100%;opacity:1;transform:translateX(0);transition:width 0ms 0ms,height 0ms 0ms,transform .15s cubic-bezier(.1,.7,.1,1) .15s,opacity .15s .15s;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__inner{float:right}[dir=rtl] .md-search__inner{float:left}.md-search__inner{padding:.1rem 0;position:relative;transition:width .25s cubic-bezier(.1,.7,.1,1);width:11.7rem}}@media screen and (min-width:60em) and (max-width:76.234375em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:23.4rem}}@media screen and (min-width:76.25em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:34.4rem}}.md-search__form{background-color:var(--md-default-bg-color);box-shadow:0 0 .6rem #0000;height:2.4rem;position:relative;transition:color .25s,background-color .25s;z-index:2}@media screen and (min-width:60em){.md-search__form{background-color:#00000042;border-radius:.1rem;height:1.8rem}.md-search__form:hover{background-color:#ffffff1f}}[data-md-toggle=search]:checked~.md-header .md-search__form{background-color:var(--md-default-bg-color);border-radius:.1rem .1rem 0 0;box-shadow:0 0 .6rem #00000012;color:var(--md-default-fg-color)}[dir=ltr] .md-search__input{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__input{padding-left:2.2rem;padding-right:3.6rem}.md-search__input{background:#0000;font-size:.9rem;height:100%;position:relative;text-overflow:ellipsis;width:100%;z-index:2}.md-search__input::placeholder{transition:color .25s}.md-search__input::placeholder,.md-search__input~.md-search__icon{color:var(--md-default-fg-color--light)}.md-search__input::-ms-clear{display:none}@media screen and (max-width:59.984375em){.md-search__input{font-size:.9rem;height:2.4rem;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__input{padding-left:2.2rem}[dir=rtl] .md-search__input{padding-right:2.2rem}.md-search__input{color:inherit;font-size:.8rem}.md-search__input::placeholder{color:var(--md-primary-bg-color--light)}.md-search__input+.md-search__icon{color:var(--md-primary-bg-color)}[data-md-toggle=search]:checked~.md-header .md-search__input{text-overflow:clip}[data-md-toggle=search]:checked~.md-header .md-search__input+.md-search__icon{color:var(--md-default-fg-color--light)}[data-md-toggle=search]:checked~.md-header .md-search__input::placeholder{color:#0000}}.md-search__icon{cursor:pointer;display:inline-block;height:1.2rem;transition:color .25s,opacity .25s;width:1.2rem}.md-search__icon:hover{opacity:.7}[dir=ltr] .md-search__icon[for=__search]{left:.5rem}[dir=rtl] .md-search__icon[for=__search]{right:.5rem}.md-search__icon[for=__search]{position:absolute;top:.3rem;z-index:2}[dir=rtl] .md-search__icon[for=__search] svg{transform:scaleX(-1)}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__icon[for=__search]{left:.8rem}[dir=rtl] .md-search__icon[for=__search]{right:.8rem}.md-search__icon[for=__search]{top:.6rem}.md-search__icon[for=__search] svg:first-child{display:none}}@media screen and (min-width:60em){.md-search__icon[for=__search]{pointer-events:none}.md-search__icon[for=__search] svg:last-child{display:none}}[dir=ltr] .md-search__options{right:.5rem}[dir=rtl] .md-search__options{left:.5rem}.md-search__options{pointer-events:none;position:absolute;top:.3rem;z-index:2}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__options{right:.8rem}[dir=rtl] .md-search__options{left:.8rem}.md-search__options{top:.6rem}}[dir=ltr] .md-search__options>.md-icon{margin-left:.2rem}[dir=rtl] .md-search__options>.md-icon{margin-right:.2rem}.md-search__options>.md-icon{color:var(--md-default-fg-color--light);opacity:0;transform:scale(.75);transition:transform .15s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-search__options>.md-icon:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon{opacity:1;pointer-events:auto;transform:scale(1)}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon:hover{opacity:.7}[dir=ltr] .md-search__suggest{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__suggest{padding-left:2.2rem;padding-right:3.6rem}.md-search__suggest{align-items:center;color:var(--md-default-fg-color--lighter);display:flex;font-size:.9rem;height:100%;opacity:0;position:absolute;top:0;transition:opacity 50ms;white-space:nowrap;width:100%}@media screen and (min-width:60em){[dir=ltr] .md-search__suggest{padding-left:2.2rem}[dir=rtl] .md-search__suggest{padding-right:2.2rem}.md-search__suggest{font-size:.8rem}}[data-md-toggle=search]:checked~.md-header .md-search__suggest{opacity:1;transition:opacity .3s .1s}[dir=ltr] .md-search__output{border-bottom-left-radius:.1rem}[dir=ltr] .md-search__output,[dir=rtl] .md-search__output{border-bottom-right-radius:.1rem}[dir=rtl] .md-search__output{border-bottom-left-radius:.1rem}.md-search__output{overflow:hidden;position:absolute;width:100%;z-index:1}@media screen and (max-width:59.984375em){.md-search__output{bottom:0;top:2.4rem}}@media screen and (min-width:60em){.md-search__output{opacity:0;top:1.9rem;transition:opacity .4s}[data-md-toggle=search]:checked~.md-header .md-search__output{box-shadow:var(--md-shadow-z3);opacity:1}}.md-search__scrollwrap{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);height:100%;overflow-y:auto;touch-action:pan-y}@media (-webkit-max-device-pixel-ratio:1),(max-resolution:1dppx){.md-search__scrollwrap{transform:translateZ(0)}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-search__scrollwrap{width:23.4rem}}@media screen and (min-width:76.25em){.md-search__scrollwrap{width:34.4rem}}@media screen and (min-width:60em){.md-search__scrollwrap{max-height:0;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}[data-md-toggle=search]:checked~.md-header .md-search__scrollwrap{max-height:75vh}.md-search__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-search__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-search__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-search__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}}.md-search-result{color:var(--md-default-fg-color);word-break:break-word}.md-search-result__meta{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.8rem;padding:0 .8rem;scroll-snap-align:start}@media screen and (min-width:60em){[dir=ltr] .md-search-result__meta{padding-left:2.2rem}[dir=rtl] .md-search-result__meta{padding-right:2.2rem}}.md-search-result__list{list-style:none;margin:0;padding:0;-webkit-user-select:none;user-select:none}.md-search-result__item{box-shadow:0 -.05rem var(--md-default-fg-color--lightest)}.md-search-result__item:first-child{box-shadow:none}.md-search-result__link{display:block;outline:none;scroll-snap-align:start;transition:background-color .25s}.md-search-result__link:focus,.md-search-result__link:hover{background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:last-child p:last-child{margin-bottom:.6rem}.md-search-result__more>summary{cursor:pointer;display:block;outline:none;position:sticky;scroll-snap-align:start;top:0;z-index:1}.md-search-result__more>summary::marker{display:none}.md-search-result__more>summary::-webkit-details-marker{display:none}.md-search-result__more>summary>div{color:var(--md-typeset-a-color);font-size:.64rem;padding:.75em .8rem;transition:color .25s,background-color .25s}@media screen and (min-width:60em){[dir=ltr] .md-search-result__more>summary>div{padding-left:2.2rem}[dir=rtl] .md-search-result__more>summary>div{padding-right:2.2rem}}.md-search-result__more>summary:focus>div,.md-search-result__more>summary:hover>div{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more[open]>summary{background-color:var(--md-default-bg-color)}.md-search-result__article{overflow:hidden;padding:0 .8rem;position:relative}@media screen and (min-width:60em){[dir=ltr] .md-search-result__article{padding-left:2.2rem}[dir=rtl] .md-search-result__article{padding-right:2.2rem}}[dir=ltr] .md-search-result__icon{left:0}[dir=rtl] .md-search-result__icon{right:0}.md-search-result__icon{color:var(--md-default-fg-color--light);height:1.2rem;margin:.5rem;position:absolute;width:1.2rem}@media screen and (max-width:59.984375em){.md-search-result__icon{display:none}}.md-search-result__icon:after{background-color:currentcolor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-search-result-icon);mask-image:var(--md-search-result-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-search-result__icon:after{transform:scaleX(-1)}.md-search-result .md-typeset{color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.6}.md-search-result .md-typeset h1{color:var(--md-default-fg-color);font-size:.8rem;font-weight:400;line-height:1.4;margin:.55rem 0}.md-search-result .md-typeset h1 mark{text-decoration:none}.md-search-result .md-typeset h2{color:var(--md-default-fg-color);font-size:.64rem;font-weight:700;line-height:1.6;margin:.5em 0}.md-search-result .md-typeset h2 mark{text-decoration:none}.md-search-result__terms{color:var(--md-default-fg-color);display:block;font-size:.64rem;font-style:italic;margin:.5em 0}.md-search-result mark{background-color:initial;color:var(--md-accent-fg-color);text-decoration:underline}.md-select{position:relative;z-index:1}.md-select__inner{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);left:50%;margin-top:.2rem;max-height:0;opacity:0;position:absolute;top:calc(100% - .2rem);transform:translate3d(-50%,.3rem,0);transition:transform .25s 375ms,opacity .25s .25s,max-height 0ms .5s}.md-select:focus-within .md-select__inner,.md-select:hover .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select__inner:after{border-bottom:.2rem solid #0000;border-bottom-color:var(--md-default-bg-color);border-left:.2rem solid #0000;border-right:.2rem solid #0000;border-top:0;content:"";height:0;left:50%;margin-left:-.2rem;margin-top:-.2rem;position:absolute;top:0;width:0}.md-select__list{border-radius:.1rem;font-size:.8rem;list-style-type:none;margin:0;max-height:inherit;overflow:auto;padding:0}.md-select__item{line-height:1.8rem}[dir=ltr] .md-select__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-select__link{padding-left:1.2rem;padding-right:.6rem}.md-select__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:background-color .25s,color .25s;width:100%}.md-select__link:focus,.md-select__link:hover{color:var(--md-accent-fg-color)}.md-select__link:focus{background-color:var(--md-default-fg-color--lightest)}.md-sidebar{align-self:flex-start;flex-shrink:0;padding:1.2rem 0;position:sticky;top:2.4rem;width:12.1rem}@media print{.md-sidebar{display:none}}@media screen and (max-width:76.234375em){[dir=ltr] .md-sidebar--primary{left:-12.1rem}[dir=rtl] .md-sidebar--primary{right:-12.1rem}.md-sidebar--primary{background-color:var(--md-default-bg-color);display:block;height:100%;position:fixed;top:0;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),box-shadow .25s;width:12.1rem;z-index:5}[data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{box-shadow:var(--md-shadow-z3);transform:translateX(12.1rem)}[dir=rtl] [data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{transform:translateX(-12.1rem)}.md-sidebar--primary .md-sidebar__scrollwrap{bottom:0;left:0;margin:0;overflow:hidden;position:absolute;right:0;scroll-snap-type:none;top:0}}@media screen and (min-width:76.25em){.md-sidebar{height:0}.no-js .md-sidebar{height:auto}.md-header--lifted~.md-container .md-sidebar{top:4.8rem}}.md-sidebar--secondary{display:none;order:2}@media screen and (min-width:60em){.md-sidebar--secondary{height:0}.no-js .md-sidebar--secondary{height:auto}.md-sidebar--secondary:not([hidden]){display:block}.md-sidebar--secondary .md-sidebar__scrollwrap{touch-action:pan-y}}.md-sidebar__scrollwrap{scrollbar-gutter:stable;-webkit-backface-visibility:hidden;backface-visibility:hidden;margin:0 .2rem;overflow-y:auto;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}.md-sidebar__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-sidebar__scrollwrap:focus-within,.md-sidebar__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb:hover,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}@supports selector(::-webkit-scrollbar){.md-sidebar__scrollwrap{scrollbar-gutter:auto}[dir=ltr] .md-sidebar__inner{padding-right:calc(100% - 11.5rem)}[dir=rtl] .md-sidebar__inner{padding-left:calc(100% - 11.5rem)}}@media screen and (max-width:76.234375em){.md-overlay{background-color:#0000008a;height:0;opacity:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0;z-index:5}[data-md-toggle=drawer]:checked~.md-overlay{height:100%;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@keyframes facts{0%{height:0}to{height:.65rem}}@keyframes fact{0%{opacity:0;transform:translateY(100%)}50%{opacity:0}to{opacity:1;transform:translateY(0)}}:root{--md-source-forks-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M5 5.372v.878c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.878a2.25 2.25 0 1 1 1.5 0v.878a2.25 2.25 0 0 1-2.25 2.25h-1.5v2.128a2.251 2.251 0 1 1-1.5 0V8.5h-1.5A2.25 2.25 0 0 1 3.5 6.25v-.878a2.25 2.25 0 1 1 1.5 0ZM5 3.25a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Zm6.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5Zm-3 8.75a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Z"/></svg>');--md-source-repositories-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M2 2.5A2.5 2.5 0 0 1 4.5 0h8.75a.75.75 0 0 1 .75.75v12.5a.75.75 0 0 1-.75.75h-2.5a.75.75 0 0 1 0-1.5h1.75v-2h-8a1 1 0 0 0-.714 1.7.75.75 0 1 1-1.072 1.05A2.495 2.495 0 0 1 2 11.5Zm10.5-1h-8a1 1 0 0 0-1 1v6.708A2.486 2.486 0 0 1 4.5 9h8ZM5 12.25a.25.25 0 0 1 .25-.25h3.5a.25.25 0 0 1 .25.25v3.25a.25.25 0 0 1-.4.2l-1.45-1.087a.249.249 0 0 0-.3 0L5.4 15.7a.25.25 0 0 1-.4-.2Z"/></svg>');--md-source-stars-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M8 .25a.75.75 0 0 1 .673.418l1.882 3.815 4.21.612a.75.75 0 0 1 .416 1.279l-3.046 2.97.719 4.192a.751.751 0 0 1-1.088.791L8 12.347l-3.766 1.98a.75.75 0 0 1-1.088-.79l.72-4.194L.818 6.374a.75.75 0 0 1 .416-1.28l4.21-.611L7.327.668A.75.75 0 0 1 8 .25Zm0 2.445L6.615 5.5a.75.75 0 0 1-.564.41l-3.097.45 2.24 2.184a.75.75 0 0 1 .216.664l-.528 3.084 2.769-1.456a.75.75 0 0 1 .698 0l2.77 1.456-.53-3.084a.75.75 0 0 1 .216-.664l2.24-2.183-3.096-.45a.75.75 0 0 1-.564-.41L8 2.694Z"/></svg>');--md-source-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M1 7.775V2.75C1 1.784 1.784 1 2.75 1h5.025c.464 0 .91.184 1.238.513l6.25 6.25a1.75 1.75 0 0 1 0 2.474l-5.026 5.026a1.75 1.75 0 0 1-2.474 0l-6.25-6.25A1.752 1.752 0 0 1 1 7.775Zm1.5 0c0 .066.026.13.073.177l6.25 6.25a.25.25 0 0 0 .354 0l5.025-5.025a.25.25 0 0 0 0-.354l-6.25-6.25a.25.25 0 0 0-.177-.073H2.75a.25.25 0 0 0-.25.25ZM6 5a1 1 0 1 1 0 2 1 1 0 0 1 0-2Z"/></svg>')}.md-source{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.65rem;line-height:1.2;outline-color:var(--md-accent-fg-color);transition:opacity .25s;white-space:nowrap}.md-source:hover{opacity:.7}.md-source__icon{display:inline-block;height:2.4rem;vertical-align:middle;width:2rem}[dir=ltr] .md-source__icon svg{margin-left:.6rem}[dir=rtl] .md-source__icon svg{margin-right:.6rem}.md-source__icon svg{margin-top:.6rem}[dir=ltr] .md-source__icon+.md-source__repository{padding-left:2rem}[dir=rtl] .md-source__icon+.md-source__repository{padding-right:2rem}[dir=ltr] .md-source__icon+.md-source__repository{margin-left:-2rem}[dir=rtl] .md-source__icon+.md-source__repository{margin-right:-2rem}[dir=ltr] .md-source__repository{margin-left:.6rem}[dir=rtl] .md-source__repository{margin-right:.6rem}.md-source__repository{display:inline-block;max-width:calc(100% - 1.2rem);overflow:hidden;text-overflow:ellipsis;vertical-align:middle}.md-source__facts{display:flex;font-size:.55rem;gap:.4rem;list-style-type:none;margin:.1rem 0 0;opacity:.75;overflow:hidden;padding:0;width:100%}.md-source__repository--active .md-source__facts{animation:facts .25s ease-in}.md-source__fact{overflow:hidden;text-overflow:ellipsis}.md-source__repository--active .md-source__fact{animation:fact .4s ease-out}[dir=ltr] .md-source__fact:before{margin-right:.1rem}[dir=rtl] .md-source__fact:before{margin-left:.1rem}.md-source__fact:before{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-top;width:.6rem}.md-source__fact:nth-child(1n+2){flex-shrink:0}.md-source__fact--version:before{-webkit-mask-image:var(--md-source-version-icon);mask-image:var(--md-source-version-icon)}.md-source__fact--stars:before{-webkit-mask-image:var(--md-source-stars-icon);mask-image:var(--md-source-stars-icon)}.md-source__fact--forks:before{-webkit-mask-image:var(--md-source-forks-icon);mask-image:var(--md-source-forks-icon)}.md-source__fact--repositories:before{-webkit-mask-image:var(--md-source-repositories-icon);mask-image:var(--md-source-repositories-icon)}.md-source-file{margin:1em 0}[dir=ltr] .md-source-file__fact{margin-right:.6rem}[dir=rtl] .md-source-file__fact{margin-left:.6rem}.md-source-file__fact{align-items:center;color:var(--md-default-fg-color--light);display:inline-flex;font-size:.68rem;gap:.3rem}.md-source-file__fact .md-icon{flex-shrink:0;margin-bottom:.05rem}[dir=ltr] .md-source-file__fact .md-author{float:left}[dir=rtl] .md-source-file__fact .md-author{float:right}.md-source-file__fact .md-author{margin-right:.2rem}.md-source-file__fact svg{width:.9rem}:root{--md-status:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 9h2V7h-2m1 13c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8m0-18A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2m-1 15h2v-6h-2v6Z"/></svg>');--md-status--new:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m23 12-2.44-2.78.34-3.68-3.61-.82-1.89-3.18L12 3 8.6 1.54 6.71 4.72l-3.61.81.34 3.68L1 12l2.44 2.78-.34 3.69 3.61.82 1.89 3.18L12 21l3.4 1.46 1.89-3.18 3.61-.82-.34-3.68L23 12m-10 5h-2v-2h2v2m0-4h-2V7h2v6Z"/></svg>');--md-status--deprecated:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9 3v1H4v2h1v13a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V6h1V4h-5V3H9m0 5h2v9H9V8m4 0h2v9h-2V8Z"/></svg>');--md-status--encrypted:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 1 3 5v6c0 5.55 3.84 10.74 9 12 5.16-1.26 9-6.45 9-12V5l-9-4m0 6c1.4 0 2.8 1.1 2.8 2.5V11c.6 0 1.2.6 1.2 1.3v3.5c0 .6-.6 1.2-1.3 1.2H9.2c-.6 0-1.2-.6-1.2-1.3v-3.5c0-.6.6-1.2 1.2-1.2V9.5C9.2 8.1 10.6 7 12 7m0 1.2c-.8 0-1.5.5-1.5 1.3V11h3V9.5c0-.8-.7-1.3-1.5-1.3Z"/></svg>')}.md-status:after{background-color:var(--md-default-fg-color--light);content:"";display:inline-block;height:1.125em;-webkit-mask-image:var(--md-status);mask-image:var(--md-status);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-bottom;width:1.125em}.md-status:hover:after{background-color:currentcolor}.md-status--new:after{-webkit-mask-image:var(--md-status--new);mask-image:var(--md-status--new)}.md-status--deprecated:after{-webkit-mask-image:var(--md-status--deprecated);mask-image:var(--md-status--deprecated)}.md-status--encrypted:after{-webkit-mask-image:var(--md-status--encrypted);mask-image:var(--md-status--encrypted)}.md-tabs{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);display:block;line-height:1.3;overflow:auto;width:100%;z-index:3}@media print{.md-tabs{display:none}}@media screen and (max-width:76.234375em){.md-tabs{display:none}}.md-tabs[hidden]{pointer-events:none}[dir=ltr] .md-tabs__list{margin-left:.2rem}[dir=rtl] .md-tabs__list{margin-right:.2rem}.md-tabs__list{contain:content;display:flex;list-style:none;margin:0;overflow:auto;padding:0;scrollbar-width:none;white-space:nowrap}.md-tabs__list::-webkit-scrollbar{display:none}.md-tabs__item{height:2.4rem;padding-left:.6rem;padding-right:.6rem}.md-tabs__item--active .md-tabs__link{color:inherit;opacity:1}.md-tabs__link{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:flex;font-size:.7rem;margin-top:.8rem;opacity:.7;outline-color:var(--md-accent-fg-color);outline-offset:.2rem;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .25s}.md-tabs__link:focus,.md-tabs__link:hover{color:inherit;opacity:1}[dir=ltr] .md-tabs__link svg{margin-right:.4rem}[dir=rtl] .md-tabs__link svg{margin-left:.4rem}.md-tabs__link svg{fill:currentcolor;height:1.3em}.md-tabs__item:nth-child(2) .md-tabs__link{transition-delay:20ms}.md-tabs__item:nth-child(3) .md-tabs__link{transition-delay:40ms}.md-tabs__item:nth-child(4) .md-tabs__link{transition-delay:60ms}.md-tabs__item:nth-child(5) .md-tabs__link{transition-delay:80ms}.md-tabs__item:nth-child(6) .md-tabs__link{transition-delay:.1s}.md-tabs__item:nth-child(7) .md-tabs__link{transition-delay:.12s}.md-tabs__item:nth-child(8) .md-tabs__link{transition-delay:.14s}.md-tabs__item:nth-child(9) .md-tabs__link{transition-delay:.16s}.md-tabs__item:nth-child(10) .md-tabs__link{transition-delay:.18s}.md-tabs__item:nth-child(11) .md-tabs__link{transition-delay:.2s}.md-tabs__item:nth-child(12) .md-tabs__link{transition-delay:.22s}.md-tabs__item:nth-child(13) .md-tabs__link{transition-delay:.24s}.md-tabs__item:nth-child(14) .md-tabs__link{transition-delay:.26s}.md-tabs__item:nth-child(15) .md-tabs__link{transition-delay:.28s}.md-tabs__item:nth-child(16) .md-tabs__link{transition-delay:.3s}.md-tabs[hidden] .md-tabs__link{opacity:0;transform:translateY(50%);transition:transform 0ms .1s,opacity .1s}:root{--md-tag-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m5.41 21 .71-4h-4l.35-2h4l1.06-6h-4l.35-2h4l.71-4h2l-.71 4h6l.71-4h2l-.71 4h4l-.35 2h-4l-1.06 6h4l-.35 2h-4l-.71 4h-2l.71-4h-6l-.71 4h-2M9.53 9l-1.06 6h6l1.06-6h-6Z"/></svg>')}.md-typeset .md-tags:not([hidden]){display:inline-flex;flex-wrap:wrap;gap:.5em;margin-bottom:.75em;margin-top:-.125em}.md-typeset .md-tag{align-items:center;background:var(--md-default-fg-color--lightest);border-radius:2.4rem;display:inline-flex;font-size:.64rem;font-size:min(.8em,.64rem);font-weight:700;gap:.5em;letter-spacing:normal;line-height:1.6;padding:.3125em .78125em}.md-typeset .md-tag[href]{-webkit-tap-highlight-color:transparent;color:inherit;outline:none;transition:color 125ms,background-color 125ms}.md-typeset .md-tag[href]:focus,.md-typeset .md-tag[href]:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[id]>.md-typeset .md-tag{vertical-align:text-top}.md-typeset .md-tag-shadow{opacity:.5}.md-typeset .md-tag-icon:before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-tag-icon);mask-image:var(--md-tag-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset .md-tag-icon[href]:focus:before,.md-typeset .md-tag-icon[href]:hover:before{background-color:var(--md-accent-bg-color)}@keyframes pulse{0%{transform:scale(.95)}75%{transform:scale(1)}to{transform:scale(.95)}}:root{--md-annotation-bg-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2Z"/></svg>');--md-annotation-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 13h-4v4h-2v-4H7v-2h4V7h2v4h4m-5-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2Z"/></svg>')}.md-tooltip{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);font-family:var(--md-text-font-family);left:clamp(var(--md-tooltip-0,0rem) + .8rem,var(--md-tooltip-x),100vw + var(--md-tooltip-0,0rem) + .8rem - var(--md-tooltip-width) - 2 * .8rem);max-width:calc(100vw - 1.6rem);opacity:0;position:absolute;top:var(--md-tooltip-y);transform:translateY(-.4rem);transition:transform 0ms .25s,opacity .25s,z-index .25s;width:var(--md-tooltip-width);z-index:0}.md-tooltip--active{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip--inline{font-weight:700;-webkit-user-select:none;user-select:none;width:auto}.md-tooltip--inline:not(.md-tooltip--active){transform:translateY(.2rem) scale(.9)}.md-tooltip--inline .md-tooltip__inner{font-size:.5rem;padding:.2rem .4rem}[hidden]+.md-tooltip--inline{display:none}.focus-visible>.md-tooltip,.md-tooltip:target{outline:var(--md-accent-fg-color) auto}.md-tooltip__inner{font-size:.64rem;padding:.8rem}.md-tooltip__inner.md-typeset>:first-child{margin-top:0}.md-tooltip__inner.md-typeset>:last-child{margin-bottom:0}.md-annotation{font-style:normal;font-weight:400;outline:none;text-align:initial;vertical-align:text-bottom;white-space:normal}[dir=rtl] .md-annotation{direction:rtl}code .md-annotation{font-family:var(--md-code-font-family);font-size:inherit}.md-annotation:not([hidden]){display:inline-block;line-height:1.25}.md-annotation__index{border-radius:.01px;cursor:pointer;display:inline-block;margin-left:.4ch;margin-right:.4ch;outline:none;overflow:hidden;position:relative;-webkit-user-select:none;user-select:none;vertical-align:text-top;z-index:0}.md-annotation .md-annotation__index{transition:z-index .25s}@media screen{.md-annotation__index{width:2.2ch}[data-md-visible]>.md-annotation__index{animation:pulse 2s infinite}.md-annotation__index:before{background:var(--md-default-bg-color);-webkit-mask-image:var(--md-annotation-bg-icon);mask-image:var(--md-annotation-bg-icon)}.md-annotation__index:after,.md-annotation__index:before{content:"";height:2.2ch;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:-.1ch;width:2.2ch;z-index:-1}.md-annotation__index:after{background-color:var(--md-default-fg-color--lighter);-webkit-mask-image:var(--md-annotation-icon);mask-image:var(--md-annotation-icon);transform:scale(1.0001);transition:background-color .25s,transform .25s}.md-tooltip--active+.md-annotation__index:after{transform:rotate(45deg)}.md-tooltip--active+.md-annotation__index:after,:hover>.md-annotation__index:after{background-color:var(--md-accent-fg-color)}}.md-tooltip--active+.md-annotation__index{animation-play-state:paused;transition-duration:0ms;z-index:2}.md-annotation__index [data-md-annotation-id]{display:inline-block}@media print{.md-annotation__index [data-md-annotation-id]{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);font-weight:700;padding:0 .6ch;white-space:nowrap}.md-annotation__index [data-md-annotation-id]:after{content:attr(data-md-annotation-id)}}.md-typeset .md-annotation-list{counter-reset:xxx;list-style:none}.md-typeset .md-annotation-list li{position:relative}[dir=ltr] .md-typeset .md-annotation-list li:before{left:-2.125em}[dir=rtl] .md-typeset .md-annotation-list li:before{right:-2.125em}.md-typeset .md-annotation-list li:before{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);content:counter(xxx);counter-increment:xxx;font-size:.8875em;font-weight:700;height:2ch;line-height:1.25;min-width:2ch;padding:0 .6ch;position:absolute;text-align:center;top:.25em}:root{--md-tooltip-width:20rem;--md-tooltip-tail:0.3rem}.md-tooltip2{-webkit-backface-visibility:hidden;backface-visibility:hidden;color:var(--md-default-fg-color);font-family:var(--md-text-font-family);opacity:0;pointer-events:none;position:absolute;top:calc(var(--md-tooltip-host-y) + var(--md-tooltip-y));transform:translateY(-.4rem);transform-origin:calc(var(--md-tooltip-host-x) + var(--md-tooltip-x)) 0;transition:transform 0ms .25s,opacity .25s,z-index .25s;width:100%;z-index:0}.md-tooltip2:before{border-left:var(--md-tooltip-tail) solid #0000;border-right:var(--md-tooltip-tail) solid #0000;content:"";display:block;left:clamp(1.5 * .8rem,var(--md-tooltip-host-x) + var(--md-tooltip-x) - var(--md-tooltip-tail),100vw - 2 * var(--md-tooltip-tail) - 1.5 * .8rem);position:absolute;z-index:1}.md-tooltip2--top:before{border-top:var(--md-tooltip-tail) solid var(--md-default-bg-color);bottom:calc(var(--md-tooltip-tail)*-1 + .025rem);filter:drop-shadow(0 1px 0 hsla(0,0%,0%,.05))}.md-tooltip2--bottom:before{border-bottom:var(--md-tooltip-tail) solid var(--md-default-bg-color);filter:drop-shadow(0 -1px 0 hsla(0,0%,0%,.05));top:calc(var(--md-tooltip-tail)*-1 + .025rem)}.md-tooltip2--active{opacity:1;transform:translateY(0);transition:transform .4s cubic-bezier(0,1,.5,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip2__inner{scrollbar-gutter:stable;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);left:clamp(.8rem,var(--md-tooltip-host-x) - .8rem,100vw - var(--md-tooltip-width) - .8rem);max-height:40vh;max-width:calc(100vw - 1.6rem);position:relative;scrollbar-width:thin}.md-tooltip2__inner::-webkit-scrollbar{height:.2rem;width:.2rem}.md-tooltip2__inner::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-tooltip2__inner::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}[role=dialog]>.md-tooltip2__inner{font-size:.64rem;overflow:auto;padding:0 .8rem;pointer-events:auto;width:var(--md-tooltip-width)}[role=dialog]>.md-tooltip2__inner:after,[role=dialog]>.md-tooltip2__inner:before{content:"";display:block;height:.8rem;position:sticky;width:100%;z-index:10}[role=dialog]>.md-tooltip2__inner:before{background:linear-gradient(var(--md-default-bg-color),#0000 75%);top:0}[role=dialog]>.md-tooltip2__inner:after{background:linear-gradient(#0000,var(--md-default-bg-color) 75%);bottom:0}[role=tooltip]>.md-tooltip2__inner{font-size:.5rem;font-weight:700;left:clamp(.8rem,var(--md-tooltip-host-x) + var(--md-tooltip-x) - var(--md-tooltip-width)/2,100vw - var(--md-tooltip-width) - .8rem);max-width:min(100vw - 2 * .8rem,400px);padding:.2rem .4rem;-webkit-user-select:none;user-select:none;width:-moz-fit-content;width:fit-content}.md-tooltip2__inner.md-typeset>:first-child{margin-top:0}.md-tooltip2__inner.md-typeset>:last-child{margin-bottom:0}[dir=ltr] .md-top{margin-left:50%}[dir=rtl] .md-top{margin-right:50%}.md-top{background-color:var(--md-default-bg-color);border-radius:1.6rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color--light);cursor:pointer;display:block;font-size:.7rem;outline:none;padding:.4rem .8rem;position:fixed;top:3.2rem;transform:translate(-50%);transition:color 125ms,background-color 125ms,transform 125ms cubic-bezier(.4,0,.2,1),opacity 125ms;z-index:2}@media print{.md-top{display:none}}[dir=rtl] .md-top{transform:translate(50%)}.md-top[hidden]{opacity:0;pointer-events:none;transform:translate(-50%,.2rem);transition-duration:0ms}[dir=rtl] .md-top[hidden]{transform:translate(50%,.2rem)}.md-top:focus,.md-top:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top svg{display:inline-block;vertical-align:-.5em}@keyframes hoverfix{0%{pointer-events:none}}:root{--md-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.6.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 2024 Fonticons, Inc.--><path d="M137.4 374.6c12.5 12.5 32.8 12.5 45.3 0l128-128c9.2-9.2 11.9-22.9 6.9-34.9S301 191.9 288 191.9L32 192c-12.9 0-24.6 7.8-29.6 19.8s-2.2 25.7 6.9 34.9l128 128z"/></svg>')}.md-version{flex-shrink:0;font-size:.8rem;height:2.4rem}[dir=ltr] .md-version__current{margin-left:1.4rem;margin-right:.4rem}[dir=rtl] .md-version__current{margin-left:.4rem;margin-right:1.4rem}.md-version__current{color:inherit;cursor:pointer;outline:none;position:relative;top:.05rem}[dir=ltr] .md-version__current:after{margin-left:.4rem}[dir=rtl] .md-version__current:after{margin-right:.4rem}.md-version__current:after{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-image:var(--md-version-icon);mask-image:var(--md-version-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.4rem}.md-version__alias{margin-left:.3rem;opacity:.7}.md-version__list{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);list-style-type:none;margin:.2rem .8rem;max-height:0;opacity:0;overflow:auto;padding:0;position:absolute;scroll-snap-type:y mandatory;top:.15rem;transition:max-height 0ms .5s,opacity .25s .25s;z-index:3}.md-version:focus-within .md-version__list,.md-version:hover .md-version__list{max-height:10rem;opacity:1;transition:max-height 0ms,opacity .25s}@media (hover:none),(pointer:coarse){.md-version:hover .md-version__list{animation:hoverfix .25s forwards}.md-version:focus-within .md-version__list{animation:none}}.md-version__item{line-height:1.8rem}[dir=ltr] .md-version__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-version__link{padding-left:1.2rem;padding-right:.6rem}.md-version__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:color .25s,background-color .25s;white-space:nowrap;width:100%}.md-version__link:focus,.md-version__link:hover{color:var(--md-accent-fg-color)}.md-version__link:focus{background-color:var(--md-default-fg-color--lightest)}:root{--md-admonition-icon--note:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2C6.47 2 2 6.47 2 12s4.47 10 10 10 10-4.47 10-10S17.53 2 12 2m3.1 5.07c.14 0 .28.05.4.16l1.27 1.27c.23.22.23.57 0 .78l-1 1-2.05-2.05 1-1c.1-.11.24-.16.38-.16m-1.97 1.74 2.06 2.06-6.06 6.06H7.07v-2.06l6.06-6.06Z"/></svg>');--md-admonition-icon--abstract:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 9H7V7h10m0 6H7v-2h10m-3 6H7v-2h7M12 3a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1m7 0h-4.18C14.4 1.84 13.3 1 12 1c-1.3 0-2.4.84-2.82 2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V5a2 2 0 0 0-2-2Z"/></svg>');--md-admonition-icon--info:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 9h-2V7h2m0 10h-2v-6h2m-1-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2Z"/></svg>');--md-admonition-icon--tip:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17.66 11.2c-.23-.3-.51-.56-.77-.82-.67-.6-1.43-1.03-2.07-1.66C13.33 7.26 13 4.85 13.95 3c-.95.23-1.78.75-2.49 1.32-2.59 2.08-3.61 5.75-2.39 8.9.04.1.08.2.08.33 0 .22-.15.42-.35.5-.23.1-.47.04-.66-.12a.58.58 0 0 1-.14-.17c-1.13-1.43-1.31-3.48-.55-5.12C5.78 10 4.87 12.3 5 14.47c.06.5.12 1 .29 1.5.14.6.41 1.2.71 1.73 1.08 1.73 2.95 2.97 4.96 3.22 2.14.27 4.43-.12 6.07-1.6 1.83-1.66 2.47-4.32 1.53-6.6l-.13-.26c-.21-.46-.77-1.26-.77-1.26m-3.16 6.3c-.28.24-.74.5-1.1.6-1.12.4-2.24-.16-2.9-.82 1.19-.28 1.9-1.16 2.11-2.05.17-.8-.15-1.46-.28-2.23-.12-.74-.1-1.37.17-2.06.19.38.39.76.63 1.06.77 1 1.98 1.44 2.24 2.8.04.14.06.28.06.43.03.82-.33 1.72-.93 2.27Z"/></svg>');--md-admonition-icon--success:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 7 9 19l-5.5-5.5 1.41-1.41L9 16.17 19.59 5.59 21 7Z"/></svg>');--md-admonition-icon--question:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m15.07 11.25-.9.92C13.45 12.89 13 13.5 13 15h-2v-.5c0-1.11.45-2.11 1.17-2.83l1.24-1.26c.37-.36.59-.86.59-1.41a2 2 0 0 0-2-2 2 2 0 0 0-2 2H8a4 4 0 0 1 4-4 4 4 0 0 1 4 4 3.2 3.2 0 0 1-.93 2.25M13 19h-2v-2h2M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10c0-5.53-4.5-10-10-10Z"/></svg>');--md-admonition-icon--warning:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 14h-2V9h2m0 9h-2v-2h2M1 21h22L12 2 1 21Z"/></svg>');--md-admonition-icon--failure:url('data:image/svg+xml;charset=utf-8,<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>');--md-admonition-icon--danger:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m11.5 20 4.86-9.73H13V4l-5 9.73h3.5V20M12 2c2.75 0 5.1 1 7.05 2.95C21 6.9 22 9.25 22 12s-1 5.1-2.95 7.05C17.1 21 14.75 22 12 22s-5.1-1-7.05-2.95C3 17.1 2 14.75 2 12s1-5.1 2.95-7.05C6.9 3 9.25 2 12 2Z"/></svg>');--md-admonition-icon--bug:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 13h2v1h-2v-1m10-8v6c0 5.5-3.8 10.7-9 12-5.2-1.3-9-6.5-9-12V5l9-4 9 4m-4 5h-2.2c-.2-.6-.6-1.1-1.1-1.5l1.2-1.2-.7-.7L12.8 8H12c-.2 0-.5 0-.7.1L9.9 6.6l-.8.8 1.2 1.2c-.5.3-.9.8-1.1 1.4H7v1h2v1H7v1h2v1H7v1h2.2c.4 1.2 1.5 2 2.8 2s2.4-.8 2.8-2H17v-1h-2v-1h2v-1h-2v-1h2v-1m-6 2h2v-1h-2v1Z"/></svg>');--md-admonition-icon--example:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M7 2v2h1v14a4 4 0 0 0 4 4 4 4 0 0 0 4-4V4h1V2H7m4 14c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m2-4c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m1-5h-4V4h4v3Z"/></svg>');--md-admonition-icon--quote:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 17h3l2-4V7h-6v6h3M6 17h3l2-4V7H5v6h3l-2 4Z"/></svg>')}.md-typeset .admonition,.md-typeset details{background-color:var(--md-admonition-bg-color);border:.075rem solid #448aff;border-radius:.2rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid;transition:box-shadow 125ms}@media print{.md-typeset .admonition,.md-typeset details{box-shadow:none}}.md-typeset .admonition:focus-within,.md-typeset details:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .admonition>*,.md-typeset details>*{box-sizing:border-box}.md-typeset .admonition .admonition,.md-typeset .admonition details,.md-typeset details .admonition,.md-typeset details details{margin-bottom:1em;margin-top:1em}.md-typeset .admonition .md-typeset__scrollwrap,.md-typeset details .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset .admonition .md-typeset__table,.md-typeset details .md-typeset__table{padding:0 .6rem}.md-typeset .admonition>.tabbed-set:only-child,.md-typeset details>.tabbed-set:only-child{margin-top:0}html .md-typeset .admonition>:last-child,html .md-typeset details>:last-child{margin-bottom:.6rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{padding-left:2rem;padding-right:.6rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{padding-left:.6rem;padding-right:2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-left-width:.2rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-right-width:.2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset .admonition-title,.md-typeset summary{background-color:#448aff1a;border:none;font-weight:700;margin:0 -.6rem;padding-bottom:.4rem;padding-top:.4rem;position:relative}html .md-typeset .admonition-title:last-child,html .md-typeset summary:last-child{margin-bottom:0}[dir=ltr] .md-typeset .admonition-title:before,[dir=ltr] .md-typeset summary:before{left:.6rem}[dir=rtl] .md-typeset .admonition-title:before,[dir=rtl] .md-typeset summary:before{right:.6rem}.md-typeset .admonition-title:before,.md-typeset summary:before{background-color:#448aff;content:"";height:1rem;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;width:1rem}.md-typeset .admonition-title code,.md-typeset summary code{box-shadow:0 0 0 .05rem var(--md-default-fg-color--lightest)}.md-typeset .admonition.note,.md-typeset details.note{border-color:#448aff}.md-typeset .admonition.note:focus-within,.md-typeset details.note:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .note>.admonition-title,.md-typeset .note>summary{background-color:#448aff1a}.md-typeset .note>.admonition-title:before,.md-typeset .note>summary:before{background-color:#448aff;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note)}.md-typeset .note>.admonition-title:after,.md-typeset .note>summary:after{color:#448aff}.md-typeset .admonition.abstract,.md-typeset details.abstract{border-color:#00b0ff}.md-typeset .admonition.abstract:focus-within,.md-typeset details.abstract:focus-within{box-shadow:0 0 0 .2rem #00b0ff1a}.md-typeset .abstract>.admonition-title,.md-typeset .abstract>summary{background-color:#00b0ff1a}.md-typeset .abstract>.admonition-title:before,.md-typeset .abstract>summary:before{background-color:#00b0ff;-webkit-mask-image:var(--md-admonition-icon--abstract);mask-image:var(--md-admonition-icon--abstract)}.md-typeset .abstract>.admonition-title:after,.md-typeset .abstract>summary:after{color:#00b0ff}.md-typeset .admonition.info,.md-typeset details.info{border-color:#00b8d4}.md-typeset .admonition.info:focus-within,.md-typeset details.info:focus-within{box-shadow:0 0 0 .2rem #00b8d41a}.md-typeset .info>.admonition-title,.md-typeset .info>summary{background-color:#00b8d41a}.md-typeset .info>.admonition-title:before,.md-typeset .info>summary:before{background-color:#00b8d4;-webkit-mask-image:var(--md-admonition-icon--info);mask-image:var(--md-admonition-icon--info)}.md-typeset .info>.admonition-title:after,.md-typeset .info>summary:after{color:#00b8d4}.md-typeset .admonition.tip,.md-typeset details.tip{border-color:#00bfa5}.md-typeset .admonition.tip:focus-within,.md-typeset details.tip:focus-within{box-shadow:0 0 0 .2rem #00bfa51a}.md-typeset .tip>.admonition-title,.md-typeset .tip>summary{background-color:#00bfa51a}.md-typeset .tip>.admonition-title:before,.md-typeset .tip>summary:before{background-color:#00bfa5;-webkit-mask-image:var(--md-admonition-icon--tip);mask-image:var(--md-admonition-icon--tip)}.md-typeset .tip>.admonition-title:after,.md-typeset .tip>summary:after{color:#00bfa5}.md-typeset .admonition.success,.md-typeset details.success{border-color:#00c853}.md-typeset .admonition.success:focus-within,.md-typeset details.success:focus-within{box-shadow:0 0 0 .2rem #00c8531a}.md-typeset .success>.admonition-title,.md-typeset .success>summary{background-color:#00c8531a}.md-typeset .success>.admonition-title:before,.md-typeset .success>summary:before{background-color:#00c853;-webkit-mask-image:var(--md-admonition-icon--success);mask-image:var(--md-admonition-icon--success)}.md-typeset .success>.admonition-title:after,.md-typeset .success>summary:after{color:#00c853}.md-typeset .admonition.question,.md-typeset details.question{border-color:#64dd17}.md-typeset .admonition.question:focus-within,.md-typeset details.question:focus-within{box-shadow:0 0 0 .2rem #64dd171a}.md-typeset .question>.admonition-title,.md-typeset .question>summary{background-color:#64dd171a}.md-typeset .question>.admonition-title:before,.md-typeset .question>summary:before{background-color:#64dd17;-webkit-mask-image:var(--md-admonition-icon--question);mask-image:var(--md-admonition-icon--question)}.md-typeset .question>.admonition-title:after,.md-typeset .question>summary:after{color:#64dd17}.md-typeset .admonition.warning,.md-typeset details.warning{border-color:#ff9100}.md-typeset .admonition.warning:focus-within,.md-typeset details.warning:focus-within{box-shadow:0 0 0 .2rem #ff91001a}.md-typeset .warning>.admonition-title,.md-typeset .warning>summary{background-color:#ff91001a}.md-typeset .warning>.admonition-title:before,.md-typeset .warning>summary:before{background-color:#ff9100;-webkit-mask-image:var(--md-admonition-icon--warning);mask-image:var(--md-admonition-icon--warning)}.md-typeset .warning>.admonition-title:after,.md-typeset .warning>summary:after{color:#ff9100}.md-typeset .admonition.failure,.md-typeset details.failure{border-color:#ff5252}.md-typeset .admonition.failure:focus-within,.md-typeset details.failure:focus-within{box-shadow:0 0 0 .2rem #ff52521a}.md-typeset .failure>.admonition-title,.md-typeset .failure>summary{background-color:#ff52521a}.md-typeset .failure>.admonition-title:before,.md-typeset .failure>summary:before{background-color:#ff5252;-webkit-mask-image:var(--md-admonition-icon--failure);mask-image:var(--md-admonition-icon--failure)}.md-typeset .failure>.admonition-title:after,.md-typeset .failure>summary:after{color:#ff5252}.md-typeset .admonition.danger,.md-typeset details.danger{border-color:#ff1744}.md-typeset .admonition.danger:focus-within,.md-typeset details.danger:focus-within{box-shadow:0 0 0 .2rem #ff17441a}.md-typeset .danger>.admonition-title,.md-typeset .danger>summary{background-color:#ff17441a}.md-typeset .danger>.admonition-title:before,.md-typeset .danger>summary:before{background-color:#ff1744;-webkit-mask-image:var(--md-admonition-icon--danger);mask-image:var(--md-admonition-icon--danger)}.md-typeset .danger>.admonition-title:after,.md-typeset .danger>summary:after{color:#ff1744}.md-typeset .admonition.bug,.md-typeset details.bug{border-color:#f50057}.md-typeset .admonition.bug:focus-within,.md-typeset details.bug:focus-within{box-shadow:0 0 0 .2rem #f500571a}.md-typeset .bug>.admonition-title,.md-typeset .bug>summary{background-color:#f500571a}.md-typeset .bug>.admonition-title:before,.md-typeset .bug>summary:before{background-color:#f50057;-webkit-mask-image:var(--md-admonition-icon--bug);mask-image:var(--md-admonition-icon--bug)}.md-typeset .bug>.admonition-title:after,.md-typeset .bug>summary:after{color:#f50057}.md-typeset .admonition.example,.md-typeset details.example{border-color:#7c4dff}.md-typeset .admonition.example:focus-within,.md-typeset details.example:focus-within{box-shadow:0 0 0 .2rem #7c4dff1a}.md-typeset .example>.admonition-title,.md-typeset .example>summary{background-color:#7c4dff1a}.md-typeset .example>.admonition-title:before,.md-typeset .example>summary:before{background-color:#7c4dff;-webkit-mask-image:var(--md-admonition-icon--example);mask-image:var(--md-admonition-icon--example)}.md-typeset .example>.admonition-title:after,.md-typeset .example>summary:after{color:#7c4dff}.md-typeset .admonition.quote,.md-typeset details.quote{border-color:#9e9e9e}.md-typeset .admonition.quote:focus-within,.md-typeset details.quote:focus-within{box-shadow:0 0 0 .2rem #9e9e9e1a}.md-typeset .quote>.admonition-title,.md-typeset .quote>summary{background-color:#9e9e9e1a}.md-typeset .quote>.admonition-title:before,.md-typeset .quote>summary:before{background-color:#9e9e9e;-webkit-mask-image:var(--md-admonition-icon--quote);mask-image:var(--md-admonition-icon--quote)}.md-typeset .quote>.admonition-title:after,.md-typeset .quote>summary:after{color:#9e9e9e}:root{--md-footnotes-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7v4H5.83l3.58-3.59L8 6l-6 6 6 6 1.41-1.42L5.83 13H21V7h-2Z"/></svg>')}.md-typeset .footnote{color:var(--md-default-fg-color--light);font-size:.64rem}[dir=ltr] .md-typeset .footnote>ol{margin-left:0}[dir=rtl] .md-typeset .footnote>ol{margin-right:0}.md-typeset .footnote>ol>li{transition:color 125ms}.md-typeset .footnote>ol>li:target{color:var(--md-default-fg-color)}.md-typeset .footnote>ol>li:focus-within .footnote-backref{opacity:1;transform:translateX(0);transition:none}.md-typeset .footnote>ol>li:hover .footnote-backref,.md-typeset .footnote>ol>li:target .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li>:first-child{margin-top:0}.md-typeset .footnote-ref{font-size:.75em;font-weight:700}html .md-typeset .footnote-ref{outline-offset:.1rem}.md-typeset [id^="fnref:"]:target>.footnote-ref{outline:auto}.md-typeset .footnote-backref{color:var(--md-typeset-a-color);display:inline-block;font-size:0;opacity:0;transform:translateX(.25rem);transition:color .25s,transform .25s .25s,opacity 125ms .25s;vertical-align:text-bottom}@media print{.md-typeset .footnote-backref{color:var(--md-typeset-a-color);opacity:1;transform:translateX(0)}}[dir=rtl] .md-typeset .footnote-backref{transform:translateX(-.25rem)}.md-typeset .footnote-backref:hover{color:var(--md-accent-fg-color)}.md-typeset .footnote-backref:before{background-color:currentcolor;content:"";display:inline-block;height:.8rem;-webkit-mask-image:var(--md-footnotes-icon);mask-image:var(--md-footnotes-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.8rem}[dir=rtl] .md-typeset .footnote-backref:before svg{transform:scaleX(-1)}[dir=ltr] .md-typeset .headerlink{margin-left:.5rem}[dir=rtl] .md-typeset .headerlink{margin-right:.5rem}.md-typeset .headerlink{color:var(--md-default-fg-color--lighter);display:inline-block;opacity:0;transition:color .25s,opacity 125ms}@media print{.md-typeset .headerlink{display:none}}.md-typeset .headerlink:focus,.md-typeset :hover>.headerlink,.md-typeset :target>.headerlink{opacity:1;transition:color .25s,opacity 125ms}.md-typeset .headerlink:focus,.md-typeset .headerlink:hover,.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset :target{--md-scroll-margin:3.6rem;--md-scroll-offset:0rem;scroll-margin-top:calc(var(--md-scroll-margin) - var(--md-scroll-offset))}@media screen and (min-width:76.25em){.md-header--lifted~.md-container .md-typeset :target{--md-scroll-margin:6rem}}.md-typeset h1:target,.md-typeset h2:target,.md-typeset h3:target{--md-scroll-offset:0.2rem}.md-typeset h4:target{--md-scroll-offset:0.15rem}.md-typeset div.arithmatex{overflow:auto}@media screen and (max-width:44.984375em){.md-typeset div.arithmatex{margin:0 -.8rem}.md-typeset div.arithmatex>*{width:min-content}}.md-typeset div.arithmatex>*{margin-left:auto!important;margin-right:auto!important;padding:0 .8rem;touch-action:auto}.md-typeset div.arithmatex>* mjx-container{margin:0!important}.md-typeset div.arithmatex mjx-assistive-mml{height:0}.md-typeset del.critic{background-color:var(--md-typeset-del-color)}.md-typeset del.critic,.md-typeset ins.critic{-webkit-box-decoration-break:clone;box-decoration-break:clone}.md-typeset ins.critic{background-color:var(--md-typeset-ins-color)}.md-typeset .critic.comment{-webkit-box-decoration-break:clone;box-decoration-break:clone;color:var(--md-code-hl-comment-color)}.md-typeset .critic.comment:before{content:"/* "}.md-typeset .critic.comment:after{content:" */"}.md-typeset .critic.block{box-shadow:none;display:block;margin:1em 0;overflow:auto;padding-left:.8rem;padding-right:.8rem}.md-typeset .critic.block>:first-child{margin-top:.5em}.md-typeset .critic.block>:last-child{margin-bottom:.5em}:root{--md-details-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>')}.md-typeset details{display:flow-root;overflow:visible;padding-top:0}.md-typeset details[open]>summary:after{transform:rotate(90deg)}.md-typeset details:not([open]){box-shadow:none;padding-bottom:0}.md-typeset details:not([open])>summary{border-radius:.1rem}[dir=ltr] .md-typeset summary{padding-right:1.8rem}[dir=rtl] .md-typeset summary{padding-left:1.8rem}[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset summary{cursor:pointer;display:block;min-height:1rem;overflow:hidden}.md-typeset summary.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset summary:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[dir=ltr] .md-typeset summary:after{right:.4rem}[dir=rtl] .md-typeset summary:after{left:.4rem}.md-typeset summary:after{background-color:currentcolor;content:"";height:1rem;-webkit-mask-image:var(--md-details-icon);mask-image:var(--md-details-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;transform:rotate(0deg);transition:transform .25s;width:1rem}[dir=rtl] .md-typeset summary:after{transform:rotate(180deg)}.md-typeset summary::marker{display:none}.md-typeset summary::-webkit-details-marker{display:none}.md-typeset .emojione,.md-typeset .gemoji,.md-typeset .twemoji{--md-icon-size:1.125em;display:inline-flex;height:var(--md-icon-size);vertical-align:text-top}.md-typeset .emojione svg,.md-typeset .gemoji svg,.md-typeset .twemoji svg{fill:currentcolor;max-height:100%;width:var(--md-icon-size)}.md-typeset .lg,.md-typeset .xl,.md-typeset .xxl,.md-typeset .xxxl{vertical-align:text-bottom}.md-typeset .middle{vertical-align:middle}.md-typeset .lg{--md-icon-size:1.5em}.md-typeset .xl{--md-icon-size:2.25em}.md-typeset .xxl{--md-icon-size:3em}.md-typeset .xxxl{--md-icon-size:4em}.highlight .o,.highlight .ow{color:var(--md-code-hl-operator-color)}.highlight .p{color:var(--md-code-hl-punctuation-color)}.highlight .cpf,.highlight .l,.highlight .s,.highlight .s1,.highlight .s2,.highlight .sb,.highlight .sc,.highlight .si,.highlight .ss{color:var(--md-code-hl-string-color)}.highlight .cp,.highlight .se,.highlight .sh,.highlight .sr,.highlight .sx{color:var(--md-code-hl-special-color)}.highlight .il,.highlight .m,.highlight .mb,.highlight .mf,.highlight .mh,.highlight .mi,.highlight .mo{color:var(--md-code-hl-number-color)}.highlight .k,.highlight .kd,.highlight .kn,.highlight .kp,.highlight .kr,.highlight .kt{color:var(--md-code-hl-keyword-color)}.highlight .kc,.highlight .n{color:var(--md-code-hl-name-color)}.highlight .bp,.highlight .nb,.highlight .no{color:var(--md-code-hl-constant-color)}.highlight .nc,.highlight .ne,.highlight .nf,.highlight .nn{color:var(--md-code-hl-function-color)}.highlight .nd,.highlight .ni,.highlight .nl,.highlight .nt{color:var(--md-code-hl-keyword-color)}.highlight .c,.highlight .c1,.highlight .ch,.highlight .cm,.highlight .cs,.highlight .sd{color:var(--md-code-hl-comment-color)}.highlight .na,.highlight .nv,.highlight .vc,.highlight .vg,.highlight .vi{color:var(--md-code-hl-variable-color)}.highlight .ge,.highlight .gh,.highlight .go,.highlight .gp,.highlight .gr,.highlight .gs,.highlight .gt,.highlight .gu{color:var(--md-code-hl-generic-color)}.highlight .gd,.highlight .gi{border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight .gd{background-color:var(--md-typeset-del-color)}.highlight .gi{background-color:var(--md-typeset-ins-color)}.highlight .hll{background-color:var(--md-code-hl-color--light);box-shadow:2px 0 0 0 var(--md-code-hl-color) inset;display:block;margin:0 -1.1764705882em;padding:0 1.1764705882em}.highlight span.filename{background-color:var(--md-code-bg-color);border-bottom:.05rem solid var(--md-default-fg-color--lightest);border-top-left-radius:.1rem;border-top-right-radius:.1rem;display:flow-root;font-size:.85em;font-weight:700;margin-top:1em;padding:.6617647059em 1.1764705882em;position:relative}.highlight span.filename+pre{margin-top:0}.highlight span.filename+pre>code{border-top-left-radius:0;border-top-right-radius:0}.highlight [data-linenos]:before{background-color:var(--md-code-bg-color);box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;color:var(--md-default-fg-color--light);content:attr(data-linenos);float:left;left:-1.1764705882em;margin-left:-1.1764705882em;margin-right:1.1764705882em;padding-left:1.1764705882em;position:sticky;-webkit-user-select:none;user-select:none;z-index:3}.highlight code a[id]{position:absolute;visibility:hidden}.highlight code[data-md-copying]{display:initial}.highlight code[data-md-copying] .hll{display:contents}.highlight code[data-md-copying] .md-annotation{display:none}.highlighttable{display:flow-root}.highlighttable tbody,.highlighttable td{display:block;padding:0}.highlighttable tr{display:flex}.highlighttable pre{margin:0}.highlighttable th.filename{flex-grow:1;padding:0;text-align:left}.highlighttable th.filename span.filename{margin-top:0}.highlighttable .linenos{background-color:var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-top-left-radius:.1rem;font-size:.85em;padding:.7720588235em 0 .7720588235em 1.1764705882em;-webkit-user-select:none;user-select:none}.highlighttable .linenodiv{box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset}.highlighttable .linenodiv pre{color:var(--md-default-fg-color--light);text-align:right}.highlighttable .linenodiv span[class]{padding-right:.5882352941em}.highlighttable .code{flex:1;min-width:0}.linenodiv a{color:inherit}.md-typeset .highlighttable{direction:ltr;margin:1em 0}.md-typeset .highlighttable>tbody>tr>.code>div>pre>code{border-bottom-left-radius:0;border-top-left-radius:0}.md-typeset .highlight+.result{border:.05rem solid var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-bottom-right-radius:.1rem;border-top-width:.1rem;margin-top:-1.125em;overflow:visible;padding:0 1em}.md-typeset .highlight+.result:after{clear:both;content:"";display:block}@media screen and (max-width:44.984375em){.md-content__inner>.highlight{margin:1em -.8rem}.md-content__inner>.highlight>.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.code>div>pre>code,.md-content__inner>.highlight>.highlighttable>tbody>tr>.filename span.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.linenos,.md-content__inner>.highlight>pre>code{border-radius:0}.md-content__inner>.highlight+.result{border-left-width:0;border-radius:0;border-right-width:0;margin-left:-.8rem;margin-right:-.8rem}}.md-typeset .keys kbd:after,.md-typeset .keys kbd:before{-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys span{color:var(--md-default-fg-color--light);padding:0 .2em}.md-typeset .keys .key-alt:before,.md-typeset .keys .key-left-alt:before,.md-typeset .keys .key-right-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-command:before,.md-typeset .keys .key-left-command:before,.md-typeset .keys .key-right-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-control:before,.md-typeset .keys .key-left-control:before,.md-typeset .keys .key-right-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-left-meta:before,.md-typeset .keys .key-meta:before,.md-typeset .keys .key-right-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-left-option:before,.md-typeset .keys .key-option:before,.md-typeset .keys .key-right-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-left-shift:before,.md-typeset .keys .key-right-shift:before,.md-typeset .keys .key-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-left-super:before,.md-typeset .keys .key-right-super:before,.md-typeset .keys .key-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-left-windows:before,.md-typeset .keys .key-right-windows:before,.md-typeset .keys .key-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-arrow-down:before{content:"↓";padding-right:.4em}.md-typeset .keys .key-arrow-left:before{content:"←";padding-right:.4em}.md-typeset .keys .key-arrow-right:before{content:"→";padding-right:.4em}.md-typeset .keys .key-arrow-up:before{content:"↑";padding-right:.4em}.md-typeset .keys .key-backspace:before{content:"⌫";padding-right:.4em}.md-typeset .keys .key-backtab:before{content:"⇤";padding-right:.4em}.md-typeset .keys .key-caps-lock:before{content:"⇪";padding-right:.4em}.md-typeset .keys .key-clear:before{content:"⌧";padding-right:.4em}.md-typeset .keys .key-context-menu:before{content:"☰";padding-right:.4em}.md-typeset .keys .key-delete:before{content:"⌦";padding-right:.4em}.md-typeset .keys .key-eject:before{content:"⏏";padding-right:.4em}.md-typeset .keys .key-end:before{content:"⤓";padding-right:.4em}.md-typeset .keys .key-escape:before{content:"⎋";padding-right:.4em}.md-typeset .keys .key-home:before{content:"⤒";padding-right:.4em}.md-typeset .keys .key-insert:before{content:"⎀";padding-right:.4em}.md-typeset .keys .key-page-down:before{content:"⇟";padding-right:.4em}.md-typeset .keys .key-page-up:before{content:"⇞";padding-right:.4em}.md-typeset .keys .key-print-screen:before{content:"⎙";padding-right:.4em}.md-typeset .keys .key-tab:after{content:"⇥";padding-left:.4em}.md-typeset .keys .key-num-enter:after{content:"⌤";padding-left:.4em}.md-typeset .keys .key-enter:after{content:"⏎";padding-left:.4em}:root{--md-tabbed-icon--prev:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M15.41 16.58 10.83 12l4.58-4.59L14 6l-6 6 6 6 1.41-1.42Z"/></svg>');--md-tabbed-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>')}.md-typeset .tabbed-set{border-radius:.1rem;display:flex;flex-flow:column wrap;margin:1em 0;position:relative}.md-typeset .tabbed-set>input{height:0;opacity:0;position:absolute;width:0}.md-typeset .tabbed-set>input:target{--md-scroll-offset:0.625em}.md-typeset .tabbed-set>input.focus-visible~.tabbed-labels:before{background-color:var(--md-accent-fg-color)}.md-typeset .tabbed-labels{-ms-overflow-style:none;box-shadow:0 -.05rem var(--md-default-fg-color--lightest) inset;display:flex;max-width:100%;overflow:auto;scrollbar-width:none}@media print{.md-typeset .tabbed-labels{display:contents}}@media screen{.js .md-typeset .tabbed-labels{position:relative}.js .md-typeset .tabbed-labels:before{background:var(--md-default-fg-color);bottom:0;content:"";display:block;height:2px;left:0;position:absolute;transform:translateX(var(--md-indicator-x));transition:width 225ms,background-color .25s,transform .25s;transition-timing-function:cubic-bezier(.4,0,.2,1);width:var(--md-indicator-width)}}.md-typeset .tabbed-labels::-webkit-scrollbar{display:none}.md-typeset .tabbed-labels>label{border-bottom:.1rem solid #0000;border-radius:.1rem .1rem 0 0;color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;font-size:.64rem;font-weight:700;padding:.78125em 1.25em .625em;scroll-margin-inline-start:1rem;transition:background-color .25s,color .25s;white-space:nowrap;width:auto}@media print{.md-typeset .tabbed-labels>label:first-child{order:1}.md-typeset .tabbed-labels>label:nth-child(2){order:2}.md-typeset .tabbed-labels>label:nth-child(3){order:3}.md-typeset .tabbed-labels>label:nth-child(4){order:4}.md-typeset .tabbed-labels>label:nth-child(5){order:5}.md-typeset .tabbed-labels>label:nth-child(6){order:6}.md-typeset .tabbed-labels>label:nth-child(7){order:7}.md-typeset .tabbed-labels>label:nth-child(8){order:8}.md-typeset .tabbed-labels>label:nth-child(9){order:9}.md-typeset .tabbed-labels>label:nth-child(10){order:10}.md-typeset .tabbed-labels>label:nth-child(11){order:11}.md-typeset .tabbed-labels>label:nth-child(12){order:12}.md-typeset .tabbed-labels>label:nth-child(13){order:13}.md-typeset .tabbed-labels>label:nth-child(14){order:14}.md-typeset .tabbed-labels>label:nth-child(15){order:15}.md-typeset .tabbed-labels>label:nth-child(16){order:16}.md-typeset .tabbed-labels>label:nth-child(17){order:17}.md-typeset .tabbed-labels>label:nth-child(18){order:18}.md-typeset .tabbed-labels>label:nth-child(19){order:19}.md-typeset .tabbed-labels>label:nth-child(20){order:20}}.md-typeset .tabbed-labels>label:hover{color:var(--md-default-fg-color)}.md-typeset .tabbed-labels>label>[href]:first-child{color:inherit}.md-typeset .tabbed-labels--linked>label{padding:0}.md-typeset .tabbed-labels--linked>label>a{display:block;padding:.78125em 1.25em .625em}.md-typeset .tabbed-content{width:100%}@media print{.md-typeset .tabbed-content{display:contents}}.md-typeset .tabbed-block{display:none}@media print{.md-typeset .tabbed-block{display:block}.md-typeset .tabbed-block:first-child{order:1}.md-typeset .tabbed-block:nth-child(2){order:2}.md-typeset .tabbed-block:nth-child(3){order:3}.md-typeset .tabbed-block:nth-child(4){order:4}.md-typeset .tabbed-block:nth-child(5){order:5}.md-typeset .tabbed-block:nth-child(6){order:6}.md-typeset .tabbed-block:nth-child(7){order:7}.md-typeset .tabbed-block:nth-child(8){order:8}.md-typeset .tabbed-block:nth-child(9){order:9}.md-typeset .tabbed-block:nth-child(10){order:10}.md-typeset .tabbed-block:nth-child(11){order:11}.md-typeset .tabbed-block:nth-child(12){order:12}.md-typeset .tabbed-block:nth-child(13){order:13}.md-typeset .tabbed-block:nth-child(14){order:14}.md-typeset .tabbed-block:nth-child(15){order:15}.md-typeset .tabbed-block:nth-child(16){order:16}.md-typeset .tabbed-block:nth-child(17){order:17}.md-typeset .tabbed-block:nth-child(18){order:18}.md-typeset .tabbed-block:nth-child(19){order:19}.md-typeset .tabbed-block:nth-child(20){order:20}}.md-typeset .tabbed-block>.highlight:first-child>pre,.md-typeset .tabbed-block>pre:first-child{margin:0}.md-typeset .tabbed-block>.highlight:first-child>pre>code,.md-typeset .tabbed-block>pre:first-child>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child>.filename{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable{margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.filename span.filename,.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.linenos{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.code>div>pre>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child+.result{margin-top:-.125em}.md-typeset .tabbed-block>.tabbed-set{margin:0}.md-typeset .tabbed-button{align-self:center;border-radius:100%;color:var(--md-default-fg-color--light);cursor:pointer;display:block;height:.9rem;margin-top:.1rem;pointer-events:auto;transition:background-color .25s;width:.9rem}.md-typeset .tabbed-button:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .tabbed-button:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-tabbed-icon--prev);mask-image:var(--md-tabbed-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color .25s,transform .25s;width:100%}.md-typeset .tabbed-control{background:linear-gradient(to right,var(--md-default-bg-color) 60%,#0000);display:flex;height:1.9rem;justify-content:start;pointer-events:none;position:absolute;transition:opacity 125ms;width:1.2rem}[dir=rtl] .md-typeset .tabbed-control{transform:rotate(180deg)}.md-typeset .tabbed-control[hidden]{opacity:0}.md-typeset .tabbed-control--next{background:linear-gradient(to left,var(--md-default-bg-color) 60%,#0000);justify-content:end;right:0}.md-typeset .tabbed-control--next .tabbed-button:after{-webkit-mask-image:var(--md-tabbed-icon--next);mask-image:var(--md-tabbed-icon--next)}@media screen and (max-width:44.984375em){[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels{padding-right:.8rem}.md-content__inner>.tabbed-set .tabbed-labels{margin:0 -.8rem;max-width:100vw;scroll-padding-inline-start:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-left:.8rem}.md-content__inner>.tabbed-set .tabbed-labels:after{content:""}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-right:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-left:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-right:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{width:2rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-left:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-right:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-left:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{width:2rem}}@media screen{.md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){color:var(--md-default-fg-color)}.md-typeset .no-js .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .no-js .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .no-js .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .no-js .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .no-js .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .no-js .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .no-js .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .no-js .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .no-js .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .no-js .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .no-js .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .no-js .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .no-js .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .no-js .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .no-js .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .no-js .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .no-js .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .no-js .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .no-js .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .no-js .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.no-js .md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.no-js .md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.no-js .md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.no-js .md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.no-js .md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.no-js .md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.no-js .md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.no-js .md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.no-js .md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.no-js .md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.no-js .md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.no-js .md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.no-js .md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.no-js .md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.no-js .md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.no-js .md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.no-js .md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.no-js .md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.no-js .md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.no-js .md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){border-color:var(--md-default-fg-color)}}.md-typeset .tabbed-set>input:first-child.focus-visible~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10).focus-visible~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11).focus-visible~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12).focus-visible~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13).focus-visible~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14).focus-visible~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15).focus-visible~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16).focus-visible~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17).focus-visible~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18).focus-visible~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19).focus-visible~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2).focus-visible~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20).focus-visible~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3).focus-visible~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4).focus-visible~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5).focus-visible~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6).focus-visible~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7).focus-visible~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8).focus-visible~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9).focus-visible~.tabbed-labels>:nth-child(9){color:var(--md-accent-fg-color)}.md-typeset .tabbed-set>input:first-child:checked~.tabbed-content>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-content>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-content>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-content>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-content>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-content>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-content>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-content>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-content>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-content>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-content>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-content>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-content>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-content>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-content>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-content>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-content>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-content>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-content>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-content>:nth-child(9){display:block}:root{--md-tasklist-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12Zm16.28-2.72a.751.751 0 0 0-.018-1.042.751.751 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.751.751 0 0 0-1.042.018.751.751 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>');--md-tasklist-icon--checked:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12Zm16.28-2.72a.751.751 0 0 0-.018-1.042.751.751 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.751.751 0 0 0-1.042.018.751.751 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>')}.md-typeset .task-list-item{list-style-type:none;position:relative}[dir=ltr] .md-typeset .task-list-item [type=checkbox]{left:-2em}[dir=rtl] .md-typeset .task-list-item [type=checkbox]{right:-2em}.md-typeset .task-list-item [type=checkbox]{position:absolute;top:.45em}.md-typeset .task-list-control [type=checkbox]{opacity:0;z-index:-1}[dir=ltr] .md-typeset .task-list-indicator:before{left:-1.5em}[dir=rtl] .md-typeset .task-list-indicator:before{right:-1.5em}.md-typeset .task-list-indicator:before{background-color:var(--md-default-fg-color--lightest);content:"";height:1.25em;-webkit-mask-image:var(--md-tasklist-icon);mask-image:var(--md-tasklist-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.15em;width:1.25em}.md-typeset [type=checkbox]:checked+.task-list-indicator:before{background-color:#00e676;-webkit-mask-image:var(--md-tasklist-icon--checked);mask-image:var(--md-tasklist-icon--checked)}:root>*{--md-mermaid-font-family:var(--md-text-font-family),sans-serif;--md-mermaid-edge-color:var(--md-code-fg-color);--md-mermaid-node-bg-color:var(--md-accent-fg-color--transparent);--md-mermaid-node-fg-color:var(--md-accent-fg-color);--md-mermaid-label-bg-color:var(--md-default-bg-color);--md-mermaid-label-fg-color:var(--md-code-fg-color);--md-mermaid-sequence-actor-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actor-fg-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-actor-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-actor-line-color:var(--md-default-fg-color--lighter);--md-mermaid-sequence-actorman-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actorman-line-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-box-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-box-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-label-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-label-fg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-loop-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-loop-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-loop-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-message-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-message-line-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-note-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-border-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-number-bg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-number-fg-color:var(--md-accent-bg-color)}.mermaid{line-height:normal;margin:1em 0}.md-typeset .grid{grid-gap:.4rem;display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,16rem),1fr));margin:1em 0}.md-typeset .grid.cards>ol,.md-typeset .grid.cards>ul{display:contents}.md-typeset .grid.cards>ol>li,.md-typeset .grid.cards>ul>li,.md-typeset .grid>.card{border:.05rem solid var(--md-default-fg-color--lightest);border-radius:.1rem;display:block;margin:0;padding:.8rem;transition:border .25s,box-shadow .25s}.md-typeset .grid.cards>ol>li:focus-within,.md-typeset .grid.cards>ol>li:hover,.md-typeset .grid.cards>ul>li:focus-within,.md-typeset .grid.cards>ul>li:hover,.md-typeset .grid>.card:focus-within,.md-typeset .grid>.card:hover{border-color:#0000;box-shadow:var(--md-shadow-z2)}.md-typeset .grid.cards>ol>li>hr,.md-typeset .grid.cards>ul>li>hr,.md-typeset .grid>.card>hr{margin-bottom:1em;margin-top:1em}.md-typeset .grid.cards>ol>li>:first-child,.md-typeset .grid.cards>ul>li>:first-child,.md-typeset .grid>.card>:first-child{margin-top:0}.md-typeset .grid.cards>ol>li>:last-child,.md-typeset .grid.cards>ul>li>:last-child,.md-typeset .grid>.card>:last-child{margin-bottom:0}.md-typeset .grid>*,.md-typeset .grid>.admonition,.md-typeset .grid>.highlight>*,.md-typeset .grid>.highlighttable,.md-typeset .grid>.md-typeset details,.md-typeset .grid>details,.md-typeset .grid>pre{margin-bottom:0;margin-top:0}.md-typeset .grid>.highlight>pre:only-child,.md-typeset .grid>.highlight>pre>code,.md-typeset .grid>.highlighttable,.md-typeset .grid>.highlighttable>tbody,.md-typeset .grid>.highlighttable>tbody>tr,.md-typeset .grid>.highlighttable>tbody>tr>.code,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre>code{height:100%}.md-typeset .grid>.tabbed-set{margin-bottom:0;margin-top:0}@media screen and (min-width:45em){[dir=ltr] .md-typeset .inline{float:left}[dir=rtl] .md-typeset .inline{float:right}[dir=ltr] .md-typeset .inline{margin-right:.8rem}[dir=rtl] .md-typeset .inline{margin-left:.8rem}.md-typeset .inline{margin-bottom:.8rem;margin-top:0;width:11.7rem}[dir=ltr] .md-typeset .inline.end{float:right}[dir=rtl] .md-typeset .inline.end{float:left}[dir=ltr] .md-typeset .inline.end{margin-left:.8rem;margin-right:0}[dir=rtl] .md-typeset .inline.end{margin-left:0;margin-right:.8rem}}
\ No newline at end of file
+@charset "UTF-8";html{-webkit-text-size-adjust:none;-moz-text-size-adjust:none;text-size-adjust:none;box-sizing:border-box}*,:after,:before{box-sizing:inherit}@media (prefers-reduced-motion){*,:after,:before{transition:none!important}}body{margin:0}a,button,input,label{-webkit-tap-highlight-color:transparent}a{color:inherit;text-decoration:none}hr{border:0;box-sizing:initial;display:block;height:.05rem;overflow:visible;padding:0}small{font-size:80%}sub,sup{line-height:1em}img{border-style:none}table{border-collapse:initial;border-spacing:0}td,th{font-weight:400;vertical-align:top}button{background:#0000;border:0;font-family:inherit;font-size:inherit;margin:0;padding:0}input{border:0;outline:none}:root{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:#526cfe1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-scheme=default]{color-scheme:light}[data-md-color-scheme=default] img[src$="#gh-dark-mode-only"],[data-md-color-scheme=default] img[src$="#only-dark"]{display:none}:root,[data-md-color-scheme=default]{--md-hue:225deg;--md-default-fg-color:#000000de;--md-default-fg-color--light:#0000008a;--md-default-fg-color--lighter:#00000052;--md-default-fg-color--lightest:#00000012;--md-default-bg-color:#fff;--md-default-bg-color--light:#ffffffb3;--md-default-bg-color--lighter:#ffffff4d;--md-default-bg-color--lightest:#ffffff1f;--md-code-fg-color:#36464e;--md-code-bg-color:#f5f5f5;--md-code-bg-color--light:#f5f5f5b3;--md-code-bg-color--lighter:#f5f5f54d;--md-code-hl-color:#4287ff;--md-code-hl-color--light:#4287ff1a;--md-code-hl-number-color:#d52a2a;--md-code-hl-special-color:#db1457;--md-code-hl-function-color:#a846b9;--md-code-hl-constant-color:#6e59d9;--md-code-hl-keyword-color:#3f6ec6;--md-code-hl-string-color:#1c7d4d;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-del-color:#f5503d26;--md-typeset-ins-color:#0bd57026;--md-typeset-kbd-color:#fafafa;--md-typeset-kbd-accent-color:#fff;--md-typeset-kbd-border-color:#b8b8b8;--md-typeset-mark-color:#ffff0080;--md-typeset-table-color:#0000001f;--md-typeset-table-color--light:rgba(0,0,0,.035);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-warning-fg-color:#000000de;--md-warning-bg-color:#ff9;--md-footer-fg-color:#fff;--md-footer-fg-color--light:#ffffffb3;--md-footer-fg-color--lighter:#ffffff73;--md-footer-bg-color:#000000de;--md-footer-bg-color--dark:#00000052;--md-shadow-z1:0 0.2rem 0.5rem #0000000d,0 0 0.05rem #0000001a;--md-shadow-z2:0 0.2rem 0.5rem #0000001a,0 0 0.05rem #00000040;--md-shadow-z3:0 0.2rem 0.5rem #0003,0 0 0.05rem #00000059}.md-icon svg{fill:currentcolor;display:block;height:1.2rem;width:1.2rem}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;--md-text-font-family:var(--md-text-font,_),-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif;--md-code-font-family:var(--md-code-font,_),SFMono-Regular,Consolas,Menlo,monospace}aside,body,input{font-feature-settings:"kern","liga";color:var(--md-typeset-color);font-family:var(--md-text-font-family)}code,kbd,pre{font-feature-settings:"kern";font-family:var(--md-code-font-family)}:root{--md-typeset-table-sort-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m18 21-4-4h3V7h-3l4-4 4 4h-3v10h3M2 19v-2h10v2M2 13v-2h7v2M2 7V5h4v2H2Z"/></svg>');--md-typeset-table-sort-icon--asc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 17h3l-4 4-4-4h3V3h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2v-2Z"/></svg>');--md-typeset-table-sort-icon--desc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7h3l-4-4-4 4h3v14h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2v-2Z"/></svg>')}.md-typeset{-webkit-print-color-adjust:exact;color-adjust:exact;font-size:.8rem;line-height:1.6}@media print{.md-typeset{font-size:.68rem}}.md-typeset blockquote,.md-typeset dl,.md-typeset figure,.md-typeset ol,.md-typeset pre,.md-typeset ul{margin-bottom:1em;margin-top:1em}.md-typeset h1{color:var(--md-default-fg-color--light);font-size:2em;line-height:1.3;margin:0 0 1.25em}.md-typeset h1,.md-typeset h2{font-weight:300;letter-spacing:-.01em}.md-typeset h2{font-size:1.5625em;line-height:1.4;margin:1.6em 0 .64em}.md-typeset h3{font-size:1.25em;font-weight:400;letter-spacing:-.01em;line-height:1.5;margin:1.6em 0 .8em}.md-typeset h2+h3{margin-top:.8em}.md-typeset h4{font-weight:700;letter-spacing:-.01em;margin:1em 0}.md-typeset h5,.md-typeset h6{color:var(--md-default-fg-color--light);font-size:.8em;font-weight:700;letter-spacing:-.01em;margin:1.25em 0}.md-typeset h5{text-transform:uppercase}.md-typeset hr{border-bottom:.05rem solid var(--md-default-fg-color--lightest);display:flow-root;margin:1.5em 0}.md-typeset a{color:var(--md-typeset-a-color);word-break:break-word}.md-typeset a,.md-typeset a:before{transition:color 125ms}.md-typeset a:focus,.md-typeset a:hover{color:var(--md-accent-fg-color)}.md-typeset a:focus code,.md-typeset a:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset a code{color:var(--md-typeset-a-color)}.md-typeset a.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset code,.md-typeset kbd,.md-typeset pre{color:var(--md-code-fg-color);direction:ltr;font-variant-ligatures:none;transition:background-color 125ms}@media print{.md-typeset code,.md-typeset kbd,.md-typeset pre{white-space:pre-wrap}}.md-typeset code{background-color:var(--md-code-bg-color);border-radius:.1rem;-webkit-box-decoration-break:clone;box-decoration-break:clone;font-size:.85em;padding:0 .2941176471em;transition:color 125ms,background-color 125ms;word-break:break-word}.md-typeset code:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-typeset pre{display:flow-root;line-height:1.4;position:relative}.md-typeset pre>code{-webkit-box-decoration-break:slice;box-decoration-break:slice;box-shadow:none;display:block;margin:0;outline-color:var(--md-accent-fg-color);overflow:auto;padding:.7720588235em 1.1764705882em;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin;touch-action:auto;word-break:normal}.md-typeset pre>code:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-typeset pre>code::-webkit-scrollbar{height:.2rem;width:.2rem}.md-typeset pre>code::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-typeset pre>code::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}.md-typeset kbd{background-color:var(--md-typeset-kbd-color);border-radius:.1rem;box-shadow:0 .1rem 0 .05rem var(--md-typeset-kbd-border-color),0 .1rem 0 var(--md-typeset-kbd-border-color),0 -.1rem .2rem var(--md-typeset-kbd-accent-color) inset;color:var(--md-default-fg-color);display:inline-block;font-size:.75em;padding:0 .6666666667em;vertical-align:text-top;word-break:break-word}.md-typeset mark{background-color:var(--md-typeset-mark-color);-webkit-box-decoration-break:clone;box-decoration-break:clone;color:inherit;word-break:break-word}.md-typeset abbr{cursor:help;text-decoration:none}.md-typeset [data-preview],.md-typeset abbr{border-bottom:.05rem dotted var(--md-default-fg-color--light)}.md-typeset small{opacity:.75}[dir=ltr] .md-typeset sub,[dir=ltr] .md-typeset sup{margin-left:.078125em}[dir=rtl] .md-typeset sub,[dir=rtl] .md-typeset sup{margin-right:.078125em}[dir=ltr] .md-typeset blockquote{padding-left:.6rem}[dir=rtl] .md-typeset blockquote{padding-right:.6rem}[dir=ltr] .md-typeset blockquote{border-left:.2rem solid var(--md-default-fg-color--lighter)}[dir=rtl] .md-typeset blockquote{border-right:.2rem solid var(--md-default-fg-color--lighter)}.md-typeset blockquote{color:var(--md-default-fg-color--light);margin-left:0;margin-right:0}.md-typeset ul{list-style-type:disc}[dir=ltr] .md-typeset ol,[dir=ltr] .md-typeset ul{margin-left:.625em}[dir=rtl] .md-typeset ol,[dir=rtl] .md-typeset ul{margin-right:.625em}.md-typeset ol,.md-typeset ul{padding:0}.md-typeset ol:not([hidden]),.md-typeset ul:not([hidden]){display:flow-root}.md-typeset ol ol,.md-typeset ul ol{list-style-type:lower-alpha}.md-typeset ol ol ol,.md-typeset ul ol ol{list-style-type:lower-roman}[dir=ltr] .md-typeset ol li,[dir=ltr] .md-typeset ul li{margin-left:1.25em}[dir=rtl] .md-typeset ol li,[dir=rtl] .md-typeset ul li{margin-right:1.25em}.md-typeset ol li,.md-typeset ul li{margin-bottom:.5em}.md-typeset ol li blockquote,.md-typeset ol li p,.md-typeset ul li blockquote,.md-typeset ul li p{margin:.5em 0}.md-typeset ol li:last-child,.md-typeset ul li:last-child{margin-bottom:0}[dir=ltr] .md-typeset ol li ol,[dir=ltr] .md-typeset ol li ul,[dir=ltr] .md-typeset ul li ol,[dir=ltr] .md-typeset ul li ul{margin-left:.625em}[dir=rtl] .md-typeset ol li ol,[dir=rtl] .md-typeset ol li ul,[dir=rtl] .md-typeset ul li ol,[dir=rtl] .md-typeset ul li ul{margin-right:.625em}.md-typeset ol li ol,.md-typeset ol li ul,.md-typeset ul li ol,.md-typeset ul li ul{margin-bottom:.5em;margin-top:.5em}[dir=ltr] .md-typeset dd{margin-left:1.875em}[dir=rtl] .md-typeset dd{margin-right:1.875em}.md-typeset dd{margin-bottom:1.5em;margin-top:1em}.md-typeset img,.md-typeset svg,.md-typeset video{height:auto;max-width:100%}.md-typeset img[align=left]{margin:1em 1em 1em 0}.md-typeset img[align=right]{margin:1em 0 1em 1em}.md-typeset img[align]:only-child{margin-top:0}.md-typeset figure{display:flow-root;margin:1em auto;max-width:100%;text-align:center;width:-moz-fit-content;width:fit-content}.md-typeset figure img{display:block;margin:0 auto}.md-typeset figcaption{font-style:italic;margin:1em auto;max-width:24rem}.md-typeset iframe{max-width:100%}.md-typeset table:not([class]){background-color:var(--md-default-bg-color);border:.05rem solid var(--md-typeset-table-color);border-radius:.1rem;display:inline-block;font-size:.64rem;max-width:100%;overflow:auto;touch-action:auto}@media print{.md-typeset table:not([class]){display:table}}.md-typeset table:not([class])+*{margin-top:1.5em}.md-typeset table:not([class]) td>:first-child,.md-typeset table:not([class]) th>:first-child{margin-top:0}.md-typeset table:not([class]) td>:last-child,.md-typeset table:not([class]) th>:last-child{margin-bottom:0}.md-typeset table:not([class]) td:not([align]),.md-typeset table:not([class]) th:not([align]){text-align:left}[dir=rtl] .md-typeset table:not([class]) td:not([align]),[dir=rtl] .md-typeset table:not([class]) th:not([align]){text-align:right}.md-typeset table:not([class]) th{font-weight:700;min-width:5rem;padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) td{border-top:.05rem solid var(--md-typeset-table-color);padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) tbody tr{transition:background-color 125ms}.md-typeset table:not([class]) tbody tr:hover{background-color:var(--md-typeset-table-color--light);box-shadow:0 .05rem 0 var(--md-default-bg-color) inset}.md-typeset table:not([class]) a{word-break:normal}.md-typeset table th[role=columnheader]{cursor:pointer}[dir=ltr] .md-typeset table th[role=columnheader]:after{margin-left:.5em}[dir=rtl] .md-typeset table th[role=columnheader]:after{margin-right:.5em}.md-typeset table th[role=columnheader]:after{content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-typeset-table-sort-icon);mask-image:var(--md-typeset-table-sort-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset table th[role=columnheader]:hover:after{background-color:var(--md-default-fg-color--lighter)}.md-typeset table th[role=columnheader][aria-sort=ascending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--asc);mask-image:var(--md-typeset-table-sort-icon--asc)}.md-typeset table th[role=columnheader][aria-sort=descending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--desc);mask-image:var(--md-typeset-table-sort-icon--desc)}.md-typeset__scrollwrap{margin:1em -.8rem;overflow-x:auto;touch-action:auto}.md-typeset__table{display:inline-block;margin-bottom:.5em;padding:0 .8rem}@media print{.md-typeset__table{display:block}}html .md-typeset__table table{display:table;margin:0;overflow:hidden;width:100%}@media screen and (max-width:44.984375em){.md-content__inner>pre{margin:1em -.8rem}.md-content__inner>pre code{border-radius:0}}.md-typeset .md-author{border-radius:100%;display:block;flex-shrink:0;height:1.6rem;overflow:hidden;position:relative;transition:color 125ms,transform 125ms;width:1.6rem}.md-typeset .md-author img{display:block}.md-typeset .md-author--more{background:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--lighter);font-size:.6rem;font-weight:700;line-height:1.6rem;text-align:center}.md-typeset .md-author--long{height:2.4rem;width:2.4rem}.md-typeset a.md-author{transform:scale(1)}.md-typeset a.md-author img{border-radius:100%;filter:grayscale(100%) opacity(75%);transition:filter 125ms}.md-typeset a.md-author:focus,.md-typeset a.md-author:hover{transform:scale(1.1);z-index:1}.md-typeset a.md-author:focus img,.md-typeset a.md-author:hover img{filter:grayscale(0)}.md-banner{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color);overflow:auto}@media print{.md-banner{display:none}}.md-banner--warning{background-color:var(--md-warning-bg-color);color:var(--md-warning-fg-color)}.md-banner__inner{font-size:.7rem;margin:.6rem auto;padding:0 .8rem}[dir=ltr] .md-banner__button{float:right}[dir=rtl] .md-banner__button{float:left}.md-banner__button{color:inherit;cursor:pointer;transition:opacity .25s}.no-js .md-banner__button{display:none}.md-banner__button:hover{opacity:.7}html{font-size:125%;height:100%;overflow-x:hidden}@media screen and (min-width:100em){html{font-size:137.5%}}@media screen and (min-width:125em){html{font-size:150%}}body{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;font-size:.5rem;min-height:100%;position:relative;width:100%}@media print{body{display:block}}@media screen and (max-width:59.984375em){body[data-md-scrolllock]{position:fixed}}.md-grid{margin-left:auto;margin-right:auto;max-width:61rem}.md-container{display:flex;flex-direction:column;flex-grow:1}@media print{.md-container{display:block}}.md-main{flex-grow:1}.md-main__inner{display:flex;height:100%;margin-top:1.5rem}.md-ellipsis{overflow:hidden;text-overflow:ellipsis}.md-toggle{display:none}.md-option{height:0;opacity:0;position:absolute;width:0}.md-option:checked+label:not([hidden]){display:block}.md-option.focus-visible+label{outline-color:var(--md-accent-fg-color);outline-style:auto}.md-skip{background-color:var(--md-default-fg-color);border-radius:.1rem;color:var(--md-default-bg-color);font-size:.64rem;margin:.5rem;opacity:0;outline-color:var(--md-accent-fg-color);padding:.3rem .5rem;position:fixed;transform:translateY(.4rem);z-index:-1}.md-skip:focus{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 175ms 75ms;z-index:10}@page{margin:25mm}:root{--md-clipboard-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 21H8V7h11m0-2H8a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2m-3-4H4a2 2 0 0 0-2 2v14h2V3h12V1Z"/></svg>')}.md-clipboard{border-radius:.1rem;color:var(--md-default-fg-color--lightest);cursor:pointer;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;transition:color .25s;width:1.5em;z-index:1}@media print{.md-clipboard{display:none}}.md-clipboard:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}:hover>.md-clipboard{color:var(--md-default-fg-color--light)}.md-clipboard:focus,.md-clipboard:hover{color:var(--md-accent-fg-color)}.md-clipboard:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-image:var(--md-clipboard-icon);mask-image:var(--md-clipboard-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-clipboard--inline{cursor:pointer}.md-clipboard--inline code{transition:color .25s,background-color .25s}.md-clipboard--inline:focus code,.md-clipboard--inline:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}:root{--md-code-select-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 19h-4v2h4c1.1 0 2-.9 2-2v-4h-2m0-12h-4v2h4v4h2V5c0-1.1-.9-2-2-2M5 5h4V3H5c-1.1 0-2 .9-2 2v4h2m0 6H3v4c0 1.1.9 2 2 2h4v-2H5v-4m2-4h2v2H7v-2m4 0h2v2h-2v-2m4 0h2v2h-2v-2M7 7h2v2H7V7m4 0h2v2h-2V7m4 0h2v2h-2V7m-8 8h2v2H7v-2m4 0h2v2h-2v-2m4 0h2v2h-2v-2Z"/></svg>');--md-code-copy-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 21H8V7h11m0-2H8a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2m-3-4H4a2 2 0 0 0-2 2v14h2V3h12V1Z"/></svg>')}.md-typeset .md-code__content{display:grid}.md-code__nav{background-color:var(--md-code-bg-color--lighter);border-radius:.1rem;display:flex;gap:.2rem;padding:.2rem;position:absolute;right:.25em;top:.25em;transition:background-color .25s;z-index:1}:hover>.md-code__nav{background-color:var(--md-code-bg-color--light)}.md-code__button{color:var(--md-default-fg-color--lightest);cursor:pointer;display:block;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;transition:color .25s;width:1.5em}:hover>*>.md-code__button{color:var(--md-default-fg-color--light)}.md-code__button.focus-visible,.md-code__button:hover{color:var(--md-accent-fg-color)}.md-code__button--active{color:var(--md-default-fg-color)!important}.md-code__button:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-code__button[data-md-type=select]:after{-webkit-mask-image:var(--md-code-select-icon);mask-image:var(--md-code-select-icon)}.md-code__button[data-md-type=copy]:after{-webkit-mask-image:var(--md-code-copy-icon);mask-image:var(--md-code-copy-icon)}@keyframes consent{0%{opacity:0;transform:translateY(100%)}to{opacity:1;transform:translateY(0)}}@keyframes overlay{0%{opacity:0}to{opacity:1}}.md-consent__overlay{animation:overlay .25s both;-webkit-backdrop-filter:blur(.1rem);backdrop-filter:blur(.1rem);background-color:#0000008a;height:100%;opacity:1;position:fixed;top:0;width:100%;z-index:5}.md-consent__inner{animation:consent .5s cubic-bezier(.1,.7,.1,1) both;background-color:var(--md-default-bg-color);border:0;border-radius:.1rem;bottom:0;box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;max-height:100%;overflow:auto;padding:0;position:fixed;width:100%;z-index:5}.md-consent__form{padding:.8rem}.md-consent__settings{display:none;margin:1em 0}input:checked+.md-consent__settings{display:block}.md-consent__controls{margin-bottom:.8rem}.md-typeset .md-consent__controls .md-button{display:inline}@media screen and (max-width:44.984375em){.md-typeset .md-consent__controls .md-button{display:block;margin-top:.4rem;text-align:center;width:100%}}.md-consent label{cursor:pointer}.md-content{flex-grow:1;min-width:0}.md-content__inner{margin:0 .8rem 1.2rem;padding-top:.6rem}@media screen and (min-width:76.25em){[dir=ltr] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}[dir=ltr] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner,[dir=rtl] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-right:1.2rem}[dir=rtl] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}}.md-content__inner:before{content:"";display:block;height:.4rem}.md-content__inner>:last-child{margin-bottom:0}[dir=ltr] .md-content__button{float:right}[dir=rtl] .md-content__button{float:left}[dir=ltr] .md-content__button{margin-left:.4rem}[dir=rtl] .md-content__button{margin-right:.4rem}.md-content__button{margin:.4rem 0;padding:0}@media print{.md-content__button{display:none}}.md-typeset .md-content__button{color:var(--md-default-fg-color--lighter)}.md-content__button svg{display:inline;vertical-align:top}[dir=rtl] .md-content__button svg{transform:scaleX(-1)}[dir=ltr] .md-dialog{right:.8rem}[dir=rtl] .md-dialog{left:.8rem}.md-dialog{background-color:var(--md-default-fg-color);border-radius:.1rem;bottom:.8rem;box-shadow:var(--md-shadow-z3);min-width:11.1rem;opacity:0;padding:.4rem .6rem;pointer-events:none;position:fixed;transform:translateY(100%);transition:transform 0ms .4s,opacity .4s;z-index:4}@media print{.md-dialog{display:none}}.md-dialog--active{opacity:1;pointer-events:auto;transform:translateY(0);transition:transform .4s cubic-bezier(.075,.85,.175,1),opacity .4s}.md-dialog__inner{color:var(--md-default-bg-color);font-size:.7rem}.md-feedback{margin:2em 0 1em;text-align:center}.md-feedback fieldset{border:none;margin:0;padding:0}.md-feedback__title{font-weight:700;margin:1em auto}.md-feedback__inner{position:relative}.md-feedback__list{display:flex;flex-wrap:wrap;place-content:baseline center;position:relative}.md-feedback__list:hover .md-icon:not(:disabled){color:var(--md-default-fg-color--lighter)}:disabled .md-feedback__list{min-height:1.8rem}.md-feedback__icon{color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;margin:0 .1rem;transition:color 125ms}.md-feedback__icon:not(:disabled).md-icon:hover{color:var(--md-accent-fg-color)}.md-feedback__icon:disabled{color:var(--md-default-fg-color--lightest);pointer-events:none}.md-feedback__note{opacity:0;position:relative;transform:translateY(.4rem);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-feedback__note>*{margin:0 auto;max-width:16rem}:disabled .md-feedback__note{opacity:1;transform:translateY(0)}.md-footer{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color)}@media print{.md-footer{display:none}}.md-footer__inner{justify-content:space-between;overflow:auto;padding:.2rem}.md-footer__inner:not([hidden]){display:flex}.md-footer__link{align-items:end;display:flex;flex-grow:0.01;margin-bottom:.4rem;margin-top:1rem;max-width:100%;outline-color:var(--md-accent-fg-color);overflow:hidden;transition:opacity .25s}.md-footer__link:focus,.md-footer__link:hover{opacity:.7}[dir=rtl] .md-footer__link svg{transform:scaleX(-1)}@media screen and (max-width:44.984375em){.md-footer__link--prev{flex-shrink:0}.md-footer__link--prev .md-footer__title{display:none}}[dir=ltr] .md-footer__link--next{margin-left:auto}[dir=rtl] .md-footer__link--next{margin-right:auto}.md-footer__link--next{text-align:right}[dir=rtl] .md-footer__link--next{text-align:left}.md-footer__title{flex-grow:1;font-size:.9rem;margin-bottom:.7rem;max-width:calc(100% - 2.4rem);padding:0 1rem;white-space:nowrap}.md-footer__button{margin:.2rem;padding:.4rem}.md-footer__direction{font-size:.64rem;opacity:.7}.md-footer-meta{background-color:var(--md-footer-bg-color--dark)}.md-footer-meta__inner{display:flex;flex-wrap:wrap;justify-content:space-between;padding:.2rem}html .md-footer-meta.md-typeset a{color:var(--md-footer-fg-color--light)}html .md-footer-meta.md-typeset a:focus,html .md-footer-meta.md-typeset a:hover{color:var(--md-footer-fg-color)}.md-copyright{color:var(--md-footer-fg-color--lighter);font-size:.64rem;margin:auto .6rem;padding:.4rem 0;width:100%}@media screen and (min-width:45em){.md-copyright{width:auto}}.md-copyright__highlight{color:var(--md-footer-fg-color--light)}.md-social{display:inline-flex;gap:.2rem;margin:0 .4rem;padding:.2rem 0 .6rem}@media screen and (min-width:45em){.md-social{padding:.6rem 0}}.md-social__link{display:inline-block;height:1.6rem;text-align:center;width:1.6rem}.md-social__link:before{line-height:1.9}.md-social__link svg{fill:currentcolor;max-height:.8rem;vertical-align:-25%}.md-typeset .md-button{border:.1rem solid;border-radius:.1rem;color:var(--md-primary-fg-color);cursor:pointer;display:inline-block;font-weight:700;padding:.625em 2em;transition:color 125ms,background-color 125ms,border-color 125ms}.md-typeset .md-button--primary{background-color:var(--md-primary-fg-color);border-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color)}.md-typeset .md-button:focus,.md-typeset .md-button:hover{background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[dir=ltr] .md-typeset .md-input{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .md-input,[dir=rtl] .md-typeset .md-input{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .md-input{border-top-left-radius:.1rem}.md-typeset .md-input{border-bottom:.1rem solid var(--md-default-fg-color--lighter);box-shadow:var(--md-shadow-z1);font-size:.8rem;height:1.8rem;padding:0 .6rem;transition:border .25s,box-shadow .25s}.md-typeset .md-input:focus,.md-typeset .md-input:hover{border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input--stretch{width:100%}.md-header{background-color:var(--md-primary-fg-color);box-shadow:0 0 .2rem #0000,0 .2rem .4rem #0000;color:var(--md-primary-bg-color);display:block;left:0;position:sticky;right:0;top:0;z-index:4}@media print{.md-header{display:none}}.md-header[hidden]{transform:translateY(-100%);transition:transform .25s cubic-bezier(.8,0,.6,1),box-shadow .25s}.md-header--shadow{box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;transition:transform .25s cubic-bezier(.1,.7,.1,1),box-shadow .25s}.md-header__inner{align-items:center;display:flex;padding:0 .2rem}.md-header__button{color:currentcolor;cursor:pointer;margin:.2rem;outline-color:var(--md-accent-fg-color);padding:.4rem;position:relative;transition:opacity .25s;vertical-align:middle;z-index:1}.md-header__button:hover{opacity:.7}.md-header__button:not([hidden]){display:inline-block}.md-header__button:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-header__button.md-logo{margin:.2rem;padding:.4rem}@media screen and (max-width:76.234375em){.md-header__button.md-logo{display:none}}.md-header__button.md-logo img,.md-header__button.md-logo svg{fill:currentcolor;display:block;height:1.2rem;width:auto}@media screen and (min-width:60em){.md-header__button[for=__search]{display:none}}.no-js .md-header__button[for=__search]{display:none}[dir=rtl] .md-header__button[for=__search] svg{transform:scaleX(-1)}@media screen and (min-width:76.25em){.md-header__button[for=__drawer]{display:none}}.md-header__topic{display:flex;max-width:100%;position:absolute;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;white-space:nowrap}.md-header__topic+.md-header__topic{opacity:0;pointer-events:none;transform:translateX(1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__topic+.md-header__topic{transform:translateX(-1.25rem)}.md-header__topic:first-child{font-weight:700}[dir=ltr] .md-header__title{margin-left:1rem;margin-right:.4rem}[dir=rtl] .md-header__title{margin-left:.4rem;margin-right:1rem}.md-header__title{flex-grow:1;font-size:.9rem;height:2.4rem;line-height:2.4rem}.md-header__title--active .md-header__topic{opacity:0;pointer-events:none;transform:translateX(-1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__title--active .md-header__topic{transform:translateX(1.25rem)}.md-header__title--active .md-header__topic+.md-header__topic{opacity:1;pointer-events:auto;transform:translateX(0);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;z-index:0}.md-header__title>.md-header__ellipsis{height:100%;position:relative;width:100%}.md-header__option{display:flex;flex-shrink:0;max-width:100%;transition:max-width 0ms .25s,opacity .25s .25s;white-space:nowrap}[data-md-toggle=search]:checked~.md-header .md-header__option{max-width:0;opacity:0;transition:max-width 0ms,opacity 0ms}.md-header__option>input{bottom:0}.md-header__source{display:none}@media screen and (min-width:60em){[dir=ltr] .md-header__source{margin-left:1rem}[dir=rtl] .md-header__source{margin-right:1rem}.md-header__source{display:block;max-width:11.7rem;width:11.7rem}}@media screen and (min-width:76.25em){[dir=ltr] .md-header__source{margin-left:1.4rem}[dir=rtl] .md-header__source{margin-right:1.4rem}}.md-meta{color:var(--md-default-fg-color--light);font-size:.7rem;line-height:1.3}.md-meta__list{display:inline-flex;flex-wrap:wrap;list-style:none;margin:0;padding:0}.md-meta__item:not(:last-child):after{content:"·";margin-left:.2rem;margin-right:.2rem}.md-meta__link{color:var(--md-typeset-a-color)}.md-meta__link:focus,.md-meta__link:hover{color:var(--md-accent-fg-color)}.md-draft{background-color:#ff1744;border-radius:.125em;color:#fff;display:inline-block;font-weight:700;padding-left:.5714285714em;padding-right:.5714285714em}:root{--md-nav-icon--prev:url('data:image/svg+xml;charset=utf-8,<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>');--md-nav-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>');--md-toc-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 9h14V7H3v2m0 4h14v-2H3v2m0 4h14v-2H3v2m16 0h2v-2h-2v2m0-10v2h2V7h-2m0 6h2v-2h-2v2Z"/></svg>')}.md-nav{font-size:.7rem;line-height:1.3}.md-nav__title{color:var(--md-default-fg-color--light);display:block;font-weight:700;overflow:hidden;padding:0 .6rem;text-overflow:ellipsis}.md-nav__title .md-nav__button{display:none}.md-nav__title .md-nav__button img{height:100%;width:auto}.md-nav__title .md-nav__button.md-logo img,.md-nav__title .md-nav__button.md-logo svg{fill:currentcolor;display:block;height:2.4rem;max-width:100%;object-fit:contain;width:auto}.md-nav__list{list-style:none;margin:0;padding:0}.md-nav__link{align-items:flex-start;display:flex;gap:.4rem;margin-top:.625em;scroll-snap-align:start;transition:color 125ms}.md-nav__link--passed,.md-nav__link--passed code{color:var(--md-default-fg-color--light)}.md-nav__item .md-nav__link--active,.md-nav__item .md-nav__link--active code{color:var(--md-typeset-a-color)}.md-nav__link .md-ellipsis{position:relative}.md-nav__link .md-ellipsis code{word-break:normal}[dir=ltr] .md-nav__link .md-icon:last-child{margin-left:auto}[dir=rtl] .md-nav__link .md-icon:last-child{margin-right:auto}.md-nav__link .md-typeset{font-size:.7rem;line-height:1.3}.md-nav__link svg{fill:currentcolor;flex-shrink:0;height:1.3em;position:relative}.md-nav__link[for]:focus,.md-nav__link[for]:hover,.md-nav__link[href]:focus,.md-nav__link[href]:hover{color:var(--md-accent-fg-color);cursor:pointer}.md-nav__link[for]:focus code,.md-nav__link[for]:hover code,.md-nav__link[href]:focus code,.md-nav__link[href]:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-nav__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-nav--primary .md-nav__link[for=__toc]{display:none}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{background-color:currentcolor;display:block;height:100%;-webkit-mask-image:var(--md-toc-icon);mask-image:var(--md-toc-icon);width:100%}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:none}.md-nav__container>.md-nav__link{margin-top:0}.md-nav__container>.md-nav__link:first-child{flex-grow:1;min-width:0}.md-nav__icon{flex-shrink:0}.md-nav__source{display:none}@media screen and (max-width:76.234375em){.md-nav--primary,.md-nav--primary .md-nav{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;height:100%;left:0;position:absolute;right:0;top:0;z-index:1}.md-nav--primary .md-nav__item,.md-nav--primary .md-nav__title{font-size:.8rem;line-height:1.5}.md-nav--primary .md-nav__title{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);cursor:pointer;height:5.6rem;line-height:2.4rem;padding:3rem .8rem .2rem;position:relative;white-space:nowrap}[dir=ltr] .md-nav--primary .md-nav__title .md-nav__icon{left:.4rem}[dir=rtl] .md-nav--primary .md-nav__title .md-nav__icon{right:.4rem}.md-nav--primary .md-nav__title .md-nav__icon{display:block;height:1.2rem;margin:.2rem;position:absolute;top:.4rem;width:1.2rem}.md-nav--primary .md-nav__title .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--prev);mask-image:var(--md-nav-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}.md-nav--primary .md-nav__title~.md-nav__list{background-color:var(--md-default-bg-color);box-shadow:0 .05rem 0 var(--md-default-fg-color--lightest) inset;overflow-y:auto;scroll-snap-type:y mandatory;touch-action:pan-y}.md-nav--primary .md-nav__title~.md-nav__list>:first-child{border-top:0}.md-nav--primary .md-nav__title[for=__drawer]{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);font-weight:700}.md-nav--primary .md-nav__title .md-logo{display:block;left:.2rem;margin:.2rem;padding:.4rem;position:absolute;right:.2rem;top:.2rem}.md-nav--primary .md-nav__list{flex:1}.md-nav--primary .md-nav__item{border-top:.05rem solid var(--md-default-fg-color--lightest)}.md-nav--primary .md-nav__item--active>.md-nav__link{color:var(--md-typeset-a-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:focus,.md-nav--primary .md-nav__item--active>.md-nav__link:hover{color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__link{margin-top:0;padding:.6rem .8rem}.md-nav--primary .md-nav__link svg{margin-top:.1em}.md-nav--primary .md-nav__link>.md-nav__link{padding:0}[dir=ltr] .md-nav--primary .md-nav__link .md-nav__icon{margin-right:-.2rem}[dir=rtl] .md-nav--primary .md-nav__link .md-nav__icon{margin-left:-.2rem}.md-nav--primary .md-nav__link .md-nav__icon{font-size:1.2rem;height:1.2rem;width:1.2rem}.md-nav--primary .md-nav__link .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-nav--primary .md-nav__icon:after{transform:scale(-1)}.md-nav--primary .md-nav--secondary .md-nav{background-color:initial;position:static}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-left:1.4rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-right:1.4rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-left:2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-right:2rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-left:2.6rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-right:2.6rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-left:3.2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-right:3.2rem}.md-nav--secondary{background-color:initial}.md-nav__toggle~.md-nav{display:flex;opacity:0;transform:translateX(100%);transition:transform .25s cubic-bezier(.8,0,.6,1),opacity 125ms 50ms}[dir=rtl] .md-nav__toggle~.md-nav{transform:translateX(-100%)}.md-nav__toggle:checked~.md-nav{opacity:1;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 125ms 125ms}.md-nav__toggle:checked~.md-nav>.md-nav__list{-webkit-backface-visibility:hidden;backface-visibility:hidden}}@media screen and (max-width:59.984375em){.md-nav--primary .md-nav__link[for=__toc]{display:flex}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--primary .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:flex}.md-nav__source{background-color:var(--md-primary-fg-color--dark);color:var(--md-primary-bg-color);display:block;padding:0 .2rem}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-nav--integrated .md-nav__link[for=__toc]{display:flex}.md-nav--integrated .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--integrated .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--integrated .md-nav__link[for=__toc]~.md-nav{display:flex}}@media screen and (min-width:60em){.md-nav{margin-bottom:-.4rem}.md-nav--secondary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--secondary .md-nav__title[for=__toc]{scroll-snap-align:start}.md-nav--secondary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--secondary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--secondary .md-nav__list{padding-right:.6rem}.md-nav--secondary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--secondary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--secondary .md-nav__item>.md-nav__link{margin-left:.4rem}}@media screen and (min-width:76.25em){.md-nav{margin-bottom:-.4rem;transition:max-height .25s cubic-bezier(.86,0,.07,1)}.md-nav--primary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--primary .md-nav__title[for=__drawer]{scroll-snap-align:start}.md-nav--primary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--primary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--primary .md-nav__list{padding-right:.6rem}.md-nav--primary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--primary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--primary .md-nav__item>.md-nav__link{margin-left:.4rem}.md-nav__toggle~.md-nav{display:grid;grid-template-rows:0fr;opacity:0;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .25s,visibility 0ms .25s;visibility:collapse}.md-nav__toggle~.md-nav>.md-nav__list{overflow:hidden}.md-nav__toggle.md-toggle--indeterminate~.md-nav,.md-nav__toggle:checked~.md-nav{grid-template-rows:1fr;opacity:1;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .15s .1s,visibility 0ms;visibility:visible}.md-nav__toggle.md-toggle--indeterminate~.md-nav{transition:none}.md-nav__item--nested>.md-nav>.md-nav__title{display:none}.md-nav__item--section{display:block;margin:1.25em 0}.md-nav__item--section:last-child{margin-bottom:0}.md-nav__item--section>.md-nav__link{font-weight:700}.md-nav__item--section>.md-nav__link[for]{color:var(--md-default-fg-color--light)}.md-nav__item--section>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav__item--section>.md-nav__link .md-icon,.md-nav__item--section>.md-nav__link>[for]{display:none}[dir=ltr] .md-nav__item--section>.md-nav{margin-left:-.6rem}[dir=rtl] .md-nav__item--section>.md-nav{margin-right:-.6rem}.md-nav__item--section>.md-nav{display:block;opacity:1;visibility:visible}.md-nav__item--section>.md-nav>.md-nav__list>.md-nav__item{padding:0}.md-nav__icon{border-radius:100%;height:.9rem;transition:background-color .25s;width:.9rem}.md-nav__icon:hover{background-color:var(--md-accent-fg-color--transparent)}.md-nav__icon:after{background-color:currentcolor;border-radius:100%;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:transform .25s;vertical-align:-.1rem;width:100%}[dir=rtl] .md-nav__icon:after{transform:rotate(180deg)}.md-nav__item--nested .md-nav__toggle:checked~.md-nav__link .md-nav__icon:after,.md-nav__item--nested .md-toggle--indeterminate~.md-nav__link .md-nav__icon:after{transform:rotate(90deg)}.md-nav--lifted>.md-nav__list>.md-nav__item,.md-nav--lifted>.md-nav__title{display:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active{display:block}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);margin-top:0;position:sticky;top:0;z-index:1}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active.md-nav__item--section{margin:0}[dir=ltr] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-left:-.6rem}[dir=rtl] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-right:-.6rem}.md-nav--lifted>.md-nav__list>.md-nav__item>[for]{color:var(--md-default-fg-color--light)}.md-nav--lifted .md-nav[data-md-level="1"]{grid-template-rows:1fr;opacity:1;visibility:visible}[dir=ltr] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-left:.05rem solid var(--md-primary-fg-color)}[dir=rtl] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-right:.05rem solid var(--md-primary-fg-color)}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{display:block;margin-bottom:1.25em;opacity:1;visibility:visible}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__list{overflow:visible;padding-bottom:0}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__title{display:none}}.md-pagination{font-size:.8rem;font-weight:700;gap:.4rem}.md-pagination,.md-pagination>*{align-items:center;display:flex;justify-content:center}.md-pagination>*{border-radius:.2rem;height:1.8rem;min-width:1.8rem;text-align:center}.md-pagination__current{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light)}.md-pagination__link{transition:color 125ms,background-color 125ms}.md-pagination__link:focus,.md-pagination__link:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-pagination__link:focus svg,.md-pagination__link:hover svg{color:var(--md-accent-fg-color)}.md-pagination__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-pagination__link svg{fill:currentcolor;color:var(--md-default-fg-color--lighter);display:block;max-height:100%;width:1.2rem}:root{--md-path-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>')}.md-path{font-size:.7rem;margin:0 .8rem;overflow:auto;padding-top:1.2rem}.md-path:not([hidden]){display:block}@media screen and (min-width:76.25em){.md-path{margin:0 1.2rem}}.md-path__list{align-items:center;display:flex;gap:.2rem;list-style:none;margin:0;padding:0}.md-path__item:not(:first-child){display:inline-flex;gap:.2rem;white-space:nowrap}.md-path__item:not(:first-child):before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline;height:.8rem;-webkit-mask-image:var(--md-path-icon);mask-image:var(--md-path-icon);width:.8rem}.md-path__link{align-items:center;color:var(--md-default-fg-color--light);display:flex}.md-path__link:focus,.md-path__link:hover{color:var(--md-accent-fg-color)}:root{--md-post-pin-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M16 12V4h1V2H7v2h1v8l-2 2v2h5.2v6h1.6v-6H18v-2l-2-2Z"/></svg>')}.md-post__back{border-bottom:.05rem solid var(--md-default-fg-color--lightest);margin-bottom:1.2rem;padding-bottom:1.2rem}@media screen and (max-width:76.234375em){.md-post__back{display:none}}[dir=rtl] .md-post__back svg{transform:scaleX(-1)}.md-post__authors{display:flex;flex-direction:column;gap:.6rem;margin:0 .6rem 1.2rem}.md-post .md-post__meta a{transition:color 125ms}.md-post .md-post__meta a:focus,.md-post .md-post__meta a:hover{color:var(--md-accent-fg-color)}.md-post__title{color:var(--md-default-fg-color--light);font-weight:700}.md-post--excerpt{margin-bottom:3.2rem}.md-post--excerpt .md-post__header{align-items:center;display:flex;gap:.6rem;min-height:1.6rem}.md-post--excerpt .md-post__authors{align-items:center;display:inline-flex;flex-direction:row;gap:.2rem;margin:0;min-height:2.4rem}[dir=ltr] .md-post--excerpt .md-post__meta .md-meta__list{margin-right:.4rem}[dir=rtl] .md-post--excerpt .md-post__meta .md-meta__list{margin-left:.4rem}.md-post--excerpt .md-post__content>:first-child{--md-scroll-margin:6rem;margin-top:0}.md-post>.md-nav--secondary{margin:1em 0}.md-pin{background:var(--md-default-fg-color--lightest);border-radius:1rem;margin-top:-.05rem;padding:.2rem}.md-pin:after{background-color:currentcolor;content:"";display:block;height:.6rem;margin:0 auto;-webkit-mask-image:var(--md-post-pin-icon);mask-image:var(--md-post-pin-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.6rem}.md-profile{align-items:center;display:flex;font-size:.7rem;gap:.6rem;line-height:1.4;width:100%}.md-profile__description{flex-grow:1}.md-content--post{display:flex}@media screen and (max-width:76.234375em){.md-content--post{flex-flow:column-reverse}}.md-content--post>.md-content__inner{min-width:0}@media screen and (min-width:76.25em){[dir=ltr] .md-content--post>.md-content__inner{margin-left:1.2rem}[dir=rtl] .md-content--post>.md-content__inner{margin-right:1.2rem}}@media screen and (max-width:76.234375em){.md-sidebar.md-sidebar--post{padding:0;position:static;width:100%}.md-sidebar.md-sidebar--post .md-sidebar__scrollwrap{overflow:visible}.md-sidebar.md-sidebar--post .md-sidebar__inner{padding:0}.md-sidebar.md-sidebar--post .md-post__meta{margin-left:.6rem;margin-right:.6rem}.md-sidebar.md-sidebar--post .md-nav__item{border:none;display:inline}.md-sidebar.md-sidebar--post .md-nav__list{display:inline-flex;flex-wrap:wrap;gap:.6rem;padding-bottom:.6rem;padding-top:.6rem}.md-sidebar.md-sidebar--post .md-nav__link{padding:0}.md-sidebar.md-sidebar--post .md-nav{height:auto;margin-bottom:0;position:static}}:root{--md-progress-value:0;--md-progress-delay:400ms}.md-progress{background:var(--md-primary-bg-color);height:.075rem;opacity:min(clamp(0,var(--md-progress-value),1),clamp(0,100 - var(--md-progress-value),1));position:fixed;top:0;transform:scaleX(calc(var(--md-progress-value)*1%));transform-origin:left;transition:transform .5s cubic-bezier(.19,1,.22,1),opacity .25s var(--md-progress-delay);width:100%;z-index:4}:root{--md-search-result-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h7c-.41-.25-.8-.56-1.14-.9-.33-.33-.61-.7-.86-1.1H6V4h7v5h5v1.18c.71.16 1.39.43 2 .82V8l-6-6m6.31 16.9c1.33-2.11.69-4.9-1.4-6.22-2.11-1.33-4.91-.68-6.22 1.4-1.34 2.11-.69 4.89 1.4 6.22 1.46.93 3.32.93 4.79.02L22 23.39 23.39 22l-3.08-3.1m-3.81.1a2.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.5Z"/></svg>')}.md-search{position:relative}@media screen and (min-width:60em){.md-search{padding:.2rem 0}}.no-js .md-search{display:none}.md-search__overlay{opacity:0;z-index:1}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__overlay{left:-2.2rem}[dir=rtl] .md-search__overlay{right:-2.2rem}.md-search__overlay{background-color:var(--md-default-bg-color);border-radius:1rem;height:2rem;overflow:hidden;pointer-events:none;position:absolute;top:-1rem;transform-origin:center;transition:transform .3s .1s,opacity .2s .2s;width:2rem}[data-md-toggle=search]:checked~.md-header .md-search__overlay{opacity:1;transition:transform .4s,opacity .1s}}@media screen and (min-width:60em){[dir=ltr] .md-search__overlay{left:0}[dir=rtl] .md-search__overlay{right:0}.md-search__overlay{background-color:#0000008a;cursor:pointer;height:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0}[data-md-toggle=search]:checked~.md-header .md-search__overlay{height:200vh;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@media screen and (max-width:29.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(45)}}@media screen and (min-width:30em) and (max-width:44.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(60)}}@media screen and (min-width:45em) and (max-width:59.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(75)}}.md-search__inner{-webkit-backface-visibility:hidden;backface-visibility:hidden}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__inner{left:0}[dir=rtl] .md-search__inner{right:0}.md-search__inner{height:0;opacity:0;overflow:hidden;position:fixed;top:0;transform:translateX(5%);transition:width 0ms .3s,height 0ms .3s,transform .15s cubic-bezier(.4,0,.2,1) .15s,opacity .15s .15s;width:0;z-index:2}[dir=rtl] .md-search__inner{transform:translateX(-5%)}[data-md-toggle=search]:checked~.md-header .md-search__inner{height:100%;opacity:1;transform:translateX(0);transition:width 0ms 0ms,height 0ms 0ms,transform .15s cubic-bezier(.1,.7,.1,1) .15s,opacity .15s .15s;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__inner{float:right}[dir=rtl] .md-search__inner{float:left}.md-search__inner{padding:.1rem 0;position:relative;transition:width .25s cubic-bezier(.1,.7,.1,1);width:11.7rem}}@media screen and (min-width:60em) and (max-width:76.234375em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:23.4rem}}@media screen and (min-width:76.25em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:34.4rem}}.md-search__form{background-color:var(--md-default-bg-color);box-shadow:0 0 .6rem #0000;height:2.4rem;position:relative;transition:color .25s,background-color .25s;z-index:2}@media screen and (min-width:60em){.md-search__form{background-color:#00000042;border-radius:.1rem;height:1.8rem}.md-search__form:hover{background-color:#ffffff1f}}[data-md-toggle=search]:checked~.md-header .md-search__form{background-color:var(--md-default-bg-color);border-radius:.1rem .1rem 0 0;box-shadow:0 0 .6rem #00000012;color:var(--md-default-fg-color)}[dir=ltr] .md-search__input{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__input{padding-left:2.2rem;padding-right:3.6rem}.md-search__input{background:#0000;font-size:.9rem;height:100%;position:relative;text-overflow:ellipsis;width:100%;z-index:2}.md-search__input::placeholder{transition:color .25s}.md-search__input::placeholder,.md-search__input~.md-search__icon{color:var(--md-default-fg-color--light)}.md-search__input::-ms-clear{display:none}@media screen and (max-width:59.984375em){.md-search__input{font-size:.9rem;height:2.4rem;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__input{padding-left:2.2rem}[dir=rtl] .md-search__input{padding-right:2.2rem}.md-search__input{color:inherit;font-size:.8rem}.md-search__input::placeholder{color:var(--md-primary-bg-color--light)}.md-search__input+.md-search__icon{color:var(--md-primary-bg-color)}[data-md-toggle=search]:checked~.md-header .md-search__input{text-overflow:clip}[data-md-toggle=search]:checked~.md-header .md-search__input+.md-search__icon{color:var(--md-default-fg-color--light)}[data-md-toggle=search]:checked~.md-header .md-search__input::placeholder{color:#0000}}.md-search__icon{cursor:pointer;display:inline-block;height:1.2rem;transition:color .25s,opacity .25s;width:1.2rem}.md-search__icon:hover{opacity:.7}[dir=ltr] .md-search__icon[for=__search]{left:.5rem}[dir=rtl] .md-search__icon[for=__search]{right:.5rem}.md-search__icon[for=__search]{position:absolute;top:.3rem;z-index:2}[dir=rtl] .md-search__icon[for=__search] svg{transform:scaleX(-1)}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__icon[for=__search]{left:.8rem}[dir=rtl] .md-search__icon[for=__search]{right:.8rem}.md-search__icon[for=__search]{top:.6rem}.md-search__icon[for=__search] svg:first-child{display:none}}@media screen and (min-width:60em){.md-search__icon[for=__search]{pointer-events:none}.md-search__icon[for=__search] svg:last-child{display:none}}[dir=ltr] .md-search__options{right:.5rem}[dir=rtl] .md-search__options{left:.5rem}.md-search__options{pointer-events:none;position:absolute;top:.3rem;z-index:2}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__options{right:.8rem}[dir=rtl] .md-search__options{left:.8rem}.md-search__options{top:.6rem}}[dir=ltr] .md-search__options>.md-icon{margin-left:.2rem}[dir=rtl] .md-search__options>.md-icon{margin-right:.2rem}.md-search__options>.md-icon{color:var(--md-default-fg-color--light);opacity:0;transform:scale(.75);transition:transform .15s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-search__options>.md-icon:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon{opacity:1;pointer-events:auto;transform:scale(1)}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon:hover{opacity:.7}[dir=ltr] .md-search__suggest{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__suggest{padding-left:2.2rem;padding-right:3.6rem}.md-search__suggest{align-items:center;color:var(--md-default-fg-color--lighter);display:flex;font-size:.9rem;height:100%;opacity:0;position:absolute;top:0;transition:opacity 50ms;white-space:nowrap;width:100%}@media screen and (min-width:60em){[dir=ltr] .md-search__suggest{padding-left:2.2rem}[dir=rtl] .md-search__suggest{padding-right:2.2rem}.md-search__suggest{font-size:.8rem}}[data-md-toggle=search]:checked~.md-header .md-search__suggest{opacity:1;transition:opacity .3s .1s}[dir=ltr] .md-search__output{border-bottom-left-radius:.1rem}[dir=ltr] .md-search__output,[dir=rtl] .md-search__output{border-bottom-right-radius:.1rem}[dir=rtl] .md-search__output{border-bottom-left-radius:.1rem}.md-search__output{overflow:hidden;position:absolute;width:100%;z-index:1}@media screen and (max-width:59.984375em){.md-search__output{bottom:0;top:2.4rem}}@media screen and (min-width:60em){.md-search__output{opacity:0;top:1.9rem;transition:opacity .4s}[data-md-toggle=search]:checked~.md-header .md-search__output{box-shadow:var(--md-shadow-z3);opacity:1}}.md-search__scrollwrap{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);height:100%;overflow-y:auto;touch-action:pan-y}@media (-webkit-max-device-pixel-ratio:1),(max-resolution:1dppx){.md-search__scrollwrap{transform:translateZ(0)}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-search__scrollwrap{width:23.4rem}}@media screen and (min-width:76.25em){.md-search__scrollwrap{width:34.4rem}}@media screen and (min-width:60em){.md-search__scrollwrap{max-height:0;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}[data-md-toggle=search]:checked~.md-header .md-search__scrollwrap{max-height:75vh}.md-search__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-search__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-search__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-search__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}}.md-search-result{color:var(--md-default-fg-color);word-break:break-word}.md-search-result__meta{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.8rem;padding:0 .8rem;scroll-snap-align:start}@media screen and (min-width:60em){[dir=ltr] .md-search-result__meta{padding-left:2.2rem}[dir=rtl] .md-search-result__meta{padding-right:2.2rem}}.md-search-result__list{list-style:none;margin:0;padding:0;-webkit-user-select:none;user-select:none}.md-search-result__item{box-shadow:0 -.05rem var(--md-default-fg-color--lightest)}.md-search-result__item:first-child{box-shadow:none}.md-search-result__link{display:block;outline:none;scroll-snap-align:start;transition:background-color .25s}.md-search-result__link:focus,.md-search-result__link:hover{background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:last-child p:last-child{margin-bottom:.6rem}.md-search-result__more>summary{cursor:pointer;display:block;outline:none;position:sticky;scroll-snap-align:start;top:0;z-index:1}.md-search-result__more>summary::marker{display:none}.md-search-result__more>summary::-webkit-details-marker{display:none}.md-search-result__more>summary>div{color:var(--md-typeset-a-color);font-size:.64rem;padding:.75em .8rem;transition:color .25s,background-color .25s}@media screen and (min-width:60em){[dir=ltr] .md-search-result__more>summary>div{padding-left:2.2rem}[dir=rtl] .md-search-result__more>summary>div{padding-right:2.2rem}}.md-search-result__more>summary:focus>div,.md-search-result__more>summary:hover>div{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more[open]>summary{background-color:var(--md-default-bg-color)}.md-search-result__article{overflow:hidden;padding:0 .8rem;position:relative}@media screen and (min-width:60em){[dir=ltr] .md-search-result__article{padding-left:2.2rem}[dir=rtl] .md-search-result__article{padding-right:2.2rem}}[dir=ltr] .md-search-result__icon{left:0}[dir=rtl] .md-search-result__icon{right:0}.md-search-result__icon{color:var(--md-default-fg-color--light);height:1.2rem;margin:.5rem;position:absolute;width:1.2rem}@media screen and (max-width:59.984375em){.md-search-result__icon{display:none}}.md-search-result__icon:after{background-color:currentcolor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-search-result-icon);mask-image:var(--md-search-result-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-search-result__icon:after{transform:scaleX(-1)}.md-search-result .md-typeset{color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.6}.md-search-result .md-typeset h1{color:var(--md-default-fg-color);font-size:.8rem;font-weight:400;line-height:1.4;margin:.55rem 0}.md-search-result .md-typeset h1 mark{text-decoration:none}.md-search-result .md-typeset h2{color:var(--md-default-fg-color);font-size:.64rem;font-weight:700;line-height:1.6;margin:.5em 0}.md-search-result .md-typeset h2 mark{text-decoration:none}.md-search-result__terms{color:var(--md-default-fg-color);display:block;font-size:.64rem;font-style:italic;margin:.5em 0}.md-search-result mark{background-color:initial;color:var(--md-accent-fg-color);text-decoration:underline}.md-select{position:relative;z-index:1}.md-select__inner{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);left:50%;margin-top:.2rem;max-height:0;opacity:0;position:absolute;top:calc(100% - .2rem);transform:translate3d(-50%,.3rem,0);transition:transform .25s 375ms,opacity .25s .25s,max-height 0ms .5s}.md-select:focus-within .md-select__inner,.md-select:hover .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select__inner:after{border-bottom:.2rem solid #0000;border-bottom-color:var(--md-default-bg-color);border-left:.2rem solid #0000;border-right:.2rem solid #0000;border-top:0;content:"";height:0;left:50%;margin-left:-.2rem;margin-top:-.2rem;position:absolute;top:0;width:0}.md-select__list{border-radius:.1rem;font-size:.8rem;list-style-type:none;margin:0;max-height:inherit;overflow:auto;padding:0}.md-select__item{line-height:1.8rem}[dir=ltr] .md-select__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-select__link{padding-left:1.2rem;padding-right:.6rem}.md-select__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:background-color .25s,color .25s;width:100%}.md-select__link:focus,.md-select__link:hover{color:var(--md-accent-fg-color)}.md-select__link:focus{background-color:var(--md-default-fg-color--lightest)}.md-sidebar{align-self:flex-start;flex-shrink:0;padding:1.2rem 0;position:sticky;top:2.4rem;width:12.1rem}@media print{.md-sidebar{display:none}}@media screen and (max-width:76.234375em){[dir=ltr] .md-sidebar--primary{left:-12.1rem}[dir=rtl] .md-sidebar--primary{right:-12.1rem}.md-sidebar--primary{background-color:var(--md-default-bg-color);display:block;height:100%;position:fixed;top:0;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),box-shadow .25s;width:12.1rem;z-index:5}[data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{box-shadow:var(--md-shadow-z3);transform:translateX(12.1rem)}[dir=rtl] [data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{transform:translateX(-12.1rem)}.md-sidebar--primary .md-sidebar__scrollwrap{bottom:0;left:0;margin:0;overflow:hidden;position:absolute;right:0;scroll-snap-type:none;top:0}}@media screen and (min-width:76.25em){.md-sidebar{height:0}.no-js .md-sidebar{height:auto}.md-header--lifted~.md-container .md-sidebar{top:4.8rem}}.md-sidebar--secondary{display:none;order:2}@media screen and (min-width:60em){.md-sidebar--secondary{height:0}.no-js .md-sidebar--secondary{height:auto}.md-sidebar--secondary:not([hidden]){display:block}.md-sidebar--secondary .md-sidebar__scrollwrap{touch-action:pan-y}}.md-sidebar__scrollwrap{scrollbar-gutter:stable;-webkit-backface-visibility:hidden;backface-visibility:hidden;margin:0 .2rem;overflow-y:auto;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}.md-sidebar__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-sidebar__scrollwrap:focus-within,.md-sidebar__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb:hover,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}@supports selector(::-webkit-scrollbar){.md-sidebar__scrollwrap{scrollbar-gutter:auto}[dir=ltr] .md-sidebar__inner{padding-right:calc(100% - 11.5rem)}[dir=rtl] .md-sidebar__inner{padding-left:calc(100% - 11.5rem)}}@media screen and (max-width:76.234375em){.md-overlay{background-color:#0000008a;height:0;opacity:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0;z-index:5}[data-md-toggle=drawer]:checked~.md-overlay{height:100%;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@keyframes facts{0%{height:0}to{height:.65rem}}@keyframes fact{0%{opacity:0;transform:translateY(100%)}50%{opacity:0}to{opacity:1;transform:translateY(0)}}:root{--md-source-forks-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M5 5.372v.878c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.878a2.25 2.25 0 1 1 1.5 0v.878a2.25 2.25 0 0 1-2.25 2.25h-1.5v2.128a2.251 2.251 0 1 1-1.5 0V8.5h-1.5A2.25 2.25 0 0 1 3.5 6.25v-.878a2.25 2.25 0 1 1 1.5 0ZM5 3.25a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Zm6.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5Zm-3 8.75a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Z"/></svg>');--md-source-repositories-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M2 2.5A2.5 2.5 0 0 1 4.5 0h8.75a.75.75 0 0 1 .75.75v12.5a.75.75 0 0 1-.75.75h-2.5a.75.75 0 0 1 0-1.5h1.75v-2h-8a1 1 0 0 0-.714 1.7.75.75 0 1 1-1.072 1.05A2.495 2.495 0 0 1 2 11.5Zm10.5-1h-8a1 1 0 0 0-1 1v6.708A2.486 2.486 0 0 1 4.5 9h8ZM5 12.25a.25.25 0 0 1 .25-.25h3.5a.25.25 0 0 1 .25.25v3.25a.25.25 0 0 1-.4.2l-1.45-1.087a.249.249 0 0 0-.3 0L5.4 15.7a.25.25 0 0 1-.4-.2Z"/></svg>');--md-source-stars-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M8 .25a.75.75 0 0 1 .673.418l1.882 3.815 4.21.612a.75.75 0 0 1 .416 1.279l-3.046 2.97.719 4.192a.751.751 0 0 1-1.088.791L8 12.347l-3.766 1.98a.75.75 0 0 1-1.088-.79l.72-4.194L.818 6.374a.75.75 0 0 1 .416-1.28l4.21-.611L7.327.668A.75.75 0 0 1 8 .25Zm0 2.445L6.615 5.5a.75.75 0 0 1-.564.41l-3.097.45 2.24 2.184a.75.75 0 0 1 .216.664l-.528 3.084 2.769-1.456a.75.75 0 0 1 .698 0l2.77 1.456-.53-3.084a.75.75 0 0 1 .216-.664l2.24-2.183-3.096-.45a.75.75 0 0 1-.564-.41L8 2.694Z"/></svg>');--md-source-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M1 7.775V2.75C1 1.784 1.784 1 2.75 1h5.025c.464 0 .91.184 1.238.513l6.25 6.25a1.75 1.75 0 0 1 0 2.474l-5.026 5.026a1.75 1.75 0 0 1-2.474 0l-6.25-6.25A1.752 1.752 0 0 1 1 7.775Zm1.5 0c0 .066.026.13.073.177l6.25 6.25a.25.25 0 0 0 .354 0l5.025-5.025a.25.25 0 0 0 0-.354l-6.25-6.25a.25.25 0 0 0-.177-.073H2.75a.25.25 0 0 0-.25.25ZM6 5a1 1 0 1 1 0 2 1 1 0 0 1 0-2Z"/></svg>')}.md-source{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.65rem;line-height:1.2;outline-color:var(--md-accent-fg-color);transition:opacity .25s;white-space:nowrap}.md-source:hover{opacity:.7}.md-source__icon{display:inline-block;height:2.4rem;vertical-align:middle;width:2rem}[dir=ltr] .md-source__icon svg{margin-left:.6rem}[dir=rtl] .md-source__icon svg{margin-right:.6rem}.md-source__icon svg{margin-top:.6rem}[dir=ltr] .md-source__icon+.md-source__repository{padding-left:2rem}[dir=rtl] .md-source__icon+.md-source__repository{padding-right:2rem}[dir=ltr] .md-source__icon+.md-source__repository{margin-left:-2rem}[dir=rtl] .md-source__icon+.md-source__repository{margin-right:-2rem}[dir=ltr] .md-source__repository{margin-left:.6rem}[dir=rtl] .md-source__repository{margin-right:.6rem}.md-source__repository{display:inline-block;max-width:calc(100% - 1.2rem);overflow:hidden;text-overflow:ellipsis;vertical-align:middle}.md-source__facts{display:flex;font-size:.55rem;gap:.4rem;list-style-type:none;margin:.1rem 0 0;opacity:.75;overflow:hidden;padding:0;width:100%}.md-source__repository--active .md-source__facts{animation:facts .25s ease-in}.md-source__fact{overflow:hidden;text-overflow:ellipsis}.md-source__repository--active .md-source__fact{animation:fact .4s ease-out}[dir=ltr] .md-source__fact:before{margin-right:.1rem}[dir=rtl] .md-source__fact:before{margin-left:.1rem}.md-source__fact:before{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-top;width:.6rem}.md-source__fact:nth-child(1n+2){flex-shrink:0}.md-source__fact--version:before{-webkit-mask-image:var(--md-source-version-icon);mask-image:var(--md-source-version-icon)}.md-source__fact--stars:before{-webkit-mask-image:var(--md-source-stars-icon);mask-image:var(--md-source-stars-icon)}.md-source__fact--forks:before{-webkit-mask-image:var(--md-source-forks-icon);mask-image:var(--md-source-forks-icon)}.md-source__fact--repositories:before{-webkit-mask-image:var(--md-source-repositories-icon);mask-image:var(--md-source-repositories-icon)}.md-source-file{margin:1em 0}[dir=ltr] .md-source-file__fact{margin-right:.6rem}[dir=rtl] .md-source-file__fact{margin-left:.6rem}.md-source-file__fact{align-items:center;color:var(--md-default-fg-color--light);display:inline-flex;font-size:.68rem;gap:.3rem}.md-source-file__fact .md-icon{flex-shrink:0;margin-bottom:.05rem}[dir=ltr] .md-source-file__fact .md-author{float:left}[dir=rtl] .md-source-file__fact .md-author{float:right}.md-source-file__fact .md-author{margin-right:.2rem}.md-source-file__fact svg{width:.9rem}:root{--md-status:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 9h2V7h-2m1 13c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8m0-18A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2m-1 15h2v-6h-2v6Z"/></svg>');--md-status--new:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m23 12-2.44-2.78.34-3.68-3.61-.82-1.89-3.18L12 3 8.6 1.54 6.71 4.72l-3.61.81.34 3.68L1 12l2.44 2.78-.34 3.69 3.61.82 1.89 3.18L12 21l3.4 1.46 1.89-3.18 3.61-.82-.34-3.68L23 12m-10 5h-2v-2h2v2m0-4h-2V7h2v6Z"/></svg>');--md-status--deprecated:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9 3v1H4v2h1v13a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V6h1V4h-5V3H9m0 5h2v9H9V8m4 0h2v9h-2V8Z"/></svg>');--md-status--encrypted:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 1 3 5v6c0 5.55 3.84 10.74 9 12 5.16-1.26 9-6.45 9-12V5l-9-4m0 6c1.4 0 2.8 1.1 2.8 2.5V11c.6 0 1.2.6 1.2 1.3v3.5c0 .6-.6 1.2-1.3 1.2H9.2c-.6 0-1.2-.6-1.2-1.3v-3.5c0-.6.6-1.2 1.2-1.2V9.5C9.2 8.1 10.6 7 12 7m0 1.2c-.8 0-1.5.5-1.5 1.3V11h3V9.5c0-.8-.7-1.3-1.5-1.3Z"/></svg>')}.md-status:after{background-color:var(--md-default-fg-color--light);content:"";display:inline-block;height:1.125em;-webkit-mask-image:var(--md-status);mask-image:var(--md-status);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-bottom;width:1.125em}.md-status:hover:after{background-color:currentcolor}.md-status--new:after{-webkit-mask-image:var(--md-status--new);mask-image:var(--md-status--new)}.md-status--deprecated:after{-webkit-mask-image:var(--md-status--deprecated);mask-image:var(--md-status--deprecated)}.md-status--encrypted:after{-webkit-mask-image:var(--md-status--encrypted);mask-image:var(--md-status--encrypted)}.md-tabs{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);display:block;line-height:1.3;overflow:auto;width:100%;z-index:3}@media print{.md-tabs{display:none}}@media screen and (max-width:76.234375em){.md-tabs{display:none}}.md-tabs[hidden]{pointer-events:none}[dir=ltr] .md-tabs__list{margin-left:.2rem}[dir=rtl] .md-tabs__list{margin-right:.2rem}.md-tabs__list{contain:content;display:flex;list-style:none;margin:0;overflow:auto;padding:0;scrollbar-width:none;white-space:nowrap}.md-tabs__list::-webkit-scrollbar{display:none}.md-tabs__item{height:2.4rem;padding-left:.6rem;padding-right:.6rem}.md-tabs__item--active .md-tabs__link{color:inherit;opacity:1}.md-tabs__link{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:flex;font-size:.7rem;margin-top:.8rem;opacity:.7;outline-color:var(--md-accent-fg-color);outline-offset:.2rem;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .25s}.md-tabs__link:focus,.md-tabs__link:hover{color:inherit;opacity:1}[dir=ltr] .md-tabs__link svg{margin-right:.4rem}[dir=rtl] .md-tabs__link svg{margin-left:.4rem}.md-tabs__link svg{fill:currentcolor;height:1.3em}.md-tabs__item:nth-child(2) .md-tabs__link{transition-delay:20ms}.md-tabs__item:nth-child(3) .md-tabs__link{transition-delay:40ms}.md-tabs__item:nth-child(4) .md-tabs__link{transition-delay:60ms}.md-tabs__item:nth-child(5) .md-tabs__link{transition-delay:80ms}.md-tabs__item:nth-child(6) .md-tabs__link{transition-delay:.1s}.md-tabs__item:nth-child(7) .md-tabs__link{transition-delay:.12s}.md-tabs__item:nth-child(8) .md-tabs__link{transition-delay:.14s}.md-tabs__item:nth-child(9) .md-tabs__link{transition-delay:.16s}.md-tabs__item:nth-child(10) .md-tabs__link{transition-delay:.18s}.md-tabs__item:nth-child(11) .md-tabs__link{transition-delay:.2s}.md-tabs__item:nth-child(12) .md-tabs__link{transition-delay:.22s}.md-tabs__item:nth-child(13) .md-tabs__link{transition-delay:.24s}.md-tabs__item:nth-child(14) .md-tabs__link{transition-delay:.26s}.md-tabs__item:nth-child(15) .md-tabs__link{transition-delay:.28s}.md-tabs__item:nth-child(16) .md-tabs__link{transition-delay:.3s}.md-tabs[hidden] .md-tabs__link{opacity:0;transform:translateY(50%);transition:transform 0ms .1s,opacity .1s}:root{--md-tag-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m5.41 21 .71-4h-4l.35-2h4l1.06-6h-4l.35-2h4l.71-4h2l-.71 4h6l.71-4h2l-.71 4h4l-.35 2h-4l-1.06 6h4l-.35 2h-4l-.71 4h-2l.71-4h-6l-.71 4h-2M9.53 9l-1.06 6h6l1.06-6h-6Z"/></svg>')}.md-typeset .md-tags:not([hidden]){display:inline-flex;flex-wrap:wrap;gap:.5em;margin-bottom:.75em;margin-top:-.125em}.md-typeset .md-tag{align-items:center;background:var(--md-default-fg-color--lightest);border-radius:2.4rem;display:inline-flex;font-size:.64rem;font-size:min(.8em,.64rem);font-weight:700;gap:.5em;letter-spacing:normal;line-height:1.6;padding:.3125em .78125em}.md-typeset .md-tag[href]{-webkit-tap-highlight-color:transparent;color:inherit;outline:none;transition:color 125ms,background-color 125ms}.md-typeset .md-tag[href]:focus,.md-typeset .md-tag[href]:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[id]>.md-typeset .md-tag{vertical-align:text-top}.md-typeset .md-tag-shadow{opacity:.5}.md-typeset .md-tag-icon:before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-tag-icon);mask-image:var(--md-tag-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset .md-tag-icon[href]:focus:before,.md-typeset .md-tag-icon[href]:hover:before{background-color:var(--md-accent-bg-color)}@keyframes pulse{0%{transform:scale(.95)}75%{transform:scale(1)}to{transform:scale(.95)}}:root{--md-annotation-bg-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2Z"/></svg>');--md-annotation-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 13h-4v4h-2v-4H7v-2h4V7h2v4h4m-5-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2Z"/></svg>')}.md-tooltip{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);font-family:var(--md-text-font-family);left:clamp(var(--md-tooltip-0,0rem) + .8rem,var(--md-tooltip-x),100vw + var(--md-tooltip-0,0rem) + .8rem - var(--md-tooltip-width) - 2 * .8rem);max-width:calc(100vw - 1.6rem);opacity:0;position:absolute;top:var(--md-tooltip-y);transform:translateY(-.4rem);transition:transform 0ms .25s,opacity .25s,z-index .25s;width:var(--md-tooltip-width);z-index:0}.md-tooltip--active{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip--inline{font-weight:700;-webkit-user-select:none;user-select:none;width:auto}.md-tooltip--inline:not(.md-tooltip--active){transform:translateY(.2rem) scale(.9)}.md-tooltip--inline .md-tooltip__inner{font-size:.5rem;padding:.2rem .4rem}[hidden]+.md-tooltip--inline{display:none}.focus-visible>.md-tooltip,.md-tooltip:target{outline:var(--md-accent-fg-color) auto}.md-tooltip__inner{font-size:.64rem;padding:.8rem}.md-tooltip__inner.md-typeset>:first-child{margin-top:0}.md-tooltip__inner.md-typeset>:last-child{margin-bottom:0}.md-annotation{font-style:normal;font-weight:400;outline:none;text-align:initial;vertical-align:text-bottom;white-space:normal}[dir=rtl] .md-annotation{direction:rtl}code .md-annotation{font-family:var(--md-code-font-family);font-size:inherit}.md-annotation:not([hidden]){display:inline-block;line-height:1.25}.md-annotation__index{border-radius:.01px;cursor:pointer;display:inline-block;margin-left:.4ch;margin-right:.4ch;outline:none;overflow:hidden;position:relative;-webkit-user-select:none;user-select:none;vertical-align:text-top;z-index:0}.md-annotation .md-annotation__index{transition:z-index .25s}@media screen{.md-annotation__index{width:2.2ch}[data-md-visible]>.md-annotation__index{animation:pulse 2s infinite}.md-annotation__index:before{background:var(--md-default-bg-color);-webkit-mask-image:var(--md-annotation-bg-icon);mask-image:var(--md-annotation-bg-icon)}.md-annotation__index:after,.md-annotation__index:before{content:"";height:2.2ch;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:-.1ch;width:2.2ch;z-index:-1}.md-annotation__index:after{background-color:var(--md-default-fg-color--lighter);-webkit-mask-image:var(--md-annotation-icon);mask-image:var(--md-annotation-icon);transform:scale(1.0001);transition:background-color .25s,transform .25s}.md-tooltip--active+.md-annotation__index:after{transform:rotate(45deg)}.md-tooltip--active+.md-annotation__index:after,:hover>.md-annotation__index:after{background-color:var(--md-accent-fg-color)}}.md-tooltip--active+.md-annotation__index{animation-play-state:paused;transition-duration:0ms;z-index:2}.md-annotation__index [data-md-annotation-id]{display:inline-block}@media print{.md-annotation__index [data-md-annotation-id]{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);font-weight:700;padding:0 .6ch;white-space:nowrap}.md-annotation__index [data-md-annotation-id]:after{content:attr(data-md-annotation-id)}}.md-typeset .md-annotation-list{counter-reset:xxx;list-style:none}.md-typeset .md-annotation-list li{position:relative}[dir=ltr] .md-typeset .md-annotation-list li:before{left:-2.125em}[dir=rtl] .md-typeset .md-annotation-list li:before{right:-2.125em}.md-typeset .md-annotation-list li:before{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);content:counter(xxx);counter-increment:xxx;font-size:.8875em;font-weight:700;height:2ch;line-height:1.25;min-width:2ch;padding:0 .6ch;position:absolute;text-align:center;top:.25em}:root{--md-tooltip-width:20rem;--md-tooltip-tail:0.3rem}.md-tooltip2{-webkit-backface-visibility:hidden;backface-visibility:hidden;color:var(--md-default-fg-color);font-family:var(--md-text-font-family);opacity:0;pointer-events:none;position:absolute;top:calc(var(--md-tooltip-host-y) + var(--md-tooltip-y));transform:translateY(-.4rem);transform-origin:calc(var(--md-tooltip-host-x) + var(--md-tooltip-x)) 0;transition:transform 0ms .25s,opacity .25s,z-index .25s;width:100%;z-index:0}.md-tooltip2:before{border-left:var(--md-tooltip-tail) solid #0000;border-right:var(--md-tooltip-tail) solid #0000;content:"";display:block;left:clamp(1.5 * .8rem,var(--md-tooltip-host-x) + var(--md-tooltip-x) - var(--md-tooltip-tail),100vw - 2 * var(--md-tooltip-tail) - 1.5 * .8rem);position:absolute;z-index:1}.md-tooltip2--top:before{border-top:var(--md-tooltip-tail) solid var(--md-default-bg-color);bottom:calc(var(--md-tooltip-tail)*-1 + .025rem);filter:drop-shadow(0 1px 0 hsla(0,0%,0%,.05))}.md-tooltip2--bottom:before{border-bottom:var(--md-tooltip-tail) solid var(--md-default-bg-color);filter:drop-shadow(0 -1px 0 hsla(0,0%,0%,.05));top:calc(var(--md-tooltip-tail)*-1 + .025rem)}.md-tooltip2--active{opacity:1;transform:translateY(0);transition:transform .4s cubic-bezier(0,1,.5,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip2__inner{scrollbar-gutter:stable;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);left:clamp(.8rem,var(--md-tooltip-host-x) - .8rem,100vw - var(--md-tooltip-width) - .8rem);max-height:40vh;max-width:calc(100vw - 1.6rem);position:relative;scrollbar-width:thin}.md-tooltip2__inner::-webkit-scrollbar{height:.2rem;width:.2rem}.md-tooltip2__inner::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-tooltip2__inner::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}[role=dialog]>.md-tooltip2__inner{font-size:.64rem;overflow:auto;padding:0 .8rem;pointer-events:auto;width:var(--md-tooltip-width)}[role=dialog]>.md-tooltip2__inner:after,[role=dialog]>.md-tooltip2__inner:before{content:"";display:block;height:.8rem;position:sticky;width:100%;z-index:10}[role=dialog]>.md-tooltip2__inner:before{background:linear-gradient(var(--md-default-bg-color),#0000 75%);top:0}[role=dialog]>.md-tooltip2__inner:after{background:linear-gradient(#0000,var(--md-default-bg-color) 75%);bottom:0}[role=tooltip]>.md-tooltip2__inner{font-size:.5rem;font-weight:700;left:clamp(.8rem,var(--md-tooltip-host-x) + var(--md-tooltip-x) - var(--md-tooltip-width)/2,100vw - var(--md-tooltip-width) - .8rem);max-width:min(100vw - 2 * .8rem,400px);padding:.2rem .4rem;-webkit-user-select:none;user-select:none;width:-moz-fit-content;width:fit-content}.md-tooltip2__inner.md-typeset>:first-child{margin-top:0}.md-tooltip2__inner.md-typeset>:last-child{margin-bottom:0}[dir=ltr] .md-top{margin-left:50%}[dir=rtl] .md-top{margin-right:50%}.md-top{background-color:var(--md-default-bg-color);border-radius:1.6rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color--light);cursor:pointer;display:block;font-size:.7rem;outline:none;padding:.4rem .8rem;position:fixed;top:3.2rem;transform:translate(-50%);transition:color 125ms,background-color 125ms,transform 125ms cubic-bezier(.4,0,.2,1),opacity 125ms;z-index:2}@media print{.md-top{display:none}}[dir=rtl] .md-top{transform:translate(50%)}.md-top[hidden]{opacity:0;pointer-events:none;transform:translate(-50%,.2rem);transition-duration:0ms}[dir=rtl] .md-top[hidden]{transform:translate(50%,.2rem)}.md-top:focus,.md-top:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top svg{display:inline-block;vertical-align:-.5em}@keyframes hoverfix{0%{pointer-events:none}}:root{--md-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.6.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 2024 Fonticons, Inc.--><path d="M137.4 374.6c12.5 12.5 32.8 12.5 45.3 0l128-128c9.2-9.2 11.9-22.9 6.9-34.9S301 191.9 288 191.9L32 192c-12.9 0-24.6 7.8-29.6 19.8s-2.2 25.7 6.9 34.9l128 128z"/></svg>')}.md-version{flex-shrink:0;font-size:.8rem;height:2.4rem}[dir=ltr] .md-version__current{margin-left:1.4rem;margin-right:.4rem}[dir=rtl] .md-version__current{margin-left:.4rem;margin-right:1.4rem}.md-version__current{color:inherit;cursor:pointer;outline:none;position:relative;top:.05rem}[dir=ltr] .md-version__current:after{margin-left:.4rem}[dir=rtl] .md-version__current:after{margin-right:.4rem}.md-version__current:after{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-image:var(--md-version-icon);mask-image:var(--md-version-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.4rem}.md-version__alias{margin-left:.3rem;opacity:.7}.md-version__list{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);list-style-type:none;margin:.2rem .8rem;max-height:0;opacity:0;overflow:auto;padding:0;position:absolute;scroll-snap-type:y mandatory;top:.15rem;transition:max-height 0ms .5s,opacity .25s .25s;z-index:3}.md-version:focus-within .md-version__list,.md-version:hover .md-version__list{max-height:10rem;opacity:1;transition:max-height 0ms,opacity .25s}@media (hover:none),(pointer:coarse){.md-version:hover .md-version__list{animation:hoverfix .25s forwards}.md-version:focus-within .md-version__list{animation:none}}.md-version__item{line-height:1.8rem}[dir=ltr] .md-version__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-version__link{padding-left:1.2rem;padding-right:.6rem}.md-version__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:color .25s,background-color .25s;white-space:nowrap;width:100%}.md-version__link:focus,.md-version__link:hover{color:var(--md-accent-fg-color)}.md-version__link:focus{background-color:var(--md-default-fg-color--lightest)}:root{--md-admonition-icon--note:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2C6.47 2 2 6.47 2 12s4.47 10 10 10 10-4.47 10-10S17.53 2 12 2m3.1 5.07c.14 0 .28.05.4.16l1.27 1.27c.23.22.23.57 0 .78l-1 1-2.05-2.05 1-1c.1-.11.24-.16.38-.16m-1.97 1.74 2.06 2.06-6.06 6.06H7.07v-2.06l6.06-6.06Z"/></svg>');--md-admonition-icon--abstract:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 9H7V7h10m0 6H7v-2h10m-3 6H7v-2h7M12 3a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1m7 0h-4.18C14.4 1.84 13.3 1 12 1c-1.3 0-2.4.84-2.82 2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V5a2 2 0 0 0-2-2Z"/></svg>');--md-admonition-icon--info:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 9h-2V7h2m0 10h-2v-6h2m-1-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2Z"/></svg>');--md-admonition-icon--tip:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17.66 11.2c-.23-.3-.51-.56-.77-.82-.67-.6-1.43-1.03-2.07-1.66C13.33 7.26 13 4.85 13.95 3c-.95.23-1.78.75-2.49 1.32-2.59 2.08-3.61 5.75-2.39 8.9.04.1.08.2.08.33 0 .22-.15.42-.35.5-.23.1-.47.04-.66-.12a.58.58 0 0 1-.14-.17c-1.13-1.43-1.31-3.48-.55-5.12C5.78 10 4.87 12.3 5 14.47c.06.5.12 1 .29 1.5.14.6.41 1.2.71 1.73 1.08 1.73 2.95 2.97 4.96 3.22 2.14.27 4.43-.12 6.07-1.6 1.83-1.66 2.47-4.32 1.53-6.6l-.13-.26c-.21-.46-.77-1.26-.77-1.26m-3.16 6.3c-.28.24-.74.5-1.1.6-1.12.4-2.24-.16-2.9-.82 1.19-.28 1.9-1.16 2.11-2.05.17-.8-.15-1.46-.28-2.23-.12-.74-.1-1.37.17-2.06.19.38.39.76.63 1.06.77 1 1.98 1.44 2.24 2.8.04.14.06.28.06.43.03.82-.33 1.72-.93 2.27Z"/></svg>');--md-admonition-icon--success:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 7 9 19l-5.5-5.5 1.41-1.41L9 16.17 19.59 5.59 21 7Z"/></svg>');--md-admonition-icon--question:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m15.07 11.25-.9.92C13.45 12.89 13 13.5 13 15h-2v-.5c0-1.11.45-2.11 1.17-2.83l1.24-1.26c.37-.36.59-.86.59-1.41a2 2 0 0 0-2-2 2 2 0 0 0-2 2H8a4 4 0 0 1 4-4 4 4 0 0 1 4 4 3.2 3.2 0 0 1-.93 2.25M13 19h-2v-2h2M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10c0-5.53-4.5-10-10-10Z"/></svg>');--md-admonition-icon--warning:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 14h-2V9h2m0 9h-2v-2h2M1 21h22L12 2 1 21Z"/></svg>');--md-admonition-icon--failure:url('data:image/svg+xml;charset=utf-8,<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>');--md-admonition-icon--danger:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m11.5 20 4.86-9.73H13V4l-5 9.73h3.5V20M12 2c2.75 0 5.1 1 7.05 2.95C21 6.9 22 9.25 22 12s-1 5.1-2.95 7.05C17.1 21 14.75 22 12 22s-5.1-1-7.05-2.95C3 17.1 2 14.75 2 12s1-5.1 2.95-7.05C6.9 3 9.25 2 12 2Z"/></svg>');--md-admonition-icon--bug:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 13h2v1h-2v-1m10-8v6c0 5.5-3.8 10.7-9 12-5.2-1.3-9-6.5-9-12V5l9-4 9 4m-4 5h-2.2c-.2-.6-.6-1.1-1.1-1.5l1.2-1.2-.7-.7L12.8 8H12c-.2 0-.5 0-.7.1L9.9 6.6l-.8.8 1.2 1.2c-.5.3-.9.8-1.1 1.4H7v1h2v1H7v1h2v1H7v1h2.2c.4 1.2 1.5 2 2.8 2s2.4-.8 2.8-2H17v-1h-2v-1h2v-1h-2v-1h2v-1m-6 2h2v-1h-2v1Z"/></svg>');--md-admonition-icon--example:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M7 2v2h1v14a4 4 0 0 0 4 4 4 4 0 0 0 4-4V4h1V2H7m4 14c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m2-4c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m1-5h-4V4h4v3Z"/></svg>');--md-admonition-icon--quote:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 17h3l2-4V7h-6v6h3M6 17h3l2-4V7H5v6h3l-2 4Z"/></svg>')}.md-typeset .admonition,.md-typeset details{background-color:var(--md-admonition-bg-color);border:.075rem solid #448aff;border-radius:.2rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid;transition:box-shadow 125ms}@media print{.md-typeset .admonition,.md-typeset details{box-shadow:none}}.md-typeset .admonition:focus-within,.md-typeset details:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .admonition>*,.md-typeset details>*{box-sizing:border-box}.md-typeset .admonition .admonition,.md-typeset .admonition details,.md-typeset details .admonition,.md-typeset details details{margin-bottom:1em;margin-top:1em}.md-typeset .admonition .md-typeset__scrollwrap,.md-typeset details .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset .admonition .md-typeset__table,.md-typeset details .md-typeset__table{padding:0 .6rem}.md-typeset .admonition>.tabbed-set:only-child,.md-typeset details>.tabbed-set:only-child{margin-top:0}html .md-typeset .admonition>:last-child,html .md-typeset details>:last-child{margin-bottom:.6rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{padding-left:2rem;padding-right:.6rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{padding-left:.6rem;padding-right:2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-left-width:.2rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-right-width:.2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset .admonition-title,.md-typeset summary{background-color:#448aff1a;border:none;font-weight:700;margin:0 -.6rem;padding-bottom:.4rem;padding-top:.4rem;position:relative}html .md-typeset .admonition-title:last-child,html .md-typeset summary:last-child{margin-bottom:0}[dir=ltr] .md-typeset .admonition-title:before,[dir=ltr] .md-typeset summary:before{left:.6rem}[dir=rtl] .md-typeset .admonition-title:before,[dir=rtl] .md-typeset summary:before{right:.6rem}.md-typeset .admonition-title:before,.md-typeset summary:before{background-color:#448aff;content:"";height:1rem;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;width:1rem}.md-typeset .admonition-title code,.md-typeset summary code{box-shadow:0 0 0 .05rem var(--md-default-fg-color--lightest)}.md-typeset .admonition.note,.md-typeset details.note{border-color:#448aff}.md-typeset .admonition.note:focus-within,.md-typeset details.note:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .note>.admonition-title,.md-typeset .note>summary{background-color:#448aff1a}.md-typeset .note>.admonition-title:before,.md-typeset .note>summary:before{background-color:#448aff;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note)}.md-typeset .note>.admonition-title:after,.md-typeset .note>summary:after{color:#448aff}.md-typeset .admonition.abstract,.md-typeset details.abstract{border-color:#00b0ff}.md-typeset .admonition.abstract:focus-within,.md-typeset details.abstract:focus-within{box-shadow:0 0 0 .2rem #00b0ff1a}.md-typeset .abstract>.admonition-title,.md-typeset .abstract>summary{background-color:#00b0ff1a}.md-typeset .abstract>.admonition-title:before,.md-typeset .abstract>summary:before{background-color:#00b0ff;-webkit-mask-image:var(--md-admonition-icon--abstract);mask-image:var(--md-admonition-icon--abstract)}.md-typeset .abstract>.admonition-title:after,.md-typeset .abstract>summary:after{color:#00b0ff}.md-typeset .admonition.info,.md-typeset details.info{border-color:#00b8d4}.md-typeset .admonition.info:focus-within,.md-typeset details.info:focus-within{box-shadow:0 0 0 .2rem #00b8d41a}.md-typeset .info>.admonition-title,.md-typeset .info>summary{background-color:#00b8d41a}.md-typeset .info>.admonition-title:before,.md-typeset .info>summary:before{background-color:#00b8d4;-webkit-mask-image:var(--md-admonition-icon--info);mask-image:var(--md-admonition-icon--info)}.md-typeset .info>.admonition-title:after,.md-typeset .info>summary:after{color:#00b8d4}.md-typeset .admonition.tip,.md-typeset details.tip{border-color:#00bfa5}.md-typeset .admonition.tip:focus-within,.md-typeset details.tip:focus-within{box-shadow:0 0 0 .2rem #00bfa51a}.md-typeset .tip>.admonition-title,.md-typeset .tip>summary{background-color:#00bfa51a}.md-typeset .tip>.admonition-title:before,.md-typeset .tip>summary:before{background-color:#00bfa5;-webkit-mask-image:var(--md-admonition-icon--tip);mask-image:var(--md-admonition-icon--tip)}.md-typeset .tip>.admonition-title:after,.md-typeset .tip>summary:after{color:#00bfa5}.md-typeset .admonition.success,.md-typeset details.success{border-color:#00c853}.md-typeset .admonition.success:focus-within,.md-typeset details.success:focus-within{box-shadow:0 0 0 .2rem #00c8531a}.md-typeset .success>.admonition-title,.md-typeset .success>summary{background-color:#00c8531a}.md-typeset .success>.admonition-title:before,.md-typeset .success>summary:before{background-color:#00c853;-webkit-mask-image:var(--md-admonition-icon--success);mask-image:var(--md-admonition-icon--success)}.md-typeset .success>.admonition-title:after,.md-typeset .success>summary:after{color:#00c853}.md-typeset .admonition.question,.md-typeset details.question{border-color:#64dd17}.md-typeset .admonition.question:focus-within,.md-typeset details.question:focus-within{box-shadow:0 0 0 .2rem #64dd171a}.md-typeset .question>.admonition-title,.md-typeset .question>summary{background-color:#64dd171a}.md-typeset .question>.admonition-title:before,.md-typeset .question>summary:before{background-color:#64dd17;-webkit-mask-image:var(--md-admonition-icon--question);mask-image:var(--md-admonition-icon--question)}.md-typeset .question>.admonition-title:after,.md-typeset .question>summary:after{color:#64dd17}.md-typeset .admonition.warning,.md-typeset details.warning{border-color:#ff9100}.md-typeset .admonition.warning:focus-within,.md-typeset details.warning:focus-within{box-shadow:0 0 0 .2rem #ff91001a}.md-typeset .warning>.admonition-title,.md-typeset .warning>summary{background-color:#ff91001a}.md-typeset .warning>.admonition-title:before,.md-typeset .warning>summary:before{background-color:#ff9100;-webkit-mask-image:var(--md-admonition-icon--warning);mask-image:var(--md-admonition-icon--warning)}.md-typeset .warning>.admonition-title:after,.md-typeset .warning>summary:after{color:#ff9100}.md-typeset .admonition.failure,.md-typeset details.failure{border-color:#ff5252}.md-typeset .admonition.failure:focus-within,.md-typeset details.failure:focus-within{box-shadow:0 0 0 .2rem #ff52521a}.md-typeset .failure>.admonition-title,.md-typeset .failure>summary{background-color:#ff52521a}.md-typeset .failure>.admonition-title:before,.md-typeset .failure>summary:before{background-color:#ff5252;-webkit-mask-image:var(--md-admonition-icon--failure);mask-image:var(--md-admonition-icon--failure)}.md-typeset .failure>.admonition-title:after,.md-typeset .failure>summary:after{color:#ff5252}.md-typeset .admonition.danger,.md-typeset details.danger{border-color:#ff1744}.md-typeset .admonition.danger:focus-within,.md-typeset details.danger:focus-within{box-shadow:0 0 0 .2rem #ff17441a}.md-typeset .danger>.admonition-title,.md-typeset .danger>summary{background-color:#ff17441a}.md-typeset .danger>.admonition-title:before,.md-typeset .danger>summary:before{background-color:#ff1744;-webkit-mask-image:var(--md-admonition-icon--danger);mask-image:var(--md-admonition-icon--danger)}.md-typeset .danger>.admonition-title:after,.md-typeset .danger>summary:after{color:#ff1744}.md-typeset .admonition.bug,.md-typeset details.bug{border-color:#f50057}.md-typeset .admonition.bug:focus-within,.md-typeset details.bug:focus-within{box-shadow:0 0 0 .2rem #f500571a}.md-typeset .bug>.admonition-title,.md-typeset .bug>summary{background-color:#f500571a}.md-typeset .bug>.admonition-title:before,.md-typeset .bug>summary:before{background-color:#f50057;-webkit-mask-image:var(--md-admonition-icon--bug);mask-image:var(--md-admonition-icon--bug)}.md-typeset .bug>.admonition-title:after,.md-typeset .bug>summary:after{color:#f50057}.md-typeset .admonition.example,.md-typeset details.example{border-color:#7c4dff}.md-typeset .admonition.example:focus-within,.md-typeset details.example:focus-within{box-shadow:0 0 0 .2rem #7c4dff1a}.md-typeset .example>.admonition-title,.md-typeset .example>summary{background-color:#7c4dff1a}.md-typeset .example>.admonition-title:before,.md-typeset .example>summary:before{background-color:#7c4dff;-webkit-mask-image:var(--md-admonition-icon--example);mask-image:var(--md-admonition-icon--example)}.md-typeset .example>.admonition-title:after,.md-typeset .example>summary:after{color:#7c4dff}.md-typeset .admonition.quote,.md-typeset details.quote{border-color:#9e9e9e}.md-typeset .admonition.quote:focus-within,.md-typeset details.quote:focus-within{box-shadow:0 0 0 .2rem #9e9e9e1a}.md-typeset .quote>.admonition-title,.md-typeset .quote>summary{background-color:#9e9e9e1a}.md-typeset .quote>.admonition-title:before,.md-typeset .quote>summary:before{background-color:#9e9e9e;-webkit-mask-image:var(--md-admonition-icon--quote);mask-image:var(--md-admonition-icon--quote)}.md-typeset .quote>.admonition-title:after,.md-typeset .quote>summary:after{color:#9e9e9e}:root{--md-footnotes-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7v4H5.83l3.58-3.59L8 6l-6 6 6 6 1.41-1.42L5.83 13H21V7h-2Z"/></svg>')}.md-typeset .footnote{color:var(--md-default-fg-color--light);font-size:.64rem}[dir=ltr] .md-typeset .footnote>ol{margin-left:0}[dir=rtl] .md-typeset .footnote>ol{margin-right:0}.md-typeset .footnote>ol>li{transition:color 125ms}.md-typeset .footnote>ol>li:target{color:var(--md-default-fg-color)}.md-typeset .footnote>ol>li:focus-within .footnote-backref{opacity:1;transform:translateX(0);transition:none}.md-typeset .footnote>ol>li:hover .footnote-backref,.md-typeset .footnote>ol>li:target .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li>:first-child{margin-top:0}.md-typeset .footnote-ref{font-size:.75em;font-weight:700}html .md-typeset .footnote-ref{outline-offset:.1rem}.md-typeset [id^="fnref:"]:target>.footnote-ref{outline:auto}.md-typeset .footnote-backref{color:var(--md-typeset-a-color);display:inline-block;font-size:0;opacity:0;transform:translateX(.25rem);transition:color .25s,transform .25s .25s,opacity 125ms .25s;vertical-align:text-bottom}@media print{.md-typeset .footnote-backref{color:var(--md-typeset-a-color);opacity:1;transform:translateX(0)}}[dir=rtl] .md-typeset .footnote-backref{transform:translateX(-.25rem)}.md-typeset .footnote-backref:hover{color:var(--md-accent-fg-color)}.md-typeset .footnote-backref:before{background-color:currentcolor;content:"";display:inline-block;height:.8rem;-webkit-mask-image:var(--md-footnotes-icon);mask-image:var(--md-footnotes-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.8rem}[dir=rtl] .md-typeset .footnote-backref:before svg{transform:scaleX(-1)}[dir=ltr] .md-typeset .headerlink{margin-left:.5rem}[dir=rtl] .md-typeset .headerlink{margin-right:.5rem}.md-typeset .headerlink{color:var(--md-default-fg-color--lighter);display:inline-block;opacity:0;transition:color .25s,opacity 125ms}@media print{.md-typeset .headerlink{display:none}}.md-typeset .headerlink:focus,.md-typeset :hover>.headerlink,.md-typeset :target>.headerlink{opacity:1;transition:color .25s,opacity 125ms}.md-typeset .headerlink:focus,.md-typeset .headerlink:hover,.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset :target{--md-scroll-margin:3.6rem;--md-scroll-offset:0rem;scroll-margin-top:calc(var(--md-scroll-margin) - var(--md-scroll-offset))}@media screen and (min-width:76.25em){.md-header--lifted~.md-container .md-typeset :target{--md-scroll-margin:6rem}}.md-typeset h1:target,.md-typeset h2:target,.md-typeset h3:target{--md-scroll-offset:0.2rem}.md-typeset h4:target{--md-scroll-offset:0.15rem}.md-typeset div.arithmatex{overflow:auto}@media screen and (max-width:44.984375em){.md-typeset div.arithmatex{margin:0 -.8rem}.md-typeset div.arithmatex>*{width:min-content}}.md-typeset div.arithmatex>*{margin-left:auto!important;margin-right:auto!important;padding:0 .8rem;touch-action:auto}.md-typeset div.arithmatex>* mjx-container{margin:0!important}.md-typeset div.arithmatex mjx-assistive-mml{height:0}.md-typeset del.critic{background-color:var(--md-typeset-del-color)}.md-typeset del.critic,.md-typeset ins.critic{-webkit-box-decoration-break:clone;box-decoration-break:clone}.md-typeset ins.critic{background-color:var(--md-typeset-ins-color)}.md-typeset .critic.comment{-webkit-box-decoration-break:clone;box-decoration-break:clone;color:var(--md-code-hl-comment-color)}.md-typeset .critic.comment:before{content:"/* "}.md-typeset .critic.comment:after{content:" */"}.md-typeset .critic.block{box-shadow:none;display:block;margin:1em 0;overflow:auto;padding-left:.8rem;padding-right:.8rem}.md-typeset .critic.block>:first-child{margin-top:.5em}.md-typeset .critic.block>:last-child{margin-bottom:.5em}:root{--md-details-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>')}.md-typeset details{display:flow-root;overflow:visible;padding-top:0}.md-typeset details[open]>summary:after{transform:rotate(90deg)}.md-typeset details:not([open]){box-shadow:none;padding-bottom:0}.md-typeset details:not([open])>summary{border-radius:.1rem}[dir=ltr] .md-typeset summary{padding-right:1.8rem}[dir=rtl] .md-typeset summary{padding-left:1.8rem}[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset summary{cursor:pointer;display:block;min-height:1rem;overflow:hidden}.md-typeset summary.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset summary:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[dir=ltr] .md-typeset summary:after{right:.4rem}[dir=rtl] .md-typeset summary:after{left:.4rem}.md-typeset summary:after{background-color:currentcolor;content:"";height:1rem;-webkit-mask-image:var(--md-details-icon);mask-image:var(--md-details-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;transform:rotate(0deg);transition:transform .25s;width:1rem}[dir=rtl] .md-typeset summary:after{transform:rotate(180deg)}.md-typeset summary::marker{display:none}.md-typeset summary::-webkit-details-marker{display:none}.md-typeset .emojione,.md-typeset .gemoji,.md-typeset .twemoji{--md-icon-size:1.125em;display:inline-flex;height:var(--md-icon-size);vertical-align:text-top}.md-typeset .emojione svg,.md-typeset .gemoji svg,.md-typeset .twemoji svg{fill:currentcolor;max-height:100%;width:var(--md-icon-size)}.md-typeset .lg,.md-typeset .xl,.md-typeset .xxl,.md-typeset .xxxl{vertical-align:text-bottom}.md-typeset .middle{vertical-align:middle}.md-typeset .lg{--md-icon-size:1.5em}.md-typeset .xl{--md-icon-size:2.25em}.md-typeset .xxl{--md-icon-size:3em}.md-typeset .xxxl{--md-icon-size:4em}.highlight .o,.highlight .ow{color:var(--md-code-hl-operator-color)}.highlight .p{color:var(--md-code-hl-punctuation-color)}.highlight .cpf,.highlight .l,.highlight .s,.highlight .s1,.highlight .s2,.highlight .sb,.highlight .sc,.highlight .si,.highlight .ss{color:var(--md-code-hl-string-color)}.highlight .cp,.highlight .se,.highlight .sh,.highlight .sr,.highlight .sx{color:var(--md-code-hl-special-color)}.highlight .il,.highlight .m,.highlight .mb,.highlight .mf,.highlight .mh,.highlight .mi,.highlight .mo{color:var(--md-code-hl-number-color)}.highlight .k,.highlight .kd,.highlight .kn,.highlight .kp,.highlight .kr,.highlight .kt{color:var(--md-code-hl-keyword-color)}.highlight .kc,.highlight .n{color:var(--md-code-hl-name-color)}.highlight .bp,.highlight .nb,.highlight .no{color:var(--md-code-hl-constant-color)}.highlight .nc,.highlight .ne,.highlight .nf,.highlight .nn{color:var(--md-code-hl-function-color)}.highlight .nd,.highlight .ni,.highlight .nl,.highlight .nt{color:var(--md-code-hl-keyword-color)}.highlight .c,.highlight .c1,.highlight .ch,.highlight .cm,.highlight .cs,.highlight .sd{color:var(--md-code-hl-comment-color)}.highlight .na,.highlight .nv,.highlight .vc,.highlight .vg,.highlight .vi{color:var(--md-code-hl-variable-color)}.highlight .ge,.highlight .gh,.highlight .go,.highlight .gp,.highlight .gr,.highlight .gs,.highlight .gt,.highlight .gu{color:var(--md-code-hl-generic-color)}.highlight .gd,.highlight .gi{border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight .gd{background-color:var(--md-typeset-del-color)}.highlight .gi{background-color:var(--md-typeset-ins-color)}.highlight .hll{background-color:var(--md-code-hl-color--light);box-shadow:2px 0 0 0 var(--md-code-hl-color) inset;display:block;margin:0 -1.1764705882em;padding:0 1.1764705882em}.highlight span.filename{background-color:var(--md-code-bg-color);border-bottom:.05rem solid var(--md-default-fg-color--lightest);border-top-left-radius:.1rem;border-top-right-radius:.1rem;display:flow-root;font-size:.85em;font-weight:700;margin-top:1em;padding:.6617647059em 1.1764705882em;position:relative}.highlight span.filename+pre{margin-top:0}.highlight span.filename+pre>code{border-top-left-radius:0;border-top-right-radius:0}.highlight [data-linenos]:before{background-color:var(--md-code-bg-color);box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;color:var(--md-default-fg-color--light);content:attr(data-linenos);float:left;left:-1.1764705882em;margin-left:-1.1764705882em;margin-right:1.1764705882em;padding-left:1.1764705882em;position:sticky;-webkit-user-select:none;user-select:none;z-index:3}.highlight code a[id]{position:absolute;visibility:hidden}.highlight code[data-md-copying]{display:initial}.highlight code[data-md-copying] .hll{display:contents}.highlight code[data-md-copying] .md-annotation{display:none}.highlighttable{display:flow-root}.highlighttable tbody,.highlighttable td{display:block;padding:0}.highlighttable tr{display:flex}.highlighttable pre{margin:0}.highlighttable th.filename{flex-grow:1;padding:0;text-align:left}.highlighttable th.filename span.filename{margin-top:0}.highlighttable .linenos{background-color:var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-top-left-radius:.1rem;font-size:.85em;padding:.7720588235em 0 .7720588235em 1.1764705882em;-webkit-user-select:none;user-select:none}.highlighttable .linenodiv{box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset}.highlighttable .linenodiv pre{color:var(--md-default-fg-color--light);text-align:right}.highlighttable .linenodiv span[class]{padding-right:.5882352941em}.highlighttable .code{flex:1;min-width:0}.linenodiv a{color:inherit}.md-typeset .highlighttable{direction:ltr;margin:1em 0}.md-typeset .highlighttable>tbody>tr>.code>div>pre>code{border-bottom-left-radius:0;border-top-left-radius:0}.md-typeset .highlight+.result{border:.05rem solid var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-bottom-right-radius:.1rem;border-top-width:.1rem;margin-top:-1.125em;overflow:visible;padding:0 1em}.md-typeset .highlight+.result:after{clear:both;content:"";display:block}@media screen and (max-width:44.984375em){.md-content__inner>.highlight{margin:1em -.8rem}.md-content__inner>.highlight>.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.code>div>pre>code,.md-content__inner>.highlight>.highlighttable>tbody>tr>.filename span.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.linenos,.md-content__inner>.highlight>pre>code{border-radius:0}.md-content__inner>.highlight+.result{border-left-width:0;border-radius:0;border-right-width:0;margin-left:-.8rem;margin-right:-.8rem}}.md-typeset .keys kbd:after,.md-typeset .keys kbd:before{-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys span{color:var(--md-default-fg-color--light);padding:0 .2em}.md-typeset .keys .key-alt:before,.md-typeset .keys .key-left-alt:before,.md-typeset .keys .key-right-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-command:before,.md-typeset .keys .key-left-command:before,.md-typeset .keys .key-right-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-control:before,.md-typeset .keys .key-left-control:before,.md-typeset .keys .key-right-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-left-meta:before,.md-typeset .keys .key-meta:before,.md-typeset .keys .key-right-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-left-option:before,.md-typeset .keys .key-option:before,.md-typeset .keys .key-right-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-left-shift:before,.md-typeset .keys .key-right-shift:before,.md-typeset .keys .key-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-left-super:before,.md-typeset .keys .key-right-super:before,.md-typeset .keys .key-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-left-windows:before,.md-typeset .keys .key-right-windows:before,.md-typeset .keys .key-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-arrow-down:before{content:"↓";padding-right:.4em}.md-typeset .keys .key-arrow-left:before{content:"←";padding-right:.4em}.md-typeset .keys .key-arrow-right:before{content:"→";padding-right:.4em}.md-typeset .keys .key-arrow-up:before{content:"↑";padding-right:.4em}.md-typeset .keys .key-backspace:before{content:"⌫";padding-right:.4em}.md-typeset .keys .key-backtab:before{content:"⇤";padding-right:.4em}.md-typeset .keys .key-caps-lock:before{content:"⇪";padding-right:.4em}.md-typeset .keys .key-clear:before{content:"⌧";padding-right:.4em}.md-typeset .keys .key-context-menu:before{content:"☰";padding-right:.4em}.md-typeset .keys .key-delete:before{content:"⌦";padding-right:.4em}.md-typeset .keys .key-eject:before{content:"⏏";padding-right:.4em}.md-typeset .keys .key-end:before{content:"⤓";padding-right:.4em}.md-typeset .keys .key-escape:before{content:"⎋";padding-right:.4em}.md-typeset .keys .key-home:before{content:"⤒";padding-right:.4em}.md-typeset .keys .key-insert:before{content:"⎀";padding-right:.4em}.md-typeset .keys .key-page-down:before{content:"⇟";padding-right:.4em}.md-typeset .keys .key-page-up:before{content:"⇞";padding-right:.4em}.md-typeset .keys .key-print-screen:before{content:"⎙";padding-right:.4em}.md-typeset .keys .key-tab:after{content:"⇥";padding-left:.4em}.md-typeset .keys .key-num-enter:after{content:"⌤";padding-left:.4em}.md-typeset .keys .key-enter:after{content:"⏎";padding-left:.4em}:root{--md-tabbed-icon--prev:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M15.41 16.58 10.83 12l4.58-4.59L14 6l-6 6 6 6 1.41-1.42Z"/></svg>');--md-tabbed-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>')}.md-typeset .tabbed-set{border-radius:.1rem;display:flex;flex-flow:column wrap;margin:1em 0;position:relative}.md-typeset .tabbed-set>input{height:0;opacity:0;position:absolute;width:0}.md-typeset .tabbed-set>input:target{--md-scroll-offset:0.625em}.md-typeset .tabbed-set>input.focus-visible~.tabbed-labels:before{background-color:var(--md-accent-fg-color)}.md-typeset .tabbed-labels{-ms-overflow-style:none;box-shadow:0 -.05rem var(--md-default-fg-color--lightest) inset;display:flex;max-width:100%;overflow:auto;scrollbar-width:none}@media print{.md-typeset .tabbed-labels{display:contents}}@media screen{.js .md-typeset .tabbed-labels{position:relative}.js .md-typeset .tabbed-labels:before{background:var(--md-default-fg-color);bottom:0;content:"";display:block;height:2px;left:0;position:absolute;transform:translateX(var(--md-indicator-x));transition:width 225ms,background-color .25s,transform .25s;transition-timing-function:cubic-bezier(.4,0,.2,1);width:var(--md-indicator-width)}}.md-typeset .tabbed-labels::-webkit-scrollbar{display:none}.md-typeset .tabbed-labels>label{border-bottom:.1rem solid #0000;border-radius:.1rem .1rem 0 0;color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;font-size:.64rem;font-weight:700;padding:.78125em 1.25em .625em;scroll-margin-inline-start:1rem;transition:background-color .25s,color .25s;white-space:nowrap;width:auto}@media print{.md-typeset .tabbed-labels>label:first-child{order:1}.md-typeset .tabbed-labels>label:nth-child(2){order:2}.md-typeset .tabbed-labels>label:nth-child(3){order:3}.md-typeset .tabbed-labels>label:nth-child(4){order:4}.md-typeset .tabbed-labels>label:nth-child(5){order:5}.md-typeset .tabbed-labels>label:nth-child(6){order:6}.md-typeset .tabbed-labels>label:nth-child(7){order:7}.md-typeset .tabbed-labels>label:nth-child(8){order:8}.md-typeset .tabbed-labels>label:nth-child(9){order:9}.md-typeset .tabbed-labels>label:nth-child(10){order:10}.md-typeset .tabbed-labels>label:nth-child(11){order:11}.md-typeset .tabbed-labels>label:nth-child(12){order:12}.md-typeset .tabbed-labels>label:nth-child(13){order:13}.md-typeset .tabbed-labels>label:nth-child(14){order:14}.md-typeset .tabbed-labels>label:nth-child(15){order:15}.md-typeset .tabbed-labels>label:nth-child(16){order:16}.md-typeset .tabbed-labels>label:nth-child(17){order:17}.md-typeset .tabbed-labels>label:nth-child(18){order:18}.md-typeset .tabbed-labels>label:nth-child(19){order:19}.md-typeset .tabbed-labels>label:nth-child(20){order:20}}.md-typeset .tabbed-labels>label:hover{color:var(--md-default-fg-color)}.md-typeset .tabbed-labels>label>[href]:first-child{color:inherit}.md-typeset .tabbed-labels--linked>label{padding:0}.md-typeset .tabbed-labels--linked>label>a{display:block;padding:.78125em 1.25em .625em}.md-typeset .tabbed-content{width:100%}@media print{.md-typeset .tabbed-content{display:contents}}.md-typeset .tabbed-block{display:none}@media print{.md-typeset .tabbed-block{display:block}.md-typeset .tabbed-block:first-child{order:1}.md-typeset .tabbed-block:nth-child(2){order:2}.md-typeset .tabbed-block:nth-child(3){order:3}.md-typeset .tabbed-block:nth-child(4){order:4}.md-typeset .tabbed-block:nth-child(5){order:5}.md-typeset .tabbed-block:nth-child(6){order:6}.md-typeset .tabbed-block:nth-child(7){order:7}.md-typeset .tabbed-block:nth-child(8){order:8}.md-typeset .tabbed-block:nth-child(9){order:9}.md-typeset .tabbed-block:nth-child(10){order:10}.md-typeset .tabbed-block:nth-child(11){order:11}.md-typeset .tabbed-block:nth-child(12){order:12}.md-typeset .tabbed-block:nth-child(13){order:13}.md-typeset .tabbed-block:nth-child(14){order:14}.md-typeset .tabbed-block:nth-child(15){order:15}.md-typeset .tabbed-block:nth-child(16){order:16}.md-typeset .tabbed-block:nth-child(17){order:17}.md-typeset .tabbed-block:nth-child(18){order:18}.md-typeset .tabbed-block:nth-child(19){order:19}.md-typeset .tabbed-block:nth-child(20){order:20}}.md-typeset .tabbed-block>.highlight:first-child>pre,.md-typeset .tabbed-block>pre:first-child{margin:0}.md-typeset .tabbed-block>.highlight:first-child>pre>code,.md-typeset .tabbed-block>pre:first-child>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child>.filename{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable{margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.filename span.filename,.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.linenos{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.code>div>pre>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child+.result{margin-top:-.125em}.md-typeset .tabbed-block>.tabbed-set{margin:0}.md-typeset .tabbed-button{align-self:center;border-radius:100%;color:var(--md-default-fg-color--light);cursor:pointer;display:block;height:.9rem;margin-top:.1rem;pointer-events:auto;transition:background-color .25s;width:.9rem}.md-typeset .tabbed-button:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .tabbed-button:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-tabbed-icon--prev);mask-image:var(--md-tabbed-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color .25s,transform .25s;width:100%}.md-typeset .tabbed-control{background:linear-gradient(to right,var(--md-default-bg-color) 60%,#0000);display:flex;height:1.9rem;justify-content:start;pointer-events:none;position:absolute;transition:opacity 125ms;width:1.2rem}[dir=rtl] .md-typeset .tabbed-control{transform:rotate(180deg)}.md-typeset .tabbed-control[hidden]{opacity:0}.md-typeset .tabbed-control--next{background:linear-gradient(to left,var(--md-default-bg-color) 60%,#0000);justify-content:end;right:0}.md-typeset .tabbed-control--next .tabbed-button:after{-webkit-mask-image:var(--md-tabbed-icon--next);mask-image:var(--md-tabbed-icon--next)}@media screen and (max-width:44.984375em){[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels{padding-right:.8rem}.md-content__inner>.tabbed-set .tabbed-labels{margin:0 -.8rem;max-width:100vw;scroll-padding-inline-start:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-left:.8rem}.md-content__inner>.tabbed-set .tabbed-labels:after{content:""}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-right:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-left:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-right:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{width:2rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-left:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-right:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-left:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{width:2rem}}@media screen{.md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){color:var(--md-default-fg-color)}.md-typeset .no-js .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .no-js .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .no-js .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .no-js .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .no-js .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .no-js .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .no-js .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .no-js .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .no-js .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .no-js .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .no-js .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .no-js .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .no-js .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .no-js .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .no-js .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .no-js .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .no-js .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .no-js .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .no-js .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .no-js .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.md-typeset [role=dialog] .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset [role=dialog] .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset [role=dialog] .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset [role=dialog] .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset [role=dialog] .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset [role=dialog] .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset [role=dialog] .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset [role=dialog] .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset [role=dialog] .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset [role=dialog] .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset [role=dialog] .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset [role=dialog] .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset [role=dialog] .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset [role=dialog] .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset [role=dialog] .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset [role=dialog] .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset [role=dialog] .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset [role=dialog] .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset [role=dialog] .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset [role=dialog] .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.no-js .md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.no-js .md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.no-js .md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.no-js .md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.no-js .md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.no-js .md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.no-js .md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.no-js .md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.no-js .md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.no-js .md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.no-js .md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.no-js .md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.no-js .md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.no-js .md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.no-js .md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.no-js .md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.no-js .md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.no-js .md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.no-js .md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.no-js .md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),[role=dialog] .md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,[role=dialog] .md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),[role=dialog] .md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),[role=dialog] .md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),[role=dialog] .md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),[role=dialog] .md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),[role=dialog] .md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),[role=dialog] .md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),[role=dialog] .md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),[role=dialog] .md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),[role=dialog] .md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),[role=dialog] .md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),[role=dialog] .md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),[role=dialog] .md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),[role=dialog] .md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),[role=dialog] .md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),[role=dialog] .md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),[role=dialog] .md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),[role=dialog] .md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),[role=dialog] .md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){border-color:var(--md-default-fg-color)}}.md-typeset .tabbed-set>input:first-child.focus-visible~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10).focus-visible~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11).focus-visible~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12).focus-visible~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13).focus-visible~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14).focus-visible~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15).focus-visible~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16).focus-visible~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17).focus-visible~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18).focus-visible~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19).focus-visible~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2).focus-visible~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20).focus-visible~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3).focus-visible~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4).focus-visible~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5).focus-visible~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6).focus-visible~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7).focus-visible~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8).focus-visible~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9).focus-visible~.tabbed-labels>:nth-child(9){color:var(--md-accent-fg-color)}.md-typeset .tabbed-set>input:first-child:checked~.tabbed-content>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-content>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-content>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-content>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-content>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-content>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-content>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-content>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-content>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-content>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-content>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-content>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-content>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-content>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-content>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-content>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-content>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-content>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-content>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-content>:nth-child(9){display:block}:root{--md-tasklist-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12Zm16.28-2.72a.751.751 0 0 0-.018-1.042.751.751 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.751.751 0 0 0-1.042.018.751.751 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>');--md-tasklist-icon--checked:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12Zm16.28-2.72a.751.751 0 0 0-.018-1.042.751.751 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.751.751 0 0 0-1.042.018.751.751 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>')}.md-typeset .task-list-item{list-style-type:none;position:relative}[dir=ltr] .md-typeset .task-list-item [type=checkbox]{left:-2em}[dir=rtl] .md-typeset .task-list-item [type=checkbox]{right:-2em}.md-typeset .task-list-item [type=checkbox]{position:absolute;top:.45em}.md-typeset .task-list-control [type=checkbox]{opacity:0;z-index:-1}[dir=ltr] .md-typeset .task-list-indicator:before{left:-1.5em}[dir=rtl] .md-typeset .task-list-indicator:before{right:-1.5em}.md-typeset .task-list-indicator:before{background-color:var(--md-default-fg-color--lightest);content:"";height:1.25em;-webkit-mask-image:var(--md-tasklist-icon);mask-image:var(--md-tasklist-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.15em;width:1.25em}.md-typeset [type=checkbox]:checked+.task-list-indicator:before{background-color:#00e676;-webkit-mask-image:var(--md-tasklist-icon--checked);mask-image:var(--md-tasklist-icon--checked)}:root>*{--md-mermaid-font-family:var(--md-text-font-family),sans-serif;--md-mermaid-edge-color:var(--md-code-fg-color);--md-mermaid-node-bg-color:var(--md-accent-fg-color--transparent);--md-mermaid-node-fg-color:var(--md-accent-fg-color);--md-mermaid-label-bg-color:var(--md-default-bg-color);--md-mermaid-label-fg-color:var(--md-code-fg-color);--md-mermaid-sequence-actor-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actor-fg-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-actor-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-actor-line-color:var(--md-default-fg-color--lighter);--md-mermaid-sequence-actorman-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actorman-line-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-box-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-box-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-label-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-label-fg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-loop-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-loop-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-loop-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-message-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-message-line-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-note-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-border-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-number-bg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-number-fg-color:var(--md-accent-bg-color)}.mermaid{line-height:normal;margin:1em 0}.md-typeset .grid{grid-gap:.4rem;display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,16rem),1fr));margin:1em 0}.md-typeset .grid.cards>ol,.md-typeset .grid.cards>ul{display:contents}.md-typeset .grid.cards>ol>li,.md-typeset .grid.cards>ul>li,.md-typeset .grid>.card{border:.05rem solid var(--md-default-fg-color--lightest);border-radius:.1rem;display:block;margin:0;padding:.8rem;transition:border .25s,box-shadow .25s}.md-typeset .grid.cards>ol>li:focus-within,.md-typeset .grid.cards>ol>li:hover,.md-typeset .grid.cards>ul>li:focus-within,.md-typeset .grid.cards>ul>li:hover,.md-typeset .grid>.card:focus-within,.md-typeset .grid>.card:hover{border-color:#0000;box-shadow:var(--md-shadow-z2)}.md-typeset .grid.cards>ol>li>hr,.md-typeset .grid.cards>ul>li>hr,.md-typeset .grid>.card>hr{margin-bottom:1em;margin-top:1em}.md-typeset .grid.cards>ol>li>:first-child,.md-typeset .grid.cards>ul>li>:first-child,.md-typeset .grid>.card>:first-child{margin-top:0}.md-typeset .grid.cards>ol>li>:last-child,.md-typeset .grid.cards>ul>li>:last-child,.md-typeset .grid>.card>:last-child{margin-bottom:0}.md-typeset .grid>*,.md-typeset .grid>.admonition,.md-typeset .grid>.highlight>*,.md-typeset .grid>.highlighttable,.md-typeset .grid>.md-typeset details,.md-typeset .grid>details,.md-typeset .grid>pre{margin-bottom:0;margin-top:0}.md-typeset .grid>.highlight>pre:only-child,.md-typeset .grid>.highlight>pre>code,.md-typeset .grid>.highlighttable,.md-typeset .grid>.highlighttable>tbody,.md-typeset .grid>.highlighttable>tbody>tr,.md-typeset .grid>.highlighttable>tbody>tr>.code,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre>code{height:100%}.md-typeset .grid>.tabbed-set{margin-bottom:0;margin-top:0}@media screen and (min-width:45em){[dir=ltr] .md-typeset .inline{float:left}[dir=rtl] .md-typeset .inline{float:right}[dir=ltr] .md-typeset .inline{margin-right:.8rem}[dir=rtl] .md-typeset .inline{margin-left:.8rem}.md-typeset .inline{margin-bottom:.8rem;margin-top:0;width:11.7rem}[dir=ltr] .md-typeset .inline.end{float:right}[dir=rtl] .md-typeset .inline.end{float:left}[dir=ltr] .md-typeset .inline.end{margin-left:.8rem;margin-right:0}[dir=rtl] .md-typeset .inline.end{margin-left:0;margin-right:.8rem}}
\ No newline at end of file
diff --git a/blog/archive/2024/index.html b/blog/archive/2024/index.html
index 424a3053..08f6d2c8 100644
--- a/blog/archive/2024/index.html
+++ b/blog/archive/2024/index.html
@@ -23,7 +23,7 @@
       
       
       <link rel="icon" href="../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -31,7 +31,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1752,6 +1752,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../docs/examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2384,7 +2411,7 @@ <h2 id="introducing-dstack-sky"><a class="toclink" href="../../dstack-sky/">Intr
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../assets/javascripts/extra.js"></script>
       
diff --git a/blog/archive/say-goodbye-to-managed-notebooks/index.html b/blog/archive/say-goodbye-to-managed-notebooks/index.html
index 61a7e46c..9522aea3 100644
--- a/blog/archive/say-goodbye-to-managed-notebooks/index.html
+++ b/blog/archive/say-goodbye-to-managed-notebooks/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../docs/examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2349,7 +2376,7 @@ <h2 id="say-hello-to-cloud-dev-environments">Say hello to cloud dev environments
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../assets/javascripts/extra.js"></script>
       
diff --git a/blog/dstack-sky-own-cloud-accounts/index.html b/blog/dstack-sky-own-cloud-accounts/index.html
index b495e83e..7b763748 100644
--- a/blog/dstack-sky-own-cloud-accounts/index.html
+++ b/blog/dstack-sky-own-cloud-accounts/index.html
@@ -23,7 +23,7 @@
       
       
       <link rel="icon" href="../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -31,7 +31,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1754,6 +1754,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../docs/examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2328,7 +2355,7 @@ <h3 id="configure-backends">Configure backends<a class="headerlink" href="#confi
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../assets/javascripts/extra.js"></script>
       
diff --git a/blog/dstack-sky/index.html b/blog/dstack-sky/index.html
index dbbec5ab..eb7bbe8b 100644
--- a/blog/dstack-sky/index.html
+++ b/blog/dstack-sky/index.html
@@ -23,7 +23,7 @@
       
       
       <link rel="icon" href="../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -31,7 +31,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1754,6 +1754,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../docs/examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2457,7 +2484,7 @@ <h2 id="what-is-dstack-sky">What is dstack Sky?<a class="headerlink" href="#what
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../assets/javascripts/extra.js"></script>
       
diff --git a/blog/index.html b/blog/index.html
index 1a8929eb..8dcf54c2 100644
--- a/blog/index.html
+++ b/blog/index.html
@@ -15,7 +15,7 @@
         <link rel="canonical" href="https://dstack.ai/blog/">
       
       
-        <link rel="prev" href="../docs/examples/fine-tuning/alignment-handbook/">
+        <link rel="prev" href="../docs/examples/fine-tuning/axolotl/">
       
       
         <link rel="next" href="archive/2024/">
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1754,6 +1754,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../docs/examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2384,7 +2411,7 @@ <h2 id="introducing-dstack-sky"><a class="toclink" href="dstack-sky/">Introducin
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../assets/javascripts/extra.js"></script>
       
diff --git a/changelog/index.html b/changelog/index.html
index d081e338..b16b8297 100644
--- a/changelog/index.html
+++ b/changelog/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../docs/examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2207,7 +2234,7 @@ <h1 id="blog">Blog<a class="headerlink" href="#blog" title="Permanent link">&par
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../assets/javascripts/extra.js"></script>
       
diff --git a/docs/concepts/gateways/index.html b/docs/concepts/gateways/index.html
index a72cc16e..aa1b3ccd 100644
--- a/docs/concepts/gateways/index.html
+++ b/docs/concepts/gateways/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1920,6 +1920,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2585,7 +2612,7 @@ <h2 id="whats-next">What's next?<a class="headerlink" href="#whats-next" title="
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/concepts/pools/index.html b/docs/concepts/pools/index.html
index 6508d5db..e4318c1f 100644
--- a/docs/concepts/pools/index.html
+++ b/docs/concepts/pools/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2406,7 +2433,7 @@ <h2 id="list-instances">List instances<a class="headerlink" href="#list-instance
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/concepts/volumes/index.html b/docs/concepts/volumes/index.html
index 998fdbb1..83501290 100644
--- a/docs/concepts/volumes/index.html
+++ b/docs/concepts/volumes/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1920,6 +1920,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2622,7 +2649,7 @@ <h2 id="faq">FAQ<a class="headerlink" href="#faq" title="Permanent link">&para;<
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/dev-environments/index.html b/docs/dev-environments/index.html
index d8732ea8..5cf7be7f 100644
--- a/docs/dev-environments/index.html
+++ b/docs/dev-environments/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1937,6 +1937,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2654,7 +2681,7 @@ <h2 id="whats-next">What's next?<a class="headerlink" href="#whats-next" title="
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/deployment/infinity/index.html b/docs/examples/deployment/infinity/index.html
index a61f585a..cef779c7 100644
--- a/docs/examples/deployment/infinity/index.html
+++ b/docs/examples/deployment/infinity/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2204,7 +2231,7 @@ <h1 id="infinity">Infinity<a class="headerlink" href="#infinity" title="Permanen
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/deployment/lorax/index.html b/docs/examples/deployment/lorax/index.html
index d576db91..76e3c9cf 100644
--- a/docs/examples/deployment/lorax/index.html
+++ b/docs/examples/deployment/lorax/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2246,7 +2273,7 @@ <h2 id="task">Task<a class="headerlink" href="#task" title="Permanent link">&par
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/deployment/ollama/index.html b/docs/examples/deployment/ollama/index.html
index 843fe6ec..f8abe59b 100644
--- a/docs/examples/deployment/ollama/index.html
+++ b/docs/examples/deployment/ollama/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2204,7 +2231,7 @@ <h1 id="ollama">Ollama<a class="headerlink" href="#ollama" title="Permanent link
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/deployment/tei/index.html b/docs/examples/deployment/tei/index.html
index 80dcf381..d2659110 100644
--- a/docs/examples/deployment/tei/index.html
+++ b/docs/examples/deployment/tei/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2204,7 +2231,7 @@ <h1 id="text-embeddings-inference">Text Embeddings Inference<a class="headerlink
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/deployment/tgi/index.html b/docs/examples/deployment/tgi/index.html
index 2b76fd71..8c441dca 100644
--- a/docs/examples/deployment/tgi/index.html
+++ b/docs/examples/deployment/tgi/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2244,7 +2271,7 @@ <h2 id="task">Task<a class="headerlink" href="#task" title="Permanent link">&par
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/deployment/vllm/index.html b/docs/examples/deployment/vllm/index.html
index 38b280d5..21a5b634 100644
--- a/docs/examples/deployment/vllm/index.html
+++ b/docs/examples/deployment/vllm/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2244,7 +2271,7 @@ <h2 id="task">Task<a class="headerlink" href="#task" title="Permanent link">&par
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/fine-tuning/alignment-handbook/index.html b/docs/examples/fine-tuning/alignment-handbook/index.html
index 6eda7c66..2e64b380 100644
--- a/docs/examples/fine-tuning/alignment-handbook/index.html
+++ b/docs/examples/fine-tuning/alignment-handbook/index.html
@@ -18,14 +18,14 @@
         <link rel="prev" href="../../">
       
       
-        <link rel="next" href="../../../../blog/">
+        <link rel="next" href="../axolotl/">
       
       
         
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1927,6 +1927,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2388,10 +2415,12 @@ <h1 id="alignment-handbook">Alignment Handbook<a class="headerlink" href="#align
 scripts for fine-tuning LLMs. It includes all the code needed to run CPT, SFT, DPO, and ORPO leveraging HuggingFace's
 libraries like <code>transformers</code>, <code>peft</code>, <code>accelerate</code>, and <code>trl</code>. You just need to modify the recipes and run the 
 appropriate script.</p>
-<p>This example shows how use Alignment Handbook to fine-tune Gemma 7B on your SFT dataset 
-with Alignment Handbook and <code>dstack</code>. </p>
+<blockquote>
+<p>This example shows how use Alignment Handbook with <code>dstack</code> to fine-tune Gemma 7B on your 
+SFT dataset using one node or multiple nodes. </p>
+</blockquote>
 <h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">&para;</a></h2>
-<p>Once <code>dstack</code> is <a href="https://dstack.ai/docs/installation">installed</a>, clone the repo and run <code>dstack init</code></p>
+<p>Once <code>dstack</code> is <a href="https://dstack.ai/docs/installation">installed</a>, clone the repo and run <code>dstack init</code>:</p>
 <div class="highlight"><pre><span></span><code>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/dstackai/dstack
 <span class="nb">cd</span><span class="w"> </span>dstack
 dstack<span class="w"> </span>init
@@ -2401,6 +2430,10 @@ <h2 id="training-configuration-recipe">Training configuration recipe<a class="he
 as trainer configuration from a YAML file.
 This file can be found at <a href="https://github.com/dstackai/dstack/blob/master/examples/fine-tuning/alignment-handbook/config.yaml"><code>examples/fine-tuning/alignment-handbook/config.yaml</code></a>.
 You can modify it as needed.</p>
+<blockquote>
+<p>Before you proceed with training, make sure to update the <code>hub_model_id</code> in <a href="https://github.com/dstackai/dstack/blob/master/examples/fine-tuning/alignment-handbook/config.yaml"><code>examples/fine-tuning/alignment-handbook/config.yaml</code></a>
+with your HuggingFace username.</p>
+</blockquote>
 <h2 id="single-node-training">Single-node training<a class="headerlink" href="#single-node-training" title="Permanent link">&para;</a></h2>
 <p>The easiest way to run a training script with <code>dstack</code> is by creating a task configuration file.
 This file can be found at <a href="https://github.com/dstackai/dstack/blob/master/examples/fine-tuning/alignment-handbook/train.dstack.yml"><code>examples/fine-tuning/alignment-handbook/train.dstack.yml</code></a>. Below is its content: </p>
@@ -2428,9 +2461,9 @@ <h2 id="single-node-training">Single-node training<a class="headerlink" href="#s
 <span class="w">    </span><span class="l l-Scalar l-Scalar-Plain">--num_processes=$DSTACK_GPUS_NUM</span>
 <span class="w">    </span><span class="l l-Scalar l-Scalar-Plain">scripts/run_sft.py</span>
 <span class="w">    </span><span class="l l-Scalar l-Scalar-Plain">../examples/fine-tuning/alignment-handbook/config.yaml</span>
-<span class="c1"># Expose 6006 to access TensorBoard</span>
-<span class="nt">ports</span><span class="p">:</span>
-<span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">6006</span>
+<span class="c1"># Uncomment to access TensorBoard</span>
+<span class="c1">#ports:</span>
+<span class="c1">#  - 6006</span>
 
 <span class="nt">resources</span><span class="p">:</span>
 <span class="w">  </span><span class="c1"># Required resources</span>
@@ -2442,7 +2475,6 @@ <h2 id="single-node-training">Single-node training<a class="headerlink" href="#s
 according to the <code>resoruce</code> property.</p>
 <p>To run the task, use <code>dstack apply</code>:</p>
 <div class="highlight"><pre><span></span><code><span class="nv">HUGGING_FACE_HUB_TOKEN</span><span class="o">=</span>...
-<span class="nv">ACCELERATE_LOG_LEVEL</span><span class="o">=</span>...
 <span class="nv">WANDB_API_KEY</span><span class="o">=</span>...
 
 dstack<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>examples/fine-tuning/alignment-handbook/train.dstack.yml
@@ -2523,7 +2555,7 @@ <h2 id="fleets">Fleets<a class="headerlink" href="#fleets" title="Permanent link
 </blockquote>
 <h2 id="dev-environment">Dev environment<a class="headerlink" href="#dev-environment" title="Permanent link">&para;</a></h2>
 <p>If you'd like to play with the example using a dev environment, run
-<a href=".dstack.yml">.dstack.yml</a> via <code>dstack apply</code>:</p>
+<a href="https://github.com/dstackai/dstack/examples/fine-tuning/alignment-handbook/.dstack.yml">.dstack.yml</a> via <code>dstack apply</code>:</p>
 <div class="highlight"><pre><span></span><code>dstack<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>examples/fine-tuning/alignment-handbook/.dstack.yaml<span class="w"> </span>
 </code></pre></div>
 <h2 id="source-code">Source code<a class="headerlink" href="#source-code" title="Permanent link">&para;</a></h2>
@@ -2574,13 +2606,13 @@ <h2 id="whats-next">What's next?<a class="headerlink" href="#whats-next" title="
             
             
               
-              <a href="../../../../blog/" class="md-footer__link md-footer__link--next" aria-label="Next: Blog">
+              <a href="../axolotl/" class="md-footer__link md-footer__link--next" aria-label="Next: Axolotl">
                 <div class="md-footer__title">
                   <span class="md-footer__direction">
                     Next
                   </span>
                   <div class="md-ellipsis">
-                    Blog
+                    Axolotl
                   </div>
                 </div>
                 <div class="md-footer__button md-icon">
@@ -2694,7 +2726,7 @@ <h2 id="whats-next">What's next?<a class="headerlink" href="#whats-next" title="
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/fine-tuning/axolotl/index.html b/docs/examples/fine-tuning/axolotl/index.html
index aa272770..2c29891a 100644
--- a/docs/examples/fine-tuning/axolotl/index.html
+++ b/docs/examples/fine-tuning/axolotl/index.html
@@ -15,13 +15,17 @@
         <link rel="canonical" href="https://dstack.ai/docs/examples/fine-tuning/axolotl/">
       
       
+        <link rel="prev" href="../alignment-handbook/">
+      
+      
+        <link rel="next" href="../../../../blog/">
       
       
         
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -306,10 +310,12 @@
         
   
   
+    
+  
   
     
     
-      <li class="md-tabs__item">
+      <li class="md-tabs__item md-tabs__item--active">
         <a href="../../" class="md-tabs__link">
           
   
@@ -1596,25 +1602,30 @@
       
   
   
+    
+  
   
   
     
     
     
       
+        
+        
+      
       
         
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
+          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1631,7 +1642,7 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_3">
             <span class="md-nav__icon md-icon"></span>
             
@@ -1675,6 +1686,8 @@
                 
   
   
+    
+  
   
   
     
@@ -1682,18 +1695,21 @@
     
       
       
+        
+          
+          
         
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2" checked>
         
           
-          <label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
+          <label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1710,7 +1726,7 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_3_2">
             <span class="md-nav__icon md-icon"></span>
             
@@ -1748,6 +1764,183 @@
 
               
             
+              
+                
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+        
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#prerequisites" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Prerequisites
+        </span>
+      
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#training-configuration-recipe" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Training configuration recipe
+        </span>
+      
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#single-node-training" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Single-node training
+        </span>
+      
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#fleets" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Fleets
+        </span>
+      
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#dev-environment" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Dev environment
+        </span>
+      
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#source-code" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Source code
+        </span>
+      
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#contributing" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Contributing
+        </span>
+      
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#whats-next" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          What's next?
+        </span>
+      
+    </span>
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2071,34 +2264,106 @@
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
         <li class="md-nav__item">
-  <a href="#running-with-dstack" class="md-nav__link">
+  <a href="#prerequisites" class="md-nav__link">
     <span class="md-ellipsis">
       
         <span class="md-typeset">
-          Running with <code>dstack</code>
+          Prerequisites
         </span>
       
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="Running with dstack">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#building-axolotl-from-sources" class="md-nav__link">
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#training-configuration-recipe" class="md-nav__link">
     <span class="md-ellipsis">
       
         <span class="md-typeset">
-          Building <code>axolotl</code> from sources
+          Training configuration recipe
         </span>
       
     </span>
   </a>
   
 </li>
-        
-      </ul>
-    </nav>
+      
+        <li class="md-nav__item">
+  <a href="#single-node-training" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Single-node training
+        </span>
+      
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#fleets" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Fleets
+        </span>
+      
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#dev-environment" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Dev environment
+        </span>
+      
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#source-code" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Source code
+        </span>
+      
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#contributing" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Contributing
+        </span>
+      
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#whats-next" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          What's next?
+        </span>
+      
+    </span>
+  </a>
   
 </li>
       
@@ -2120,73 +2385,97 @@
 
 
 <h1 id="axolotl">Axolotl<a class="headerlink" href="#axolotl" title="Permanent link">&para;</a></h1>
-<p><a href="https://github.com/OpenAccess-AI-Collective/axolotl"><code>axolotl</code></a> streamlines the fine-tuning of AI models, offering support for multiple configurations and architectures.</p>
-<p>Furthermore, <code>axolotl</code> provides a set of <a href="https://github.com/OpenAccess-AI-Collective/axolotl/tree/main/examples"><code>yaml</code> examples</a> for almost all kinds of LLMs such as LLaMA2 family, Gemma family, LLaMA3 family, Jamba, and so on. It's recommended to navigate through the examples to get a sense about the role of each parameters, and adjust them for your specific use cases. Also, it is worth checking out all configs/parameters options with a brief description from <a href="https://github.com/OpenAccess-AI-Collective/axolotl/blob/main/docs/config.qmd">this doc</a>.</p>
-<p>The example below replicates the <a href="https://github.com/OpenAccess-AI-Collective/axolotl/blob/main/examples/llama-3/qlora-fsdp-70b.yaml">FSDP+QLoRA on LLaMA3 70B</a>, except that here we use Llama3 8B. You can see the <a href="config.yaml"><code>config.yaml</code></a>.</p>
-<h2 id="running-with-dstack">Running with <code>dstack</code><a class="headerlink" href="#running-with-dstack" title="Permanent link">&para;</a></h2>
-<p>Running <code>axolotl</code> with <code>dstack</code> is very straightforward.</p>
-<p>First, define the <a href="train.dstack.yaml"><code>train.dstack.yaml</code></a> task configuration file as follows:</p>
+<p><a href="https://github.com/OpenAccess-AI-Collective/axolotl">Axolotl</a> streamlines the fine-tuning of AI models It not only
+supports multiple configurations and architectures but also provides many
+ready-to-use <a href="https://github.com/axolotl-ai-cloud/axolotl/tree/main/examples">recipes</a>. You just need to pick a suitable
+recipe and adjust it for your use case.</p>
+<blockquote>
+<p>This example shows how use Axolotl with <code>dstack</code> to fine-tune Llama3 8B using FSDP and QLoRA
+on one node.</p>
+</blockquote>
+<h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">&para;</a></h2>
+<p>Once <code>dstack</code> is <a href="https://dstack.ai/docs/installation">installed</a>, clone the repo and run <code>dstack init</code>:</p>
+<div class="highlight"><pre><span></span><code>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/dstackai/dstack
+<span class="nb">cd</span><span class="w"> </span>dstack
+dstack<span class="w"> </span>init
+</code></pre></div>
+<h2 id="training-configuration-recipe">Training configuration recipe<a class="headerlink" href="#training-configuration-recipe" title="Permanent link">&para;</a></h2>
+<p>Axolotl reads the model, LoRA, and dataset arguments, as well as trainer configuration from a YAML file. This file can
+be found at <a href="https://github.com/dstackai/dstack/blob/master/examples/fine-tuning/axolotl/config.yaml"><code>examples/fine-tuning/axolotl/config.yaml</code></a>.
+You can modify it as needed.</p>
+<blockquote>
+<p>Before you proceed with training, make sure to update the <code>hub_model_id</code> in <a href="https://github.com/dstackai/dstack/blob/master/examples/fine-tuning/alignment-handbook/config.yaml"><code>examples/fine-tuning/axolotl/config.yaml</code></a>
+with your HuggingFace username.</p>
+</blockquote>
+<h2 id="single-node-training">Single-node training<a class="headerlink" href="#single-node-training" title="Permanent link">&para;</a></h2>
+<p>The easiest way to run a training script with <code>dstack</code> is by creating a task configuration file.
+This file can be found at <a href="https://github.com/dstackai/dstack/blob/master/examples/fine-tuning/axolotl/train.dstack.yml"><code>examples/fine-tuning/axolotl/train.dstack.yml</code></a>. Below is its content: </p>
 <div class="highlight"><pre><span></span><code><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">task</span>
+<span class="c1"># The name is optional, if not specified, generated randomly</span>
+<span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">axolotl-train</span>
 
+<span class="c1"># Using the official Axolotl&#39;s Docker image</span>
 <span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">winglian/axolotl-cloud:main-20240429-py3.11-cu121-2.2.1</span>
 
+<span class="c1"># Required environment variables</span>
 <span class="nt">env</span><span class="p">:</span>
 <span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HUGGING_FACE_HUB_TOKEN</span>
 <span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">WANDB_API_KEY</span>
-
+<span class="c1"># Commands of the task</span>
 <span class="nt">commands</span><span class="p">:</span>
-<span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">accelerate launch -m axolotl.cli.train config.yaml</span>
-
+<span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">accelerate launch -m axolotl.cli.train examples/fine-tuning/axolotl/config.yaml</span>
+<span class="c1"># Expose 6006 to access TensorBoard</span>
 <span class="nt">ports</span><span class="p">:</span>
 <span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">6006</span>
 
 <span class="nt">resources</span><span class="p">:</span>
-<span class="w">  </span><span class="nt">gpu</span><span class="p">:</span>
-<span class="w">    </span><span class="nt">memory</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">24GB..</span>
-<span class="w">    </span><span class="nt">count</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span>
+<span class="w">  </span><span class="c1"># Two or more 24GB GPUs (required by FSDP)</span>
+<span class="w">  </span><span class="nt">gpu</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">24GB:2..</span>
+</code></pre></div>
+<p>The task uses Axolotl's Docker image, where Axolotl is already pre-installed.</p>
+<p>To run the task, use <code>dstack apply</code>:</p>
+<div class="highlight"><pre><span></span><code><span class="nv">HUGGING_FACE_HUB_TOKEN</span><span class="o">=</span>...
+<span class="nv">WANDB_API_KEY</span><span class="o">=</span>...
+
+dstack<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>examples/fine-tuning/axolotl/train.dstack.yml
 </code></pre></div>
+<p>If you list <code>tensorbord</code> via <code>report_to</code> in <a href="https://github.com/dstackai/dstack/blob/master/examples/fine-tuning/axolotl/config.yaml"><code>examples/fine-tuning/axolotl/config.yaml</code></a>,
+you'll be able to access experiment metrics via <code>http://localhost:6006</code> (while the task is running).</p>
+<h2 id="fleets">Fleets<a class="headerlink" href="#fleets" title="Permanent link">&para;</a></h2>
 <blockquote>
-<p>[!NOTE]
-Feel free to adjust <code>resources</code> to specify the required resources.</p>
+<p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing <a href="https://dstack.ai/docs/fleets">fleets</a>.
+If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p>
 </blockquote>
-<p>We are using the official Docker image provided by Axolotl team (<code>winglian/axolotl-cloud:main-20240429-py3.11-cu121-2.2.1</code>). If you want to see other images, their official <a href="https://hub.docker.com/r/winglian/axolotl-cloud/tags">repo</a>. Note, <code>dstack</code> requires the CUDA driver to be 12.1+.</p>
-<p>To run the task, use the following command:</p>
-<div class="highlight"><pre><span></span><code><span class="nv">HUGGING_FACE_HUB_TOKEN</span><span class="o">=</span>&lt;...&gt;<span class="w"> </span><span class="se">\</span>
-<span class="nv">WANDB_API_KEY</span><span class="o">=</span>&lt;...&gt;<span class="w"> </span><span class="se">\</span>
-dstack<span class="w"> </span>run<span class="w"> </span>.<span class="w"> </span>-f<span class="w"> </span>examples/fine-tuning/axolotl/train.dstack.yaml
+<p>The example folder includes a fleet configuration: 
+<a href="https://github.com/dstackai/dstack/blob/master/examples/fine-tuning/axolotl/fleet.dstack.yml"> <code>examples/fine-tuning/axolotl/fleet.dstack.yml</code></a> 
+( a single node with a <code>24GB</code> GPU).</p>
+<p>You can update the fleet configuration to change the vRAM size, GPU model, number of GPUs per node, or number of nodes. </p>
+<p>A fleet can be provisioned with <code>dstack apply</code>:</p>
+<div class="highlight"><pre><span></span><code>dstack<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>examples/fine-tuning/axolotl/fleet.dstack.yml
 </code></pre></div>
-<p>To push the final fine-tuned model to Hugging Face Hub, set <code>hub_model_id</code> in <a href="config.yaml"><code>config.yaml</code></a>.</p>
-<h3 id="building-axolotl-from-sources">Building <code>axolotl</code> from sources<a class="headerlink" href="#building-axolotl-from-sources" title="Permanent link">&para;</a></h3>
-<p>If you'd like to build <code>axolot</code> from sources (e.g. if you intend to modify its source code), follow its <a href="https://github.com/OpenAccess-AI-Collective/axolotl?tab=readme-ov-file#condapip-venv">installation guide</a>.</p>
-<p>Example:</p>
-<div class="highlight"><pre><span></span><code><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">task</span>
-
-<span class="nt">python</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">3.11</span>
-
-<span class="nt">env</span><span class="p">:</span>
-<span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HUGGING_FACE_HUB_TOKEN</span>
-<span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">WANDB_API_KEY</span>
-
-<span class="nt">commands</span><span class="p">:</span>
-<span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">conda install cuda</span>
-<span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pip3 install torch torchvision torchaudio</span>
-
-<span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">git clone https://github.com/OpenAccess-AI-Collective/axolotl.git</span>
-<span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cd axolotl</span>
-
-<span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pip3 install packaging</span>
-<span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pip3 install -e &#39;.[flash-attn,deepspeed]&#39;</span>
-
-<span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">accelerate launch -m axolotl.cli.train ../config.yaml</span>
-
-<span class="nt">ports</span><span class="p">:</span>
-<span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">6006</span>
-
-<span class="nt">resources</span><span class="p">:</span>
-<span class="w">  </span><span class="nt">gpu</span><span class="p">:</span>
-<span class="w">    </span><span class="nt">memory</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">24GB..</span>
-<span class="w">    </span><span class="nt">count</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span>
+<p>Once provisioned, the fleet can run dev environments and fine-tuning tasks.
+To delete the fleet, use <code>dstack fleet delete</code>.</p>
+<blockquote>
+<p>To ensure <code>dstack apply</code> always reuses an existing fleet,
+pass <code>--reuse</code> to <code>dstack apply</code> (or set <code>creation_policy</code> to <code>reuse</code> in the task configuration).
+The default policy is <code>reuse_or_create</code>.</p>
+</blockquote>
+<h2 id="dev-environment">Dev environment<a class="headerlink" href="#dev-environment" title="Permanent link">&para;</a></h2>
+<p>If you'd like to play with the example using a dev environment, run
+<a href="https://github.com/dstackai/dstack/examples/fine-tuning/axolotl/.dstack.yml">.dstack.yml</a> via <code>dstack apply</code>:</p>
+<div class="highlight"><pre><span></span><code>dstack<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>examples/fine-tuning/axolotl/.dstack.yaml<span class="w"> </span>
 </code></pre></div>
+<h2 id="source-code">Source code<a class="headerlink" href="#source-code" title="Permanent link">&para;</a></h2>
+<p>The source-code of this example can be found in  <a href="https://github.com/dstackai/dstack/blob/master/examples/fine-tuning/axolotl"><code>https://github.com/dstackai/dstack/examples/fine-tuning/axolotl</code></a>.</p>
+<h2 id="contributing">Contributing<a class="headerlink" href="#contributing" title="Permanent link">&para;</a></h2>
+<p>Find a mistake or can't find an important example? Raise an <a href="https://github.com/dstackai/dstack/issues">issue</a> or send a <a href="https://github.com/dstackai/dstack/tree/master/examples">pull request</a>!</p>
+<h2 id="whats-next">What's next?<a class="headerlink" href="#whats-next" title="Permanent link">&para;</a></h2>
+<ol>
+<li>Browse <a href="https://github.com/OpenAccess-AI-Collective/axolotl">Axolotl</a>.</li>
+<li>Check <a href="https://dstack.ai/docs/dev-environments">dev environments</a>, <a href="https://dstack.ai/docs/tasks">tasks</a>, 
+   <a href="https://dstack.ai/docs/services">services</a>, and <a href="https://dstack.ai/docs/fleets">fleets</a>.</li>
+<li>See other <a href="https://github.com/dstackai/dstack/blob/master/examples/">examples</a>.</li>
+</ol>
 
 
 
@@ -2203,6 +2492,44 @@ <h3 id="building-axolotl-from-sources">Building <code>axolotl</code> from source
 
 
       
+          
+          <nav class="md-footer__inner md-grid" aria-label="Footer" >
+            
+              
+              <a href="../alignment-handbook/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Alignment Handbook">
+                <div class="md-footer__button md-icon">
+                  
+                  <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>
+                </div>
+                <div class="md-footer__title">
+                  <span class="md-footer__direction">
+                    Previous
+                  </span>
+                  <div class="md-ellipsis">
+                    Alignment Handbook
+                  </div>
+                </div>
+              </a>
+            
+            
+              
+              <a href="../../../../blog/" class="md-footer__link md-footer__link--next" aria-label="Next: Blog">
+                <div class="md-footer__title">
+                  <span class="md-footer__direction">
+                    Next
+                  </span>
+                  <div class="md-ellipsis">
+                    Blog
+                  </div>
+                </div>
+                <div class="md-footer__button md-icon">
+                  
+                  <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 11H4Z"/></svg>
+                </div>
+              </a>
+            
+          </nav>
+        
     
   </article>
 </div>
@@ -2306,7 +2633,7 @@ <h3 id="building-axolotl-from-sources">Building <code>axolotl</code> from source
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/fine-tuning/qlora/index.html b/docs/examples/fine-tuning/qlora/index.html
index 9a762570..17dfd9d6 100644
--- a/docs/examples/fine-tuning/qlora/index.html
+++ b/docs/examples/fine-tuning/qlora/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2204,7 +2231,7 @@ <h1 id="qlora">QLoRA<a class="headerlink" href="#qlora" title="Permanent link">&
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/index.html b/docs/examples/index.html
index 775ee011..5227e23d 100644
--- a/docs/examples/index.html
+++ b/docs/examples/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1849,6 +1849,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2396,7 +2423,7 @@ <h2 id="contributing">Contributing<a class="headerlink" href="#contributing" tit
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/llms/chat-ui/index.html b/docs/examples/llms/chat-ui/index.html
index 0311b501..9fb9466e 100644
--- a/docs/examples/llms/chat-ui/index.html
+++ b/docs/examples/llms/chat-ui/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2293,7 +2320,7 @@ <h3 id="run-chat-ui">Run Chat UI<a class="headerlink" href="#run-chat-ui" title=
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/llms/llama3/index.html b/docs/examples/llms/llama3/index.html
index dba091de..66e33849 100644
--- a/docs/examples/llms/llama3/index.html
+++ b/docs/examples/llms/llama3/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2260,7 +2287,7 @@ <h2 id="run-chat-ui">Run Chat UI<a class="headerlink" href="#run-chat-ui" title=
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/llms/mixtral/index.html b/docs/examples/llms/mixtral/index.html
index 567aa3cf..2082dedb 100644
--- a/docs/examples/llms/mixtral/index.html
+++ b/docs/examples/llms/mixtral/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2204,7 +2231,7 @@ <h1 id="mixtral-8x7b">Mixtral 8x7B<a class="headerlink" href="#mixtral-8x7b" tit
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/misc/http.server/index.html b/docs/examples/misc/http.server/index.html
index 1acaf01c..546df092 100644
--- a/docs/examples/misc/http.server/index.html
+++ b/docs/examples/misc/http.server/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2244,7 +2271,7 @@ <h2 id="task">Task<a class="headerlink" href="#task" title="Permanent link">&par
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/examples/misc/streamlit/index.html b/docs/examples/misc/streamlit/index.html
index 363176eb..cb3507c3 100644
--- a/docs/examples/misc/streamlit/index.html
+++ b/docs/examples/misc/streamlit/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2244,7 +2271,7 @@ <h2 id="task">Task<a class="headerlink" href="#task" title="Permanent link">&par
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/fleets/index.html b/docs/fleets/index.html
index e59eca58..50a5a347 100644
--- a/docs/fleets/index.html
+++ b/docs/fleets/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1918,6 +1918,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2633,7 +2660,7 @@ <h3 id="deleting-fleets">Deleting fleets<a class="headerlink" href="#deleting-fl
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/guides/protips/index.html b/docs/guides/protips/index.html
index 51198ee1..9e9d7028 100644
--- a/docs/guides/protips/index.html
+++ b/docs/guides/protips/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1940,6 +1940,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2765,7 +2792,7 @@ <h2 id="service-quotas">Service quotas<a class="headerlink" href="#service-quota
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/index.html b/docs/index.html
index d1e46ee9..1bd75ac0 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1918,6 +1918,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2555,7 +2582,7 @@ <h2 id="where-do-i-start">Where do I start?<a class="headerlink" href="#where-do
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../assets/javascripts/extra.js"></script>
       
diff --git a/docs/installation/index.html b/docs/installation/index.html
index 0e1ebea5..81ccfe9b 100644
--- a/docs/installation/index.html
+++ b/docs/installation/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1950,6 +1950,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2688,7 +2715,7 @@ <h2 id="whats-next">What's next?<a class="headerlink" href="#whats-next" title="
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/quickstart/index.html b/docs/quickstart/index.html
index fc1fb03d..e0ed038a 100644
--- a/docs/quickstart/index.html
+++ b/docs/quickstart/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1873,6 +1873,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2544,7 +2571,7 @@ <h2 id="whats-next">What's next?<a class="headerlink" href="#whats-next" title="
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/reference/api/python/index.html b/docs/reference/api/python/index.html
index 8b3c7ba5..ee4ba3c2 100644
--- a/docs/reference/api/python/index.html
+++ b/docs/reference/api/python/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1837,6 +1837,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nvcc" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        nvcc
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -2206,6 +2217,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nvcc" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        nvcc
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -3092,6 +3114,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -3643,6 +3692,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nvcc" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        nvcc
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -4012,6 +4072,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nvcc" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        nvcc
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -5482,6 +5553,7 @@ <h4 class="reference-item" id="working_dir"><code>working_dir</code> - (Optional
 <h4 class="reference-item" id="home_dir"><code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.<a class="headerlink" href="#home_dir" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="_registry_auth"><a href="#dstack.api.RegistryAuth"><code>registry_auth</code></a> - (Optional) Credentials for pulling a private Docker image.<a class="headerlink" href="#_registry_auth" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="python"><code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.<a class="headerlink" href="#python" title="Permanent link">&para;</a></h4>
+<h4 class="reference-item" id="nvcc"><code>nvcc</code> - (Optional) Use image with NVIDIA CUDA Compiler (NVCC) included. Mutually exclusive with <code>image</code>.<a class="headerlink" href="#nvcc" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="env"><code>env</code> - (Optional) The mapping or the list of environment variables.<a class="headerlink" href="#env" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="setup"><code>setup</code> - (Optional) The bash commands to run on the boot.<a class="headerlink" href="#setup" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="_resources"><a href="#dstack.api.Resources"><code>resources</code></a> - (Optional) The resources requirements to run the configuration.<a class="headerlink" href="#_resources" title="Permanent link">&para;</a></h4>
@@ -5515,6 +5587,7 @@ <h4 class="reference-item" id="working_dir"><code>working_dir</code> - (Optional
 <h4 class="reference-item" id="home_dir"><code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.<a class="headerlink" href="#home_dir" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="_registry_auth"><a href="#dstack.api.RegistryAuth"><code>registry_auth</code></a> - (Optional) Credentials for pulling a private Docker image.<a class="headerlink" href="#_registry_auth" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="python"><code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.<a class="headerlink" href="#python" title="Permanent link">&para;</a></h4>
+<h4 class="reference-item" id="nvcc"><code>nvcc</code> - (Optional) Use image with NVIDIA CUDA Compiler (NVCC) included. Mutually exclusive with <code>image</code>.<a class="headerlink" href="#nvcc" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="env"><code>env</code> - (Optional) The mapping or the list of environment variables.<a class="headerlink" href="#env" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="setup"><code>setup</code> - (Optional) The bash commands to run on the boot.<a class="headerlink" href="#setup" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="_resources"><a href="#dstack.api.Resources"><code>resources</code></a> - (Optional) The resources requirements to run the configuration.<a class="headerlink" href="#_resources" title="Permanent link">&para;</a></h4>
@@ -6731,7 +6804,7 @@ <h3 id="dstack.api.BackendType"><code>dstack.api.BackendType</code><a class="hea
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/reference/api/rest/index.html b/docs/reference/api/rest/index.html
index 389078fe..18e46902 100644
--- a/docs/reference/api/rest/index.html
+++ b/docs/reference/api/rest/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1780,6 +1780,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2312,7 +2339,7 @@ <h1>REST API</h1>
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/reference/api/rest/openapi.json b/docs/reference/api/rest/openapi.json
index 96b707d9..7cb7beb3 100644
--- a/docs/reference/api/rest/openapi.json
+++ b/docs/reference/api/rest/openapi.json
@@ -1 +1 @@
-{"openapi": "3.1.0", "info": {"title": "REST API", "description": "The REST API enables running tasks, services, and managing runs programmatically.", "version": "0.0.0"}, "servers": [{"url": "http://localhost:3000", "description": "Local server"}, {"url": "https://sky.dstack.ai", "description": "Managed server"}], "paths": {"/api/users/list": {"post": {"tags": ["users"], "summary": "List Users", "operationId": "list_users_api_users_list_post", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/UserRequest"}, "type": "array", "title": "Response List Users Api Users List Post"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/users/get_my_user": {"post": {"tags": ["users"], "summary": "Get My User", "operationId": "get_my_user_api_users_get_my_user_post", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserRequest"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/users/get_user": {"post": {"tags": ["users"], "summary": "Get User", "operationId": "get_user_api_users_get_user_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetUserRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserWithCredsRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/users/create": {"post": {"tags": ["users"], "summary": "Create User", "operationId": "create_user_api_users_create_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateUserRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/users/update": {"post": {"tags": ["users"], "summary": "Update User", "operationId": "update_user_api_users_update_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateUserRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/users/refresh_token": {"post": {"tags": ["users"], "summary": "Refresh Token", "operationId": "refresh_token_api_users_refresh_token_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/RefreshTokenRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserWithCredsRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/users/delete": {"post": {"tags": ["users"], "summary": "Delete Users", "operationId": "delete_users_api_users_delete_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteUsersRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/projects/list": {"post": {"tags": ["projects"], "summary": "List Projects", "description": "Returns all projects visible to user.\n`members` and `backends` are always empty - call `/api/projects/{project_name}/get` to retrieve them.", "operationId": "list_projects_api_projects_list_post", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/ProjectRequest"}, "type": "array", "title": "Response List Projects Api Projects List Post"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/projects/create": {"post": {"tags": ["projects"], "summary": "Create Project", "operationId": "create_project_api_projects_create_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateProjectRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProjectRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/projects/delete": {"post": {"tags": ["projects"], "summary": "Delete Projects", "operationId": "delete_projects_api_projects_delete_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteProjectsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/projects/{project_name}/get": {"post": {"tags": ["projects"], "summary": "Get Project", "operationId": "get_project_api_projects__project_name__get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProjectRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/projects/{project_name}/set_members": {"post": {"tags": ["projects"], "summary": "Set Project Members", "operationId": "set_project_members_api_projects__project_name__set_members_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/SetProjectMembersRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProjectRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/backends/list_types": {"post": {"tags": ["backends"], "summary": "List Backend Types", "operationId": "list_backend_types_api_backends_list_types_post", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array"}}}}}}}, "/api/backends/config_values": {"post": {"tags": ["backends"], "summary": "Get Backend Config Values", "operationId": "get_backend_config_values_api_backends_config_values_post", "requestBody": {"content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}], "title": "Body"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigValuesRequest"}, {"$ref": "#/components/schemas/AzureConfigValuesRequest"}, {"$ref": "#/components/schemas/CudoConfigValuesRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigValuesRequest"}, {"$ref": "#/components/schemas/GCPConfigValuesRequest"}, {"$ref": "#/components/schemas/KubernetesConfigValuesRequest"}, {"$ref": "#/components/schemas/LambdaConfigValuesRequest"}, {"$ref": "#/components/schemas/NebiusConfigValuesRequest"}, {"$ref": "#/components/schemas/OCIConfigValuesRequest"}, {"$ref": "#/components/schemas/RunpodConfigValuesRequest"}, {"$ref": "#/components/schemas/TensorDockConfigValuesRequest"}, {"$ref": "#/components/schemas/VastAIConfigValuesRequest"}, {"$ref": "#/components/schemas/DstackConfigValuesRequest"}], "title": "Response Get Backend Config Values Api Backends Config Values Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/create": {"post": {"tags": ["backends"], "summary": "Create Backend", "operationId": "create_backend_api_project__project_name__backends_create_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}], "title": "Body"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}], "title": "Response Create Backend Api Project  Project Name  Backends Create Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/update": {"post": {"tags": ["backends"], "summary": "Update Backend", "operationId": "update_backend_api_project__project_name__backends_update_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}], "title": "Body"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}], "title": "Response Update Backend Api Project  Project Name  Backends Update Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/delete": {"post": {"tags": ["backends"], "summary": "Delete Backends", "operationId": "delete_backends_api_project__project_name__backends_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteBackendsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/{backend_name}/config_info": {"post": {"tags": ["backends"], "summary": "Get Backend Config Info", "operationId": "get_backend_config_info_api_project__project_name__backends__backend_name__config_info_post", "parameters": [{"required": true, "schema": {"$ref": "#/components/schemas/BackendType"}, "name": "backend_name", "in": "path"}, {"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}], "title": "Response Get Backend Config Info Api Project  Project Name  Backends  Backend Name  Config Info Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/create_yaml": {"post": {"tags": ["backends"], "summary": "Create Backend Yaml", "operationId": "create_backend_yaml_api_project__project_name__backends_create_yaml_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateBackendYAMLRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/update_yaml": {"post": {"tags": ["backends"], "summary": "Update Backend Yaml", "operationId": "update_backend_yaml_api_project__project_name__backends_update_yaml_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/UpdateBackendYAMLRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/{backend_name}/get_yaml": {"post": {"tags": ["backends"], "summary": "Get Backend Yaml", "operationId": "get_backend_yaml_api_project__project_name__backends__backend_name__get_yaml_post", "parameters": [{"required": true, "schema": {"$ref": "#/components/schemas/BackendType"}, "name": "backend_name", "in": "path"}, {"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/BackendInfoYAMLRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/pools/list_instances": {"post": {"tags": ["pool"], "summary": "List Pool Instances", "description": "Returns all instances visible to user sorted by descending created_at.\nA **project_name** and **pool_name** can be specified as filters.\n\nThe results are paginated. To get the next page, pass created_at and id of\nthe last run from the previous page as **prev_created_at** and **prev_id**.", "operationId": "list_pool_instances_api_pools_list_instances_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListPoolsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/InstanceRequest"}, "type": "array", "title": "Response List Pool Instances Api Pools List Instances Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/list": {"post": {"tags": ["pool"], "summary": "List Pool", "operationId": "list_pool_api_project__project_name__pool_list_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/PoolRequest"}, "type": "array", "title": "Response List Pool Api Project  Project Name  Pool List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/create": {"post": {"tags": ["pool"], "summary": "Create Pool", "operationId": "create_pool_api_project__project_name__pool_create_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreatePoolRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/set_default": {"post": {"tags": ["pool"], "summary": "Set Default Pool", "operationId": "set_default_pool_api_project__project_name__pool_set_default_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/SetDefaultPoolRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/delete": {"post": {"tags": ["pool"], "summary": "Delete Pool", "operationId": "delete_pool_api_project__project_name__pool_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeletePoolRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/show": {"post": {"tags": ["pool"], "summary": "Show Pool", "operationId": "show_pool_api_project__project_name__pool_show_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/ShowPoolRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/PoolInstancesRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/remove": {"post": {"tags": ["pool"], "summary": "Remove Instance", "operationId": "remove_instance_api_project__project_name__pool_remove_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/RemoveInstanceRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/add_remote": {"post": {"tags": ["pool"], "summary": "Add Instance", "operationId": "add_instance_api_project__project_name__pool_add_remote_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/AddRemoteInstanceRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/InstanceRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/fleets/list": {"post": {"tags": ["fleets"], "summary": "List Fleets", "operationId": "list_fleets_api_project__project_name__fleets_list_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/FleetRequest"}, "type": "array", "title": "Response List Fleets Api Project  Project Name  Fleets List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/fleets/get": {"post": {"tags": ["fleets"], "summary": "Get Fleet", "operationId": "get_fleet_api_project__project_name__fleets_get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetFleetRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/FleetRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/fleets/create": {"post": {"tags": ["fleets"], "summary": "Create Fleet", "operationId": "create_fleet_api_project__project_name__fleets_create_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateFleetRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/FleetRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/fleets/delete": {"post": {"tags": ["fleets"], "summary": "Delete Fleets", "operationId": "delete_fleets_api_project__project_name__fleets_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteFleetsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/fleets/delete_instances": {"post": {"tags": ["fleets"], "summary": "Delete Fleet Instances", "operationId": "delete_fleet_instances_api_project__project_name__fleets_delete_instances_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteFleetInstancesRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/repos/list": {"post": {"tags": ["repos"], "summary": "List Repos", "operationId": "list_repos_api_project__project_name__repos_list_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/RepoHeadRequest"}, "type": "array", "title": "Response List Repos Api Project  Project Name  Repos List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/repos/get": {"post": {"tags": ["repos"], "summary": "Get Repo", "operationId": "get_repo_api_project__project_name__repos_get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetRepoRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RepoHeadWithCredsRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/repos/init": {"post": {"tags": ["repos"], "summary": "Init Repo", "operationId": "init_repo_api_project__project_name__repos_init_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/SaveRepoCredsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/repos/delete": {"post": {"tags": ["repos"], "summary": "Delete Repos", "operationId": "delete_repos_api_project__project_name__repos_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteReposRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/repos/upload_code": {"post": {"tags": ["repos"], "summary": "Upload Code", "operationId": "upload_code_api_project__project_name__repos_upload_code_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}, {"required": true, "schema": {"type": "string", "title": "Repo Id"}, "name": "repo_id", "in": "query"}], "requestBody": {"content": {"multipart/form-data": {"schema": {"$ref": "#/components/schemas/Body_upload_code_api_project__project_name__repos_upload_code_post"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/runs/list": {"post": {"tags": ["runs"], "summary": "List Runs", "description": "Returns all runs visible to user sorted by descending submitted_at.\nA **project_name**, **repo_id**, and **username** can be specified as filters.\nSpecifying **repo_id** without **project_name** returns no runs.\n\nThe results are paginated. To get the next page, pass submitted_at and id of\nthe last run from the previous page as **prev_submitted_at** and **prev_run_id**.", "operationId": "list_runs_api_runs_list_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListRunsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/RunRequest"}, "type": "array", "title": "Response List Runs Api Runs List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/get": {"post": {"tags": ["runs"], "summary": "Get Run", "operationId": "get_run_api_project__project_name__runs_get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetRunRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RunRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/get_plan": {"post": {"tags": ["runs"], "summary": "Get Run Plan", "operationId": "get_run_plan_api_project__project_name__runs_get_plan_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetRunPlanRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RunPlanRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/submit": {"post": {"tags": ["runs"], "summary": "Submit Run", "operationId": "submit_run_api_project__project_name__runs_submit_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/SubmitRunRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RunRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/stop": {"post": {"tags": ["runs"], "summary": "Stop Runs", "operationId": "stop_runs_api_project__project_name__runs_stop_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/StopRunsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/delete": {"post": {"tags": ["runs"], "summary": "Delete Runs", "operationId": "delete_runs_api_project__project_name__runs_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteRunsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/get_offers": {"post": {"tags": ["runs"], "summary": "Get Offers", "operationId": "get_offers_api_project__project_name__runs_get_offers_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetOffersRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/PoolInstanceOffersRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/create_instance": {"post": {"tags": ["runs"], "summary": "Create Instance", "operationId": "create_instance_api_project__project_name__runs_create_instance_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateInstanceRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/InstanceRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/logs/poll": {"post": {"tags": ["logs"], "summary": "Poll Logs", "operationId": "poll_logs_api_project__project_name__logs_poll_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/PollLogsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/JobSubmissionLogsRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/secrets/list": {"post": {"tags": ["secrets"], "summary": "List Secrets", "operationId": "list_secrets_api_project__project_name__secrets_list_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListSecretsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/RunRequest"}, "type": "array", "title": "Response List Secrets Api Project  Project Name  Secrets List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/project/{project_name}/secrets/get": {"post": {"tags": ["secrets"], "summary": "Get Secret", "operationId": "get_secret_api_project__project_name__secrets_get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetSecretsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SecretRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/project/{project_name}/secrets/add": {"post": {"tags": ["secrets"], "summary": "Add Or Update Secret", "operationId": "add_or_update_secret_api_project__project_name__secrets_add_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/AddSecretRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SecretRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/project/{project_name}/secrets/delete": {"post": {"tags": ["secrets"], "summary": "Delete Secrets", "operationId": "delete_secrets_api_project__project_name__secrets_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteSecretsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/project/{project_name}/gateways/list": {"post": {"tags": ["gateways"], "summary": "List Gateways", "operationId": "list_gateways_api_project__project_name__gateways_list_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/GatewayRequest"}, "type": "array", "title": "Response List Gateways Api Project  Project Name  Gateways List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/gateways/get": {"post": {"tags": ["gateways"], "summary": "Get Gateway", "operationId": "get_gateway_api_project__project_name__gateways_get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetGatewayRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GatewayRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/gateways/create": {"post": {"tags": ["gateways"], "summary": "Create Gateway", "operationId": "create_gateway_api_project__project_name__gateways_create_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateGatewayRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GatewayRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/gateways/delete": {"post": {"tags": ["gateways"], "summary": "Delete Gateways", "operationId": "delete_gateways_api_project__project_name__gateways_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteGatewaysRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/gateways/set_default": {"post": {"tags": ["gateways"], "summary": "Set Default Gateway", "operationId": "set_default_gateway_api_project__project_name__gateways_set_default_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/SetDefaultGatewayRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/gateways/set_wildcard_domain": {"post": {"tags": ["gateways"], "summary": "Set Gateway Wildcard Domain", "operationId": "set_gateway_wildcard_domain_api_project__project_name__gateways_set_wildcard_domain_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/SetWildcardDomainRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GatewayRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/volumes/list": {"post": {"tags": ["volumes"], "summary": "List Volumes", "operationId": "list_volumes_api_project__project_name__volumes_list_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/VolumeRequest"}, "type": "array", "title": "Response List Volumes Api Project  Project Name  Volumes List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/volumes/get": {"post": {"tags": ["volumes"], "summary": "Get Volume", "operationId": "get_volume_api_project__project_name__volumes_get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetVolumeRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/VolumeRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/volumes/create": {"post": {"tags": ["volumes"], "summary": "Create Volume", "operationId": "create_volume_api_project__project_name__volumes_create_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateVolumeRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/VolumeRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/volumes/delete": {"post": {"tags": ["volumes"], "summary": "Delete Volumes", "operationId": "delete_volumes_api_project__project_name__volumes_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteVolumesRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/healthcheck": {"get": {"summary": "Healthcheck", "operationId": "healthcheck_healthcheck_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/": {"get": {"summary": "Index", "operationId": "index__get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}}, "components": {"schemas": {"ACMGatewayCertificateRequest": {"properties": {"type": {"type": "string", "enum": ["acm"], "title": "Type", "description": "Certificates by AWS Certificate Manager (ACM)", "default": "acm"}, "arn": {"type": "string", "title": "Arn", "description": "The ARN of the wildcard ACM certificate for the domain"}}, "additionalProperties": false, "type": "object", "required": ["arn"], "title": "ACMGatewayCertificateRequest"}, "AWSAccessKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["access_key"], "title": "Type", "description": "The type of credentials", "default": "access_key"}, "access_key": {"type": "string", "title": "Access Key", "description": "The access key"}, "secret_key": {"type": "string", "title": "Secret Key", "description": "The secret key"}}, "additionalProperties": false, "type": "object", "required": ["access_key", "secret_key"], "title": "AWSAccessKeyCredsRequest"}, "AWSConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["aws"], "title": "Type", "default": "aws"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "vpc_name": {"type": "string", "title": "Vpc Name"}, "vpc_ids": {"additionalProperties": {"type": "string"}, "type": "object", "title": "Vpc Ids"}, "default_vpcs": {"type": "boolean", "title": "Default Vpcs"}, "public_ips": {"type": "boolean", "title": "Public Ips"}}, "additionalProperties": false, "type": "object", "title": "AWSConfigInfoRequest"}, "AWSConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["aws"], "title": "Type", "default": "aws"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/AWSAccessKeyCredsRequest"}, {"$ref": "#/components/schemas/AWSDefaultCredsRequest"}], "title": "Creds"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "vpc_name": {"type": "string", "title": "Vpc Name"}, "vpc_ids": {"additionalProperties": {"type": "string"}, "type": "object", "title": "Vpc Ids"}, "default_vpcs": {"type": "boolean", "title": "Default Vpcs"}, "public_ips": {"type": "boolean", "title": "Public Ips"}}, "additionalProperties": false, "type": "object", "title": "AWSConfigInfoWithCredsPartialRequest"}, "AWSConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["aws"], "title": "Type", "default": "aws"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "vpc_name": {"type": "string", "title": "Vpc Name"}, "vpc_ids": {"additionalProperties": {"type": "string"}, "type": "object", "title": "Vpc Ids"}, "default_vpcs": {"type": "boolean", "title": "Default Vpcs"}, "public_ips": {"type": "boolean", "title": "Public Ips"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/AWSAccessKeyCredsRequest"}, {"$ref": "#/components/schemas/AWSDefaultCredsRequest"}], "title": "Creds"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "AWSConfigInfoWithCredsRequest"}, "AWSConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["aws"], "title": "Type", "default": "aws"}, "default_creds": {"type": "boolean", "title": "Default Creds", "default": false}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "AWSConfigValuesRequest"}, "AWSDefaultCredsRequest": {"properties": {"type": {"type": "string", "enum": ["default"], "title": "Type", "description": "The type of credentials", "default": "default"}}, "additionalProperties": false, "type": "object", "title": "AWSDefaultCredsRequest"}, "AddRemoteInstanceRequestRequest": {"properties": {"pool_name": {"type": "string", "title": "Pool Name"}, "instance_name": {"type": "string", "title": "Instance Name"}, "instance_network": {"type": "string", "title": "Instance Network"}, "region": {"type": "string", "title": "Region"}, "host": {"type": "string", "title": "Host"}, "port": {"type": "integer", "title": "Port"}, "ssh_user": {"type": "string", "title": "Ssh User"}, "ssh_keys": {"items": {"$ref": "#/components/schemas/SSHKeyRequest"}, "type": "array", "title": "Ssh Keys"}}, "additionalProperties": false, "type": "object", "required": ["host", "port", "ssh_user", "ssh_keys"], "title": "AddRemoteInstanceRequestRequest"}, "AddSecretRequestRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}, "secret": {"$ref": "#/components/schemas/SecretRequest"}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "secret"], "title": "AddSecretRequestRequest"}, "AppSpecRequest": {"properties": {"port": {"type": "integer", "title": "Port"}, "map_to_port": {"type": "integer", "title": "Map To Port"}, "app_name": {"type": "string", "title": "App Name"}, "url_path": {"type": "string", "title": "Url Path"}, "url_query_params": {"additionalProperties": {"type": "string"}, "type": "object", "title": "Url Query Params"}}, "additionalProperties": false, "type": "object", "required": ["port", "app_name"], "title": "AppSpecRequest"}, "AzureClientCredsRequest": {"properties": {"type": {"type": "string", "enum": ["client"], "title": "Type", "description": "The type of credentials", "default": "client"}, "client_id": {"type": "string", "title": "Client Id", "description": "The client ID"}, "client_secret": {"type": "string", "title": "Client Secret", "description": "The client secret"}, "tenant_id": {"type": "string", "title": "Tenant Id"}}, "additionalProperties": false, "type": "object", "required": ["client_id", "client_secret"], "title": "AzureClientCredsRequest"}, "AzureConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["azure"], "title": "Type", "default": "azure"}, "tenant_id": {"type": "string", "title": "Tenant Id"}, "subscription_id": {"type": "string", "title": "Subscription Id"}, "locations": {"items": {"type": "string"}, "type": "array", "title": "Locations"}}, "additionalProperties": false, "type": "object", "required": ["tenant_id", "subscription_id"], "title": "AzureConfigInfoRequest"}, "AzureConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["azure"], "title": "Type", "default": "azure"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/AzureClientCredsRequest"}, {"$ref": "#/components/schemas/AzureDefaultCredsRequest"}], "title": "Creds"}, "tenant_id": {"type": "string", "title": "Tenant Id"}, "subscription_id": {"type": "string", "title": "Subscription Id"}, "locations": {"items": {"type": "string"}, "type": "array", "title": "Locations"}}, "additionalProperties": false, "type": "object", "title": "AzureConfigInfoWithCredsPartialRequest"}, "AzureConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["azure"], "title": "Type", "default": "azure"}, "tenant_id": {"type": "string", "title": "Tenant Id"}, "subscription_id": {"type": "string", "title": "Subscription Id"}, "locations": {"items": {"type": "string"}, "type": "array", "title": "Locations"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/AzureClientCredsRequest"}, {"$ref": "#/components/schemas/AzureDefaultCredsRequest"}], "title": "Creds"}}, "additionalProperties": false, "type": "object", "required": ["tenant_id", "subscription_id", "creds"], "title": "AzureConfigInfoWithCredsRequest"}, "AzureConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["azure"], "title": "Type", "default": "azure"}, "default_creds": {"type": "boolean", "title": "Default Creds", "default": false}, "tenant_id": {"$ref": "#/components/schemas/ConfigElementRequest"}, "subscription_id": {"$ref": "#/components/schemas/ConfigElementRequest"}, "locations": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "AzureConfigValuesRequest"}, "AzureDefaultCredsRequest": {"properties": {"type": {"type": "string", "enum": ["default"], "title": "Type", "description": "The type of credentials", "default": "default"}}, "additionalProperties": false, "type": "object", "title": "AzureDefaultCredsRequest"}, "BackendInfoRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "config": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}, {"$ref": "#/components/schemas/DstackBaseBackendConfigInfoRequest"}], "title": "Config"}}, "additionalProperties": false, "type": "object", "required": ["name", "config"], "title": "BackendInfoRequest"}, "BackendInfoYAMLRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "config_yaml": {"type": "string", "title": "Config Yaml"}}, "additionalProperties": false, "type": "object", "required": ["name", "config_yaml"], "title": "BackendInfoYAMLRequest"}, "BackendType": {"type": "string", "enum": ["aws", "azure", "cudo", "datacrunch", "dstack", "gcp", "kubernetes", "lambda", "local", "remote", "nebius", "oci", "runpod", "tensordock", "vastai"], "title": "BackendType", "description": "Attributes:\n    AWS (BackendType): Amazon Web Services\n    AZURE (BackendType): Microsoft Azure\n    CUDO (BackendType): Cudo\n    DSTACK (BackendType): dstack Sky\n    GCP (BackendType): Google Cloud Platform\n    DATACRUNCH (BackendType): DataCrunch\n    KUBERNETES (BackendType): Kubernetes\n    LAMBDA (BackendType): Lambda Cloud\n    RUNPOD (BackendType): Runpod Cloud\n    TENSORDOCK (BackendType): TensorDock Marketplace\n    VASTAI (BackendType): Vast.ai Marketplace"}, "Body_upload_code_api_project__project_name__repos_upload_code_post": {"properties": {"file": {"type": "string", "format": "binary", "title": "File"}}, "type": "object", "required": ["file"], "title": "Body_upload_code_api_project__project_name__repos_upload_code_post"}, "ConfigElementRequest": {"properties": {"selected": {"type": "string", "title": "Selected"}, "values": {"items": {"$ref": "#/components/schemas/ConfigElementValueRequest"}, "type": "array", "title": "Values", "default": []}}, "additionalProperties": false, "type": "object", "title": "ConfigElementRequest"}, "ConfigElementValueRequest": {"properties": {"value": {"type": "string", "title": "Value"}, "label": {"type": "string", "title": "Label"}}, "additionalProperties": false, "type": "object", "required": ["value", "label"], "title": "ConfigElementValueRequest"}, "ConfigMultiElementRequest": {"properties": {"selected": {"items": {"type": "string"}, "type": "array", "title": "Selected", "default": []}, "values": {"items": {"$ref": "#/components/schemas/ConfigElementValueRequest"}, "type": "array", "title": "Values", "default": []}}, "additionalProperties": false, "type": "object", "title": "ConfigMultiElementRequest"}, "CreateBackendYAMLRequestRequest": {"properties": {"config_yaml": {"type": "string", "title": "Config Yaml"}}, "additionalProperties": false, "type": "object", "required": ["config_yaml"], "title": "CreateBackendYAMLRequestRequest"}, "CreateFleetRequestRequest": {"properties": {"spec": {"$ref": "#/components/schemas/FleetSpecRequest"}}, "additionalProperties": false, "type": "object", "required": ["spec"], "title": "CreateFleetRequestRequest"}, "CreateGatewayRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "backend_type": {"$ref": "#/components/schemas/BackendType"}, "region": {"type": "string", "title": "Region"}, "configuration": {"$ref": "#/components/schemas/GatewayConfigurationRequest"}}, "additionalProperties": false, "type": "object", "title": "CreateGatewayRequestRequest"}, "CreateInstanceRequestRequest": {"properties": {"profile": {"$ref": "#/components/schemas/ProfileRequest"}, "requirements": {"$ref": "#/components/schemas/RequirementsRequest"}}, "additionalProperties": false, "type": "object", "required": ["profile", "requirements"], "title": "CreateInstanceRequestRequest"}, "CreatePoolRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}}, "additionalProperties": false, "type": "object", "required": ["name"], "title": "CreatePoolRequestRequest"}, "CreateProjectRequestRequest": {"properties": {"project_name": {"type": "string", "title": "Project Name"}}, "additionalProperties": false, "type": "object", "required": ["project_name"], "title": "CreateProjectRequestRequest"}, "CreateUserRequestRequest": {"properties": {"username": {"type": "string", "title": "Username"}, "global_role": {"$ref": "#/components/schemas/GlobalRole"}, "email": {"type": "string", "title": "Email"}}, "additionalProperties": false, "type": "object", "required": ["username", "global_role"], "title": "CreateUserRequestRequest"}, "CreateVolumeRequestRequest": {"properties": {"configuration": {"$ref": "#/components/schemas/VolumeConfigurationRequest"}}, "additionalProperties": false, "type": "object", "required": ["configuration"], "title": "CreateVolumeRequestRequest"}, "CreationPolicy": {"type": "string", "enum": ["reuse", "reuse-or-create"], "title": "CreationPolicy", "description": "An enumeration."}, "CudoAPIKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["api_key"], "title": "Type", "description": "The type of credentials", "default": "api_key"}, "api_key": {"type": "string", "title": "Api Key", "description": "The API key"}}, "additionalProperties": false, "type": "object", "required": ["api_key"], "title": "CudoAPIKeyCredsRequest"}, "CudoConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["cudo"], "title": "Type", "default": "cudo"}, "project_id": {"type": "string", "title": "Project Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "required": ["project_id"], "title": "CudoConfigInfoRequest"}, "CudoConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["cudo"], "title": "Type", "default": "cudo"}, "creds": {"$ref": "#/components/schemas/CudoAPIKeyCredsRequest"}, "project_id": {"type": "string", "title": "Project Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "CudoConfigInfoWithCredsPartialRequest"}, "CudoConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["cudo"], "title": "Type", "default": "cudo"}, "project_id": {"type": "string", "title": "Project Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/CudoAPIKeyCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["project_id", "creds"], "title": "CudoConfigInfoWithCredsRequest"}, "CudoConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["cudo"], "title": "Type", "default": "cudo"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}, "project_id": {"$ref": "#/components/schemas/ConfigElementRequest"}}, "additionalProperties": false, "type": "object", "title": "CudoConfigValuesRequest"}, "DataCrunchAPIKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["api_key"], "title": "Type", "description": "The type of credentials", "default": "api_key"}, "client_id": {"type": "string", "title": "Client Id", "description": "The client ID"}, "client_secret": {"type": "string", "title": "Client Secret", "description": "The client secret"}}, "additionalProperties": false, "type": "object", "required": ["client_id", "client_secret"], "title": "DataCrunchAPIKeyCredsRequest"}, "DataCrunchConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["datacrunch"], "title": "Type", "default": "datacrunch"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "DataCrunchConfigInfoRequest"}, "DataCrunchConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["datacrunch"], "title": "Type", "default": "datacrunch"}, "creds": {"$ref": "#/components/schemas/DataCrunchAPIKeyCredsRequest"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "DataCrunchConfigInfoWithCredsPartialRequest"}, "DataCrunchConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["datacrunch"], "title": "Type", "default": "datacrunch"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/DataCrunchAPIKeyCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "DataCrunchConfigInfoWithCredsRequest"}, "DataCrunchConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["datacrunch"], "title": "Type", "default": "datacrunch"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "DataCrunchConfigValuesRequest"}, "DeleteBackendsRequestRequest": {"properties": {"backends_names": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array"}}, "additionalProperties": false, "type": "object", "required": ["backends_names"], "title": "DeleteBackendsRequestRequest"}, "DeleteFleetInstancesRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "instance_nums": {"items": {"type": "integer"}, "type": "array", "title": "Instance Nums"}}, "additionalProperties": false, "type": "object", "required": ["name", "instance_nums"], "title": "DeleteFleetInstancesRequestRequest"}, "DeleteFleetsRequestRequest": {"properties": {"names": {"items": {"type": "string"}, "type": "array", "title": "Names"}}, "additionalProperties": false, "type": "object", "required": ["names"], "title": "DeleteFleetsRequestRequest"}, "DeleteGatewaysRequestRequest": {"properties": {"names": {"items": {"type": "string"}, "type": "array", "title": "Names"}}, "additionalProperties": false, "type": "object", "required": ["names"], "title": "DeleteGatewaysRequestRequest"}, "DeletePoolRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "force": {"type": "boolean", "title": "Force"}}, "additionalProperties": false, "type": "object", "required": ["name", "force"], "title": "DeletePoolRequestRequest"}, "DeleteProjectsRequestRequest": {"properties": {"projects_names": {"items": {"type": "string"}, "type": "array", "title": "Projects Names"}}, "additionalProperties": false, "type": "object", "required": ["projects_names"], "title": "DeleteProjectsRequestRequest"}, "DeleteReposRequestRequest": {"properties": {"repos_ids": {"items": {"type": "string"}, "type": "array", "title": "Repos Ids"}}, "additionalProperties": false, "type": "object", "required": ["repos_ids"], "title": "DeleteReposRequestRequest"}, "DeleteRunsRequestRequest": {"properties": {"runs_names": {"items": {"type": "string"}, "type": "array", "title": "Runs Names"}}, "additionalProperties": false, "type": "object", "required": ["runs_names"], "title": "DeleteRunsRequestRequest"}, "DeleteSecretsRequestRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}, "secrets_names": {"items": {"type": "string"}, "type": "array", "title": "Secrets Names"}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "secrets_names"], "title": "DeleteSecretsRequestRequest"}, "DeleteUsersRequestRequest": {"properties": {"users": {"items": {"type": "string"}, "type": "array", "title": "Users"}}, "additionalProperties": false, "type": "object", "required": ["users"], "title": "DeleteUsersRequestRequest"}, "DeleteVolumesRequestRequest": {"properties": {"names": {"items": {"type": "string"}, "type": "array", "title": "Names"}}, "additionalProperties": false, "type": "object", "required": ["names"], "title": "DeleteVolumesRequestRequest"}, "DevEnvironmentConfigurationRequest": {"properties": {"ide": {"type": "string", "enum": ["vscode"], "title": "Ide", "description": "The IDE to run"}, "version": {"type": "string", "title": "Version", "description": "The version of the IDE"}, "init": {"items": {"type": "string"}, "type": "array", "title": "Init", "description": "The bash commands to run", "default": []}, "type": {"type": "string", "enum": ["dev-environment"], "title": "Type", "default": "dev-environment"}, "name": {"type": "string", "title": "Name", "description": "The run name"}, "image": {"type": "string", "title": "Image", "description": "The name of the Docker image to run"}, "entrypoint": {"type": "string", "title": "Entrypoint", "description": "The Docker entrypoint"}, "working_dir": {"type": "string", "title": "Working Dir", "description": "The path to the working directory inside the container. It's specified relative to the repository directory (`/workflow`) and should be inside it. Defaults to `\".\"` "}, "home_dir": {"type": "string", "title": "Home Dir", "description": "The absolute path to the home directory inside the container. Defaults to `/root`", "default": "/root"}, "registry_auth": {"allOf": [{"$ref": "#/components/schemas/RegistryAuthRequest"}], "title": "Registry Auth", "description": "Credentials for pulling a private Docker image"}, "python": {"allOf": [{"$ref": "#/components/schemas/PythonVersion"}], "description": "The major version of Python. Mutually exclusive with `image`"}, "env": {"anyOf": [{"items": {"type": "string", "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*(=.*$|$)"}, "type": "array"}, {"additionalProperties": {"anyOf": [{"type": "string"}, {"$ref": "#/components/schemas/EnvSentinelRequest"}]}, "type": "object"}], "title": "Env", "description": "The mapping or the list of environment variables", "default": {}}, "setup": {"items": {"type": "string"}, "type": "array", "title": "Setup", "description": "The bash commands to run on the boot", "default": []}, "resources": {"allOf": [{"$ref": "#/components/schemas/ResourcesSpecRequest"}], "title": "Resources", "description": "The resources requirements to run the configuration", "default": {"cpu": {"min": 2}, "memory": {"min": 8.0}, "disk": {"size": {"min": 100.0}}}}, "volumes": {"items": {"$ref": "#/components/schemas/VolumeMountPointRequest"}, "type": "array", "title": "Volumes", "description": "The volumes mount points", "default": []}, "ports": {"items": {"anyOf": [{"type": "integer", "maximum": 65536.0, "exclusiveMinimum": 0.0}, {"type": "string", "pattern": "^(?:[0-9]+|\\*):[0-9]+$"}, {"$ref": "#/components/schemas/PortMappingRequest"}]}, "type": "array", "title": "Ports", "description": "Port numbers/mapping to expose", "default": []}, "backends": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array", "description": "The backends to consider for provisioning (e.g., `[aws, gcp]`)"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions", "description": "The regions to consider for provisioning (e.g., `[eu-west-1, us-west4, westeurope]`)"}, "instance_types": {"items": {"type": "string"}, "type": "array", "title": "Instance Types", "description": "The cloud-specific instance types to consider for provisioning (e.g., `[p3.8xlarge, n1-standard-4]`)"}, "spot_policy": {"allOf": [{"$ref": "#/components/schemas/SpotPolicy"}], "description": "The policy for provisioning spot or on-demand instances: `spot`, `on-demand`, or `auto`"}, "retry": {"anyOf": [{"$ref": "#/components/schemas/ProfileRetryRequest"}, {"type": "boolean"}], "title": "Retry", "description": "The policy for resubmitting the run. Defaults to `false`"}, "retry_policy": {"allOf": [{"$ref": "#/components/schemas/ProfileRetryPolicyRequest"}], "title": "Retry Policy", "description": "The policy for resubmitting the run. Deprecated in favor of `retry`"}, "max_duration": {"anyOf": [{"type": "string", "enum": ["off"]}, {"type": "string"}, {"type": "integer"}], "title": "Max Duration", "description": "The maximum duration of a run (e.g., `2h`, `1d`, etc). After it elapses, the run is forced to stop. Defaults to `off`"}, "max_price": {"type": "number", "exclusiveMinimum": 0.0, "title": "Max Price", "description": "The maximum instance price per hour, in dollars"}, "pool_name": {"type": "string", "title": "Pool Name", "description": "The name of the pool. If not set, dstack will use the default name"}, "instance_name": {"type": "string", "title": "Instance Name", "description": "The name of the instance"}, "creation_policy": {"allOf": [{"$ref": "#/components/schemas/CreationPolicy"}], "description": "The policy for using instances from the pool. Defaults to `reuse-or-create`"}, "termination_policy": {"allOf": [{"$ref": "#/components/schemas/TerminationPolicy"}], "description": "The policy for instance termination. Defaults to `destroy-after-idle`"}, "termination_idle_time": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Termination Idle Time", "description": "Time to wait before destroying the idle instance. Defaults to `5m` for `dstack run` and to `3d` for `dstack pool add`"}}, "additionalProperties": false, "type": "object", "required": ["ide"], "title": "DevEnvironmentConfigurationRequest"}, "DiskRequest": {"properties": {"size_mib": {"type": "integer", "title": "Size Mib"}}, "additionalProperties": false, "type": "object", "required": ["size_mib"], "title": "DiskRequest"}, "DiskSpecRequest": {"properties": {"size": {"allOf": [{"$ref": "#/components/schemas/Range_Memory_"}], "title": "Size", "description": "Disk size"}}, "additionalProperties": false, "type": "object", "required": ["size"], "title": "DiskSpecRequest"}, "DstackBaseBackendConfigInfoRequest": {"properties": {"type": {"type": "string", "title": "Type"}}, "additionalProperties": false, "type": "object", "required": ["type"], "title": "DstackBaseBackendConfigInfoRequest"}, "DstackConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["dstack"], "title": "Type", "default": "dstack"}, "base_backends": {"items": {"type": "string"}, "type": "array", "title": "Base Backends"}}, "additionalProperties": false, "type": "object", "required": ["base_backends"], "title": "DstackConfigInfoRequest", "description": "This is a config model of DstackBackend stored in BackendModel.config and used by DstackConfigurator."}, "DstackConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["dstack"], "title": "Type", "default": "dstack"}}, "additionalProperties": false, "type": "object", "title": "DstackConfigValuesRequest"}, "EnvSentinelRequest": {"properties": {"key": {"type": "string", "title": "Key"}}, "additionalProperties": false, "type": "object", "required": ["key"], "title": "EnvSentinelRequest"}, "FleetConfigurationRequest": {"properties": {"type": {"type": "string", "enum": ["fleet"], "title": "Type", "default": "fleet"}, "name": {"type": "string", "title": "Name", "description": "The fleet name"}, "ssh_config": {"allOf": [{"$ref": "#/components/schemas/SSHParamsRequest"}], "title": "Ssh Config", "description": "The parameters for adding instances via SSH"}, "nodes": {"allOf": [{"$ref": "#/components/schemas/Range_int_"}], "title": "Nodes", "description": "The number of instances"}, "placement": {"allOf": [{"$ref": "#/components/schemas/InstanceGroupPlacement"}], "description": "The placement of instances: `any` or `cluster`"}, "resources": {"allOf": [{"$ref": "#/components/schemas/ResourcesSpecRequest"}], "title": "Resources", "description": "The resources requirements", "default": {"cpu": {"min": 2}, "memory": {"min": 8.0}, "disk": {"size": {"min": 100.0}}}}, "backends": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array", "description": "The backends to consider for provisioning (e.g., `[aws, gcp]`)"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions", "description": "The regions to consider for provisioning (e.g., `[eu-west-1, us-west4, westeurope]`)"}, "instance_types": {"items": {"type": "string"}, "type": "array", "title": "Instance Types", "description": "The cloud-specific instance types to consider for provisioning (e.g., `[p3.8xlarge, n1-standard-4]`)"}, "spot_policy": {"allOf": [{"$ref": "#/components/schemas/SpotPolicy"}], "description": "The policy for provisioning spot or on-demand instances: `spot`, `on-demand`, or `auto`"}, "retry": {"anyOf": [{"$ref": "#/components/schemas/ProfileRetryRequest"}, {"type": "boolean"}], "title": "Retry", "description": "The policy for provisioning retry. Defaults to `false`"}, "max_price": {"type": "number", "exclusiveMinimum": 0.0, "title": "Max Price", "description": "The maximum instance price per hour, in dollars"}, "termination_policy": {"allOf": [{"$ref": "#/components/schemas/TerminationPolicy"}], "description": "The policy for instance termination. Defaults to `destroy-after-idle`"}, "termination_idle_time": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Termination Idle Time", "description": "Time to wait before destroying idle instances. Defaults to `3d`"}}, "additionalProperties": false, "type": "object", "title": "FleetConfigurationRequest"}, "FleetRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "project_name": {"type": "string", "title": "Project Name"}, "spec": {"$ref": "#/components/schemas/FleetSpecRequest"}, "created_at": {"type": "string", "format": "date-time", "title": "Created At"}, "status": {"$ref": "#/components/schemas/FleetStatus"}, "status_message": {"type": "string", "title": "Status Message"}, "instances": {"items": {"$ref": "#/components/schemas/InstanceRequest"}, "type": "array", "title": "Instances"}}, "additionalProperties": false, "type": "object", "required": ["name", "project_name", "spec", "created_at", "status", "instances"], "title": "FleetRequest"}, "FleetSpecRequest": {"properties": {"configuration": {"$ref": "#/components/schemas/FleetConfigurationRequest"}, "profile": {"$ref": "#/components/schemas/ProfileRequest"}, "autocreated": {"type": "boolean", "title": "Autocreated", "default": false}}, "additionalProperties": false, "type": "object", "required": ["configuration", "profile"], "title": "FleetSpecRequest"}, "FleetStatus": {"type": "string", "enum": ["submitted", "active", "terminating", "terminated", "failed"], "title": "FleetStatus", "description": "An enumeration."}, "GCPConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["gcp"], "title": "Type", "default": "gcp"}, "project_id": {"type": "string", "title": "Project Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "vpc_name": {"type": "string", "title": "Vpc Name"}, "vpc_project_id": {"type": "string", "title": "Vpc Project Id"}, "public_ips": {"type": "boolean", "title": "Public Ips"}}, "additionalProperties": false, "type": "object", "required": ["project_id"], "title": "GCPConfigInfoRequest"}, "GCPConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["gcp"], "title": "Type", "default": "gcp"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/GCPServiceAccountCredsRequest"}, {"$ref": "#/components/schemas/GCPDefaultCredsRequest"}], "title": "Creds"}, "project_id": {"type": "string", "title": "Project Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "vpc_name": {"type": "string", "title": "Vpc Name"}, "vpc_project_id": {"type": "string", "title": "Vpc Project Id"}, "public_ips": {"type": "boolean", "title": "Public Ips"}}, "additionalProperties": false, "type": "object", "title": "GCPConfigInfoWithCredsPartialRequest"}, "GCPConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["gcp"], "title": "Type", "default": "gcp"}, "project_id": {"type": "string", "title": "Project Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "vpc_name": {"type": "string", "title": "Vpc Name"}, "vpc_project_id": {"type": "string", "title": "Vpc Project Id"}, "public_ips": {"type": "boolean", "title": "Public Ips"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/GCPServiceAccountCredsRequest"}, {"$ref": "#/components/schemas/GCPDefaultCredsRequest"}], "title": "Creds"}}, "additionalProperties": false, "type": "object", "required": ["project_id", "creds"], "title": "GCPConfigInfoWithCredsRequest"}, "GCPConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["gcp"], "title": "Type", "default": "gcp"}, "default_creds": {"type": "boolean", "title": "Default Creds", "default": false}, "project_id": {"$ref": "#/components/schemas/ConfigElementRequest"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "GCPConfigValuesRequest"}, "GCPDefaultCredsRequest": {"properties": {"type": {"type": "string", "enum": ["default"], "title": "Type", "default": "default"}}, "additionalProperties": false, "type": "object", "title": "GCPDefaultCredsRequest"}, "GCPServiceAccountCredsRequest": {"properties": {"type": {"type": "string", "enum": ["service_account"], "title": "Type", "default": "service_account"}, "filename": {"type": "string", "title": "Filename"}, "data": {"type": "string", "title": "Data"}}, "additionalProperties": false, "type": "object", "required": ["filename", "data"], "title": "GCPServiceAccountCredsRequest"}, "GPUSpecRequest": {"properties": {"name": {"items": {"type": "string"}, "type": "array", "title": "Name", "description": "The name of the GPU (e.g., `A100` or `H100`)"}, "count": {"allOf": [{"$ref": "#/components/schemas/Range_int_"}], "title": "Count", "description": "The number of GPUs", "default": {"min": 1, "max": 1}}, "memory": {"allOf": [{"$ref": "#/components/schemas/Range_Memory_"}], "title": "Memory", "description": "The RAM size (e.g., `16GB`). Can be set to a range (e.g. `16GB..`, or `16GB..80GB`)"}, "total_memory": {"allOf": [{"$ref": "#/components/schemas/Range_Memory_"}], "title": "Total Memory", "description": "The total RAM size (e.g., `32GB`). Can be set to a range (e.g. `16GB..`, or `16GB..80GB`)"}, "compute_capability": {"items": {}, "type": "array", "title": "Compute Capability", "description": "The minimum compute capability of the GPU (e.g., `7.5`)"}}, "additionalProperties": false, "type": "object", "title": "GPUSpecRequest"}, "GatewayConfigurationRequest": {"properties": {"type": {"type": "string", "enum": ["gateway"], "title": "Type", "default": "gateway"}, "name": {"type": "string", "title": "Name", "description": "The gateway name"}, "default": {"type": "boolean", "title": "Default", "description": "Make the gateway default", "default": false}, "backend": {"allOf": [{"$ref": "#/components/schemas/BackendType"}], "description": "The gateway backend"}, "region": {"type": "string", "title": "Region", "description": "The gateway region"}, "domain": {"type": "string", "title": "Domain", "description": "The gateway domain, e.g. `example.com`"}, "public_ip": {"type": "boolean", "title": "Public Ip", "description": "Allocate public IP for the gateway", "default": true}, "certificate": {"anyOf": [{"$ref": "#/components/schemas/LetsEncryptGatewayCertificateRequest"}, {"$ref": "#/components/schemas/ACMGatewayCertificateRequest"}], "title": "Certificate", "description": "The SSL certificate configuration. Defaults to `type: lets-encrypt`", "default": {"type": "lets-encrypt"}}}, "additionalProperties": false, "type": "object", "required": ["backend", "region"], "title": "GatewayConfigurationRequest"}, "GatewayRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "configuration": {"$ref": "#/components/schemas/GatewayConfigurationRequest"}, "created_at": {"type": "string", "format": "date-time", "title": "Created At"}, "status": {"$ref": "#/components/schemas/GatewayStatus"}, "status_message": {"type": "string", "title": "Status Message"}, "hostname": {"type": "string", "title": "Hostname"}, "ip_address": {"type": "string", "title": "Ip Address"}, "instance_id": {"type": "string", "title": "Instance Id"}, "backend": {"$ref": "#/components/schemas/BackendType"}, "region": {"type": "string", "title": "Region"}, "default": {"type": "boolean", "title": "Default"}, "wildcard_domain": {"type": "string", "title": "Wildcard Domain"}}, "additionalProperties": false, "type": "object", "required": ["name", "configuration", "created_at", "status", "backend", "region", "default"], "title": "GatewayRequest"}, "GatewayStatus": {"type": "string", "enum": ["submitted", "provisioning", "running", "failed"], "title": "GatewayStatus", "description": "An enumeration."}, "GetFleetRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}}, "additionalProperties": false, "type": "object", "required": ["name"], "title": "GetFleetRequestRequest"}, "GetGatewayRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}}, "additionalProperties": false, "type": "object", "required": ["name"], "title": "GetGatewayRequestRequest"}, "GetOffersRequestRequest": {"properties": {"profile": {"$ref": "#/components/schemas/ProfileRequest"}, "requirements": {"$ref": "#/components/schemas/RequirementsRequest"}}, "additionalProperties": false, "type": "object", "required": ["profile", "requirements"], "title": "GetOffersRequestRequest"}, "GetRepoRequestRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}, "include_creds": {"type": "boolean", "title": "Include Creds"}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "include_creds"], "title": "GetRepoRequestRequest"}, "GetRunPlanRequestRequest": {"properties": {"run_spec": {"$ref": "#/components/schemas/RunSpecRequest"}}, "additionalProperties": false, "type": "object", "required": ["run_spec"], "title": "GetRunPlanRequestRequest"}, "GetRunRequestRequest": {"properties": {"run_name": {"type": "string", "title": "Run Name"}}, "additionalProperties": false, "type": "object", "required": ["run_name"], "title": "GetRunRequestRequest"}, "GetSecretsRequestRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}}, "additionalProperties": false, "type": "object", "required": ["repo_id"], "title": "GetSecretsRequestRequest"}, "GetUserRequestRequest": {"properties": {"username": {"type": "string", "title": "Username"}}, "additionalProperties": false, "type": "object", "required": ["username"], "title": "GetUserRequestRequest"}, "GetVolumeRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}}, "additionalProperties": false, "type": "object", "required": ["name"], "title": "GetVolumeRequestRequest"}, "GlobalRole": {"type": "string", "enum": ["admin", "user"], "title": "GlobalRole", "description": "An enumeration."}, "GpuRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "memory_mib": {"type": "integer", "title": "Memory Mib"}}, "additionalProperties": false, "type": "object", "required": ["name", "memory_mib"], "title": "GpuRequest"}, "HTTPValidationError": {"properties": {"detail": {"items": {"$ref": "#/components/schemas/ValidationError"}, "type": "array", "title": "Detail"}}, "type": "object", "title": "HTTPValidationError"}, "InstanceAvailability": {"enum": ["unknown", "available", "not_available", "no_quota", "idle", "busy"], "title": "InstanceAvailability", "description": "An enumeration."}, "InstanceGroupPlacement": {"type": "string", "enum": ["any", "cluster"], "title": "InstanceGroupPlacement", "description": "An enumeration."}, "InstanceOfferWithAvailabilityRequest": {"properties": {"backend": {"$ref": "#/components/schemas/BackendType"}, "instance": {"$ref": "#/components/schemas/InstanceTypeRequest"}, "region": {"type": "string", "title": "Region"}, "price": {"type": "number", "title": "Price"}, "availability": {"$ref": "#/components/schemas/InstanceAvailability"}, "instance_runtime": {"allOf": [{"$ref": "#/components/schemas/InstanceRuntime"}], "default": "shim"}}, "additionalProperties": false, "type": "object", "required": ["backend", "instance", "region", "price", "availability"], "title": "InstanceOfferWithAvailabilityRequest"}, "InstanceRequest": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}, "project_name": {"type": "string", "title": "Project Name"}, "backend": {"$ref": "#/components/schemas/BackendType"}, "instance_type": {"$ref": "#/components/schemas/InstanceTypeRequest"}, "name": {"type": "string", "title": "Name"}, "instance_num": {"type": "integer", "title": "Instance Num"}, "pool_name": {"type": "string", "title": "Pool Name"}, "job_name": {"type": "string", "title": "Job Name"}, "hostname": {"type": "string", "title": "Hostname"}, "status": {"$ref": "#/components/schemas/InstanceStatus"}, "unreachable": {"type": "boolean", "title": "Unreachable", "default": false}, "created": {"type": "string", "format": "date-time", "title": "Created"}, "region": {"type": "string", "title": "Region"}, "price": {"type": "number", "title": "Price"}}, "additionalProperties": false, "type": "object", "required": ["id", "project_name", "name", "instance_num", "status", "created"], "title": "InstanceRequest"}, "InstanceRuntime": {"enum": ["shim", "runner"], "title": "InstanceRuntime", "description": "An enumeration."}, "InstanceStatus": {"type": "string", "enum": ["pending", "provisioning", "idle", "busy", "terminating", "terminated"], "title": "InstanceStatus", "description": "An enumeration."}, "InstanceTypeRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "resources": {"$ref": "#/components/schemas/ResourcesRequest"}}, "additionalProperties": false, "type": "object", "required": ["name", "resources"], "title": "InstanceTypeRequest"}, "JobPlanRequest": {"properties": {"job_spec": {"$ref": "#/components/schemas/JobSpecRequest"}, "offers": {"items": {"$ref": "#/components/schemas/InstanceOfferWithAvailabilityRequest"}, "type": "array", "title": "Offers"}, "total_offers": {"type": "integer", "title": "Total Offers"}, "max_price": {"type": "number", "title": "Max Price"}}, "additionalProperties": false, "type": "object", "required": ["job_spec", "offers", "total_offers"], "title": "JobPlanRequest"}, "JobProvisioningDataRequest": {"properties": {"backend": {"$ref": "#/components/schemas/BackendType"}, "instance_type": {"$ref": "#/components/schemas/InstanceTypeRequest"}, "instance_id": {"type": "string", "title": "Instance Id"}, "hostname": {"type": "string", "title": "Hostname"}, "internal_ip": {"type": "string", "title": "Internal Ip"}, "public_ip_enabled": {"type": "boolean", "title": "Public Ip Enabled", "default": true}, "instance_network": {"type": "string", "title": "Instance Network"}, "region": {"type": "string", "title": "Region"}, "availability_zone": {"type": "string", "title": "Availability Zone"}, "price": {"type": "number", "title": "Price"}, "username": {"type": "string", "title": "Username"}, "ssh_port": {"type": "integer", "title": "Ssh Port"}, "dockerized": {"type": "boolean", "title": "Dockerized"}, "ssh_proxy": {"$ref": "#/components/schemas/SSHConnectionParamsRequest"}, "backend_data": {"type": "string", "title": "Backend Data"}}, "additionalProperties": false, "type": "object", "required": ["backend", "instance_type", "instance_id", "region", "price", "username", "dockerized"], "title": "JobProvisioningDataRequest"}, "JobRequest": {"properties": {"job_spec": {"$ref": "#/components/schemas/JobSpecRequest"}, "job_submissions": {"items": {"$ref": "#/components/schemas/JobSubmissionRequest"}, "type": "array", "title": "Job Submissions"}}, "additionalProperties": false, "type": "object", "required": ["job_spec", "job_submissions"], "title": "JobRequest"}, "JobSpecRequest": {"properties": {"replica_num": {"type": "integer", "title": "Replica Num", "default": 0}, "job_num": {"type": "integer", "title": "Job Num"}, "job_name": {"type": "string", "title": "Job Name"}, "jobs_per_replica": {"type": "integer", "title": "Jobs Per Replica", "default": 1}, "app_specs": {"items": {"$ref": "#/components/schemas/AppSpecRequest"}, "type": "array", "title": "App Specs"}, "commands": {"items": {"type": "string"}, "type": "array", "title": "Commands"}, "env": {"additionalProperties": {"type": "string"}, "type": "object", "title": "Env"}, "home_dir": {"type": "string", "title": "Home Dir"}, "image_name": {"type": "string", "title": "Image Name"}, "max_duration": {"type": "integer", "title": "Max Duration"}, "registry_auth": {"$ref": "#/components/schemas/RegistryAuthRequest"}, "requirements": {"$ref": "#/components/schemas/RequirementsRequest"}, "retry": {"$ref": "#/components/schemas/RetryRequest"}, "retry_policy": {"allOf": [{"$ref": "#/components/schemas/ProfileRetryPolicyRequest"}], "title": "Retry Policy", "default": {"retry": false}}, "working_dir": {"type": "string", "title": "Working Dir"}}, "additionalProperties": false, "type": "object", "required": ["job_num", "job_name", "commands", "env", "image_name", "requirements"], "title": "JobSpecRequest"}, "JobStatus": {"type": "string", "enum": ["submitted", "provisioning", "pulling", "running", "terminating", "terminated", "aborted", "failed", "done"], "title": "JobStatus", "description": "An enumeration."}, "JobSubmissionLogsRequest": {"properties": {"logs": {"items": {"$ref": "#/components/schemas/LogEventRequest"}, "type": "array", "title": "Logs"}}, "additionalProperties": false, "type": "object", "required": ["logs"], "title": "JobSubmissionLogsRequest"}, "JobSubmissionRequest": {"properties": {"id": {"type": "string", "format": "uuid4", "title": "Id"}, "submission_num": {"type": "integer", "title": "Submission Num"}, "submitted_at": {"type": "string", "format": "date-time", "title": "Submitted At"}, "last_processed_at": {"type": "string", "format": "date-time", "title": "Last Processed At"}, "finished_at": {"type": "string", "format": "date-time", "title": "Finished At"}, "status": {"$ref": "#/components/schemas/JobStatus"}, "termination_reason": {"$ref": "#/components/schemas/JobTerminationReason"}, "termination_reason_message": {"type": "string", "title": "Termination Reason Message"}, "job_provisioning_data": {"$ref": "#/components/schemas/JobProvisioningDataRequest"}}, "additionalProperties": false, "type": "object", "required": ["id", "submission_num", "submitted_at", "last_processed_at", "status"], "title": "JobSubmissionRequest"}, "JobTerminationReason": {"type": "string", "enum": ["failed_to_start_due_to_no_capacity", "interrupted_by_no_capacity", "waiting_instance_limit_exceeded", "waiting_runner_limit_exceeded", "terminated_by_user", "volume_error", "gateway_error", "scaled_down", "done_by_runner", "aborted_by_user", "terminated_by_server", "container_exited_with_error", "ports_binding_failed", "creating_container_error", "executor_error"], "title": "JobTerminationReason", "description": "An enumeration."}, "KubeconfigConfigRequest": {"properties": {"filename": {"type": "string", "title": "Filename"}, "data": {"type": "string", "title": "Data"}}, "additionalProperties": false, "type": "object", "required": ["filename", "data"], "title": "KubeconfigConfigRequest"}, "KubernetesConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["kubernetes"], "title": "Type", "default": "kubernetes"}, "networking": {"$ref": "#/components/schemas/KubernetesNetworkingConfigRequest"}}, "additionalProperties": false, "type": "object", "required": ["networking"], "title": "KubernetesConfigInfoRequest"}, "KubernetesConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["kubernetes"], "title": "Type", "default": "kubernetes"}, "networking": {"$ref": "#/components/schemas/KubernetesNetworkingConfigRequest"}, "kubeconfig": {"$ref": "#/components/schemas/KubeconfigConfigRequest"}}, "additionalProperties": false, "type": "object", "required": ["networking", "kubeconfig"], "title": "KubernetesConfigInfoWithCredsPartialRequest"}, "KubernetesConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["kubernetes"], "title": "Type", "default": "kubernetes"}, "networking": {"$ref": "#/components/schemas/KubernetesNetworkingConfigRequest"}, "kubeconfig": {"$ref": "#/components/schemas/KubeconfigConfigRequest"}}, "additionalProperties": false, "type": "object", "required": ["networking", "kubeconfig"], "title": "KubernetesConfigInfoWithCredsRequest"}, "KubernetesConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["kubernetes"], "title": "Type", "default": "kubernetes"}}, "additionalProperties": false, "type": "object", "title": "KubernetesConfigValuesRequest"}, "KubernetesNetworkingConfigRequest": {"properties": {"ssh_host": {"type": "string", "title": "Ssh Host", "description": "The external IP address of any node"}, "ssh_port": {"type": "integer", "title": "Ssh Port", "description": "Any port accessible outside of the cluster"}}, "additionalProperties": false, "type": "object", "title": "KubernetesNetworkingConfigRequest"}, "LambdaAPIKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["api_key"], "title": "Type", "description": "The type of credentials", "default": "api_key"}, "api_key": {"type": "string", "title": "Api Key", "description": "The API key"}}, "additionalProperties": false, "type": "object", "required": ["api_key"], "title": "LambdaAPIKeyCredsRequest"}, "LambdaConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["lambda"], "title": "Type", "default": "lambda"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "LambdaConfigInfoRequest"}, "LambdaConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["lambda"], "title": "Type", "default": "lambda"}, "creds": {"$ref": "#/components/schemas/LambdaAPIKeyCredsRequest"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "LambdaConfigInfoWithCredsPartialRequest"}, "LambdaConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["lambda"], "title": "Type", "default": "lambda"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/LambdaAPIKeyCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "LambdaConfigInfoWithCredsRequest"}, "LambdaConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["lambda"], "title": "Type", "default": "lambda"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "LambdaConfigValuesRequest"}, "LetsEncryptGatewayCertificateRequest": {"properties": {"type": {"type": "string", "enum": ["lets-encrypt"], "title": "Type", "description": "Automatic certificates by Let's Encrypt", "default": "lets-encrypt"}}, "additionalProperties": false, "type": "object", "title": "LetsEncryptGatewayCertificateRequest"}, "ListPoolsRequestRequest": {"properties": {"project_name": {"type": "string", "title": "Project Name"}, "pool_name": {"type": "string", "title": "Pool Name"}, "only_active": {"type": "boolean", "title": "Only Active", "default": false}, "prev_created_at": {"type": "string", "format": "date-time", "title": "Prev Created At"}, "prev_id": {"type": "string", "format": "uuid", "title": "Prev Id"}, "limit": {"type": "integer", "title": "Limit", "default": 1000}, "ascending": {"type": "boolean", "title": "Ascending", "default": false}}, "additionalProperties": false, "type": "object", "title": "ListPoolsRequestRequest"}, "ListRunsRequestRequest": {"properties": {"project_name": {"type": "string", "title": "Project Name"}, "repo_id": {"type": "string", "title": "Repo Id"}, "username": {"type": "string", "title": "Username"}, "only_active": {"type": "boolean", "title": "Only Active", "default": false}, "prev_submitted_at": {"type": "string", "format": "date-time", "title": "Prev Submitted At"}, "prev_run_id": {"type": "string", "format": "uuid", "title": "Prev Run Id"}, "limit": {"type": "integer", "maximum": 100.0, "minimum": 0.0, "title": "Limit", "default": 100}, "ascending": {"type": "boolean", "title": "Ascending", "default": false}}, "additionalProperties": false, "type": "object", "title": "ListRunsRequestRequest"}, "ListSecretsRequestRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}}, "additionalProperties": false, "type": "object", "required": ["repo_id"], "title": "ListSecretsRequestRequest"}, "LocalRepoInfoRequest": {"properties": {"repo_type": {"type": "string", "enum": ["local"], "title": "Repo Type", "default": "local"}, "repo_dir": {"type": "string", "title": "Repo Dir"}}, "additionalProperties": false, "type": "object", "required": ["repo_dir"], "title": "LocalRepoInfoRequest"}, "LocalRunRepoDataRequest": {"properties": {"repo_type": {"type": "string", "enum": ["local"], "title": "Repo Type", "default": "local"}, "repo_dir": {"type": "string", "title": "Repo Dir"}}, "additionalProperties": false, "type": "object", "required": ["repo_dir"], "title": "LocalRunRepoDataRequest"}, "LogEventRequest": {"properties": {"timestamp": {"type": "string", "format": "date-time", "title": "Timestamp"}, "log_source": {"$ref": "#/components/schemas/LogEventSource"}, "message": {"type": "string", "title": "Message"}}, "additionalProperties": false, "type": "object", "required": ["timestamp", "log_source", "message"], "title": "LogEventRequest"}, "LogEventSource": {"type": "string", "enum": ["stdout", "stderr"], "title": "LogEventSource", "description": "An enumeration."}, "MemberRequest": {"properties": {"user": {"$ref": "#/components/schemas/UserRequest"}, "project_role": {"$ref": "#/components/schemas/ProjectRole"}}, "additionalProperties": false, "type": "object", "required": ["user", "project_role"], "title": "MemberRequest"}, "MemberSettingRequest": {"properties": {"username": {"type": "string", "title": "Username"}, "project_role": {"$ref": "#/components/schemas/ProjectRole"}}, "additionalProperties": false, "type": "object", "required": ["username", "project_role"], "title": "MemberSettingRequest"}, "NebiusConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["nebius"], "title": "Type", "default": "nebius"}, "cloud_id": {"type": "string", "title": "Cloud Id"}, "folder_id": {"type": "string", "title": "Folder Id"}, "network_id": {"type": "string", "title": "Network Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "required": ["cloud_id", "folder_id", "network_id"], "title": "NebiusConfigInfoRequest"}, "NebiusConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["nebius"], "title": "Type", "default": "nebius"}, "creds": {"$ref": "#/components/schemas/NebiusServiceAccountCredsRequest"}, "cloud_id": {"type": "string", "title": "Cloud Id"}, "folder_id": {"type": "string", "title": "Folder Id"}, "network_id": {"type": "string", "title": "Network Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "NebiusConfigInfoWithCredsPartialRequest"}, "NebiusConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["nebius"], "title": "Type", "default": "nebius"}, "cloud_id": {"type": "string", "title": "Cloud Id"}, "folder_id": {"type": "string", "title": "Folder Id"}, "network_id": {"type": "string", "title": "Network Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/NebiusServiceAccountCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["cloud_id", "folder_id", "network_id", "creds"], "title": "NebiusConfigInfoWithCredsRequest"}, "NebiusConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["nebius"], "title": "Type", "default": "nebius"}, "cloud_id": {"$ref": "#/components/schemas/ConfigElementRequest"}, "folder_id": {"$ref": "#/components/schemas/ConfigElementRequest"}, "network_id": {"$ref": "#/components/schemas/ConfigElementRequest"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "NebiusConfigValuesRequest"}, "NebiusServiceAccountCredsRequest": {"properties": {"type": {"type": "string", "enum": ["service_account"], "title": "Type", "default": "service_account"}, "filename": {"type": "string", "title": "Filename"}, "data": {"type": "string", "title": "Data"}}, "additionalProperties": false, "type": "object", "required": ["filename", "data"], "title": "NebiusServiceAccountCredsRequest"}, "OCIClientCredsRequest": {"properties": {"type": {"type": "string", "enum": ["client"], "title": "Type", "description": "The type of credentials", "default": "client"}, "user": {"type": "string", "title": "User", "description": "User OCID"}, "tenancy": {"type": "string", "title": "Tenancy", "description": "Tenancy OCID"}, "key_file": {"type": "string", "title": "Key File", "description": "Path to the user's private PEM key. Either this or `key_content` should be set"}, "key_content": {"type": "string", "title": "Key Content", "description": "Content of the user's private PEM key. Either this or `key_file` should be set"}, "pass_phrase": {"type": "string", "title": "Pass Phrase", "description": "Passphrase for the private PEM key if it is encrypted"}, "fingerprint": {"type": "string", "title": "Fingerprint", "description": "User's public key fingerprint"}, "region": {"type": "string", "title": "Region", "description": "Name or key of any region the tenancy is subscribed to"}}, "additionalProperties": false, "type": "object", "required": ["user", "tenancy", "fingerprint", "region"], "title": "OCIClientCredsRequest"}, "OCIConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["oci"], "title": "Type", "default": "oci"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "compartment_id": {"type": "string", "title": "Compartment Id"}}, "additionalProperties": false, "type": "object", "title": "OCIConfigInfoRequest"}, "OCIConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["oci"], "title": "Type", "default": "oci"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/OCIClientCredsRequest"}, {"$ref": "#/components/schemas/OCIDefaultCredsRequest"}], "title": "Creds"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "compartment_id": {"type": "string", "title": "Compartment Id"}}, "additionalProperties": false, "type": "object", "title": "OCIConfigInfoWithCredsPartialRequest"}, "OCIConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["oci"], "title": "Type", "default": "oci"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "compartment_id": {"type": "string", "title": "Compartment Id"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/OCIClientCredsRequest"}, {"$ref": "#/components/schemas/OCIDefaultCredsRequest"}], "title": "Creds"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "OCIConfigInfoWithCredsRequest"}, "OCIConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["oci"], "title": "Type", "default": "oci"}, "default_creds": {"type": "boolean", "title": "Default Creds", "default": false}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}, "compartment_id": {"type": "string", "title": "Compartment Id"}}, "additionalProperties": false, "type": "object", "title": "OCIConfigValuesRequest"}, "OCIDefaultCredsRequest": {"properties": {"type": {"type": "string", "enum": ["default"], "title": "Type", "description": "The type of credentials", "default": "default"}, "file": {"type": "string", "title": "File", "description": "Path to the OCI CLI-compatible config file", "default": "~/.oci/config"}, "profile": {"type": "string", "title": "Profile", "description": "Profile to load from the config file", "default": "DEFAULT"}}, "additionalProperties": false, "type": "object", "title": "OCIDefaultCredsRequest"}, "OpenAIChatModelRequest": {"properties": {"type": {"type": "string", "enum": ["chat"], "title": "Type", "description": "The type of the model"}, "name": {"type": "string", "title": "Name", "description": "The name of the model"}, "format": {"type": "string", "enum": ["openai"], "title": "Format"}, "prefix": {"type": "string", "title": "Prefix", "description": "The `base_url` prefix (after hostname)", "default": "/v1"}}, "additionalProperties": false, "type": "object", "required": ["type", "name", "format"], "title": "OpenAIChatModelRequest", "description": "Mapping of the model for the OpenAI-compatible endpoint.\n\nAttributes:\n    type (str): The type of the model, e.g. \"chat\"\n    name (str): The name of the model. This name will be used both to load model configuration from the HuggingFace Hub and in the OpenAI-compatible endpoint.\n    format (str): The format of the model, i.e. \"openai\".\n    prefix (str): The `base_url` prefix: `http://hostname/{prefix}/chat/completions`. Defaults to `/v1`."}, "PollLogsRequestRequest": {"properties": {"run_name": {"type": "string", "title": "Run Name"}, "job_submission_id": {"type": "string", "format": "uuid4", "title": "Job Submission Id"}, "start_time": {"type": "string", "format": "date-time", "title": "Start Time"}, "end_time": {"type": "string", "format": "date-time", "title": "End Time"}, "descending": {"type": "boolean", "title": "Descending", "default": false}, "limit": {"type": "integer", "maximum": 1000.0, "minimum": 0.0, "title": "Limit", "default": 100}, "diagnose": {"type": "boolean", "title": "Diagnose", "default": false}}, "additionalProperties": false, "type": "object", "required": ["run_name", "job_submission_id"], "title": "PollLogsRequestRequest"}, "PoolInstanceOffersRequest": {"properties": {"pool_name": {"type": "string", "title": "Pool Name"}, "instances": {"items": {"$ref": "#/components/schemas/InstanceOfferWithAvailabilityRequest"}, "type": "array", "title": "Instances"}}, "additionalProperties": false, "type": "object", "required": ["pool_name", "instances"], "title": "PoolInstanceOffersRequest"}, "PoolInstancesRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "instances": {"items": {"$ref": "#/components/schemas/InstanceRequest"}, "type": "array", "title": "Instances"}}, "additionalProperties": false, "type": "object", "required": ["name", "instances"], "title": "PoolInstancesRequest"}, "PoolRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "default": {"type": "boolean", "title": "Default"}, "created_at": {"type": "string", "format": "date-time", "title": "Created At"}, "total_instances": {"type": "integer", "title": "Total Instances"}, "available_instances": {"type": "integer", "title": "Available Instances"}}, "additionalProperties": false, "type": "object", "required": ["name", "default", "created_at", "total_instances", "available_instances"], "title": "PoolRequest"}, "PortMappingRequest": {"properties": {"local_port": {"type": "integer", "maximum": 65536.0, "exclusiveMinimum": 0.0, "title": "Local Port"}, "container_port": {"type": "integer", "maximum": 65536.0, "exclusiveMinimum": 0.0, "title": "Container Port"}}, "additionalProperties": false, "type": "object", "required": ["container_port"], "title": "PortMappingRequest"}, "ProfileRequest": {"properties": {"backends": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array", "description": "The backends to consider for provisioning (e.g., `[aws, gcp]`)"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions", "description": "The regions to consider for provisioning (e.g., `[eu-west-1, us-west4, westeurope]`)"}, "instance_types": {"items": {"type": "string"}, "type": "array", "title": "Instance Types", "description": "The cloud-specific instance types to consider for provisioning (e.g., `[p3.8xlarge, n1-standard-4]`)"}, "spot_policy": {"allOf": [{"$ref": "#/components/schemas/SpotPolicy"}], "description": "The policy for provisioning spot or on-demand instances: `spot`, `on-demand`, or `auto`"}, "retry": {"anyOf": [{"$ref": "#/components/schemas/ProfileRetryRequest"}, {"type": "boolean"}], "title": "Retry", "description": "The policy for resubmitting the run. Defaults to `false`"}, "retry_policy": {"allOf": [{"$ref": "#/components/schemas/ProfileRetryPolicyRequest"}], "title": "Retry Policy", "description": "The policy for resubmitting the run. Deprecated in favor of `retry`"}, "max_duration": {"anyOf": [{"type": "string", "enum": ["off"]}, {"type": "string"}, {"type": "integer"}], "title": "Max Duration", "description": "The maximum duration of a run (e.g., `2h`, `1d`, etc). After it elapses, the run is forced to stop. Defaults to `off`"}, "max_price": {"type": "number", "exclusiveMinimum": 0.0, "title": "Max Price", "description": "The maximum instance price per hour, in dollars"}, "pool_name": {"type": "string", "title": "Pool Name", "description": "The name of the pool. If not set, dstack will use the default name"}, "instance_name": {"type": "string", "title": "Instance Name", "description": "The name of the instance"}, "creation_policy": {"allOf": [{"$ref": "#/components/schemas/CreationPolicy"}], "description": "The policy for using instances from the pool. Defaults to `reuse-or-create`"}, "termination_policy": {"allOf": [{"$ref": "#/components/schemas/TerminationPolicy"}], "description": "The policy for instance termination. Defaults to `destroy-after-idle`"}, "termination_idle_time": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Termination Idle Time", "description": "Time to wait before destroying the idle instance. Defaults to `5m` for `dstack run` and to `3d` for `dstack pool add`"}, "name": {"type": "string", "title": "Name", "description": "The name of the profile that can be passed as `--profile` to `dstack run`"}, "default": {"type": "boolean", "title": "Default", "description": "If set to true, `dstack run` will use this profile by default.", "default": false}}, "additionalProperties": false, "type": "object", "required": ["name"], "title": "ProfileRequest"}, "ProfileRetryPolicyRequest": {"properties": {"retry": {"type": "boolean", "title": "Retry", "description": "Whether to retry the run on failure or not", "default": false}, "duration": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Duration", "description": "The maximum period of retrying the run, e.g., `4h` or `1d`"}}, "additionalProperties": false, "type": "object", "title": "ProfileRetryPolicyRequest"}, "ProfileRetryRequest": {"properties": {"on_events": {"items": {"$ref": "#/components/schemas/RetryEvent"}, "type": "array", "description": "The list of events that should be handled with retry. Supported events are `no-capacity`, `interruption`, and `error`"}, "duration": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Duration", "description": "The maximum period of retrying the run, e.g., `4h` or `1d`"}}, "additionalProperties": false, "type": "object", "required": ["on_events"], "title": "ProfileRetryRequest"}, "ProjectRequest": {"properties": {"project_id": {"type": "string", "format": "uuid4", "title": "Project Id"}, "project_name": {"type": "string", "title": "Project Name"}, "owner": {"$ref": "#/components/schemas/UserRequest"}, "backends": {"items": {"$ref": "#/components/schemas/BackendInfoRequest"}, "type": "array", "title": "Backends"}, "members": {"items": {"$ref": "#/components/schemas/MemberRequest"}, "type": "array", "title": "Members"}}, "additionalProperties": false, "type": "object", "required": ["project_id", "project_name", "owner", "backends", "members"], "title": "ProjectRequest"}, "ProjectRole": {"type": "string", "enum": ["admin", "user"], "title": "ProjectRole", "description": "An enumeration."}, "PythonVersion": {"type": "string", "enum": ["3.8", "3.9", "3.10", "3.11", "3.12"], "title": "PythonVersion", "description": "An enumeration."}, "Range_Memory_": {"properties": {"min": {"type": "number", "title": "Min"}, "max": {"type": "number", "title": "Max"}}, "additionalProperties": false, "type": "object", "title": "Range[Memory]"}, "Range_int_": {"properties": {"min": {"type": "integer", "title": "Min"}, "max": {"type": "integer", "title": "Max"}}, "additionalProperties": false, "type": "object", "title": "Range[int]"}, "RefreshTokenRequestRequest": {"properties": {"username": {"type": "string", "title": "Username"}}, "additionalProperties": false, "type": "object", "required": ["username"], "title": "RefreshTokenRequestRequest"}, "RegistryAuthRequest": {"properties": {"username": {"type": "string", "title": "Username", "description": "The username"}, "password": {"type": "string", "title": "Password", "description": "The password or access token"}}, "additionalProperties": false, "type": "object", "required": ["username", "password"], "title": "RegistryAuthRequest", "description": "Credentials for pulling a private Docker image.\n\nAttributes:\n    username (str): The username\n    password (str): The password or access token"}, "RemoteRepoCredsDtoRequest": {"properties": {"protocol": {"$ref": "#/components/schemas/RepoProtocol"}, "clone_url": {"type": "string", "title": "Clone Url"}, "private_key": {"type": "string", "title": "Private Key"}, "oauth_token": {"type": "string", "title": "Oauth Token"}}, "additionalProperties": false, "type": "object", "required": ["protocol"], "title": "RemoteRepoCredsDtoRequest"}, "RemoteRepoCredsRequest": {"properties": {"protocol": {"$ref": "#/components/schemas/RepoProtocol"}, "clone_url": {"type": "string", "title": "Clone Url"}, "private_key": {"type": "string", "title": "Private Key"}, "oauth_token": {"type": "string", "title": "Oauth Token"}}, "additionalProperties": false, "type": "object", "required": ["protocol", "clone_url"], "title": "RemoteRepoCredsRequest"}, "RemoteRepoInfoRequest": {"properties": {"repo_type": {"type": "string", "enum": ["remote"], "title": "Repo Type", "default": "remote"}, "repo_name": {"type": "string", "title": "Repo Name"}, "repo_host_name": {"type": "string", "title": "Repo Host Name", "default": ""}, "repo_port": {"type": "integer", "title": "Repo Port"}, "repo_user_name": {"type": "string", "title": "Repo User Name", "default": ""}}, "additionalProperties": false, "type": "object", "required": ["repo_name"], "title": "RemoteRepoInfoRequest"}, "RemoteRunRepoDataRequest": {"properties": {"repo_type": {"type": "string", "enum": ["remote"], "title": "Repo Type", "default": "remote"}, "repo_name": {"type": "string", "title": "Repo Name"}, "repo_host_name": {"type": "string", "title": "Repo Host Name", "default": ""}, "repo_port": {"type": "integer", "title": "Repo Port"}, "repo_user_name": {"type": "string", "title": "Repo User Name", "default": ""}, "repo_branch": {"type": "string", "title": "Repo Branch"}, "repo_hash": {"type": "string", "title": "Repo Hash"}, "repo_diff": {"type": "string", "title": "Repo Diff"}, "repo_config_name": {"type": "string", "title": "Repo Config Name"}, "repo_config_email": {"type": "string", "title": "Repo Config Email"}}, "additionalProperties": false, "type": "object", "required": ["repo_name"], "title": "RemoteRunRepoDataRequest"}, "RemoveInstanceRequestRequest": {"properties": {"pool_name": {"type": "string", "title": "Pool Name"}, "instance_name": {"type": "string", "title": "Instance Name"}, "force": {"type": "boolean", "title": "Force", "default": false}}, "additionalProperties": false, "type": "object", "required": ["pool_name", "instance_name"], "title": "RemoveInstanceRequestRequest"}, "RepoHeadRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}, "repo_info": {"oneOf": [{"$ref": "#/components/schemas/RemoteRepoInfoRequest"}, {"$ref": "#/components/schemas/LocalRepoInfoRequest"}, {"$ref": "#/components/schemas/VirtualRepoInfoRequest"}], "title": "Repo Info", "discriminator": {"propertyName": "repo_type", "mapping": {"remote": "#/components/schemas/RemoteRepoInfoRequest", "local": "#/components/schemas/LocalRepoInfoRequest", "virtual": "#/components/schemas/VirtualRepoInfoRequest"}}}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "repo_info"], "title": "RepoHeadRequest"}, "RepoHeadWithCredsRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}, "repo_info": {"oneOf": [{"$ref": "#/components/schemas/RemoteRepoInfoRequest"}, {"$ref": "#/components/schemas/LocalRepoInfoRequest"}, {"$ref": "#/components/schemas/VirtualRepoInfoRequest"}], "title": "Repo Info", "discriminator": {"propertyName": "repo_type", "mapping": {"remote": "#/components/schemas/RemoteRepoInfoRequest", "local": "#/components/schemas/LocalRepoInfoRequest", "virtual": "#/components/schemas/VirtualRepoInfoRequest"}}}, "repo_creds": {"$ref": "#/components/schemas/RemoteRepoCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "repo_info"], "title": "RepoHeadWithCredsRequest"}, "RepoProtocol": {"type": "string", "enum": ["ssh", "https"], "title": "RepoProtocol", "description": "An enumeration."}, "RequirementsRequest": {"properties": {"resources": {"$ref": "#/components/schemas/ResourcesSpecRequest"}, "max_price": {"type": "number", "title": "Max Price"}, "spot": {"type": "boolean", "title": "Spot"}}, "additionalProperties": false, "type": "object", "required": ["resources"], "title": "RequirementsRequest"}, "ResourcesRequest": {"properties": {"cpus": {"type": "integer", "title": "Cpus"}, "memory_mib": {"type": "integer", "title": "Memory Mib"}, "gpus": {"items": {"$ref": "#/components/schemas/GpuRequest"}, "type": "array", "title": "Gpus"}, "spot": {"type": "boolean", "title": "Spot"}, "disk": {"allOf": [{"$ref": "#/components/schemas/DiskRequest"}], "title": "Disk", "default": {"size_mib": 102400}}, "description": {"type": "string", "title": "Description", "default": ""}}, "additionalProperties": false, "type": "object", "required": ["cpus", "memory_mib", "gpus", "spot"], "title": "ResourcesRequest"}, "ResourcesSpecRequest": {"properties": {"cpu": {"anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Union_int__str__"}, {"type": "integer"}, {"type": "string"}], "title": "Cpu", "description": "The number of CPU cores", "default": {"min": 2}}, "memory": {"anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Union_Memory__float__int__str__"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}], "title": "Memory", "description": "The RAM size (e.g., `8GB`)", "default": {"min": 8.0}}, "shm_size": {"anyOf": [{"type": "number"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}], "title": "Shm Size", "description": "The size of shared memory (e.g., `8GB`). If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure this"}, "gpu": {"anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/GPUSpecRequest"}, {"$ref": "#/definitions/ResourcesSpecRequest/definitions/GPUSpecSchemaRequest"}, {"type": "integer"}, {"type": "string"}], "title": "Gpu", "description": "The GPU requirements. Can be set to a number, a string (e.g. `A100`, `80GB:2`, etc.), or an object"}, "disk": {"anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/DiskSpecRequest"}, {"$ref": "#/definitions/ResourcesSpecRequest/definitions/DiskSpecSchemaRequest"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}], "title": "Disk", "description": "The disk resources", "default": {"size": {"min": 100.0}}}}, "additionalProperties": false, "type": "object", "title": "ResourcesSpecSchemaRequest", "definitions": {"Range_Union_int__str__": {"title": "Range[Union[int, str]]", "type": "object", "properties": {"min": {"title": "Min", "anyOf": [{"type": "integer"}, {"type": "string"}]}, "max": {"title": "Max", "anyOf": [{"type": "integer"}, {"type": "string"}]}}, "additionalProperties": false}, "Range_Union_Memory__float__int__str__": {"title": "Range[Union[Memory, float, int, str]]", "type": "object", "properties": {"min": {"title": "Min", "anyOf": [{"type": "number"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}]}, "max": {"title": "Max", "anyOf": [{"type": "number"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}]}}, "additionalProperties": false}, "Range_int_": {"title": "Range[int]", "type": "object", "properties": {"min": {"title": "Min", "type": "integer"}, "max": {"title": "Max", "type": "integer"}}, "additionalProperties": false}, "Range_Memory_": {"title": "Range[Memory]", "type": "object", "properties": {"min": {"title": "Min", "type": "number"}, "max": {"title": "Max", "type": "number"}}, "additionalProperties": false}, "GPUSpecRequest": {"title": "GPUSpecRequest", "type": "object", "properties": {"name": {"title": "Name", "description": "The name of the GPU (e.g., `A100` or `H100`)", "type": "array", "items": {"type": "string"}}, "count": {"title": "Count", "description": "The number of GPUs", "default": {"min": 1, "max": 1}, "allOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_int_"}]}, "memory": {"title": "Memory", "description": "The RAM size (e.g., `16GB`). Can be set to a range (e.g. `16GB..`, or `16GB..80GB`)", "allOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Memory_"}]}, "total_memory": {"title": "Total Memory", "description": "The total RAM size (e.g., `32GB`). Can be set to a range (e.g. `16GB..`, or `16GB..80GB`)", "allOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Memory_"}]}, "compute_capability": {"title": "Compute Capability", "description": "The minimum compute capability of the GPU (e.g., `7.5`)", "type": "array", "items": {}}}, "additionalProperties": false}, "GPUSpecSchemaRequest": {"title": "GPUSpecSchemaRequest", "type": "object", "properties": {"name": {"title": "Name", "description": "The GPU name or list of names", "anyOf": [{"type": "array", "items": {"type": "string"}}, {"type": "string"}]}, "count": {"title": "Count", "description": "The number of GPUs", "default": {"min": 1, "max": 1}, "anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Union_int__str__"}, {"type": "integer"}, {"type": "string"}]}, "memory": {"title": "Memory", "description": "The RAM size (e.g., `16GB`). Can be set to a range (e.g. `16GB..`, or `16GB..80GB`)", "anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Union_Memory__float__int__str__"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}]}, "total_memory": {"title": "Total Memory", "description": "The total RAM size (e.g., `32GB`). Can be set to a range (e.g. `16GB..`, or `16GB..80GB`)", "anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Union_Memory__float__int__str__"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}]}, "compute_capability": {"title": "Compute Capability", "description": "The minimum compute capability of the GPU (e.g., `7.5`)", "anyOf": [{"type": "array", "items": {}}, {"type": "number"}, {"type": "string"}]}}, "additionalProperties": false}, "DiskSpecRequest": {"title": "DiskSpecRequest", "type": "object", "properties": {"size": {"title": "Size", "description": "Disk size", "allOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Memory_"}]}}, "required": ["size"], "additionalProperties": false}, "DiskSpecSchemaRequest": {"title": "DiskSpecSchemaRequest", "type": "object", "properties": {"size": {"title": "Size", "description": "The disk size. Can be a string (e.g., `100GB` or `100GB..`) or an object", "anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Union_Memory__float__int__str__"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}]}}, "required": ["size"], "additionalProperties": false}}}, "RetryEvent": {"type": "string", "enum": ["no-capacity", "interruption", "error"], "title": "RetryEvent", "description": "An enumeration."}, "RetryRequest": {"properties": {"on_events": {"items": {"$ref": "#/components/schemas/RetryEvent"}, "type": "array"}, "duration": {"type": "integer", "title": "Duration"}}, "additionalProperties": false, "type": "object", "required": ["on_events", "duration"], "title": "RetryRequest"}, "RunPlanRequest": {"properties": {"project_name": {"type": "string", "title": "Project Name"}, "user": {"type": "string", "title": "User"}, "run_spec": {"$ref": "#/components/schemas/RunSpecRequest"}, "job_plans": {"items": {"$ref": "#/components/schemas/JobPlanRequest"}, "type": "array", "title": "Job Plans"}}, "additionalProperties": false, "type": "object", "required": ["project_name", "user", "run_spec", "job_plans"], "title": "RunPlanRequest"}, "RunRequest": {"properties": {"id": {"type": "string", "format": "uuid4", "title": "Id"}, "project_name": {"type": "string", "title": "Project Name"}, "user": {"type": "string", "title": "User"}, "submitted_at": {"type": "string", "format": "date-time", "title": "Submitted At"}, "last_processed_at": {"type": "string", "format": "date-time", "title": "Last Processed At"}, "status": {"$ref": "#/components/schemas/RunStatus"}, "termination_reason": {"$ref": "#/components/schemas/RunTerminationReason"}, "run_spec": {"$ref": "#/components/schemas/RunSpecRequest"}, "jobs": {"items": {"$ref": "#/components/schemas/JobRequest"}, "type": "array", "title": "Jobs"}, "latest_job_submission": {"$ref": "#/components/schemas/JobSubmissionRequest"}, "cost": {"type": "number", "title": "Cost", "default": 0}, "service": {"$ref": "#/components/schemas/ServiceSpecRequest"}}, "additionalProperties": false, "type": "object", "required": ["id", "project_name", "user", "submitted_at", "last_processed_at", "status", "run_spec", "jobs"], "title": "RunRequest"}, "RunSpecRequest": {"properties": {"run_name": {"type": "string", "title": "Run Name"}, "repo_id": {"type": "string", "title": "Repo Id"}, "repo_data": {"oneOf": [{"$ref": "#/components/schemas/RemoteRunRepoDataRequest"}, {"$ref": "#/components/schemas/LocalRunRepoDataRequest"}, {"$ref": "#/components/schemas/VirtualRunRepoDataRequest"}], "title": "Repo Data", "discriminator": {"propertyName": "repo_type", "mapping": {"remote": "#/components/schemas/RemoteRunRepoDataRequest", "local": "#/components/schemas/LocalRunRepoDataRequest", "virtual": "#/components/schemas/VirtualRunRepoDataRequest"}}}, "repo_code_hash": {"type": "string", "title": "Repo Code Hash"}, "working_dir": {"type": "string", "title": "Working Dir"}, "configuration_path": {"type": "string", "title": "Configuration Path"}, "configuration": {"oneOf": [{"$ref": "#/components/schemas/DevEnvironmentConfigurationRequest"}, {"$ref": "#/components/schemas/TaskConfigurationRequest"}, {"$ref": "#/components/schemas/ServiceConfigurationRequest"}], "title": "Configuration", "discriminator": {"propertyName": "type", "mapping": {"dev-environment": "#/components/schemas/DevEnvironmentConfigurationRequest", "task": "#/components/schemas/TaskConfigurationRequest", "service": "#/components/schemas/ServiceConfigurationRequest"}}}, "profile": {"$ref": "#/components/schemas/ProfileRequest"}, "ssh_key_pub": {"type": "string", "title": "Ssh Key Pub"}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "repo_data", "working_dir", "configuration_path", "configuration", "profile", "ssh_key_pub"], "title": "RunSpecRequest"}, "RunStatus": {"type": "string", "enum": ["pending", "submitted", "provisioning", "running", "terminating", "terminated", "failed", "done"], "title": "RunStatus", "description": "An enumeration."}, "RunTerminationReason": {"type": "string", "enum": ["all_jobs_done", "job_failed", "retry_limit_exceeded", "stopped_by_user", "aborted_by_user", "server_error"], "title": "RunTerminationReason", "description": "An enumeration."}, "RunpodAPIKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["api_key"], "title": "Type", "default": "api_key"}, "api_key": {"type": "string", "title": "Api Key"}}, "additionalProperties": false, "type": "object", "required": ["api_key"], "title": "RunpodAPIKeyCredsRequest"}, "RunpodConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["runpod"], "title": "Type", "default": "runpod"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "RunpodConfigInfoRequest"}, "RunpodConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["runpod"], "title": "Type", "default": "runpod"}, "creds": {"$ref": "#/components/schemas/RunpodAPIKeyCredsRequest"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "RunpodConfigInfoWithCredsPartialRequest"}, "RunpodConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["runpod"], "title": "Type", "default": "runpod"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/RunpodAPIKeyCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "RunpodConfigInfoWithCredsRequest"}, "RunpodConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["runpod"], "title": "Type", "default": "runpod"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "RunpodConfigValuesRequest"}, "SSHConnectionParamsRequest": {"properties": {"hostname": {"type": "string", "title": "Hostname"}, "username": {"type": "string", "title": "Username"}, "port": {"type": "integer", "title": "Port"}}, "additionalProperties": false, "type": "object", "required": ["hostname", "username", "port"], "title": "SSHConnectionParamsRequest"}, "SSHHostParamsRequest": {"properties": {"hostname": {"type": "string", "title": "Hostname", "description": "The IP address or domain to connect to"}, "port": {"type": "integer", "title": "Port", "description": "The SSH port to connect to for this host"}, "user": {"type": "string", "title": "User", "description": "The user to log in with for this host"}, "identity_file": {"type": "string", "title": "Identity File", "description": "The private key to use for this host"}, "ssh_key": {"$ref": "#/components/schemas/SSHKeyRequest"}}, "additionalProperties": false, "type": "object", "required": ["hostname"], "title": "SSHHostParamsRequest"}, "SSHKeyRequest": {"properties": {"public": {"type": "string", "title": "Public"}, "private": {"type": "string", "title": "Private"}}, "additionalProperties": false, "type": "object", "required": ["public"], "title": "SSHKeyRequest"}, "SSHParamsRequest": {"properties": {"user": {"type": "string", "title": "User", "description": "The user to log in with on all hosts"}, "port": {"type": "integer", "title": "Port", "description": "The SSH port to connect to"}, "identity_file": {"type": "string", "title": "Identity File", "description": "The private key to use for all hosts"}, "ssh_key": {"$ref": "#/components/schemas/SSHKeyRequest"}, "hosts": {"items": {"anyOf": [{"$ref": "#/components/schemas/SSHHostParamsRequest"}, {"type": "string"}]}, "type": "array", "title": "Hosts", "description": "The per host connection parameters: a hostname or an object that overrides default ssh parameters"}, "network": {"type": "string", "title": "Network", "description": "The network address for cluster setup in the format `<ip>/<netmask>`"}}, "additionalProperties": false, "type": "object", "required": ["hosts"], "title": "SSHParamsRequest"}, "SaveRepoCredsRequestRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}, "repo_info": {"anyOf": [{"$ref": "#/components/schemas/RemoteRepoInfoRequest"}, {"$ref": "#/components/schemas/LocalRepoInfoRequest"}, {"$ref": "#/components/schemas/VirtualRepoInfoRequest"}], "title": "Repo Info"}, "repo_creds": {"$ref": "#/components/schemas/RemoteRepoCredsDtoRequest"}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "repo_info"], "title": "SaveRepoCredsRequestRequest"}, "ScalingSpecRequest": {"properties": {"metric": {"type": "string", "enum": ["rps"], "title": "Metric", "description": "The target metric to track. Currently, the only supported value is `rps` (meaning requests per second)"}, "target": {"type": "number", "title": "Target", "description": "The target value of the metric. The number of replicas is calculated based on this number and automatically adjusts (scales up or down) as this metric changes"}, "scale_up_delay": {"type": "integer", "title": "Scale Up Delay", "description": "The delay in seconds before scaling up", "default": 300}, "scale_down_delay": {"type": "integer", "title": "Scale Down Delay", "description": "The delay in seconds before scaling down", "default": 600}}, "additionalProperties": false, "type": "object", "required": ["metric", "target"], "title": "ScalingSpecRequest"}, "SecretRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "value": {"type": "string", "title": "Value"}}, "additionalProperties": false, "type": "object", "required": ["name", "value"], "title": "SecretRequest"}, "ServiceConfigurationRequest": {"properties": {"port": {"anyOf": [{"type": "integer", "maximum": 65536.0, "exclusiveMinimum": 0.0}, {"type": "string", "pattern": "^[0-9]+:[0-9]+$"}, {"$ref": "#/components/schemas/PortMappingRequest"}], "title": "Port", "description": "The port, that application listens on or the mapping"}, "model": {"anyOf": [{"$ref": "#/components/schemas/TGIChatModelRequest"}, {"$ref": "#/components/schemas/OpenAIChatModelRequest"}], "title": "Model", "description": "Mapping of the model for the OpenAI-compatible endpoint"}, "https": {"type": "boolean", "title": "Https", "description": "Enable HTTPS", "default": true}, "auth": {"type": "boolean", "title": "Auth", "description": "Enable the authorization", "default": true}, "replicas": {"anyOf": [{"type": "integer", "minimum": 1.0}, {"type": "string", "pattern": "^[0-9]+..[1-9][0-9]*$"}, {"$ref": "#/components/schemas/Range_int_"}], "title": "Replicas", "description": "The number of replicas. Can be a number (e.g. `2`) or a range (`0..4` or `1..8`). If it's a range, the `scaling` property is required", "default": {"min": 1, "max": 1}}, "scaling": {"allOf": [{"$ref": "#/components/schemas/ScalingSpecRequest"}], "title": "Scaling", "description": "The auto-scaling rules. Required if `replicas` is set to a range"}, "type": {"type": "string", "enum": ["service"], "title": "Type", "default": "service"}, "name": {"type": "string", "title": "Name", "description": "The run name"}, "image": {"type": "string", "title": "Image", "description": "The name of the Docker image to run"}, "entrypoint": {"type": "string", "title": "Entrypoint", "description": "The Docker entrypoint"}, "working_dir": {"type": "string", "title": "Working Dir", "description": "The path to the working directory inside the container. It's specified relative to the repository directory (`/workflow`) and should be inside it. Defaults to `\".\"` "}, "home_dir": {"type": "string", "title": "Home Dir", "description": "The absolute path to the home directory inside the container. Defaults to `/root`", "default": "/root"}, "registry_auth": {"allOf": [{"$ref": "#/components/schemas/RegistryAuthRequest"}], "title": "Registry Auth", "description": "Credentials for pulling a private Docker image"}, "python": {"allOf": [{"$ref": "#/components/schemas/PythonVersion"}], "description": "The major version of Python. Mutually exclusive with `image`"}, "env": {"anyOf": [{"items": {"type": "string", "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*(=.*$|$)"}, "type": "array"}, {"additionalProperties": {"anyOf": [{"type": "string"}, {"$ref": "#/components/schemas/EnvSentinelRequest"}]}, "type": "object"}], "title": "Env", "description": "The mapping or the list of environment variables", "default": {}}, "setup": {"items": {"type": "string"}, "type": "array", "title": "Setup", "description": "The bash commands to run on the boot", "default": []}, "resources": {"allOf": [{"$ref": "#/components/schemas/ResourcesSpecRequest"}], "title": "Resources", "description": "The resources requirements to run the configuration", "default": {"cpu": {"min": 2}, "memory": {"min": 8.0}, "disk": {"size": {"min": 100.0}}}}, "volumes": {"items": {"$ref": "#/components/schemas/VolumeMountPointRequest"}, "type": "array", "title": "Volumes", "description": "The volumes mount points", "default": []}, "commands": {"items": {"type": "string"}, "type": "array", "title": "Commands", "description": "The bash commands to run", "default": []}, "backends": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array", "description": "The backends to consider for provisioning (e.g., `[aws, gcp]`)"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions", "description": "The regions to consider for provisioning (e.g., `[eu-west-1, us-west4, westeurope]`)"}, "instance_types": {"items": {"type": "string"}, "type": "array", "title": "Instance Types", "description": "The cloud-specific instance types to consider for provisioning (e.g., `[p3.8xlarge, n1-standard-4]`)"}, "spot_policy": {"allOf": [{"$ref": "#/components/schemas/SpotPolicy"}], "description": "The policy for provisioning spot or on-demand instances: `spot`, `on-demand`, or `auto`"}, "retry": {"anyOf": [{"$ref": "#/components/schemas/ProfileRetryRequest"}, {"type": "boolean"}], "title": "Retry", "description": "The policy for resubmitting the run. Defaults to `false`"}, "retry_policy": {"allOf": [{"$ref": "#/components/schemas/ProfileRetryPolicyRequest"}], "title": "Retry Policy", "description": "The policy for resubmitting the run. Deprecated in favor of `retry`"}, "max_duration": {"anyOf": [{"type": "string", "enum": ["off"]}, {"type": "string"}, {"type": "integer"}], "title": "Max Duration", "description": "The maximum duration of a run (e.g., `2h`, `1d`, etc). After it elapses, the run is forced to stop. Defaults to `off`"}, "max_price": {"type": "number", "exclusiveMinimum": 0.0, "title": "Max Price", "description": "The maximum instance price per hour, in dollars"}, "pool_name": {"type": "string", "title": "Pool Name", "description": "The name of the pool. If not set, dstack will use the default name"}, "instance_name": {"type": "string", "title": "Instance Name", "description": "The name of the instance"}, "creation_policy": {"allOf": [{"$ref": "#/components/schemas/CreationPolicy"}], "description": "The policy for using instances from the pool. Defaults to `reuse-or-create`"}, "termination_policy": {"allOf": [{"$ref": "#/components/schemas/TerminationPolicy"}], "description": "The policy for instance termination. Defaults to `destroy-after-idle`"}, "termination_idle_time": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Termination Idle Time", "description": "Time to wait before destroying the idle instance. Defaults to `5m` for `dstack run` and to `3d` for `dstack pool add`"}}, "additionalProperties": false, "type": "object", "required": ["port"], "title": "ServiceConfigurationRequest"}, "ServiceModelSpecRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "base_url": {"type": "string", "title": "Base Url"}, "type": {"type": "string", "title": "Type"}}, "additionalProperties": false, "type": "object", "required": ["name", "base_url", "type"], "title": "ServiceModelSpecRequest"}, "ServiceSpecRequest": {"properties": {"url": {"type": "string", "title": "Url"}, "model": {"$ref": "#/components/schemas/ServiceModelSpecRequest"}, "options": {"type": "object", "title": "Options", "default": {}}}, "additionalProperties": false, "type": "object", "required": ["url"], "title": "ServiceSpecRequest"}, "SetDefaultGatewayRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}}, "additionalProperties": false, "type": "object", "required": ["name"], "title": "SetDefaultGatewayRequestRequest"}, "SetDefaultPoolRequestRequest": {"properties": {"pool_name": {"type": "string", "title": "Pool Name"}}, "additionalProperties": false, "type": "object", "required": ["pool_name"], "title": "SetDefaultPoolRequestRequest"}, "SetProjectMembersRequestRequest": {"properties": {"members": {"items": {"$ref": "#/components/schemas/MemberSettingRequest"}, "type": "array", "title": "Members"}}, "additionalProperties": false, "type": "object", "required": ["members"], "title": "SetProjectMembersRequestRequest"}, "SetWildcardDomainRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "wildcard_domain": {"type": "string", "title": "Wildcard Domain"}}, "additionalProperties": false, "type": "object", "required": ["name", "wildcard_domain"], "title": "SetWildcardDomainRequestRequest"}, "ShowPoolRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}}, "additionalProperties": false, "type": "object", "title": "ShowPoolRequestRequest"}, "SpotPolicy": {"type": "string", "enum": ["spot", "on-demand", "auto"], "title": "SpotPolicy", "description": "An enumeration."}, "StopRunsRequestRequest": {"properties": {"runs_names": {"items": {"type": "string"}, "type": "array", "title": "Runs Names"}, "abort": {"type": "boolean", "title": "Abort"}}, "additionalProperties": false, "type": "object", "required": ["runs_names", "abort"], "title": "StopRunsRequestRequest"}, "SubmitRunRequestRequest": {"properties": {"run_spec": {"$ref": "#/components/schemas/RunSpecRequest"}}, "additionalProperties": false, "type": "object", "required": ["run_spec"], "title": "SubmitRunRequestRequest"}, "TGIChatModelRequest": {"properties": {"type": {"type": "string", "enum": ["chat"], "title": "Type", "description": "The type of the model"}, "name": {"type": "string", "title": "Name", "description": "The name of the model"}, "format": {"type": "string", "enum": ["tgi"], "title": "Format"}, "chat_template": {"type": "string", "title": "Chat Template"}, "eos_token": {"type": "string", "title": "Eos Token"}}, "additionalProperties": false, "type": "object", "required": ["type", "name", "format"], "title": "TGIChatModelRequest", "description": "Mapping of the model for the OpenAI-compatible endpoint.\n\nAttributes:\n    type (str): The type of the model, e.g. \"chat\"\n    name (str): The name of the model. This name will be used both to load model configuration from the HuggingFace Hub and in the OpenAI-compatible endpoint.\n    format (str): The format of the model, e.g. \"tgi\" if the model is served with HuggingFace's Text Generation Inference.\n    chat_template (Optional[str]): The custom prompt template for the model. If not specified, the default prompt template the HuggingFace Hub configuration will be used.\n    eos_token (Optional[str]): The custom end of sentence token. If not specified, the default custom end of sentence token from the HuggingFace Hub configuration will be used."}, "TaskConfigurationRequest": {"properties": {"nodes": {"type": "integer", "minimum": 1.0, "title": "Nodes", "description": "Number of nodes", "default": 1}, "type": {"type": "string", "enum": ["task"], "title": "Type", "default": "task"}, "name": {"type": "string", "title": "Name", "description": "The run name"}, "image": {"type": "string", "title": "Image", "description": "The name of the Docker image to run"}, "entrypoint": {"type": "string", "title": "Entrypoint", "description": "The Docker entrypoint"}, "working_dir": {"type": "string", "title": "Working Dir", "description": "The path to the working directory inside the container. It's specified relative to the repository directory (`/workflow`) and should be inside it. Defaults to `\".\"` "}, "home_dir": {"type": "string", "title": "Home Dir", "description": "The absolute path to the home directory inside the container. Defaults to `/root`", "default": "/root"}, "registry_auth": {"allOf": [{"$ref": "#/components/schemas/RegistryAuthRequest"}], "title": "Registry Auth", "description": "Credentials for pulling a private Docker image"}, "python": {"allOf": [{"$ref": "#/components/schemas/PythonVersion"}], "description": "The major version of Python. Mutually exclusive with `image`"}, "env": {"anyOf": [{"items": {"type": "string", "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*(=.*$|$)"}, "type": "array"}, {"additionalProperties": {"anyOf": [{"type": "string"}, {"$ref": "#/components/schemas/EnvSentinelRequest"}]}, "type": "object"}], "title": "Env", "description": "The mapping or the list of environment variables", "default": {}}, "setup": {"items": {"type": "string"}, "type": "array", "title": "Setup", "description": "The bash commands to run on the boot", "default": []}, "resources": {"allOf": [{"$ref": "#/components/schemas/ResourcesSpecRequest"}], "title": "Resources", "description": "The resources requirements to run the configuration", "default": {"cpu": {"min": 2}, "memory": {"min": 8.0}, "disk": {"size": {"min": 100.0}}}}, "volumes": {"items": {"$ref": "#/components/schemas/VolumeMountPointRequest"}, "type": "array", "title": "Volumes", "description": "The volumes mount points", "default": []}, "ports": {"items": {"anyOf": [{"type": "integer", "maximum": 65536.0, "exclusiveMinimum": 0.0}, {"type": "string", "pattern": "^(?:[0-9]+|\\*):[0-9]+$"}, {"$ref": "#/components/schemas/PortMappingRequest"}]}, "type": "array", "title": "Ports", "description": "Port numbers/mapping to expose", "default": []}, "commands": {"items": {"type": "string"}, "type": "array", "title": "Commands", "description": "The bash commands to run", "default": []}, "backends": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array", "description": "The backends to consider for provisioning (e.g., `[aws, gcp]`)"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions", "description": "The regions to consider for provisioning (e.g., `[eu-west-1, us-west4, westeurope]`)"}, "instance_types": {"items": {"type": "string"}, "type": "array", "title": "Instance Types", "description": "The cloud-specific instance types to consider for provisioning (e.g., `[p3.8xlarge, n1-standard-4]`)"}, "spot_policy": {"allOf": [{"$ref": "#/components/schemas/SpotPolicy"}], "description": "The policy for provisioning spot or on-demand instances: `spot`, `on-demand`, or `auto`"}, "retry": {"anyOf": [{"$ref": "#/components/schemas/ProfileRetryRequest"}, {"type": "boolean"}], "title": "Retry", "description": "The policy for resubmitting the run. Defaults to `false`"}, "retry_policy": {"allOf": [{"$ref": "#/components/schemas/ProfileRetryPolicyRequest"}], "title": "Retry Policy", "description": "The policy for resubmitting the run. Deprecated in favor of `retry`"}, "max_duration": {"anyOf": [{"type": "string", "enum": ["off"]}, {"type": "string"}, {"type": "integer"}], "title": "Max Duration", "description": "The maximum duration of a run (e.g., `2h`, `1d`, etc). After it elapses, the run is forced to stop. Defaults to `off`"}, "max_price": {"type": "number", "exclusiveMinimum": 0.0, "title": "Max Price", "description": "The maximum instance price per hour, in dollars"}, "pool_name": {"type": "string", "title": "Pool Name", "description": "The name of the pool. If not set, dstack will use the default name"}, "instance_name": {"type": "string", "title": "Instance Name", "description": "The name of the instance"}, "creation_policy": {"allOf": [{"$ref": "#/components/schemas/CreationPolicy"}], "description": "The policy for using instances from the pool. Defaults to `reuse-or-create`"}, "termination_policy": {"allOf": [{"$ref": "#/components/schemas/TerminationPolicy"}], "description": "The policy for instance termination. Defaults to `destroy-after-idle`"}, "termination_idle_time": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Termination Idle Time", "description": "Time to wait before destroying the idle instance. Defaults to `5m` for `dstack run` and to `3d` for `dstack pool add`"}}, "additionalProperties": false, "type": "object", "title": "TaskConfigurationRequest"}, "TensorDockAPIKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["api_key"], "title": "Type", "description": "The type of credentials", "default": "api_key"}, "api_key": {"type": "string", "title": "Api Key", "description": "The API key"}, "api_token": {"type": "string", "title": "Api Token", "description": "The API token"}}, "additionalProperties": false, "type": "object", "required": ["api_key", "api_token"], "title": "TensorDockAPIKeyCredsRequest"}, "TensorDockConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["tensordock"], "title": "Type", "default": "tensordock"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "TensorDockConfigInfoRequest"}, "TensorDockConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["tensordock"], "title": "Type", "default": "tensordock"}, "creds": {"$ref": "#/components/schemas/TensorDockAPIKeyCredsRequest"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "TensorDockConfigInfoWithCredsPartialRequest"}, "TensorDockConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["tensordock"], "title": "Type", "default": "tensordock"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/TensorDockAPIKeyCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "TensorDockConfigInfoWithCredsRequest"}, "TensorDockConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["tensordock"], "title": "Type", "default": "tensordock"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "TensorDockConfigValuesRequest"}, "TerminationPolicy": {"type": "string", "enum": ["dont-destroy", "destroy-after-idle"], "title": "TerminationPolicy", "description": "An enumeration."}, "UpdateBackendYAMLRequestRequest": {"properties": {"config_yaml": {"type": "string", "title": "Config Yaml"}}, "additionalProperties": false, "type": "object", "required": ["config_yaml"], "title": "UpdateBackendYAMLRequestRequest"}, "UserRequest": {"properties": {"id": {"type": "string", "format": "uuid4", "title": "Id"}, "username": {"type": "string", "title": "Username"}, "global_role": {"$ref": "#/components/schemas/GlobalRole"}, "email": {"type": "string", "title": "Email"}}, "additionalProperties": false, "type": "object", "required": ["id", "username", "global_role"], "title": "UserRequest"}, "UserTokenCredsRequest": {"properties": {"token": {"type": "string", "title": "Token"}}, "additionalProperties": false, "type": "object", "required": ["token"], "title": "UserTokenCredsRequest"}, "UserWithCredsRequest": {"properties": {"id": {"type": "string", "format": "uuid4", "title": "Id"}, "username": {"type": "string", "title": "Username"}, "global_role": {"$ref": "#/components/schemas/GlobalRole"}, "email": {"type": "string", "title": "Email"}, "creds": {"$ref": "#/components/schemas/UserTokenCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["id", "username", "global_role", "creds"], "title": "UserWithCredsRequest"}, "ValidationError": {"properties": {"loc": {"items": {"anyOf": [{"type": "string"}, {"type": "integer"}]}, "type": "array", "title": "Location"}, "msg": {"type": "string", "title": "Message"}, "type": {"type": "string", "title": "Error Type"}}, "type": "object", "required": ["loc", "msg", "type"], "title": "ValidationError"}, "VastAIAPIKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["api_key"], "title": "Type", "description": "The type of credentials", "default": "api_key"}, "api_key": {"type": "string", "title": "Api Key", "description": "The API key"}}, "additionalProperties": false, "type": "object", "required": ["api_key"], "title": "VastAIAPIKeyCredsRequest"}, "VastAIConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["vastai"], "title": "Type", "default": "vastai"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "VastAIConfigInfoRequest"}, "VastAIConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["vastai"], "title": "Type", "default": "vastai"}, "creds": {"$ref": "#/components/schemas/VastAIAPIKeyCredsRequest"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "VastAIConfigInfoWithCredsPartialRequest"}, "VastAIConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["vastai"], "title": "Type", "default": "vastai"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/VastAIAPIKeyCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "VastAIConfigInfoWithCredsRequest"}, "VastAIConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["vastai"], "title": "Type", "default": "vastai"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "VastAIConfigValuesRequest"}, "VirtualRepoInfoRequest": {"properties": {"repo_type": {"type": "string", "enum": ["virtual"], "title": "Repo Type", "default": "virtual"}}, "additionalProperties": false, "type": "object", "title": "VirtualRepoInfoRequest"}, "VirtualRunRepoDataRequest": {"properties": {"repo_type": {"type": "string", "enum": ["virtual"], "title": "Repo Type", "default": "virtual"}}, "additionalProperties": false, "type": "object", "title": "VirtualRunRepoDataRequest"}, "VolumeAttachmentDataRequest": {"properties": {"device_name": {"type": "string", "title": "Device Name"}}, "additionalProperties": false, "type": "object", "title": "VolumeAttachmentDataRequest"}, "VolumeConfigurationRequest": {"properties": {"type": {"type": "string", "enum": ["volume"], "title": "Type", "default": "volume"}, "name": {"type": "string", "title": "Name", "description": "The volume name"}, "backend": {"allOf": [{"$ref": "#/components/schemas/BackendType"}], "description": "The volume backend"}, "region": {"type": "string", "title": "Region", "description": "The volume region"}, "size": {"type": "number", "title": "Size", "description": "The volume size. Must be specified when creating new volumes"}, "volume_id": {"type": "string", "title": "Volume Id", "description": "The volume ID. Must be specified when registering external volumes"}}, "additionalProperties": false, "type": "object", "required": ["backend", "region"], "title": "VolumeConfigurationRequest"}, "VolumeMountPointRequest": {"properties": {"name": {"type": "string", "title": "Name", "description": "The name of the volume to mount"}, "path": {"type": "string", "title": "Path", "description": "The container path to mount the volume at"}}, "additionalProperties": false, "type": "object", "required": ["name", "path"], "title": "VolumeMountPointRequest"}, "VolumeProvisioningDataRequest": {"properties": {"backend": {"$ref": "#/components/schemas/BackendType"}, "volume_id": {"type": "string", "title": "Volume Id"}, "size_gb": {"type": "integer", "title": "Size Gb"}, "availability_zone": {"type": "string", "title": "Availability Zone"}, "price": {"type": "number", "title": "Price"}, "attachable": {"type": "boolean", "title": "Attachable", "default": true}, "detachable": {"type": "boolean", "title": "Detachable", "default": true}, "backend_data": {"type": "string", "title": "Backend Data"}}, "additionalProperties": false, "type": "object", "required": ["volume_id", "size_gb"], "title": "VolumeProvisioningDataRequest"}, "VolumeRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "project_name": {"type": "string", "title": "Project Name"}, "configuration": {"$ref": "#/components/schemas/VolumeConfigurationRequest"}, "external": {"type": "boolean", "title": "External"}, "created_at": {"type": "string", "format": "date-time", "title": "Created At"}, "status": {"$ref": "#/components/schemas/VolumeStatus"}, "status_message": {"type": "string", "title": "Status Message"}, "volume_id": {"type": "string", "title": "Volume Id"}, "provisioning_data": {"$ref": "#/components/schemas/VolumeProvisioningDataRequest"}, "attachment_data": {"$ref": "#/components/schemas/VolumeAttachmentDataRequest"}, "volume_model_id": {"type": "string", "format": "uuid", "title": "Volume Model Id"}}, "additionalProperties": false, "type": "object", "required": ["name", "project_name", "configuration", "external", "created_at", "status", "volume_model_id"], "title": "VolumeRequest"}, "VolumeStatus": {"type": "string", "enum": ["submitted", "provisioning", "active", "failed"], "title": "VolumeStatus", "description": "An enumeration."}}, "securitySchemes": {"HTTPBearer": {"type": "http", "scheme": "bearer"}}}}
\ No newline at end of file
+{"openapi": "3.1.0", "info": {"title": "REST API", "description": "The REST API enables running tasks, services, and managing runs programmatically.", "version": "0.0.0"}, "servers": [{"url": "http://localhost:3000", "description": "Local server"}, {"url": "https://sky.dstack.ai", "description": "Managed server"}], "paths": {"/api/users/list": {"post": {"tags": ["users"], "summary": "List Users", "operationId": "list_users_api_users_list_post", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/UserRequest"}, "type": "array", "title": "Response List Users Api Users List Post"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/users/get_my_user": {"post": {"tags": ["users"], "summary": "Get My User", "operationId": "get_my_user_api_users_get_my_user_post", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserRequest"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/users/get_user": {"post": {"tags": ["users"], "summary": "Get User", "operationId": "get_user_api_users_get_user_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetUserRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserWithCredsRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/users/create": {"post": {"tags": ["users"], "summary": "Create User", "operationId": "create_user_api_users_create_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateUserRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/users/update": {"post": {"tags": ["users"], "summary": "Update User", "operationId": "update_user_api_users_update_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateUserRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/users/refresh_token": {"post": {"tags": ["users"], "summary": "Refresh Token", "operationId": "refresh_token_api_users_refresh_token_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/RefreshTokenRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserWithCredsRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/users/delete": {"post": {"tags": ["users"], "summary": "Delete Users", "operationId": "delete_users_api_users_delete_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteUsersRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/projects/list": {"post": {"tags": ["projects"], "summary": "List Projects", "description": "Returns all projects visible to user.\n`members` and `backends` are always empty - call `/api/projects/{project_name}/get` to retrieve them.", "operationId": "list_projects_api_projects_list_post", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/ProjectRequest"}, "type": "array", "title": "Response List Projects Api Projects List Post"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/projects/create": {"post": {"tags": ["projects"], "summary": "Create Project", "operationId": "create_project_api_projects_create_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateProjectRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProjectRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/projects/delete": {"post": {"tags": ["projects"], "summary": "Delete Projects", "operationId": "delete_projects_api_projects_delete_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteProjectsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/projects/{project_name}/get": {"post": {"tags": ["projects"], "summary": "Get Project", "operationId": "get_project_api_projects__project_name__get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProjectRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/projects/{project_name}/set_members": {"post": {"tags": ["projects"], "summary": "Set Project Members", "operationId": "set_project_members_api_projects__project_name__set_members_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/SetProjectMembersRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProjectRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/backends/list_types": {"post": {"tags": ["backends"], "summary": "List Backend Types", "operationId": "list_backend_types_api_backends_list_types_post", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array"}}}}}}}, "/api/backends/config_values": {"post": {"tags": ["backends"], "summary": "Get Backend Config Values", "operationId": "get_backend_config_values_api_backends_config_values_post", "requestBody": {"content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoWithCredsPartialRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}], "title": "Body"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigValuesRequest"}, {"$ref": "#/components/schemas/AzureConfigValuesRequest"}, {"$ref": "#/components/schemas/CudoConfigValuesRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigValuesRequest"}, {"$ref": "#/components/schemas/GCPConfigValuesRequest"}, {"$ref": "#/components/schemas/KubernetesConfigValuesRequest"}, {"$ref": "#/components/schemas/LambdaConfigValuesRequest"}, {"$ref": "#/components/schemas/NebiusConfigValuesRequest"}, {"$ref": "#/components/schemas/OCIConfigValuesRequest"}, {"$ref": "#/components/schemas/RunpodConfigValuesRequest"}, {"$ref": "#/components/schemas/TensorDockConfigValuesRequest"}, {"$ref": "#/components/schemas/VastAIConfigValuesRequest"}, {"$ref": "#/components/schemas/DstackConfigValuesRequest"}], "title": "Response Get Backend Config Values Api Backends Config Values Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/create": {"post": {"tags": ["backends"], "summary": "Create Backend", "operationId": "create_backend_api_project__project_name__backends_create_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}], "title": "Body"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}], "title": "Response Create Backend Api Project  Project Name  Backends Create Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/update": {"post": {"tags": ["backends"], "summary": "Update Backend", "operationId": "update_backend_api_project__project_name__backends_update_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}], "title": "Body"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}], "title": "Response Update Backend Api Project  Project Name  Backends Update Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/delete": {"post": {"tags": ["backends"], "summary": "Delete Backends", "operationId": "delete_backends_api_project__project_name__backends_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteBackendsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/{backend_name}/config_info": {"post": {"tags": ["backends"], "summary": "Get Backend Config Info", "operationId": "get_backend_config_info_api_project__project_name__backends__backend_name__config_info_post", "parameters": [{"required": true, "schema": {"$ref": "#/components/schemas/BackendType"}, "name": "backend_name", "in": "path"}, {"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoWithCredsRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}], "title": "Response Get Backend Config Info Api Project  Project Name  Backends  Backend Name  Config Info Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/create_yaml": {"post": {"tags": ["backends"], "summary": "Create Backend Yaml", "operationId": "create_backend_yaml_api_project__project_name__backends_create_yaml_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateBackendYAMLRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/update_yaml": {"post": {"tags": ["backends"], "summary": "Update Backend Yaml", "operationId": "update_backend_yaml_api_project__project_name__backends_update_yaml_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/UpdateBackendYAMLRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/backends/{backend_name}/get_yaml": {"post": {"tags": ["backends"], "summary": "Get Backend Yaml", "operationId": "get_backend_yaml_api_project__project_name__backends__backend_name__get_yaml_post", "parameters": [{"required": true, "schema": {"$ref": "#/components/schemas/BackendType"}, "name": "backend_name", "in": "path"}, {"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/BackendInfoYAMLRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/pools/list_instances": {"post": {"tags": ["pool"], "summary": "List Pool Instances", "description": "Returns all instances visible to user sorted by descending created_at.\nA **project_name** and **pool_name** can be specified as filters.\n\nThe results are paginated. To get the next page, pass created_at and id of\nthe last run from the previous page as **prev_created_at** and **prev_id**.", "operationId": "list_pool_instances_api_pools_list_instances_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListPoolsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/InstanceRequest"}, "type": "array", "title": "Response List Pool Instances Api Pools List Instances Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/list": {"post": {"tags": ["pool"], "summary": "List Pool", "operationId": "list_pool_api_project__project_name__pool_list_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/PoolRequest"}, "type": "array", "title": "Response List Pool Api Project  Project Name  Pool List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/create": {"post": {"tags": ["pool"], "summary": "Create Pool", "operationId": "create_pool_api_project__project_name__pool_create_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreatePoolRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/set_default": {"post": {"tags": ["pool"], "summary": "Set Default Pool", "operationId": "set_default_pool_api_project__project_name__pool_set_default_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/SetDefaultPoolRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/delete": {"post": {"tags": ["pool"], "summary": "Delete Pool", "operationId": "delete_pool_api_project__project_name__pool_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeletePoolRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/show": {"post": {"tags": ["pool"], "summary": "Show Pool", "operationId": "show_pool_api_project__project_name__pool_show_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/ShowPoolRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/PoolInstancesRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/remove": {"post": {"tags": ["pool"], "summary": "Remove Instance", "operationId": "remove_instance_api_project__project_name__pool_remove_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/RemoveInstanceRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/pool/add_remote": {"post": {"tags": ["pool"], "summary": "Add Instance", "operationId": "add_instance_api_project__project_name__pool_add_remote_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/AddRemoteInstanceRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/InstanceRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/fleets/list": {"post": {"tags": ["fleets"], "summary": "List Fleets", "operationId": "list_fleets_api_project__project_name__fleets_list_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/FleetRequest"}, "type": "array", "title": "Response List Fleets Api Project  Project Name  Fleets List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/fleets/get": {"post": {"tags": ["fleets"], "summary": "Get Fleet", "operationId": "get_fleet_api_project__project_name__fleets_get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetFleetRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/FleetRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/fleets/create": {"post": {"tags": ["fleets"], "summary": "Create Fleet", "operationId": "create_fleet_api_project__project_name__fleets_create_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateFleetRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/FleetRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/fleets/delete": {"post": {"tags": ["fleets"], "summary": "Delete Fleets", "operationId": "delete_fleets_api_project__project_name__fleets_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteFleetsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/fleets/delete_instances": {"post": {"tags": ["fleets"], "summary": "Delete Fleet Instances", "operationId": "delete_fleet_instances_api_project__project_name__fleets_delete_instances_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteFleetInstancesRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/repos/list": {"post": {"tags": ["repos"], "summary": "List Repos", "operationId": "list_repos_api_project__project_name__repos_list_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/RepoHeadRequest"}, "type": "array", "title": "Response List Repos Api Project  Project Name  Repos List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/repos/get": {"post": {"tags": ["repos"], "summary": "Get Repo", "operationId": "get_repo_api_project__project_name__repos_get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetRepoRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RepoHeadWithCredsRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/repos/init": {"post": {"tags": ["repos"], "summary": "Init Repo", "operationId": "init_repo_api_project__project_name__repos_init_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/SaveRepoCredsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/repos/delete": {"post": {"tags": ["repos"], "summary": "Delete Repos", "operationId": "delete_repos_api_project__project_name__repos_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteReposRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/repos/upload_code": {"post": {"tags": ["repos"], "summary": "Upload Code", "operationId": "upload_code_api_project__project_name__repos_upload_code_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}, {"required": true, "schema": {"type": "string", "title": "Repo Id"}, "name": "repo_id", "in": "query"}], "requestBody": {"content": {"multipart/form-data": {"schema": {"$ref": "#/components/schemas/Body_upload_code_api_project__project_name__repos_upload_code_post"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/runs/list": {"post": {"tags": ["runs"], "summary": "List Runs", "description": "Returns all runs visible to user sorted by descending submitted_at.\nA **project_name**, **repo_id**, and **username** can be specified as filters.\nSpecifying **repo_id** without **project_name** returns no runs.\n\nThe results are paginated. To get the next page, pass submitted_at and id of\nthe last run from the previous page as **prev_submitted_at** and **prev_run_id**.", "operationId": "list_runs_api_runs_list_post", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListRunsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/RunRequest"}, "type": "array", "title": "Response List Runs Api Runs List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/get": {"post": {"tags": ["runs"], "summary": "Get Run", "operationId": "get_run_api_project__project_name__runs_get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetRunRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RunRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/get_plan": {"post": {"tags": ["runs"], "summary": "Get Run Plan", "operationId": "get_run_plan_api_project__project_name__runs_get_plan_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetRunPlanRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RunPlanRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/submit": {"post": {"tags": ["runs"], "summary": "Submit Run", "operationId": "submit_run_api_project__project_name__runs_submit_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/SubmitRunRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RunRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/stop": {"post": {"tags": ["runs"], "summary": "Stop Runs", "operationId": "stop_runs_api_project__project_name__runs_stop_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/StopRunsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/delete": {"post": {"tags": ["runs"], "summary": "Delete Runs", "operationId": "delete_runs_api_project__project_name__runs_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteRunsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/get_offers": {"post": {"tags": ["runs"], "summary": "Get Offers", "operationId": "get_offers_api_project__project_name__runs_get_offers_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetOffersRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/PoolInstanceOffersRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/runs/create_instance": {"post": {"tags": ["runs"], "summary": "Create Instance", "operationId": "create_instance_api_project__project_name__runs_create_instance_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateInstanceRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/InstanceRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/logs/poll": {"post": {"tags": ["logs"], "summary": "Poll Logs", "operationId": "poll_logs_api_project__project_name__logs_poll_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/PollLogsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/JobSubmissionLogsRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/secrets/list": {"post": {"tags": ["secrets"], "summary": "List Secrets", "operationId": "list_secrets_api_project__project_name__secrets_list_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListSecretsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/RunRequest"}, "type": "array", "title": "Response List Secrets Api Project  Project Name  Secrets List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/project/{project_name}/secrets/get": {"post": {"tags": ["secrets"], "summary": "Get Secret", "operationId": "get_secret_api_project__project_name__secrets_get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetSecretsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SecretRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/project/{project_name}/secrets/add": {"post": {"tags": ["secrets"], "summary": "Add Or Update Secret", "operationId": "add_or_update_secret_api_project__project_name__secrets_add_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/AddSecretRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SecretRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/project/{project_name}/secrets/delete": {"post": {"tags": ["secrets"], "summary": "Delete Secrets", "operationId": "delete_secrets_api_project__project_name__secrets_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteSecretsRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/project/{project_name}/gateways/list": {"post": {"tags": ["gateways"], "summary": "List Gateways", "operationId": "list_gateways_api_project__project_name__gateways_list_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/GatewayRequest"}, "type": "array", "title": "Response List Gateways Api Project  Project Name  Gateways List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/gateways/get": {"post": {"tags": ["gateways"], "summary": "Get Gateway", "operationId": "get_gateway_api_project__project_name__gateways_get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetGatewayRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GatewayRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/gateways/create": {"post": {"tags": ["gateways"], "summary": "Create Gateway", "operationId": "create_gateway_api_project__project_name__gateways_create_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateGatewayRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GatewayRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/gateways/delete": {"post": {"tags": ["gateways"], "summary": "Delete Gateways", "operationId": "delete_gateways_api_project__project_name__gateways_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteGatewaysRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/gateways/set_default": {"post": {"tags": ["gateways"], "summary": "Set Default Gateway", "operationId": "set_default_gateway_api_project__project_name__gateways_set_default_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/SetDefaultGatewayRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/gateways/set_wildcard_domain": {"post": {"tags": ["gateways"], "summary": "Set Gateway Wildcard Domain", "operationId": "set_gateway_wildcard_domain_api_project__project_name__gateways_set_wildcard_domain_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/SetWildcardDomainRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GatewayRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/volumes/list": {"post": {"tags": ["volumes"], "summary": "List Volumes", "operationId": "list_volumes_api_project__project_name__volumes_list_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/VolumeRequest"}, "type": "array", "title": "Response List Volumes Api Project  Project Name  Volumes List Post"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/volumes/get": {"post": {"tags": ["volumes"], "summary": "Get Volume", "operationId": "get_volume_api_project__project_name__volumes_get_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetVolumeRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/VolumeRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/volumes/create": {"post": {"tags": ["volumes"], "summary": "Create Volume", "operationId": "create_volume_api_project__project_name__volumes_create_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateVolumeRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/VolumeRequest"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/api/project/{project_name}/volumes/delete": {"post": {"tags": ["volumes"], "summary": "Delete Volumes", "operationId": "delete_volumes_api_project__project_name__volumes_delete_post", "parameters": [{"required": true, "schema": {"type": "string", "title": "Project Name"}, "name": "project_name", "in": "path"}], "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/DeleteVolumesRequestRequest"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"HTTPBearer": []}]}}, "/healthcheck": {"get": {"summary": "Healthcheck", "operationId": "healthcheck_healthcheck_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/": {"get": {"summary": "Index", "operationId": "index__get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}}, "components": {"schemas": {"ACMGatewayCertificateRequest": {"properties": {"type": {"type": "string", "enum": ["acm"], "title": "Type", "description": "Certificates by AWS Certificate Manager (ACM)", "default": "acm"}, "arn": {"type": "string", "title": "Arn", "description": "The ARN of the wildcard ACM certificate for the domain"}}, "additionalProperties": false, "type": "object", "required": ["arn"], "title": "ACMGatewayCertificateRequest"}, "AWSAccessKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["access_key"], "title": "Type", "description": "The type of credentials", "default": "access_key"}, "access_key": {"type": "string", "title": "Access Key", "description": "The access key"}, "secret_key": {"type": "string", "title": "Secret Key", "description": "The secret key"}}, "additionalProperties": false, "type": "object", "required": ["access_key", "secret_key"], "title": "AWSAccessKeyCredsRequest"}, "AWSConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["aws"], "title": "Type", "default": "aws"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "vpc_name": {"type": "string", "title": "Vpc Name"}, "vpc_ids": {"additionalProperties": {"type": "string"}, "type": "object", "title": "Vpc Ids"}, "default_vpcs": {"type": "boolean", "title": "Default Vpcs"}, "public_ips": {"type": "boolean", "title": "Public Ips"}}, "additionalProperties": false, "type": "object", "title": "AWSConfigInfoRequest"}, "AWSConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["aws"], "title": "Type", "default": "aws"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/AWSAccessKeyCredsRequest"}, {"$ref": "#/components/schemas/AWSDefaultCredsRequest"}], "title": "Creds"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "vpc_name": {"type": "string", "title": "Vpc Name"}, "vpc_ids": {"additionalProperties": {"type": "string"}, "type": "object", "title": "Vpc Ids"}, "default_vpcs": {"type": "boolean", "title": "Default Vpcs"}, "public_ips": {"type": "boolean", "title": "Public Ips"}}, "additionalProperties": false, "type": "object", "title": "AWSConfigInfoWithCredsPartialRequest"}, "AWSConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["aws"], "title": "Type", "default": "aws"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "vpc_name": {"type": "string", "title": "Vpc Name"}, "vpc_ids": {"additionalProperties": {"type": "string"}, "type": "object", "title": "Vpc Ids"}, "default_vpcs": {"type": "boolean", "title": "Default Vpcs"}, "public_ips": {"type": "boolean", "title": "Public Ips"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/AWSAccessKeyCredsRequest"}, {"$ref": "#/components/schemas/AWSDefaultCredsRequest"}], "title": "Creds"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "AWSConfigInfoWithCredsRequest"}, "AWSConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["aws"], "title": "Type", "default": "aws"}, "default_creds": {"type": "boolean", "title": "Default Creds", "default": false}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "AWSConfigValuesRequest"}, "AWSDefaultCredsRequest": {"properties": {"type": {"type": "string", "enum": ["default"], "title": "Type", "description": "The type of credentials", "default": "default"}}, "additionalProperties": false, "type": "object", "title": "AWSDefaultCredsRequest"}, "AddRemoteInstanceRequestRequest": {"properties": {"pool_name": {"type": "string", "title": "Pool Name"}, "instance_name": {"type": "string", "title": "Instance Name"}, "instance_network": {"type": "string", "title": "Instance Network"}, "region": {"type": "string", "title": "Region"}, "host": {"type": "string", "title": "Host"}, "port": {"type": "integer", "title": "Port"}, "ssh_user": {"type": "string", "title": "Ssh User"}, "ssh_keys": {"items": {"$ref": "#/components/schemas/SSHKeyRequest"}, "type": "array", "title": "Ssh Keys"}}, "additionalProperties": false, "type": "object", "required": ["host", "port", "ssh_user", "ssh_keys"], "title": "AddRemoteInstanceRequestRequest"}, "AddSecretRequestRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}, "secret": {"$ref": "#/components/schemas/SecretRequest"}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "secret"], "title": "AddSecretRequestRequest"}, "AppSpecRequest": {"properties": {"port": {"type": "integer", "title": "Port"}, "map_to_port": {"type": "integer", "title": "Map To Port"}, "app_name": {"type": "string", "title": "App Name"}, "url_path": {"type": "string", "title": "Url Path"}, "url_query_params": {"additionalProperties": {"type": "string"}, "type": "object", "title": "Url Query Params"}}, "additionalProperties": false, "type": "object", "required": ["port", "app_name"], "title": "AppSpecRequest"}, "AzureClientCredsRequest": {"properties": {"type": {"type": "string", "enum": ["client"], "title": "Type", "description": "The type of credentials", "default": "client"}, "client_id": {"type": "string", "title": "Client Id", "description": "The client ID"}, "client_secret": {"type": "string", "title": "Client Secret", "description": "The client secret"}, "tenant_id": {"type": "string", "title": "Tenant Id"}}, "additionalProperties": false, "type": "object", "required": ["client_id", "client_secret"], "title": "AzureClientCredsRequest"}, "AzureConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["azure"], "title": "Type", "default": "azure"}, "tenant_id": {"type": "string", "title": "Tenant Id"}, "subscription_id": {"type": "string", "title": "Subscription Id"}, "locations": {"items": {"type": "string"}, "type": "array", "title": "Locations"}}, "additionalProperties": false, "type": "object", "required": ["tenant_id", "subscription_id"], "title": "AzureConfigInfoRequest"}, "AzureConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["azure"], "title": "Type", "default": "azure"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/AzureClientCredsRequest"}, {"$ref": "#/components/schemas/AzureDefaultCredsRequest"}], "title": "Creds"}, "tenant_id": {"type": "string", "title": "Tenant Id"}, "subscription_id": {"type": "string", "title": "Subscription Id"}, "locations": {"items": {"type": "string"}, "type": "array", "title": "Locations"}}, "additionalProperties": false, "type": "object", "title": "AzureConfigInfoWithCredsPartialRequest"}, "AzureConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["azure"], "title": "Type", "default": "azure"}, "tenant_id": {"type": "string", "title": "Tenant Id"}, "subscription_id": {"type": "string", "title": "Subscription Id"}, "locations": {"items": {"type": "string"}, "type": "array", "title": "Locations"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/AzureClientCredsRequest"}, {"$ref": "#/components/schemas/AzureDefaultCredsRequest"}], "title": "Creds"}}, "additionalProperties": false, "type": "object", "required": ["tenant_id", "subscription_id", "creds"], "title": "AzureConfigInfoWithCredsRequest"}, "AzureConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["azure"], "title": "Type", "default": "azure"}, "default_creds": {"type": "boolean", "title": "Default Creds", "default": false}, "tenant_id": {"$ref": "#/components/schemas/ConfigElementRequest"}, "subscription_id": {"$ref": "#/components/schemas/ConfigElementRequest"}, "locations": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "AzureConfigValuesRequest"}, "AzureDefaultCredsRequest": {"properties": {"type": {"type": "string", "enum": ["default"], "title": "Type", "description": "The type of credentials", "default": "default"}}, "additionalProperties": false, "type": "object", "title": "AzureDefaultCredsRequest"}, "BackendInfoRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "config": {"anyOf": [{"$ref": "#/components/schemas/AWSConfigInfoRequest"}, {"$ref": "#/components/schemas/AzureConfigInfoRequest"}, {"$ref": "#/components/schemas/CudoConfigInfoRequest"}, {"$ref": "#/components/schemas/DataCrunchConfigInfoRequest"}, {"$ref": "#/components/schemas/GCPConfigInfoRequest"}, {"$ref": "#/components/schemas/KubernetesConfigInfoRequest"}, {"$ref": "#/components/schemas/LambdaConfigInfoRequest"}, {"$ref": "#/components/schemas/NebiusConfigInfoRequest"}, {"$ref": "#/components/schemas/OCIConfigInfoRequest"}, {"$ref": "#/components/schemas/RunpodConfigInfoRequest"}, {"$ref": "#/components/schemas/TensorDockConfigInfoRequest"}, {"$ref": "#/components/schemas/VastAIConfigInfoRequest"}, {"$ref": "#/components/schemas/DstackConfigInfoRequest"}, {"$ref": "#/components/schemas/DstackBaseBackendConfigInfoRequest"}], "title": "Config"}}, "additionalProperties": false, "type": "object", "required": ["name", "config"], "title": "BackendInfoRequest"}, "BackendInfoYAMLRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "config_yaml": {"type": "string", "title": "Config Yaml"}}, "additionalProperties": false, "type": "object", "required": ["name", "config_yaml"], "title": "BackendInfoYAMLRequest"}, "BackendType": {"type": "string", "enum": ["aws", "azure", "cudo", "datacrunch", "dstack", "gcp", "kubernetes", "lambda", "local", "remote", "nebius", "oci", "runpod", "tensordock", "vastai"], "title": "BackendType", "description": "Attributes:\n    AWS (BackendType): Amazon Web Services\n    AZURE (BackendType): Microsoft Azure\n    CUDO (BackendType): Cudo\n    DSTACK (BackendType): dstack Sky\n    GCP (BackendType): Google Cloud Platform\n    DATACRUNCH (BackendType): DataCrunch\n    KUBERNETES (BackendType): Kubernetes\n    LAMBDA (BackendType): Lambda Cloud\n    RUNPOD (BackendType): Runpod Cloud\n    TENSORDOCK (BackendType): TensorDock Marketplace\n    VASTAI (BackendType): Vast.ai Marketplace"}, "Body_upload_code_api_project__project_name__repos_upload_code_post": {"properties": {"file": {"type": "string", "format": "binary", "title": "File"}}, "type": "object", "required": ["file"], "title": "Body_upload_code_api_project__project_name__repos_upload_code_post"}, "ConfigElementRequest": {"properties": {"selected": {"type": "string", "title": "Selected"}, "values": {"items": {"$ref": "#/components/schemas/ConfigElementValueRequest"}, "type": "array", "title": "Values", "default": []}}, "additionalProperties": false, "type": "object", "title": "ConfigElementRequest"}, "ConfigElementValueRequest": {"properties": {"value": {"type": "string", "title": "Value"}, "label": {"type": "string", "title": "Label"}}, "additionalProperties": false, "type": "object", "required": ["value", "label"], "title": "ConfigElementValueRequest"}, "ConfigMultiElementRequest": {"properties": {"selected": {"items": {"type": "string"}, "type": "array", "title": "Selected", "default": []}, "values": {"items": {"$ref": "#/components/schemas/ConfigElementValueRequest"}, "type": "array", "title": "Values", "default": []}}, "additionalProperties": false, "type": "object", "title": "ConfigMultiElementRequest"}, "CreateBackendYAMLRequestRequest": {"properties": {"config_yaml": {"type": "string", "title": "Config Yaml"}}, "additionalProperties": false, "type": "object", "required": ["config_yaml"], "title": "CreateBackendYAMLRequestRequest"}, "CreateFleetRequestRequest": {"properties": {"spec": {"$ref": "#/components/schemas/FleetSpecRequest"}}, "additionalProperties": false, "type": "object", "required": ["spec"], "title": "CreateFleetRequestRequest"}, "CreateGatewayRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "backend_type": {"$ref": "#/components/schemas/BackendType"}, "region": {"type": "string", "title": "Region"}, "configuration": {"$ref": "#/components/schemas/GatewayConfigurationRequest"}}, "additionalProperties": false, "type": "object", "title": "CreateGatewayRequestRequest"}, "CreateInstanceRequestRequest": {"properties": {"profile": {"$ref": "#/components/schemas/ProfileRequest"}, "requirements": {"$ref": "#/components/schemas/RequirementsRequest"}}, "additionalProperties": false, "type": "object", "required": ["profile", "requirements"], "title": "CreateInstanceRequestRequest"}, "CreatePoolRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}}, "additionalProperties": false, "type": "object", "required": ["name"], "title": "CreatePoolRequestRequest"}, "CreateProjectRequestRequest": {"properties": {"project_name": {"type": "string", "title": "Project Name"}}, "additionalProperties": false, "type": "object", "required": ["project_name"], "title": "CreateProjectRequestRequest"}, "CreateUserRequestRequest": {"properties": {"username": {"type": "string", "title": "Username"}, "global_role": {"$ref": "#/components/schemas/GlobalRole"}, "email": {"type": "string", "title": "Email"}}, "additionalProperties": false, "type": "object", "required": ["username", "global_role"], "title": "CreateUserRequestRequest"}, "CreateVolumeRequestRequest": {"properties": {"configuration": {"$ref": "#/components/schemas/VolumeConfigurationRequest"}}, "additionalProperties": false, "type": "object", "required": ["configuration"], "title": "CreateVolumeRequestRequest"}, "CreationPolicy": {"type": "string", "enum": ["reuse", "reuse-or-create"], "title": "CreationPolicy", "description": "An enumeration."}, "CudoAPIKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["api_key"], "title": "Type", "description": "The type of credentials", "default": "api_key"}, "api_key": {"type": "string", "title": "Api Key", "description": "The API key"}}, "additionalProperties": false, "type": "object", "required": ["api_key"], "title": "CudoAPIKeyCredsRequest"}, "CudoConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["cudo"], "title": "Type", "default": "cudo"}, "project_id": {"type": "string", "title": "Project Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "required": ["project_id"], "title": "CudoConfigInfoRequest"}, "CudoConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["cudo"], "title": "Type", "default": "cudo"}, "creds": {"$ref": "#/components/schemas/CudoAPIKeyCredsRequest"}, "project_id": {"type": "string", "title": "Project Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "CudoConfigInfoWithCredsPartialRequest"}, "CudoConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["cudo"], "title": "Type", "default": "cudo"}, "project_id": {"type": "string", "title": "Project Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/CudoAPIKeyCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["project_id", "creds"], "title": "CudoConfigInfoWithCredsRequest"}, "CudoConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["cudo"], "title": "Type", "default": "cudo"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}, "project_id": {"$ref": "#/components/schemas/ConfigElementRequest"}}, "additionalProperties": false, "type": "object", "title": "CudoConfigValuesRequest"}, "DataCrunchAPIKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["api_key"], "title": "Type", "description": "The type of credentials", "default": "api_key"}, "client_id": {"type": "string", "title": "Client Id", "description": "The client ID"}, "client_secret": {"type": "string", "title": "Client Secret", "description": "The client secret"}}, "additionalProperties": false, "type": "object", "required": ["client_id", "client_secret"], "title": "DataCrunchAPIKeyCredsRequest"}, "DataCrunchConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["datacrunch"], "title": "Type", "default": "datacrunch"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "DataCrunchConfigInfoRequest"}, "DataCrunchConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["datacrunch"], "title": "Type", "default": "datacrunch"}, "creds": {"$ref": "#/components/schemas/DataCrunchAPIKeyCredsRequest"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "DataCrunchConfigInfoWithCredsPartialRequest"}, "DataCrunchConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["datacrunch"], "title": "Type", "default": "datacrunch"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/DataCrunchAPIKeyCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "DataCrunchConfigInfoWithCredsRequest"}, "DataCrunchConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["datacrunch"], "title": "Type", "default": "datacrunch"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "DataCrunchConfigValuesRequest"}, "DeleteBackendsRequestRequest": {"properties": {"backends_names": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array"}}, "additionalProperties": false, "type": "object", "required": ["backends_names"], "title": "DeleteBackendsRequestRequest"}, "DeleteFleetInstancesRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "instance_nums": {"items": {"type": "integer"}, "type": "array", "title": "Instance Nums"}}, "additionalProperties": false, "type": "object", "required": ["name", "instance_nums"], "title": "DeleteFleetInstancesRequestRequest"}, "DeleteFleetsRequestRequest": {"properties": {"names": {"items": {"type": "string"}, "type": "array", "title": "Names"}}, "additionalProperties": false, "type": "object", "required": ["names"], "title": "DeleteFleetsRequestRequest"}, "DeleteGatewaysRequestRequest": {"properties": {"names": {"items": {"type": "string"}, "type": "array", "title": "Names"}}, "additionalProperties": false, "type": "object", "required": ["names"], "title": "DeleteGatewaysRequestRequest"}, "DeletePoolRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "force": {"type": "boolean", "title": "Force"}}, "additionalProperties": false, "type": "object", "required": ["name", "force"], "title": "DeletePoolRequestRequest"}, "DeleteProjectsRequestRequest": {"properties": {"projects_names": {"items": {"type": "string"}, "type": "array", "title": "Projects Names"}}, "additionalProperties": false, "type": "object", "required": ["projects_names"], "title": "DeleteProjectsRequestRequest"}, "DeleteReposRequestRequest": {"properties": {"repos_ids": {"items": {"type": "string"}, "type": "array", "title": "Repos Ids"}}, "additionalProperties": false, "type": "object", "required": ["repos_ids"], "title": "DeleteReposRequestRequest"}, "DeleteRunsRequestRequest": {"properties": {"runs_names": {"items": {"type": "string"}, "type": "array", "title": "Runs Names"}}, "additionalProperties": false, "type": "object", "required": ["runs_names"], "title": "DeleteRunsRequestRequest"}, "DeleteSecretsRequestRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}, "secrets_names": {"items": {"type": "string"}, "type": "array", "title": "Secrets Names"}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "secrets_names"], "title": "DeleteSecretsRequestRequest"}, "DeleteUsersRequestRequest": {"properties": {"users": {"items": {"type": "string"}, "type": "array", "title": "Users"}}, "additionalProperties": false, "type": "object", "required": ["users"], "title": "DeleteUsersRequestRequest"}, "DeleteVolumesRequestRequest": {"properties": {"names": {"items": {"type": "string"}, "type": "array", "title": "Names"}}, "additionalProperties": false, "type": "object", "required": ["names"], "title": "DeleteVolumesRequestRequest"}, "DevEnvironmentConfigurationRequest": {"properties": {"ide": {"type": "string", "enum": ["vscode"], "title": "Ide", "description": "The IDE to run"}, "version": {"type": "string", "title": "Version", "description": "The version of the IDE"}, "init": {"items": {"type": "string"}, "type": "array", "title": "Init", "description": "The bash commands to run", "default": []}, "type": {"type": "string", "enum": ["dev-environment"], "title": "Type", "default": "dev-environment"}, "name": {"type": "string", "title": "Name", "description": "The run name"}, "image": {"type": "string", "title": "Image", "description": "The name of the Docker image to run"}, "entrypoint": {"type": "string", "title": "Entrypoint", "description": "The Docker entrypoint"}, "working_dir": {"type": "string", "title": "Working Dir", "description": "The path to the working directory inside the container. It's specified relative to the repository directory (`/workflow`) and should be inside it. Defaults to `\".\"` "}, "home_dir": {"type": "string", "title": "Home Dir", "description": "The absolute path to the home directory inside the container. Defaults to `/root`", "default": "/root"}, "registry_auth": {"allOf": [{"$ref": "#/components/schemas/RegistryAuthRequest"}], "title": "Registry Auth", "description": "Credentials for pulling a private Docker image"}, "python": {"allOf": [{"$ref": "#/components/schemas/PythonVersion"}], "description": "The major version of Python. Mutually exclusive with `image`"}, "nvcc": {"type": "boolean", "title": "Nvcc", "description": "Use image with NVIDIA CUDA Compiler (NVCC) included. Mutually exclusive with `image`"}, "env": {"anyOf": [{"items": {"type": "string", "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*(=.*$|$)"}, "type": "array"}, {"additionalProperties": {"anyOf": [{"type": "string"}, {"$ref": "#/components/schemas/EnvSentinelRequest"}]}, "type": "object"}], "title": "Env", "description": "The mapping or the list of environment variables", "default": {}}, "setup": {"items": {"type": "string"}, "type": "array", "title": "Setup", "description": "The bash commands to run on the boot", "default": []}, "resources": {"allOf": [{"$ref": "#/components/schemas/ResourcesSpecRequest"}], "title": "Resources", "description": "The resources requirements to run the configuration", "default": {"cpu": {"min": 2}, "memory": {"min": 8.0}, "disk": {"size": {"min": 100.0}}}}, "volumes": {"items": {"$ref": "#/components/schemas/VolumeMountPointRequest"}, "type": "array", "title": "Volumes", "description": "The volumes mount points", "default": []}, "ports": {"items": {"anyOf": [{"type": "integer", "maximum": 65536.0, "exclusiveMinimum": 0.0}, {"type": "string", "pattern": "^(?:[0-9]+|\\*):[0-9]+$"}, {"$ref": "#/components/schemas/PortMappingRequest"}]}, "type": "array", "title": "Ports", "description": "Port numbers/mapping to expose", "default": []}, "backends": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array", "description": "The backends to consider for provisioning (e.g., `[aws, gcp]`)"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions", "description": "The regions to consider for provisioning (e.g., `[eu-west-1, us-west4, westeurope]`)"}, "instance_types": {"items": {"type": "string"}, "type": "array", "title": "Instance Types", "description": "The cloud-specific instance types to consider for provisioning (e.g., `[p3.8xlarge, n1-standard-4]`)"}, "spot_policy": {"allOf": [{"$ref": "#/components/schemas/SpotPolicy"}], "description": "The policy for provisioning spot or on-demand instances: `spot`, `on-demand`, or `auto`"}, "retry": {"anyOf": [{"$ref": "#/components/schemas/ProfileRetryRequest"}, {"type": "boolean"}], "title": "Retry", "description": "The policy for resubmitting the run. Defaults to `false`"}, "retry_policy": {"allOf": [{"$ref": "#/components/schemas/ProfileRetryPolicyRequest"}], "title": "Retry Policy", "description": "The policy for resubmitting the run. Deprecated in favor of `retry`"}, "max_duration": {"anyOf": [{"type": "string", "enum": ["off"]}, {"type": "string"}, {"type": "integer"}], "title": "Max Duration", "description": "The maximum duration of a run (e.g., `2h`, `1d`, etc). After it elapses, the run is forced to stop. Defaults to `off`"}, "max_price": {"type": "number", "exclusiveMinimum": 0.0, "title": "Max Price", "description": "The maximum instance price per hour, in dollars"}, "pool_name": {"type": "string", "title": "Pool Name", "description": "The name of the pool. If not set, dstack will use the default name"}, "instance_name": {"type": "string", "title": "Instance Name", "description": "The name of the instance"}, "creation_policy": {"allOf": [{"$ref": "#/components/schemas/CreationPolicy"}], "description": "The policy for using instances from the pool. Defaults to `reuse-or-create`"}, "termination_policy": {"allOf": [{"$ref": "#/components/schemas/TerminationPolicy"}], "description": "The policy for instance termination. Defaults to `destroy-after-idle`"}, "termination_idle_time": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Termination Idle Time", "description": "Time to wait before destroying the idle instance. Defaults to `5m` for `dstack run` and to `3d` for `dstack pool add`"}}, "additionalProperties": false, "type": "object", "required": ["ide"], "title": "DevEnvironmentConfigurationRequest"}, "DiskRequest": {"properties": {"size_mib": {"type": "integer", "title": "Size Mib"}}, "additionalProperties": false, "type": "object", "required": ["size_mib"], "title": "DiskRequest"}, "DiskSpecRequest": {"properties": {"size": {"allOf": [{"$ref": "#/components/schemas/Range_Memory_"}], "title": "Size", "description": "Disk size"}}, "additionalProperties": false, "type": "object", "required": ["size"], "title": "DiskSpecRequest"}, "DstackBaseBackendConfigInfoRequest": {"properties": {"type": {"type": "string", "title": "Type"}}, "additionalProperties": false, "type": "object", "required": ["type"], "title": "DstackBaseBackendConfigInfoRequest"}, "DstackConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["dstack"], "title": "Type", "default": "dstack"}, "base_backends": {"items": {"type": "string"}, "type": "array", "title": "Base Backends"}}, "additionalProperties": false, "type": "object", "required": ["base_backends"], "title": "DstackConfigInfoRequest", "description": "This is a config model of DstackBackend stored in BackendModel.config and used by DstackConfigurator."}, "DstackConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["dstack"], "title": "Type", "default": "dstack"}}, "additionalProperties": false, "type": "object", "title": "DstackConfigValuesRequest"}, "EnvSentinelRequest": {"properties": {"key": {"type": "string", "title": "Key"}}, "additionalProperties": false, "type": "object", "required": ["key"], "title": "EnvSentinelRequest"}, "FleetConfigurationRequest": {"properties": {"type": {"type": "string", "enum": ["fleet"], "title": "Type", "default": "fleet"}, "name": {"type": "string", "title": "Name", "description": "The fleet name"}, "ssh_config": {"allOf": [{"$ref": "#/components/schemas/SSHParamsRequest"}], "title": "Ssh Config", "description": "The parameters for adding instances via SSH"}, "nodes": {"allOf": [{"$ref": "#/components/schemas/Range_int_"}], "title": "Nodes", "description": "The number of instances"}, "placement": {"allOf": [{"$ref": "#/components/schemas/InstanceGroupPlacement"}], "description": "The placement of instances: `any` or `cluster`"}, "resources": {"allOf": [{"$ref": "#/components/schemas/ResourcesSpecRequest"}], "title": "Resources", "description": "The resources requirements", "default": {"cpu": {"min": 2}, "memory": {"min": 8.0}, "disk": {"size": {"min": 100.0}}}}, "backends": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array", "description": "The backends to consider for provisioning (e.g., `[aws, gcp]`)"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions", "description": "The regions to consider for provisioning (e.g., `[eu-west-1, us-west4, westeurope]`)"}, "instance_types": {"items": {"type": "string"}, "type": "array", "title": "Instance Types", "description": "The cloud-specific instance types to consider for provisioning (e.g., `[p3.8xlarge, n1-standard-4]`)"}, "spot_policy": {"allOf": [{"$ref": "#/components/schemas/SpotPolicy"}], "description": "The policy for provisioning spot or on-demand instances: `spot`, `on-demand`, or `auto`"}, "retry": {"anyOf": [{"$ref": "#/components/schemas/ProfileRetryRequest"}, {"type": "boolean"}], "title": "Retry", "description": "The policy for provisioning retry. Defaults to `false`"}, "max_price": {"type": "number", "exclusiveMinimum": 0.0, "title": "Max Price", "description": "The maximum instance price per hour, in dollars"}, "termination_policy": {"allOf": [{"$ref": "#/components/schemas/TerminationPolicy"}], "description": "The policy for instance termination. Defaults to `destroy-after-idle`"}, "termination_idle_time": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Termination Idle Time", "description": "Time to wait before destroying idle instances. Defaults to `3d`"}}, "additionalProperties": false, "type": "object", "title": "FleetConfigurationRequest"}, "FleetRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "project_name": {"type": "string", "title": "Project Name"}, "spec": {"$ref": "#/components/schemas/FleetSpecRequest"}, "created_at": {"type": "string", "format": "date-time", "title": "Created At"}, "status": {"$ref": "#/components/schemas/FleetStatus"}, "status_message": {"type": "string", "title": "Status Message"}, "instances": {"items": {"$ref": "#/components/schemas/InstanceRequest"}, "type": "array", "title": "Instances"}}, "additionalProperties": false, "type": "object", "required": ["name", "project_name", "spec", "created_at", "status", "instances"], "title": "FleetRequest"}, "FleetSpecRequest": {"properties": {"configuration": {"$ref": "#/components/schemas/FleetConfigurationRequest"}, "profile": {"$ref": "#/components/schemas/ProfileRequest"}, "autocreated": {"type": "boolean", "title": "Autocreated", "default": false}}, "additionalProperties": false, "type": "object", "required": ["configuration", "profile"], "title": "FleetSpecRequest"}, "FleetStatus": {"type": "string", "enum": ["submitted", "active", "terminating", "terminated", "failed"], "title": "FleetStatus", "description": "An enumeration."}, "GCPConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["gcp"], "title": "Type", "default": "gcp"}, "project_id": {"type": "string", "title": "Project Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "vpc_name": {"type": "string", "title": "Vpc Name"}, "vpc_project_id": {"type": "string", "title": "Vpc Project Id"}, "public_ips": {"type": "boolean", "title": "Public Ips"}}, "additionalProperties": false, "type": "object", "required": ["project_id"], "title": "GCPConfigInfoRequest"}, "GCPConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["gcp"], "title": "Type", "default": "gcp"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/GCPServiceAccountCredsRequest"}, {"$ref": "#/components/schemas/GCPDefaultCredsRequest"}], "title": "Creds"}, "project_id": {"type": "string", "title": "Project Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "vpc_name": {"type": "string", "title": "Vpc Name"}, "vpc_project_id": {"type": "string", "title": "Vpc Project Id"}, "public_ips": {"type": "boolean", "title": "Public Ips"}}, "additionalProperties": false, "type": "object", "title": "GCPConfigInfoWithCredsPartialRequest"}, "GCPConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["gcp"], "title": "Type", "default": "gcp"}, "project_id": {"type": "string", "title": "Project Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "vpc_name": {"type": "string", "title": "Vpc Name"}, "vpc_project_id": {"type": "string", "title": "Vpc Project Id"}, "public_ips": {"type": "boolean", "title": "Public Ips"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/GCPServiceAccountCredsRequest"}, {"$ref": "#/components/schemas/GCPDefaultCredsRequest"}], "title": "Creds"}}, "additionalProperties": false, "type": "object", "required": ["project_id", "creds"], "title": "GCPConfigInfoWithCredsRequest"}, "GCPConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["gcp"], "title": "Type", "default": "gcp"}, "default_creds": {"type": "boolean", "title": "Default Creds", "default": false}, "project_id": {"$ref": "#/components/schemas/ConfigElementRequest"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "GCPConfigValuesRequest"}, "GCPDefaultCredsRequest": {"properties": {"type": {"type": "string", "enum": ["default"], "title": "Type", "default": "default"}}, "additionalProperties": false, "type": "object", "title": "GCPDefaultCredsRequest"}, "GCPServiceAccountCredsRequest": {"properties": {"type": {"type": "string", "enum": ["service_account"], "title": "Type", "default": "service_account"}, "filename": {"type": "string", "title": "Filename"}, "data": {"type": "string", "title": "Data"}}, "additionalProperties": false, "type": "object", "required": ["filename", "data"], "title": "GCPServiceAccountCredsRequest"}, "GPUSpecRequest": {"properties": {"name": {"items": {"type": "string"}, "type": "array", "title": "Name", "description": "The name of the GPU (e.g., `A100` or `H100`)"}, "count": {"allOf": [{"$ref": "#/components/schemas/Range_int_"}], "title": "Count", "description": "The number of GPUs", "default": {"min": 1, "max": 1}}, "memory": {"allOf": [{"$ref": "#/components/schemas/Range_Memory_"}], "title": "Memory", "description": "The RAM size (e.g., `16GB`). Can be set to a range (e.g. `16GB..`, or `16GB..80GB`)"}, "total_memory": {"allOf": [{"$ref": "#/components/schemas/Range_Memory_"}], "title": "Total Memory", "description": "The total RAM size (e.g., `32GB`). Can be set to a range (e.g. `16GB..`, or `16GB..80GB`)"}, "compute_capability": {"items": {}, "type": "array", "title": "Compute Capability", "description": "The minimum compute capability of the GPU (e.g., `7.5`)"}}, "additionalProperties": false, "type": "object", "title": "GPUSpecRequest"}, "GatewayConfigurationRequest": {"properties": {"type": {"type": "string", "enum": ["gateway"], "title": "Type", "default": "gateway"}, "name": {"type": "string", "title": "Name", "description": "The gateway name"}, "default": {"type": "boolean", "title": "Default", "description": "Make the gateway default", "default": false}, "backend": {"allOf": [{"$ref": "#/components/schemas/BackendType"}], "description": "The gateway backend"}, "region": {"type": "string", "title": "Region", "description": "The gateway region"}, "domain": {"type": "string", "title": "Domain", "description": "The gateway domain, e.g. `example.com`"}, "public_ip": {"type": "boolean", "title": "Public Ip", "description": "Allocate public IP for the gateway", "default": true}, "certificate": {"anyOf": [{"$ref": "#/components/schemas/LetsEncryptGatewayCertificateRequest"}, {"$ref": "#/components/schemas/ACMGatewayCertificateRequest"}], "title": "Certificate", "description": "The SSL certificate configuration. Defaults to `type: lets-encrypt`", "default": {"type": "lets-encrypt"}}}, "additionalProperties": false, "type": "object", "required": ["backend", "region"], "title": "GatewayConfigurationRequest"}, "GatewayRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "configuration": {"$ref": "#/components/schemas/GatewayConfigurationRequest"}, "created_at": {"type": "string", "format": "date-time", "title": "Created At"}, "status": {"$ref": "#/components/schemas/GatewayStatus"}, "status_message": {"type": "string", "title": "Status Message"}, "hostname": {"type": "string", "title": "Hostname"}, "ip_address": {"type": "string", "title": "Ip Address"}, "instance_id": {"type": "string", "title": "Instance Id"}, "backend": {"$ref": "#/components/schemas/BackendType"}, "region": {"type": "string", "title": "Region"}, "default": {"type": "boolean", "title": "Default"}, "wildcard_domain": {"type": "string", "title": "Wildcard Domain"}}, "additionalProperties": false, "type": "object", "required": ["name", "configuration", "created_at", "status", "backend", "region", "default"], "title": "GatewayRequest"}, "GatewayStatus": {"type": "string", "enum": ["submitted", "provisioning", "running", "failed"], "title": "GatewayStatus", "description": "An enumeration."}, "GetFleetRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}}, "additionalProperties": false, "type": "object", "required": ["name"], "title": "GetFleetRequestRequest"}, "GetGatewayRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}}, "additionalProperties": false, "type": "object", "required": ["name"], "title": "GetGatewayRequestRequest"}, "GetOffersRequestRequest": {"properties": {"profile": {"$ref": "#/components/schemas/ProfileRequest"}, "requirements": {"$ref": "#/components/schemas/RequirementsRequest"}}, "additionalProperties": false, "type": "object", "required": ["profile", "requirements"], "title": "GetOffersRequestRequest"}, "GetRepoRequestRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}, "include_creds": {"type": "boolean", "title": "Include Creds"}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "include_creds"], "title": "GetRepoRequestRequest"}, "GetRunPlanRequestRequest": {"properties": {"run_spec": {"$ref": "#/components/schemas/RunSpecRequest"}}, "additionalProperties": false, "type": "object", "required": ["run_spec"], "title": "GetRunPlanRequestRequest"}, "GetRunRequestRequest": {"properties": {"run_name": {"type": "string", "title": "Run Name"}}, "additionalProperties": false, "type": "object", "required": ["run_name"], "title": "GetRunRequestRequest"}, "GetSecretsRequestRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}}, "additionalProperties": false, "type": "object", "required": ["repo_id"], "title": "GetSecretsRequestRequest"}, "GetUserRequestRequest": {"properties": {"username": {"type": "string", "title": "Username"}}, "additionalProperties": false, "type": "object", "required": ["username"], "title": "GetUserRequestRequest"}, "GetVolumeRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}}, "additionalProperties": false, "type": "object", "required": ["name"], "title": "GetVolumeRequestRequest"}, "GlobalRole": {"type": "string", "enum": ["admin", "user"], "title": "GlobalRole", "description": "An enumeration."}, "GpuRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "memory_mib": {"type": "integer", "title": "Memory Mib"}}, "additionalProperties": false, "type": "object", "required": ["name", "memory_mib"], "title": "GpuRequest"}, "HTTPValidationError": {"properties": {"detail": {"items": {"$ref": "#/components/schemas/ValidationError"}, "type": "array", "title": "Detail"}}, "type": "object", "title": "HTTPValidationError"}, "InstanceAvailability": {"enum": ["unknown", "available", "not_available", "no_quota", "idle", "busy"], "title": "InstanceAvailability", "description": "An enumeration."}, "InstanceGroupPlacement": {"type": "string", "enum": ["any", "cluster"], "title": "InstanceGroupPlacement", "description": "An enumeration."}, "InstanceOfferWithAvailabilityRequest": {"properties": {"backend": {"$ref": "#/components/schemas/BackendType"}, "instance": {"$ref": "#/components/schemas/InstanceTypeRequest"}, "region": {"type": "string", "title": "Region"}, "price": {"type": "number", "title": "Price"}, "availability": {"$ref": "#/components/schemas/InstanceAvailability"}, "instance_runtime": {"allOf": [{"$ref": "#/components/schemas/InstanceRuntime"}], "default": "shim"}}, "additionalProperties": false, "type": "object", "required": ["backend", "instance", "region", "price", "availability"], "title": "InstanceOfferWithAvailabilityRequest"}, "InstanceRequest": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}, "project_name": {"type": "string", "title": "Project Name"}, "backend": {"$ref": "#/components/schemas/BackendType"}, "instance_type": {"$ref": "#/components/schemas/InstanceTypeRequest"}, "name": {"type": "string", "title": "Name"}, "instance_num": {"type": "integer", "title": "Instance Num"}, "pool_name": {"type": "string", "title": "Pool Name"}, "job_name": {"type": "string", "title": "Job Name"}, "hostname": {"type": "string", "title": "Hostname"}, "status": {"$ref": "#/components/schemas/InstanceStatus"}, "unreachable": {"type": "boolean", "title": "Unreachable", "default": false}, "created": {"type": "string", "format": "date-time", "title": "Created"}, "region": {"type": "string", "title": "Region"}, "price": {"type": "number", "title": "Price"}}, "additionalProperties": false, "type": "object", "required": ["id", "project_name", "name", "instance_num", "status", "created"], "title": "InstanceRequest"}, "InstanceRuntime": {"enum": ["shim", "runner"], "title": "InstanceRuntime", "description": "An enumeration."}, "InstanceStatus": {"type": "string", "enum": ["pending", "provisioning", "idle", "busy", "terminating", "terminated"], "title": "InstanceStatus", "description": "An enumeration."}, "InstanceTypeRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "resources": {"$ref": "#/components/schemas/ResourcesRequest"}}, "additionalProperties": false, "type": "object", "required": ["name", "resources"], "title": "InstanceTypeRequest"}, "JobPlanRequest": {"properties": {"job_spec": {"$ref": "#/components/schemas/JobSpecRequest"}, "offers": {"items": {"$ref": "#/components/schemas/InstanceOfferWithAvailabilityRequest"}, "type": "array", "title": "Offers"}, "total_offers": {"type": "integer", "title": "Total Offers"}, "max_price": {"type": "number", "title": "Max Price"}}, "additionalProperties": false, "type": "object", "required": ["job_spec", "offers", "total_offers"], "title": "JobPlanRequest"}, "JobProvisioningDataRequest": {"properties": {"backend": {"$ref": "#/components/schemas/BackendType"}, "instance_type": {"$ref": "#/components/schemas/InstanceTypeRequest"}, "instance_id": {"type": "string", "title": "Instance Id"}, "hostname": {"type": "string", "title": "Hostname"}, "internal_ip": {"type": "string", "title": "Internal Ip"}, "public_ip_enabled": {"type": "boolean", "title": "Public Ip Enabled", "default": true}, "instance_network": {"type": "string", "title": "Instance Network"}, "region": {"type": "string", "title": "Region"}, "availability_zone": {"type": "string", "title": "Availability Zone"}, "price": {"type": "number", "title": "Price"}, "username": {"type": "string", "title": "Username"}, "ssh_port": {"type": "integer", "title": "Ssh Port"}, "dockerized": {"type": "boolean", "title": "Dockerized"}, "ssh_proxy": {"$ref": "#/components/schemas/SSHConnectionParamsRequest"}, "backend_data": {"type": "string", "title": "Backend Data"}}, "additionalProperties": false, "type": "object", "required": ["backend", "instance_type", "instance_id", "region", "price", "username", "dockerized"], "title": "JobProvisioningDataRequest"}, "JobRequest": {"properties": {"job_spec": {"$ref": "#/components/schemas/JobSpecRequest"}, "job_submissions": {"items": {"$ref": "#/components/schemas/JobSubmissionRequest"}, "type": "array", "title": "Job Submissions"}}, "additionalProperties": false, "type": "object", "required": ["job_spec", "job_submissions"], "title": "JobRequest"}, "JobSpecRequest": {"properties": {"replica_num": {"type": "integer", "title": "Replica Num", "default": 0}, "job_num": {"type": "integer", "title": "Job Num"}, "job_name": {"type": "string", "title": "Job Name"}, "jobs_per_replica": {"type": "integer", "title": "Jobs Per Replica", "default": 1}, "app_specs": {"items": {"$ref": "#/components/schemas/AppSpecRequest"}, "type": "array", "title": "App Specs"}, "commands": {"items": {"type": "string"}, "type": "array", "title": "Commands"}, "env": {"additionalProperties": {"type": "string"}, "type": "object", "title": "Env"}, "home_dir": {"type": "string", "title": "Home Dir"}, "image_name": {"type": "string", "title": "Image Name"}, "max_duration": {"type": "integer", "title": "Max Duration"}, "registry_auth": {"$ref": "#/components/schemas/RegistryAuthRequest"}, "requirements": {"$ref": "#/components/schemas/RequirementsRequest"}, "retry": {"$ref": "#/components/schemas/RetryRequest"}, "retry_policy": {"allOf": [{"$ref": "#/components/schemas/ProfileRetryPolicyRequest"}], "title": "Retry Policy", "default": {"retry": false}}, "working_dir": {"type": "string", "title": "Working Dir"}}, "additionalProperties": false, "type": "object", "required": ["job_num", "job_name", "commands", "env", "image_name", "requirements"], "title": "JobSpecRequest"}, "JobStatus": {"type": "string", "enum": ["submitted", "provisioning", "pulling", "running", "terminating", "terminated", "aborted", "failed", "done"], "title": "JobStatus", "description": "An enumeration."}, "JobSubmissionLogsRequest": {"properties": {"logs": {"items": {"$ref": "#/components/schemas/LogEventRequest"}, "type": "array", "title": "Logs"}}, "additionalProperties": false, "type": "object", "required": ["logs"], "title": "JobSubmissionLogsRequest"}, "JobSubmissionRequest": {"properties": {"id": {"type": "string", "format": "uuid4", "title": "Id"}, "submission_num": {"type": "integer", "title": "Submission Num"}, "submitted_at": {"type": "string", "format": "date-time", "title": "Submitted At"}, "last_processed_at": {"type": "string", "format": "date-time", "title": "Last Processed At"}, "finished_at": {"type": "string", "format": "date-time", "title": "Finished At"}, "status": {"$ref": "#/components/schemas/JobStatus"}, "termination_reason": {"$ref": "#/components/schemas/JobTerminationReason"}, "termination_reason_message": {"type": "string", "title": "Termination Reason Message"}, "job_provisioning_data": {"$ref": "#/components/schemas/JobProvisioningDataRequest"}}, "additionalProperties": false, "type": "object", "required": ["id", "submission_num", "submitted_at", "last_processed_at", "status"], "title": "JobSubmissionRequest"}, "JobTerminationReason": {"type": "string", "enum": ["failed_to_start_due_to_no_capacity", "interrupted_by_no_capacity", "waiting_instance_limit_exceeded", "waiting_runner_limit_exceeded", "terminated_by_user", "volume_error", "gateway_error", "scaled_down", "done_by_runner", "aborted_by_user", "terminated_by_server", "container_exited_with_error", "ports_binding_failed", "creating_container_error", "executor_error"], "title": "JobTerminationReason", "description": "An enumeration."}, "KubeconfigConfigRequest": {"properties": {"filename": {"type": "string", "title": "Filename"}, "data": {"type": "string", "title": "Data"}}, "additionalProperties": false, "type": "object", "required": ["filename", "data"], "title": "KubeconfigConfigRequest"}, "KubernetesConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["kubernetes"], "title": "Type", "default": "kubernetes"}, "networking": {"$ref": "#/components/schemas/KubernetesNetworkingConfigRequest"}}, "additionalProperties": false, "type": "object", "required": ["networking"], "title": "KubernetesConfigInfoRequest"}, "KubernetesConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["kubernetes"], "title": "Type", "default": "kubernetes"}, "networking": {"$ref": "#/components/schemas/KubernetesNetworkingConfigRequest"}, "kubeconfig": {"$ref": "#/components/schemas/KubeconfigConfigRequest"}}, "additionalProperties": false, "type": "object", "required": ["networking", "kubeconfig"], "title": "KubernetesConfigInfoWithCredsPartialRequest"}, "KubernetesConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["kubernetes"], "title": "Type", "default": "kubernetes"}, "networking": {"$ref": "#/components/schemas/KubernetesNetworkingConfigRequest"}, "kubeconfig": {"$ref": "#/components/schemas/KubeconfigConfigRequest"}}, "additionalProperties": false, "type": "object", "required": ["networking", "kubeconfig"], "title": "KubernetesConfigInfoWithCredsRequest"}, "KubernetesConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["kubernetes"], "title": "Type", "default": "kubernetes"}}, "additionalProperties": false, "type": "object", "title": "KubernetesConfigValuesRequest"}, "KubernetesNetworkingConfigRequest": {"properties": {"ssh_host": {"type": "string", "title": "Ssh Host", "description": "The external IP address of any node"}, "ssh_port": {"type": "integer", "title": "Ssh Port", "description": "Any port accessible outside of the cluster"}}, "additionalProperties": false, "type": "object", "title": "KubernetesNetworkingConfigRequest"}, "LambdaAPIKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["api_key"], "title": "Type", "description": "The type of credentials", "default": "api_key"}, "api_key": {"type": "string", "title": "Api Key", "description": "The API key"}}, "additionalProperties": false, "type": "object", "required": ["api_key"], "title": "LambdaAPIKeyCredsRequest"}, "LambdaConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["lambda"], "title": "Type", "default": "lambda"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "LambdaConfigInfoRequest"}, "LambdaConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["lambda"], "title": "Type", "default": "lambda"}, "creds": {"$ref": "#/components/schemas/LambdaAPIKeyCredsRequest"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "LambdaConfigInfoWithCredsPartialRequest"}, "LambdaConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["lambda"], "title": "Type", "default": "lambda"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/LambdaAPIKeyCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "LambdaConfigInfoWithCredsRequest"}, "LambdaConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["lambda"], "title": "Type", "default": "lambda"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "LambdaConfigValuesRequest"}, "LetsEncryptGatewayCertificateRequest": {"properties": {"type": {"type": "string", "enum": ["lets-encrypt"], "title": "Type", "description": "Automatic certificates by Let's Encrypt", "default": "lets-encrypt"}}, "additionalProperties": false, "type": "object", "title": "LetsEncryptGatewayCertificateRequest"}, "ListPoolsRequestRequest": {"properties": {"project_name": {"type": "string", "title": "Project Name"}, "pool_name": {"type": "string", "title": "Pool Name"}, "only_active": {"type": "boolean", "title": "Only Active", "default": false}, "prev_created_at": {"type": "string", "format": "date-time", "title": "Prev Created At"}, "prev_id": {"type": "string", "format": "uuid", "title": "Prev Id"}, "limit": {"type": "integer", "title": "Limit", "default": 1000}, "ascending": {"type": "boolean", "title": "Ascending", "default": false}}, "additionalProperties": false, "type": "object", "title": "ListPoolsRequestRequest"}, "ListRunsRequestRequest": {"properties": {"project_name": {"type": "string", "title": "Project Name"}, "repo_id": {"type": "string", "title": "Repo Id"}, "username": {"type": "string", "title": "Username"}, "only_active": {"type": "boolean", "title": "Only Active", "default": false}, "prev_submitted_at": {"type": "string", "format": "date-time", "title": "Prev Submitted At"}, "prev_run_id": {"type": "string", "format": "uuid", "title": "Prev Run Id"}, "limit": {"type": "integer", "maximum": 100.0, "minimum": 0.0, "title": "Limit", "default": 100}, "ascending": {"type": "boolean", "title": "Ascending", "default": false}}, "additionalProperties": false, "type": "object", "title": "ListRunsRequestRequest"}, "ListSecretsRequestRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}}, "additionalProperties": false, "type": "object", "required": ["repo_id"], "title": "ListSecretsRequestRequest"}, "LocalRepoInfoRequest": {"properties": {"repo_type": {"type": "string", "enum": ["local"], "title": "Repo Type", "default": "local"}, "repo_dir": {"type": "string", "title": "Repo Dir"}}, "additionalProperties": false, "type": "object", "required": ["repo_dir"], "title": "LocalRepoInfoRequest"}, "LocalRunRepoDataRequest": {"properties": {"repo_type": {"type": "string", "enum": ["local"], "title": "Repo Type", "default": "local"}, "repo_dir": {"type": "string", "title": "Repo Dir"}}, "additionalProperties": false, "type": "object", "required": ["repo_dir"], "title": "LocalRunRepoDataRequest"}, "LogEventRequest": {"properties": {"timestamp": {"type": "string", "format": "date-time", "title": "Timestamp"}, "log_source": {"$ref": "#/components/schemas/LogEventSource"}, "message": {"type": "string", "title": "Message"}}, "additionalProperties": false, "type": "object", "required": ["timestamp", "log_source", "message"], "title": "LogEventRequest"}, "LogEventSource": {"type": "string", "enum": ["stdout", "stderr"], "title": "LogEventSource", "description": "An enumeration."}, "MemberRequest": {"properties": {"user": {"$ref": "#/components/schemas/UserRequest"}, "project_role": {"$ref": "#/components/schemas/ProjectRole"}}, "additionalProperties": false, "type": "object", "required": ["user", "project_role"], "title": "MemberRequest"}, "MemberSettingRequest": {"properties": {"username": {"type": "string", "title": "Username"}, "project_role": {"$ref": "#/components/schemas/ProjectRole"}}, "additionalProperties": false, "type": "object", "required": ["username", "project_role"], "title": "MemberSettingRequest"}, "NebiusConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["nebius"], "title": "Type", "default": "nebius"}, "cloud_id": {"type": "string", "title": "Cloud Id"}, "folder_id": {"type": "string", "title": "Folder Id"}, "network_id": {"type": "string", "title": "Network Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "required": ["cloud_id", "folder_id", "network_id"], "title": "NebiusConfigInfoRequest"}, "NebiusConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["nebius"], "title": "Type", "default": "nebius"}, "creds": {"$ref": "#/components/schemas/NebiusServiceAccountCredsRequest"}, "cloud_id": {"type": "string", "title": "Cloud Id"}, "folder_id": {"type": "string", "title": "Folder Id"}, "network_id": {"type": "string", "title": "Network Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "NebiusConfigInfoWithCredsPartialRequest"}, "NebiusConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["nebius"], "title": "Type", "default": "nebius"}, "cloud_id": {"type": "string", "title": "Cloud Id"}, "folder_id": {"type": "string", "title": "Folder Id"}, "network_id": {"type": "string", "title": "Network Id"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/NebiusServiceAccountCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["cloud_id", "folder_id", "network_id", "creds"], "title": "NebiusConfigInfoWithCredsRequest"}, "NebiusConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["nebius"], "title": "Type", "default": "nebius"}, "cloud_id": {"$ref": "#/components/schemas/ConfigElementRequest"}, "folder_id": {"$ref": "#/components/schemas/ConfigElementRequest"}, "network_id": {"$ref": "#/components/schemas/ConfigElementRequest"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "NebiusConfigValuesRequest"}, "NebiusServiceAccountCredsRequest": {"properties": {"type": {"type": "string", "enum": ["service_account"], "title": "Type", "default": "service_account"}, "filename": {"type": "string", "title": "Filename"}, "data": {"type": "string", "title": "Data"}}, "additionalProperties": false, "type": "object", "required": ["filename", "data"], "title": "NebiusServiceAccountCredsRequest"}, "OCIClientCredsRequest": {"properties": {"type": {"type": "string", "enum": ["client"], "title": "Type", "description": "The type of credentials", "default": "client"}, "user": {"type": "string", "title": "User", "description": "User OCID"}, "tenancy": {"type": "string", "title": "Tenancy", "description": "Tenancy OCID"}, "key_file": {"type": "string", "title": "Key File", "description": "Path to the user's private PEM key. Either this or `key_content` should be set"}, "key_content": {"type": "string", "title": "Key Content", "description": "Content of the user's private PEM key. Either this or `key_file` should be set"}, "pass_phrase": {"type": "string", "title": "Pass Phrase", "description": "Passphrase for the private PEM key if it is encrypted"}, "fingerprint": {"type": "string", "title": "Fingerprint", "description": "User's public key fingerprint"}, "region": {"type": "string", "title": "Region", "description": "Name or key of any region the tenancy is subscribed to"}}, "additionalProperties": false, "type": "object", "required": ["user", "tenancy", "fingerprint", "region"], "title": "OCIClientCredsRequest"}, "OCIConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["oci"], "title": "Type", "default": "oci"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "compartment_id": {"type": "string", "title": "Compartment Id"}}, "additionalProperties": false, "type": "object", "title": "OCIConfigInfoRequest"}, "OCIConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["oci"], "title": "Type", "default": "oci"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/OCIClientCredsRequest"}, {"$ref": "#/components/schemas/OCIDefaultCredsRequest"}], "title": "Creds"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "compartment_id": {"type": "string", "title": "Compartment Id"}}, "additionalProperties": false, "type": "object", "title": "OCIConfigInfoWithCredsPartialRequest"}, "OCIConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["oci"], "title": "Type", "default": "oci"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "compartment_id": {"type": "string", "title": "Compartment Id"}, "creds": {"anyOf": [{"$ref": "#/components/schemas/OCIClientCredsRequest"}, {"$ref": "#/components/schemas/OCIDefaultCredsRequest"}], "title": "Creds"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "OCIConfigInfoWithCredsRequest"}, "OCIConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["oci"], "title": "Type", "default": "oci"}, "default_creds": {"type": "boolean", "title": "Default Creds", "default": false}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}, "compartment_id": {"type": "string", "title": "Compartment Id"}}, "additionalProperties": false, "type": "object", "title": "OCIConfigValuesRequest"}, "OCIDefaultCredsRequest": {"properties": {"type": {"type": "string", "enum": ["default"], "title": "Type", "description": "The type of credentials", "default": "default"}, "file": {"type": "string", "title": "File", "description": "Path to the OCI CLI-compatible config file", "default": "~/.oci/config"}, "profile": {"type": "string", "title": "Profile", "description": "Profile to load from the config file", "default": "DEFAULT"}}, "additionalProperties": false, "type": "object", "title": "OCIDefaultCredsRequest"}, "OpenAIChatModelRequest": {"properties": {"type": {"type": "string", "enum": ["chat"], "title": "Type", "description": "The type of the model"}, "name": {"type": "string", "title": "Name", "description": "The name of the model"}, "format": {"type": "string", "enum": ["openai"], "title": "Format"}, "prefix": {"type": "string", "title": "Prefix", "description": "The `base_url` prefix (after hostname)", "default": "/v1"}}, "additionalProperties": false, "type": "object", "required": ["type", "name", "format"], "title": "OpenAIChatModelRequest", "description": "Mapping of the model for the OpenAI-compatible endpoint.\n\nAttributes:\n    type (str): The type of the model, e.g. \"chat\"\n    name (str): The name of the model. This name will be used both to load model configuration from the HuggingFace Hub and in the OpenAI-compatible endpoint.\n    format (str): The format of the model, i.e. \"openai\".\n    prefix (str): The `base_url` prefix: `http://hostname/{prefix}/chat/completions`. Defaults to `/v1`."}, "PollLogsRequestRequest": {"properties": {"run_name": {"type": "string", "title": "Run Name"}, "job_submission_id": {"type": "string", "format": "uuid4", "title": "Job Submission Id"}, "start_time": {"type": "string", "format": "date-time", "title": "Start Time"}, "end_time": {"type": "string", "format": "date-time", "title": "End Time"}, "descending": {"type": "boolean", "title": "Descending", "default": false}, "limit": {"type": "integer", "maximum": 1000.0, "minimum": 0.0, "title": "Limit", "default": 100}, "diagnose": {"type": "boolean", "title": "Diagnose", "default": false}}, "additionalProperties": false, "type": "object", "required": ["run_name", "job_submission_id"], "title": "PollLogsRequestRequest"}, "PoolInstanceOffersRequest": {"properties": {"pool_name": {"type": "string", "title": "Pool Name"}, "instances": {"items": {"$ref": "#/components/schemas/InstanceOfferWithAvailabilityRequest"}, "type": "array", "title": "Instances"}}, "additionalProperties": false, "type": "object", "required": ["pool_name", "instances"], "title": "PoolInstanceOffersRequest"}, "PoolInstancesRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "instances": {"items": {"$ref": "#/components/schemas/InstanceRequest"}, "type": "array", "title": "Instances"}}, "additionalProperties": false, "type": "object", "required": ["name", "instances"], "title": "PoolInstancesRequest"}, "PoolRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "default": {"type": "boolean", "title": "Default"}, "created_at": {"type": "string", "format": "date-time", "title": "Created At"}, "total_instances": {"type": "integer", "title": "Total Instances"}, "available_instances": {"type": "integer", "title": "Available Instances"}}, "additionalProperties": false, "type": "object", "required": ["name", "default", "created_at", "total_instances", "available_instances"], "title": "PoolRequest"}, "PortMappingRequest": {"properties": {"local_port": {"type": "integer", "maximum": 65536.0, "exclusiveMinimum": 0.0, "title": "Local Port"}, "container_port": {"type": "integer", "maximum": 65536.0, "exclusiveMinimum": 0.0, "title": "Container Port"}}, "additionalProperties": false, "type": "object", "required": ["container_port"], "title": "PortMappingRequest"}, "ProfileRequest": {"properties": {"backends": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array", "description": "The backends to consider for provisioning (e.g., `[aws, gcp]`)"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions", "description": "The regions to consider for provisioning (e.g., `[eu-west-1, us-west4, westeurope]`)"}, "instance_types": {"items": {"type": "string"}, "type": "array", "title": "Instance Types", "description": "The cloud-specific instance types to consider for provisioning (e.g., `[p3.8xlarge, n1-standard-4]`)"}, "spot_policy": {"allOf": [{"$ref": "#/components/schemas/SpotPolicy"}], "description": "The policy for provisioning spot or on-demand instances: `spot`, `on-demand`, or `auto`"}, "retry": {"anyOf": [{"$ref": "#/components/schemas/ProfileRetryRequest"}, {"type": "boolean"}], "title": "Retry", "description": "The policy for resubmitting the run. Defaults to `false`"}, "retry_policy": {"allOf": [{"$ref": "#/components/schemas/ProfileRetryPolicyRequest"}], "title": "Retry Policy", "description": "The policy for resubmitting the run. Deprecated in favor of `retry`"}, "max_duration": {"anyOf": [{"type": "string", "enum": ["off"]}, {"type": "string"}, {"type": "integer"}], "title": "Max Duration", "description": "The maximum duration of a run (e.g., `2h`, `1d`, etc). After it elapses, the run is forced to stop. Defaults to `off`"}, "max_price": {"type": "number", "exclusiveMinimum": 0.0, "title": "Max Price", "description": "The maximum instance price per hour, in dollars"}, "pool_name": {"type": "string", "title": "Pool Name", "description": "The name of the pool. If not set, dstack will use the default name"}, "instance_name": {"type": "string", "title": "Instance Name", "description": "The name of the instance"}, "creation_policy": {"allOf": [{"$ref": "#/components/schemas/CreationPolicy"}], "description": "The policy for using instances from the pool. Defaults to `reuse-or-create`"}, "termination_policy": {"allOf": [{"$ref": "#/components/schemas/TerminationPolicy"}], "description": "The policy for instance termination. Defaults to `destroy-after-idle`"}, "termination_idle_time": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Termination Idle Time", "description": "Time to wait before destroying the idle instance. Defaults to `5m` for `dstack run` and to `3d` for `dstack pool add`"}, "name": {"type": "string", "title": "Name", "description": "The name of the profile that can be passed as `--profile` to `dstack run`"}, "default": {"type": "boolean", "title": "Default", "description": "If set to true, `dstack run` will use this profile by default.", "default": false}}, "additionalProperties": false, "type": "object", "required": ["name"], "title": "ProfileRequest"}, "ProfileRetryPolicyRequest": {"properties": {"retry": {"type": "boolean", "title": "Retry", "description": "Whether to retry the run on failure or not", "default": false}, "duration": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Duration", "description": "The maximum period of retrying the run, e.g., `4h` or `1d`"}}, "additionalProperties": false, "type": "object", "title": "ProfileRetryPolicyRequest"}, "ProfileRetryRequest": {"properties": {"on_events": {"items": {"$ref": "#/components/schemas/RetryEvent"}, "type": "array", "description": "The list of events that should be handled with retry. Supported events are `no-capacity`, `interruption`, and `error`"}, "duration": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Duration", "description": "The maximum period of retrying the run, e.g., `4h` or `1d`"}}, "additionalProperties": false, "type": "object", "required": ["on_events"], "title": "ProfileRetryRequest"}, "ProjectRequest": {"properties": {"project_id": {"type": "string", "format": "uuid4", "title": "Project Id"}, "project_name": {"type": "string", "title": "Project Name"}, "owner": {"$ref": "#/components/schemas/UserRequest"}, "backends": {"items": {"$ref": "#/components/schemas/BackendInfoRequest"}, "type": "array", "title": "Backends"}, "members": {"items": {"$ref": "#/components/schemas/MemberRequest"}, "type": "array", "title": "Members"}}, "additionalProperties": false, "type": "object", "required": ["project_id", "project_name", "owner", "backends", "members"], "title": "ProjectRequest"}, "ProjectRole": {"type": "string", "enum": ["admin", "user"], "title": "ProjectRole", "description": "An enumeration."}, "PythonVersion": {"type": "string", "enum": ["3.8", "3.9", "3.10", "3.11", "3.12"], "title": "PythonVersion", "description": "An enumeration."}, "Range_Memory_": {"properties": {"min": {"type": "number", "title": "Min"}, "max": {"type": "number", "title": "Max"}}, "additionalProperties": false, "type": "object", "title": "Range[Memory]"}, "Range_int_": {"properties": {"min": {"type": "integer", "title": "Min"}, "max": {"type": "integer", "title": "Max"}}, "additionalProperties": false, "type": "object", "title": "Range[int]"}, "RefreshTokenRequestRequest": {"properties": {"username": {"type": "string", "title": "Username"}}, "additionalProperties": false, "type": "object", "required": ["username"], "title": "RefreshTokenRequestRequest"}, "RegistryAuthRequest": {"properties": {"username": {"type": "string", "title": "Username", "description": "The username"}, "password": {"type": "string", "title": "Password", "description": "The password or access token"}}, "additionalProperties": false, "type": "object", "required": ["username", "password"], "title": "RegistryAuthRequest", "description": "Credentials for pulling a private Docker image.\n\nAttributes:\n    username (str): The username\n    password (str): The password or access token"}, "RemoteRepoCredsDtoRequest": {"properties": {"protocol": {"$ref": "#/components/schemas/RepoProtocol"}, "clone_url": {"type": "string", "title": "Clone Url"}, "private_key": {"type": "string", "title": "Private Key"}, "oauth_token": {"type": "string", "title": "Oauth Token"}}, "additionalProperties": false, "type": "object", "required": ["protocol"], "title": "RemoteRepoCredsDtoRequest"}, "RemoteRepoCredsRequest": {"properties": {"protocol": {"$ref": "#/components/schemas/RepoProtocol"}, "clone_url": {"type": "string", "title": "Clone Url"}, "private_key": {"type": "string", "title": "Private Key"}, "oauth_token": {"type": "string", "title": "Oauth Token"}}, "additionalProperties": false, "type": "object", "required": ["protocol", "clone_url"], "title": "RemoteRepoCredsRequest"}, "RemoteRepoInfoRequest": {"properties": {"repo_type": {"type": "string", "enum": ["remote"], "title": "Repo Type", "default": "remote"}, "repo_name": {"type": "string", "title": "Repo Name"}, "repo_host_name": {"type": "string", "title": "Repo Host Name", "default": ""}, "repo_port": {"type": "integer", "title": "Repo Port"}, "repo_user_name": {"type": "string", "title": "Repo User Name", "default": ""}}, "additionalProperties": false, "type": "object", "required": ["repo_name"], "title": "RemoteRepoInfoRequest"}, "RemoteRunRepoDataRequest": {"properties": {"repo_type": {"type": "string", "enum": ["remote"], "title": "Repo Type", "default": "remote"}, "repo_name": {"type": "string", "title": "Repo Name"}, "repo_host_name": {"type": "string", "title": "Repo Host Name", "default": ""}, "repo_port": {"type": "integer", "title": "Repo Port"}, "repo_user_name": {"type": "string", "title": "Repo User Name", "default": ""}, "repo_branch": {"type": "string", "title": "Repo Branch"}, "repo_hash": {"type": "string", "title": "Repo Hash"}, "repo_diff": {"type": "string", "title": "Repo Diff"}, "repo_config_name": {"type": "string", "title": "Repo Config Name"}, "repo_config_email": {"type": "string", "title": "Repo Config Email"}}, "additionalProperties": false, "type": "object", "required": ["repo_name"], "title": "RemoteRunRepoDataRequest"}, "RemoveInstanceRequestRequest": {"properties": {"pool_name": {"type": "string", "title": "Pool Name"}, "instance_name": {"type": "string", "title": "Instance Name"}, "force": {"type": "boolean", "title": "Force", "default": false}}, "additionalProperties": false, "type": "object", "required": ["pool_name", "instance_name"], "title": "RemoveInstanceRequestRequest"}, "RepoHeadRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}, "repo_info": {"oneOf": [{"$ref": "#/components/schemas/RemoteRepoInfoRequest"}, {"$ref": "#/components/schemas/LocalRepoInfoRequest"}, {"$ref": "#/components/schemas/VirtualRepoInfoRequest"}], "title": "Repo Info", "discriminator": {"propertyName": "repo_type", "mapping": {"remote": "#/components/schemas/RemoteRepoInfoRequest", "local": "#/components/schemas/LocalRepoInfoRequest", "virtual": "#/components/schemas/VirtualRepoInfoRequest"}}}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "repo_info"], "title": "RepoHeadRequest"}, "RepoHeadWithCredsRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}, "repo_info": {"oneOf": [{"$ref": "#/components/schemas/RemoteRepoInfoRequest"}, {"$ref": "#/components/schemas/LocalRepoInfoRequest"}, {"$ref": "#/components/schemas/VirtualRepoInfoRequest"}], "title": "Repo Info", "discriminator": {"propertyName": "repo_type", "mapping": {"remote": "#/components/schemas/RemoteRepoInfoRequest", "local": "#/components/schemas/LocalRepoInfoRequest", "virtual": "#/components/schemas/VirtualRepoInfoRequest"}}}, "repo_creds": {"$ref": "#/components/schemas/RemoteRepoCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "repo_info"], "title": "RepoHeadWithCredsRequest"}, "RepoProtocol": {"type": "string", "enum": ["ssh", "https"], "title": "RepoProtocol", "description": "An enumeration."}, "RequirementsRequest": {"properties": {"resources": {"$ref": "#/components/schemas/ResourcesSpecRequest"}, "max_price": {"type": "number", "title": "Max Price"}, "spot": {"type": "boolean", "title": "Spot"}}, "additionalProperties": false, "type": "object", "required": ["resources"], "title": "RequirementsRequest"}, "ResourcesRequest": {"properties": {"cpus": {"type": "integer", "title": "Cpus"}, "memory_mib": {"type": "integer", "title": "Memory Mib"}, "gpus": {"items": {"$ref": "#/components/schemas/GpuRequest"}, "type": "array", "title": "Gpus"}, "spot": {"type": "boolean", "title": "Spot"}, "disk": {"allOf": [{"$ref": "#/components/schemas/DiskRequest"}], "title": "Disk", "default": {"size_mib": 102400}}, "description": {"type": "string", "title": "Description", "default": ""}}, "additionalProperties": false, "type": "object", "required": ["cpus", "memory_mib", "gpus", "spot"], "title": "ResourcesRequest"}, "ResourcesSpecRequest": {"properties": {"cpu": {"anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Union_int__str__"}, {"type": "integer"}, {"type": "string"}], "title": "Cpu", "description": "The number of CPU cores", "default": {"min": 2}}, "memory": {"anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Union_Memory__float__int__str__"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}], "title": "Memory", "description": "The RAM size (e.g., `8GB`)", "default": {"min": 8.0}}, "shm_size": {"anyOf": [{"type": "number"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}], "title": "Shm Size", "description": "The size of shared memory (e.g., `8GB`). If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure this"}, "gpu": {"anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/GPUSpecRequest"}, {"$ref": "#/definitions/ResourcesSpecRequest/definitions/GPUSpecSchemaRequest"}, {"type": "integer"}, {"type": "string"}], "title": "Gpu", "description": "The GPU requirements. Can be set to a number, a string (e.g. `A100`, `80GB:2`, etc.), or an object"}, "disk": {"anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/DiskSpecRequest"}, {"$ref": "#/definitions/ResourcesSpecRequest/definitions/DiskSpecSchemaRequest"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}], "title": "Disk", "description": "The disk resources", "default": {"size": {"min": 100.0}}}}, "additionalProperties": false, "type": "object", "title": "ResourcesSpecSchemaRequest", "definitions": {"Range_Union_int__str__": {"title": "Range[Union[int, str]]", "type": "object", "properties": {"min": {"title": "Min", "anyOf": [{"type": "integer"}, {"type": "string"}]}, "max": {"title": "Max", "anyOf": [{"type": "integer"}, {"type": "string"}]}}, "additionalProperties": false}, "Range_Union_Memory__float__int__str__": {"title": "Range[Union[Memory, float, int, str]]", "type": "object", "properties": {"min": {"title": "Min", "anyOf": [{"type": "number"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}]}, "max": {"title": "Max", "anyOf": [{"type": "number"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}]}}, "additionalProperties": false}, "Range_int_": {"title": "Range[int]", "type": "object", "properties": {"min": {"title": "Min", "type": "integer"}, "max": {"title": "Max", "type": "integer"}}, "additionalProperties": false}, "Range_Memory_": {"title": "Range[Memory]", "type": "object", "properties": {"min": {"title": "Min", "type": "number"}, "max": {"title": "Max", "type": "number"}}, "additionalProperties": false}, "GPUSpecRequest": {"title": "GPUSpecRequest", "type": "object", "properties": {"name": {"title": "Name", "description": "The name of the GPU (e.g., `A100` or `H100`)", "type": "array", "items": {"type": "string"}}, "count": {"title": "Count", "description": "The number of GPUs", "default": {"min": 1, "max": 1}, "allOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_int_"}]}, "memory": {"title": "Memory", "description": "The RAM size (e.g., `16GB`). Can be set to a range (e.g. `16GB..`, or `16GB..80GB`)", "allOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Memory_"}]}, "total_memory": {"title": "Total Memory", "description": "The total RAM size (e.g., `32GB`). Can be set to a range (e.g. `16GB..`, or `16GB..80GB`)", "allOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Memory_"}]}, "compute_capability": {"title": "Compute Capability", "description": "The minimum compute capability of the GPU (e.g., `7.5`)", "type": "array", "items": {}}}, "additionalProperties": false}, "GPUSpecSchemaRequest": {"title": "GPUSpecSchemaRequest", "type": "object", "properties": {"name": {"title": "Name", "description": "The GPU name or list of names", "anyOf": [{"type": "array", "items": {"type": "string"}}, {"type": "string"}]}, "count": {"title": "Count", "description": "The number of GPUs", "default": {"min": 1, "max": 1}, "anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Union_int__str__"}, {"type": "integer"}, {"type": "string"}]}, "memory": {"title": "Memory", "description": "The RAM size (e.g., `16GB`). Can be set to a range (e.g. `16GB..`, or `16GB..80GB`)", "anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Union_Memory__float__int__str__"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}]}, "total_memory": {"title": "Total Memory", "description": "The total RAM size (e.g., `32GB`). Can be set to a range (e.g. `16GB..`, or `16GB..80GB`)", "anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Union_Memory__float__int__str__"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}]}, "compute_capability": {"title": "Compute Capability", "description": "The minimum compute capability of the GPU (e.g., `7.5`)", "anyOf": [{"type": "array", "items": {}}, {"type": "number"}, {"type": "string"}]}}, "additionalProperties": false}, "DiskSpecRequest": {"title": "DiskSpecRequest", "type": "object", "properties": {"size": {"title": "Size", "description": "Disk size", "allOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Memory_"}]}}, "required": ["size"], "additionalProperties": false}, "DiskSpecSchemaRequest": {"title": "DiskSpecSchemaRequest", "type": "object", "properties": {"size": {"title": "Size", "description": "The disk size. Can be a string (e.g., `100GB` or `100GB..`) or an object", "anyOf": [{"$ref": "#/definitions/ResourcesSpecRequest/definitions/Range_Union_Memory__float__int__str__"}, {"type": "number"}, {"type": "integer"}, {"type": "string"}]}}, "required": ["size"], "additionalProperties": false}}}, "RetryEvent": {"type": "string", "enum": ["no-capacity", "interruption", "error"], "title": "RetryEvent", "description": "An enumeration."}, "RetryRequest": {"properties": {"on_events": {"items": {"$ref": "#/components/schemas/RetryEvent"}, "type": "array"}, "duration": {"type": "integer", "title": "Duration"}}, "additionalProperties": false, "type": "object", "required": ["on_events", "duration"], "title": "RetryRequest"}, "RunPlanRequest": {"properties": {"project_name": {"type": "string", "title": "Project Name"}, "user": {"type": "string", "title": "User"}, "run_spec": {"$ref": "#/components/schemas/RunSpecRequest"}, "job_plans": {"items": {"$ref": "#/components/schemas/JobPlanRequest"}, "type": "array", "title": "Job Plans"}}, "additionalProperties": false, "type": "object", "required": ["project_name", "user", "run_spec", "job_plans"], "title": "RunPlanRequest"}, "RunRequest": {"properties": {"id": {"type": "string", "format": "uuid4", "title": "Id"}, "project_name": {"type": "string", "title": "Project Name"}, "user": {"type": "string", "title": "User"}, "submitted_at": {"type": "string", "format": "date-time", "title": "Submitted At"}, "last_processed_at": {"type": "string", "format": "date-time", "title": "Last Processed At"}, "status": {"$ref": "#/components/schemas/RunStatus"}, "termination_reason": {"$ref": "#/components/schemas/RunTerminationReason"}, "run_spec": {"$ref": "#/components/schemas/RunSpecRequest"}, "jobs": {"items": {"$ref": "#/components/schemas/JobRequest"}, "type": "array", "title": "Jobs"}, "latest_job_submission": {"$ref": "#/components/schemas/JobSubmissionRequest"}, "cost": {"type": "number", "title": "Cost", "default": 0}, "service": {"$ref": "#/components/schemas/ServiceSpecRequest"}}, "additionalProperties": false, "type": "object", "required": ["id", "project_name", "user", "submitted_at", "last_processed_at", "status", "run_spec", "jobs"], "title": "RunRequest"}, "RunSpecRequest": {"properties": {"run_name": {"type": "string", "title": "Run Name"}, "repo_id": {"type": "string", "title": "Repo Id"}, "repo_data": {"oneOf": [{"$ref": "#/components/schemas/RemoteRunRepoDataRequest"}, {"$ref": "#/components/schemas/LocalRunRepoDataRequest"}, {"$ref": "#/components/schemas/VirtualRunRepoDataRequest"}], "title": "Repo Data", "discriminator": {"propertyName": "repo_type", "mapping": {"remote": "#/components/schemas/RemoteRunRepoDataRequest", "local": "#/components/schemas/LocalRunRepoDataRequest", "virtual": "#/components/schemas/VirtualRunRepoDataRequest"}}}, "repo_code_hash": {"type": "string", "title": "Repo Code Hash"}, "working_dir": {"type": "string", "title": "Working Dir"}, "configuration_path": {"type": "string", "title": "Configuration Path"}, "configuration": {"oneOf": [{"$ref": "#/components/schemas/DevEnvironmentConfigurationRequest"}, {"$ref": "#/components/schemas/TaskConfigurationRequest"}, {"$ref": "#/components/schemas/ServiceConfigurationRequest"}], "title": "Configuration", "discriminator": {"propertyName": "type", "mapping": {"dev-environment": "#/components/schemas/DevEnvironmentConfigurationRequest", "task": "#/components/schemas/TaskConfigurationRequest", "service": "#/components/schemas/ServiceConfigurationRequest"}}}, "profile": {"$ref": "#/components/schemas/ProfileRequest"}, "ssh_key_pub": {"type": "string", "title": "Ssh Key Pub"}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "repo_data", "working_dir", "configuration_path", "configuration", "profile", "ssh_key_pub"], "title": "RunSpecRequest"}, "RunStatus": {"type": "string", "enum": ["pending", "submitted", "provisioning", "running", "terminating", "terminated", "failed", "done"], "title": "RunStatus", "description": "An enumeration."}, "RunTerminationReason": {"type": "string", "enum": ["all_jobs_done", "job_failed", "retry_limit_exceeded", "stopped_by_user", "aborted_by_user", "server_error"], "title": "RunTerminationReason", "description": "An enumeration."}, "RunpodAPIKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["api_key"], "title": "Type", "default": "api_key"}, "api_key": {"type": "string", "title": "Api Key"}}, "additionalProperties": false, "type": "object", "required": ["api_key"], "title": "RunpodAPIKeyCredsRequest"}, "RunpodConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["runpod"], "title": "Type", "default": "runpod"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "RunpodConfigInfoRequest"}, "RunpodConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["runpod"], "title": "Type", "default": "runpod"}, "creds": {"$ref": "#/components/schemas/RunpodAPIKeyCredsRequest"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "RunpodConfigInfoWithCredsPartialRequest"}, "RunpodConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["runpod"], "title": "Type", "default": "runpod"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/RunpodAPIKeyCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "RunpodConfigInfoWithCredsRequest"}, "RunpodConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["runpod"], "title": "Type", "default": "runpod"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "RunpodConfigValuesRequest"}, "SSHConnectionParamsRequest": {"properties": {"hostname": {"type": "string", "title": "Hostname"}, "username": {"type": "string", "title": "Username"}, "port": {"type": "integer", "title": "Port"}}, "additionalProperties": false, "type": "object", "required": ["hostname", "username", "port"], "title": "SSHConnectionParamsRequest"}, "SSHHostParamsRequest": {"properties": {"hostname": {"type": "string", "title": "Hostname", "description": "The IP address or domain to connect to"}, "port": {"type": "integer", "title": "Port", "description": "The SSH port to connect to for this host"}, "user": {"type": "string", "title": "User", "description": "The user to log in with for this host"}, "identity_file": {"type": "string", "title": "Identity File", "description": "The private key to use for this host"}, "ssh_key": {"$ref": "#/components/schemas/SSHKeyRequest"}}, "additionalProperties": false, "type": "object", "required": ["hostname"], "title": "SSHHostParamsRequest"}, "SSHKeyRequest": {"properties": {"public": {"type": "string", "title": "Public"}, "private": {"type": "string", "title": "Private"}}, "additionalProperties": false, "type": "object", "required": ["public"], "title": "SSHKeyRequest"}, "SSHParamsRequest": {"properties": {"user": {"type": "string", "title": "User", "description": "The user to log in with on all hosts"}, "port": {"type": "integer", "title": "Port", "description": "The SSH port to connect to"}, "identity_file": {"type": "string", "title": "Identity File", "description": "The private key to use for all hosts"}, "ssh_key": {"$ref": "#/components/schemas/SSHKeyRequest"}, "hosts": {"items": {"anyOf": [{"$ref": "#/components/schemas/SSHHostParamsRequest"}, {"type": "string"}]}, "type": "array", "title": "Hosts", "description": "The per host connection parameters: a hostname or an object that overrides default ssh parameters"}, "network": {"type": "string", "title": "Network", "description": "The network address for cluster setup in the format `<ip>/<netmask>`"}}, "additionalProperties": false, "type": "object", "required": ["hosts"], "title": "SSHParamsRequest"}, "SaveRepoCredsRequestRequest": {"properties": {"repo_id": {"type": "string", "title": "Repo Id"}, "repo_info": {"anyOf": [{"$ref": "#/components/schemas/RemoteRepoInfoRequest"}, {"$ref": "#/components/schemas/LocalRepoInfoRequest"}, {"$ref": "#/components/schemas/VirtualRepoInfoRequest"}], "title": "Repo Info"}, "repo_creds": {"$ref": "#/components/schemas/RemoteRepoCredsDtoRequest"}}, "additionalProperties": false, "type": "object", "required": ["repo_id", "repo_info"], "title": "SaveRepoCredsRequestRequest"}, "ScalingSpecRequest": {"properties": {"metric": {"type": "string", "enum": ["rps"], "title": "Metric", "description": "The target metric to track. Currently, the only supported value is `rps` (meaning requests per second)"}, "target": {"type": "number", "title": "Target", "description": "The target value of the metric. The number of replicas is calculated based on this number and automatically adjusts (scales up or down) as this metric changes"}, "scale_up_delay": {"type": "integer", "title": "Scale Up Delay", "description": "The delay in seconds before scaling up", "default": 300}, "scale_down_delay": {"type": "integer", "title": "Scale Down Delay", "description": "The delay in seconds before scaling down", "default": 600}}, "additionalProperties": false, "type": "object", "required": ["metric", "target"], "title": "ScalingSpecRequest"}, "SecretRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "value": {"type": "string", "title": "Value"}}, "additionalProperties": false, "type": "object", "required": ["name", "value"], "title": "SecretRequest"}, "ServiceConfigurationRequest": {"properties": {"port": {"anyOf": [{"type": "integer", "maximum": 65536.0, "exclusiveMinimum": 0.0}, {"type": "string", "pattern": "^[0-9]+:[0-9]+$"}, {"$ref": "#/components/schemas/PortMappingRequest"}], "title": "Port", "description": "The port, that application listens on or the mapping"}, "model": {"anyOf": [{"$ref": "#/components/schemas/TGIChatModelRequest"}, {"$ref": "#/components/schemas/OpenAIChatModelRequest"}], "title": "Model", "description": "Mapping of the model for the OpenAI-compatible endpoint"}, "https": {"type": "boolean", "title": "Https", "description": "Enable HTTPS", "default": true}, "auth": {"type": "boolean", "title": "Auth", "description": "Enable the authorization", "default": true}, "replicas": {"anyOf": [{"type": "integer", "minimum": 1.0}, {"type": "string", "pattern": "^[0-9]+..[1-9][0-9]*$"}, {"$ref": "#/components/schemas/Range_int_"}], "title": "Replicas", "description": "The number of replicas. Can be a number (e.g. `2`) or a range (`0..4` or `1..8`). If it's a range, the `scaling` property is required", "default": {"min": 1, "max": 1}}, "scaling": {"allOf": [{"$ref": "#/components/schemas/ScalingSpecRequest"}], "title": "Scaling", "description": "The auto-scaling rules. Required if `replicas` is set to a range"}, "type": {"type": "string", "enum": ["service"], "title": "Type", "default": "service"}, "name": {"type": "string", "title": "Name", "description": "The run name"}, "image": {"type": "string", "title": "Image", "description": "The name of the Docker image to run"}, "entrypoint": {"type": "string", "title": "Entrypoint", "description": "The Docker entrypoint"}, "working_dir": {"type": "string", "title": "Working Dir", "description": "The path to the working directory inside the container. It's specified relative to the repository directory (`/workflow`) and should be inside it. Defaults to `\".\"` "}, "home_dir": {"type": "string", "title": "Home Dir", "description": "The absolute path to the home directory inside the container. Defaults to `/root`", "default": "/root"}, "registry_auth": {"allOf": [{"$ref": "#/components/schemas/RegistryAuthRequest"}], "title": "Registry Auth", "description": "Credentials for pulling a private Docker image"}, "python": {"allOf": [{"$ref": "#/components/schemas/PythonVersion"}], "description": "The major version of Python. Mutually exclusive with `image`"}, "nvcc": {"type": "boolean", "title": "Nvcc", "description": "Use image with NVIDIA CUDA Compiler (NVCC) included. Mutually exclusive with `image`"}, "env": {"anyOf": [{"items": {"type": "string", "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*(=.*$|$)"}, "type": "array"}, {"additionalProperties": {"anyOf": [{"type": "string"}, {"$ref": "#/components/schemas/EnvSentinelRequest"}]}, "type": "object"}], "title": "Env", "description": "The mapping or the list of environment variables", "default": {}}, "setup": {"items": {"type": "string"}, "type": "array", "title": "Setup", "description": "The bash commands to run on the boot", "default": []}, "resources": {"allOf": [{"$ref": "#/components/schemas/ResourcesSpecRequest"}], "title": "Resources", "description": "The resources requirements to run the configuration", "default": {"cpu": {"min": 2}, "memory": {"min": 8.0}, "disk": {"size": {"min": 100.0}}}}, "volumes": {"items": {"$ref": "#/components/schemas/VolumeMountPointRequest"}, "type": "array", "title": "Volumes", "description": "The volumes mount points", "default": []}, "commands": {"items": {"type": "string"}, "type": "array", "title": "Commands", "description": "The bash commands to run", "default": []}, "backends": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array", "description": "The backends to consider for provisioning (e.g., `[aws, gcp]`)"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions", "description": "The regions to consider for provisioning (e.g., `[eu-west-1, us-west4, westeurope]`)"}, "instance_types": {"items": {"type": "string"}, "type": "array", "title": "Instance Types", "description": "The cloud-specific instance types to consider for provisioning (e.g., `[p3.8xlarge, n1-standard-4]`)"}, "spot_policy": {"allOf": [{"$ref": "#/components/schemas/SpotPolicy"}], "description": "The policy for provisioning spot or on-demand instances: `spot`, `on-demand`, or `auto`"}, "retry": {"anyOf": [{"$ref": "#/components/schemas/ProfileRetryRequest"}, {"type": "boolean"}], "title": "Retry", "description": "The policy for resubmitting the run. Defaults to `false`"}, "retry_policy": {"allOf": [{"$ref": "#/components/schemas/ProfileRetryPolicyRequest"}], "title": "Retry Policy", "description": "The policy for resubmitting the run. Deprecated in favor of `retry`"}, "max_duration": {"anyOf": [{"type": "string", "enum": ["off"]}, {"type": "string"}, {"type": "integer"}], "title": "Max Duration", "description": "The maximum duration of a run (e.g., `2h`, `1d`, etc). After it elapses, the run is forced to stop. Defaults to `off`"}, "max_price": {"type": "number", "exclusiveMinimum": 0.0, "title": "Max Price", "description": "The maximum instance price per hour, in dollars"}, "pool_name": {"type": "string", "title": "Pool Name", "description": "The name of the pool. If not set, dstack will use the default name"}, "instance_name": {"type": "string", "title": "Instance Name", "description": "The name of the instance"}, "creation_policy": {"allOf": [{"$ref": "#/components/schemas/CreationPolicy"}], "description": "The policy for using instances from the pool. Defaults to `reuse-or-create`"}, "termination_policy": {"allOf": [{"$ref": "#/components/schemas/TerminationPolicy"}], "description": "The policy for instance termination. Defaults to `destroy-after-idle`"}, "termination_idle_time": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Termination Idle Time", "description": "Time to wait before destroying the idle instance. Defaults to `5m` for `dstack run` and to `3d` for `dstack pool add`"}}, "additionalProperties": false, "type": "object", "required": ["port"], "title": "ServiceConfigurationRequest"}, "ServiceModelSpecRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "base_url": {"type": "string", "title": "Base Url"}, "type": {"type": "string", "title": "Type"}}, "additionalProperties": false, "type": "object", "required": ["name", "base_url", "type"], "title": "ServiceModelSpecRequest"}, "ServiceSpecRequest": {"properties": {"url": {"type": "string", "title": "Url"}, "model": {"$ref": "#/components/schemas/ServiceModelSpecRequest"}, "options": {"type": "object", "title": "Options", "default": {}}}, "additionalProperties": false, "type": "object", "required": ["url"], "title": "ServiceSpecRequest"}, "SetDefaultGatewayRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}}, "additionalProperties": false, "type": "object", "required": ["name"], "title": "SetDefaultGatewayRequestRequest"}, "SetDefaultPoolRequestRequest": {"properties": {"pool_name": {"type": "string", "title": "Pool Name"}}, "additionalProperties": false, "type": "object", "required": ["pool_name"], "title": "SetDefaultPoolRequestRequest"}, "SetProjectMembersRequestRequest": {"properties": {"members": {"items": {"$ref": "#/components/schemas/MemberSettingRequest"}, "type": "array", "title": "Members"}}, "additionalProperties": false, "type": "object", "required": ["members"], "title": "SetProjectMembersRequestRequest"}, "SetWildcardDomainRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "wildcard_domain": {"type": "string", "title": "Wildcard Domain"}}, "additionalProperties": false, "type": "object", "required": ["name", "wildcard_domain"], "title": "SetWildcardDomainRequestRequest"}, "ShowPoolRequestRequest": {"properties": {"name": {"type": "string", "title": "Name"}}, "additionalProperties": false, "type": "object", "title": "ShowPoolRequestRequest"}, "SpotPolicy": {"type": "string", "enum": ["spot", "on-demand", "auto"], "title": "SpotPolicy", "description": "An enumeration."}, "StopRunsRequestRequest": {"properties": {"runs_names": {"items": {"type": "string"}, "type": "array", "title": "Runs Names"}, "abort": {"type": "boolean", "title": "Abort"}}, "additionalProperties": false, "type": "object", "required": ["runs_names", "abort"], "title": "StopRunsRequestRequest"}, "SubmitRunRequestRequest": {"properties": {"run_spec": {"$ref": "#/components/schemas/RunSpecRequest"}}, "additionalProperties": false, "type": "object", "required": ["run_spec"], "title": "SubmitRunRequestRequest"}, "TGIChatModelRequest": {"properties": {"type": {"type": "string", "enum": ["chat"], "title": "Type", "description": "The type of the model"}, "name": {"type": "string", "title": "Name", "description": "The name of the model"}, "format": {"type": "string", "enum": ["tgi"], "title": "Format"}, "chat_template": {"type": "string", "title": "Chat Template"}, "eos_token": {"type": "string", "title": "Eos Token"}}, "additionalProperties": false, "type": "object", "required": ["type", "name", "format"], "title": "TGIChatModelRequest", "description": "Mapping of the model for the OpenAI-compatible endpoint.\n\nAttributes:\n    type (str): The type of the model, e.g. \"chat\"\n    name (str): The name of the model. This name will be used both to load model configuration from the HuggingFace Hub and in the OpenAI-compatible endpoint.\n    format (str): The format of the model, e.g. \"tgi\" if the model is served with HuggingFace's Text Generation Inference.\n    chat_template (Optional[str]): The custom prompt template for the model. If not specified, the default prompt template the HuggingFace Hub configuration will be used.\n    eos_token (Optional[str]): The custom end of sentence token. If not specified, the default custom end of sentence token from the HuggingFace Hub configuration will be used."}, "TaskConfigurationRequest": {"properties": {"nodes": {"type": "integer", "minimum": 1.0, "title": "Nodes", "description": "Number of nodes", "default": 1}, "type": {"type": "string", "enum": ["task"], "title": "Type", "default": "task"}, "name": {"type": "string", "title": "Name", "description": "The run name"}, "image": {"type": "string", "title": "Image", "description": "The name of the Docker image to run"}, "entrypoint": {"type": "string", "title": "Entrypoint", "description": "The Docker entrypoint"}, "working_dir": {"type": "string", "title": "Working Dir", "description": "The path to the working directory inside the container. It's specified relative to the repository directory (`/workflow`) and should be inside it. Defaults to `\".\"` "}, "home_dir": {"type": "string", "title": "Home Dir", "description": "The absolute path to the home directory inside the container. Defaults to `/root`", "default": "/root"}, "registry_auth": {"allOf": [{"$ref": "#/components/schemas/RegistryAuthRequest"}], "title": "Registry Auth", "description": "Credentials for pulling a private Docker image"}, "python": {"allOf": [{"$ref": "#/components/schemas/PythonVersion"}], "description": "The major version of Python. Mutually exclusive with `image`"}, "nvcc": {"type": "boolean", "title": "Nvcc", "description": "Use image with NVIDIA CUDA Compiler (NVCC) included. Mutually exclusive with `image`"}, "env": {"anyOf": [{"items": {"type": "string", "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*(=.*$|$)"}, "type": "array"}, {"additionalProperties": {"anyOf": [{"type": "string"}, {"$ref": "#/components/schemas/EnvSentinelRequest"}]}, "type": "object"}], "title": "Env", "description": "The mapping or the list of environment variables", "default": {}}, "setup": {"items": {"type": "string"}, "type": "array", "title": "Setup", "description": "The bash commands to run on the boot", "default": []}, "resources": {"allOf": [{"$ref": "#/components/schemas/ResourcesSpecRequest"}], "title": "Resources", "description": "The resources requirements to run the configuration", "default": {"cpu": {"min": 2}, "memory": {"min": 8.0}, "disk": {"size": {"min": 100.0}}}}, "volumes": {"items": {"$ref": "#/components/schemas/VolumeMountPointRequest"}, "type": "array", "title": "Volumes", "description": "The volumes mount points", "default": []}, "ports": {"items": {"anyOf": [{"type": "integer", "maximum": 65536.0, "exclusiveMinimum": 0.0}, {"type": "string", "pattern": "^(?:[0-9]+|\\*):[0-9]+$"}, {"$ref": "#/components/schemas/PortMappingRequest"}]}, "type": "array", "title": "Ports", "description": "Port numbers/mapping to expose", "default": []}, "commands": {"items": {"type": "string"}, "type": "array", "title": "Commands", "description": "The bash commands to run", "default": []}, "backends": {"items": {"$ref": "#/components/schemas/BackendType"}, "type": "array", "description": "The backends to consider for provisioning (e.g., `[aws, gcp]`)"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions", "description": "The regions to consider for provisioning (e.g., `[eu-west-1, us-west4, westeurope]`)"}, "instance_types": {"items": {"type": "string"}, "type": "array", "title": "Instance Types", "description": "The cloud-specific instance types to consider for provisioning (e.g., `[p3.8xlarge, n1-standard-4]`)"}, "spot_policy": {"allOf": [{"$ref": "#/components/schemas/SpotPolicy"}], "description": "The policy for provisioning spot or on-demand instances: `spot`, `on-demand`, or `auto`"}, "retry": {"anyOf": [{"$ref": "#/components/schemas/ProfileRetryRequest"}, {"type": "boolean"}], "title": "Retry", "description": "The policy for resubmitting the run. Defaults to `false`"}, "retry_policy": {"allOf": [{"$ref": "#/components/schemas/ProfileRetryPolicyRequest"}], "title": "Retry Policy", "description": "The policy for resubmitting the run. Deprecated in favor of `retry`"}, "max_duration": {"anyOf": [{"type": "string", "enum": ["off"]}, {"type": "string"}, {"type": "integer"}], "title": "Max Duration", "description": "The maximum duration of a run (e.g., `2h`, `1d`, etc). After it elapses, the run is forced to stop. Defaults to `off`"}, "max_price": {"type": "number", "exclusiveMinimum": 0.0, "title": "Max Price", "description": "The maximum instance price per hour, in dollars"}, "pool_name": {"type": "string", "title": "Pool Name", "description": "The name of the pool. If not set, dstack will use the default name"}, "instance_name": {"type": "string", "title": "Instance Name", "description": "The name of the instance"}, "creation_policy": {"allOf": [{"$ref": "#/components/schemas/CreationPolicy"}], "description": "The policy for using instances from the pool. Defaults to `reuse-or-create`"}, "termination_policy": {"allOf": [{"$ref": "#/components/schemas/TerminationPolicy"}], "description": "The policy for instance termination. Defaults to `destroy-after-idle`"}, "termination_idle_time": {"anyOf": [{"type": "integer"}, {"type": "string"}], "title": "Termination Idle Time", "description": "Time to wait before destroying the idle instance. Defaults to `5m` for `dstack run` and to `3d` for `dstack pool add`"}}, "additionalProperties": false, "type": "object", "title": "TaskConfigurationRequest"}, "TensorDockAPIKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["api_key"], "title": "Type", "description": "The type of credentials", "default": "api_key"}, "api_key": {"type": "string", "title": "Api Key", "description": "The API key"}, "api_token": {"type": "string", "title": "Api Token", "description": "The API token"}}, "additionalProperties": false, "type": "object", "required": ["api_key", "api_token"], "title": "TensorDockAPIKeyCredsRequest"}, "TensorDockConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["tensordock"], "title": "Type", "default": "tensordock"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "TensorDockConfigInfoRequest"}, "TensorDockConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["tensordock"], "title": "Type", "default": "tensordock"}, "creds": {"$ref": "#/components/schemas/TensorDockAPIKeyCredsRequest"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "TensorDockConfigInfoWithCredsPartialRequest"}, "TensorDockConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["tensordock"], "title": "Type", "default": "tensordock"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/TensorDockAPIKeyCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "TensorDockConfigInfoWithCredsRequest"}, "TensorDockConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["tensordock"], "title": "Type", "default": "tensordock"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "TensorDockConfigValuesRequest"}, "TerminationPolicy": {"type": "string", "enum": ["dont-destroy", "destroy-after-idle"], "title": "TerminationPolicy", "description": "An enumeration."}, "UpdateBackendYAMLRequestRequest": {"properties": {"config_yaml": {"type": "string", "title": "Config Yaml"}}, "additionalProperties": false, "type": "object", "required": ["config_yaml"], "title": "UpdateBackendYAMLRequestRequest"}, "UserRequest": {"properties": {"id": {"type": "string", "format": "uuid4", "title": "Id"}, "username": {"type": "string", "title": "Username"}, "global_role": {"$ref": "#/components/schemas/GlobalRole"}, "email": {"type": "string", "title": "Email"}}, "additionalProperties": false, "type": "object", "required": ["id", "username", "global_role"], "title": "UserRequest"}, "UserTokenCredsRequest": {"properties": {"token": {"type": "string", "title": "Token"}}, "additionalProperties": false, "type": "object", "required": ["token"], "title": "UserTokenCredsRequest"}, "UserWithCredsRequest": {"properties": {"id": {"type": "string", "format": "uuid4", "title": "Id"}, "username": {"type": "string", "title": "Username"}, "global_role": {"$ref": "#/components/schemas/GlobalRole"}, "email": {"type": "string", "title": "Email"}, "creds": {"$ref": "#/components/schemas/UserTokenCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["id", "username", "global_role", "creds"], "title": "UserWithCredsRequest"}, "ValidationError": {"properties": {"loc": {"items": {"anyOf": [{"type": "string"}, {"type": "integer"}]}, "type": "array", "title": "Location"}, "msg": {"type": "string", "title": "Message"}, "type": {"type": "string", "title": "Error Type"}}, "type": "object", "required": ["loc", "msg", "type"], "title": "ValidationError"}, "VastAIAPIKeyCredsRequest": {"properties": {"type": {"type": "string", "enum": ["api_key"], "title": "Type", "description": "The type of credentials", "default": "api_key"}, "api_key": {"type": "string", "title": "Api Key", "description": "The API key"}}, "additionalProperties": false, "type": "object", "required": ["api_key"], "title": "VastAIAPIKeyCredsRequest"}, "VastAIConfigInfoRequest": {"properties": {"type": {"type": "string", "enum": ["vastai"], "title": "Type", "default": "vastai"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "VastAIConfigInfoRequest"}, "VastAIConfigInfoWithCredsPartialRequest": {"properties": {"type": {"type": "string", "enum": ["vastai"], "title": "Type", "default": "vastai"}, "creds": {"$ref": "#/components/schemas/VastAIAPIKeyCredsRequest"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}}, "additionalProperties": false, "type": "object", "title": "VastAIConfigInfoWithCredsPartialRequest"}, "VastAIConfigInfoWithCredsRequest": {"properties": {"type": {"type": "string", "enum": ["vastai"], "title": "Type", "default": "vastai"}, "regions": {"items": {"type": "string"}, "type": "array", "title": "Regions"}, "creds": {"$ref": "#/components/schemas/VastAIAPIKeyCredsRequest"}}, "additionalProperties": false, "type": "object", "required": ["creds"], "title": "VastAIConfigInfoWithCredsRequest"}, "VastAIConfigValuesRequest": {"properties": {"type": {"type": "string", "enum": ["vastai"], "title": "Type", "default": "vastai"}, "regions": {"$ref": "#/components/schemas/ConfigMultiElementRequest"}}, "additionalProperties": false, "type": "object", "title": "VastAIConfigValuesRequest"}, "VirtualRepoInfoRequest": {"properties": {"repo_type": {"type": "string", "enum": ["virtual"], "title": "Repo Type", "default": "virtual"}}, "additionalProperties": false, "type": "object", "title": "VirtualRepoInfoRequest"}, "VirtualRunRepoDataRequest": {"properties": {"repo_type": {"type": "string", "enum": ["virtual"], "title": "Repo Type", "default": "virtual"}}, "additionalProperties": false, "type": "object", "title": "VirtualRunRepoDataRequest"}, "VolumeAttachmentDataRequest": {"properties": {"device_name": {"type": "string", "title": "Device Name"}}, "additionalProperties": false, "type": "object", "title": "VolumeAttachmentDataRequest"}, "VolumeConfigurationRequest": {"properties": {"type": {"type": "string", "enum": ["volume"], "title": "Type", "default": "volume"}, "name": {"type": "string", "title": "Name", "description": "The volume name"}, "backend": {"allOf": [{"$ref": "#/components/schemas/BackendType"}], "description": "The volume backend"}, "region": {"type": "string", "title": "Region", "description": "The volume region"}, "size": {"type": "number", "title": "Size", "description": "The volume size. Must be specified when creating new volumes"}, "volume_id": {"type": "string", "title": "Volume Id", "description": "The volume ID. Must be specified when registering external volumes"}}, "additionalProperties": false, "type": "object", "required": ["backend", "region"], "title": "VolumeConfigurationRequest"}, "VolumeMountPointRequest": {"properties": {"name": {"type": "string", "title": "Name", "description": "The name of the volume to mount"}, "path": {"type": "string", "title": "Path", "description": "The container path to mount the volume at"}}, "additionalProperties": false, "type": "object", "required": ["name", "path"], "title": "VolumeMountPointRequest"}, "VolumeProvisioningDataRequest": {"properties": {"backend": {"$ref": "#/components/schemas/BackendType"}, "volume_id": {"type": "string", "title": "Volume Id"}, "size_gb": {"type": "integer", "title": "Size Gb"}, "availability_zone": {"type": "string", "title": "Availability Zone"}, "price": {"type": "number", "title": "Price"}, "attachable": {"type": "boolean", "title": "Attachable", "default": true}, "detachable": {"type": "boolean", "title": "Detachable", "default": true}, "backend_data": {"type": "string", "title": "Backend Data"}}, "additionalProperties": false, "type": "object", "required": ["volume_id", "size_gb"], "title": "VolumeProvisioningDataRequest"}, "VolumeRequest": {"properties": {"name": {"type": "string", "title": "Name"}, "project_name": {"type": "string", "title": "Project Name"}, "configuration": {"$ref": "#/components/schemas/VolumeConfigurationRequest"}, "external": {"type": "boolean", "title": "External"}, "created_at": {"type": "string", "format": "date-time", "title": "Created At"}, "status": {"$ref": "#/components/schemas/VolumeStatus"}, "status_message": {"type": "string", "title": "Status Message"}, "volume_id": {"type": "string", "title": "Volume Id"}, "provisioning_data": {"$ref": "#/components/schemas/VolumeProvisioningDataRequest"}, "attachment_data": {"$ref": "#/components/schemas/VolumeAttachmentDataRequest"}, "volume_model_id": {"type": "string", "format": "uuid", "title": "Volume Model Id"}}, "additionalProperties": false, "type": "object", "required": ["name", "project_name", "configuration", "external", "created_at", "status", "volume_model_id"], "title": "VolumeRequest"}, "VolumeStatus": {"type": "string", "enum": ["submitted", "provisioning", "active", "failed"], "title": "VolumeStatus", "description": "An enumeration."}}, "securitySchemes": {"HTTPBearer": {"type": "http", "scheme": "bearer"}}}}
\ No newline at end of file
diff --git a/docs/reference/cli/index.html b/docs/reference/cli/index.html
index a44fea9f..9fd23582 100644
--- a/docs/reference/cli/index.html
+++ b/docs/reference/cli/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -2022,6 +2022,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -3338,7 +3365,7 @@ <h2 id="environment-variables">Environment variables<a class="headerlink" href="
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/reference/dstack.yml/dev-environment/index.html b/docs/reference/dstack.yml/dev-environment/index.html
index 04c4c6be..e4243e87 100644
--- a/docs/reference/dstack.yml/dev-environment/index.html
+++ b/docs/reference/dstack.yml/dev-environment/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1596,6 +1596,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nvcc" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        nvcc
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -2540,6 +2551,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -3124,6 +3162,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nvcc" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        nvcc
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -3811,6 +3860,7 @@ <h4 class="reference-item" id="working_dir"><code>working_dir</code> - (Optional
 <h4 class="reference-item" id="home_dir"><code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.<a class="headerlink" href="#home_dir" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="_registry_auth"><a href="#registry_auth"><code>registry_auth</code></a> - (Optional) Credentials for pulling a private Docker image.<a class="headerlink" href="#_registry_auth" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="python"><code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.<a class="headerlink" href="#python" title="Permanent link">&para;</a></h4>
+<h4 class="reference-item" id="nvcc"><code>nvcc</code> - (Optional) Use image with NVIDIA CUDA Compiler (NVCC) included. Mutually exclusive with <code>image</code>.<a class="headerlink" href="#nvcc" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="env"><code>env</code> - (Optional) The mapping or the list of environment variables.<a class="headerlink" href="#env" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="setup"><code>setup</code> - (Optional) The bash commands to run on the boot.<a class="headerlink" href="#setup" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="_resources"><a href="#resources"><code>resources</code></a> - (Optional) The resources requirements to run the configuration.<a class="headerlink" href="#_resources" title="Permanent link">&para;</a></h4>
@@ -4006,7 +4056,7 @@ <h4 class="reference-item" id="path"><code>path</code> -  The container path to
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/reference/dstack.yml/fleet/index.html b/docs/reference/dstack.yml/fleet/index.html
index f35e642d..f48ddf0a 100644
--- a/docs/reference/dstack.yml/fleet/index.html
+++ b/docs/reference/dstack.yml/fleet/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -2376,6 +2376,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -3504,7 +3531,7 @@ <h4 class="reference-item" id="duration"><code>duration</code> - (Optional) The
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/reference/dstack.yml/gateway/index.html b/docs/reference/dstack.yml/gateway/index.html
index 4d3a5100..9c421e5e 100644
--- a/docs/reference/dstack.yml/gateway/index.html
+++ b/docs/reference/dstack.yml/gateway/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -2003,6 +2003,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2712,7 +2739,7 @@ <h4 class="reference-item" id="arn"><code>arn</code> -  The ARN of the wildcard
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/reference/dstack.yml/index.html b/docs/reference/dstack.yml/index.html
index 46d7edb7..242afa0d 100644
--- a/docs/reference/dstack.yml/index.html
+++ b/docs/reference/dstack.yml/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1748,6 +1748,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2204,7 +2231,7 @@ <h1 id="dstackyml">.dstack.yml<a class="headerlink" href="#dstackyml" title="Per
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/reference/dstack.yml/service/index.html b/docs/reference/dstack.yml/service/index.html
index 3959d0b8..a1abda0b 100644
--- a/docs/reference/dstack.yml/service/index.html
+++ b/docs/reference/dstack.yml/service/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1722,6 +1722,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nvcc" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        nvcc
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -2723,6 +2734,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -3379,6 +3417,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nvcc" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        nvcc
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -4320,6 +4369,7 @@ <h4 class="reference-item" id="working_dir"><code>working_dir</code> - (Optional
 <h4 class="reference-item" id="home_dir"><code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.<a class="headerlink" href="#home_dir" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="_registry_auth"><a href="#registry_auth"><code>registry_auth</code></a> - (Optional) Credentials for pulling a private Docker image.<a class="headerlink" href="#_registry_auth" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="python"><code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.<a class="headerlink" href="#python" title="Permanent link">&para;</a></h4>
+<h4 class="reference-item" id="nvcc"><code>nvcc</code> - (Optional) Use image with NVIDIA CUDA Compiler (NVCC) included. Mutually exclusive with <code>image</code>.<a class="headerlink" href="#nvcc" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="env"><code>env</code> - (Optional) The mapping or the list of environment variables.<a class="headerlink" href="#env" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="setup"><code>setup</code> - (Optional) The bash commands to run on the boot.<a class="headerlink" href="#setup" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="_resources"><a href="#resources"><code>resources</code></a> - (Optional) The resources requirements to run the configuration.<a class="headerlink" href="#_resources" title="Permanent link">&para;</a></h4>
@@ -4524,7 +4574,7 @@ <h4 class="reference-item" id="path"><code>path</code> -  The container path to
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/reference/dstack.yml/task/index.html b/docs/reference/dstack.yml/task/index.html
index 73e70098..3715519b 100644
--- a/docs/reference/dstack.yml/task/index.html
+++ b/docs/reference/dstack.yml/task/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1634,6 +1634,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nvcc" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        nvcc
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -2564,6 +2575,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -3159,6 +3197,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nvcc" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        nvcc
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -3996,6 +4045,7 @@ <h4 class="reference-item" id="working_dir"><code>working_dir</code> - (Optional
 <h4 class="reference-item" id="home_dir"><code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.<a class="headerlink" href="#home_dir" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="_registry_auth"><a href="#registry_auth"><code>registry_auth</code></a> - (Optional) Credentials for pulling a private Docker image.<a class="headerlink" href="#_registry_auth" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="python"><code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.<a class="headerlink" href="#python" title="Permanent link">&para;</a></h4>
+<h4 class="reference-item" id="nvcc"><code>nvcc</code> - (Optional) Use image with NVIDIA CUDA Compiler (NVCC) included. Mutually exclusive with <code>image</code>.<a class="headerlink" href="#nvcc" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="env"><code>env</code> - (Optional) The mapping or the list of environment variables.<a class="headerlink" href="#env" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="setup"><code>setup</code> - (Optional) The bash commands to run on the boot.<a class="headerlink" href="#setup" title="Permanent link">&para;</a></h4>
 <h4 class="reference-item" id="_resources"><a href="#resources"><code>resources</code></a> - (Optional) The resources requirements to run the configuration.<a class="headerlink" href="#_resources" title="Permanent link">&para;</a></h4>
@@ -4192,7 +4242,7 @@ <h4 class="reference-item" id="path"><code>path</code> -  The container path to
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/reference/dstack.yml/volume/index.html b/docs/reference/dstack.yml/volume/index.html
index 9a71911a..468d9018 100644
--- a/docs/reference/dstack.yml/volume/index.html
+++ b/docs/reference/dstack.yml/volume/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1942,6 +1942,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2595,7 +2622,7 @@ <h4 class="reference-item" id="volume_id"><code>volume_id</code> - (Optional) Th
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/reference/profiles.yml/index.html b/docs/reference/profiles.yml/index.html
index 48827bcf..df39f979 100644
--- a/docs/reference/profiles.yml/index.html
+++ b/docs/reference/profiles.yml/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -2057,6 +2057,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2840,7 +2867,7 @@ <h4 class="reference-item" id="duration"><code>duration</code> - (Optional) The
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/reference/server/config.yml/index.html b/docs/reference/server/config.yml/index.html
index 193232c4..5d6f4f02 100644
--- a/docs/reference/server/config.yml/index.html
+++ b/docs/reference/server/config.yml/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -3201,6 +3201,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -5827,7 +5854,7 @@ <h4 class="reference-item" id="ssh_port"><code>ssh_port</code> - (Optional) Any
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/services/index.html b/docs/services/index.html
index 1d16e9cb..d0f7b88c 100644
--- a/docs/services/index.html
+++ b/docs/services/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1937,6 +1937,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2686,7 +2713,7 @@ <h2 id="whats-next">What's next?<a class="headerlink" href="#whats-next" title="
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../assets/javascripts/extra.js"></script>
       
diff --git a/docs/tasks/index.html b/docs/tasks/index.html
index f8d8b020..941cae30 100644
--- a/docs/tasks/index.html
+++ b/docs/tasks/index.html
@@ -25,7 +25,7 @@
       
       
       <link rel="icon" href="../../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -33,7 +33,7 @@
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1905,6 +1905,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2595,7 +2622,7 @@ <h2 id="whats-next">What's next?<a class="headerlink" href="#whats-next" title="
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../../assets/javascripts/extra.js"></script>
       
diff --git a/index.html b/index.html
index 95858fa0..3314cc89 100644
--- a/index.html
+++ b/index.html
@@ -23,7 +23,7 @@
       
       
       <link rel="icon" href="assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -31,7 +31,7 @@
       
     
     
-      <link rel="stylesheet" href="assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1721,6 +1721,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="docs/examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2907,7 +2934,7 @@ <h2>FAQ</h2>
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="assets/javascripts/extra.js"></script>
       
diff --git a/pricing/index.html b/pricing/index.html
index 46bf6580..be870c02 100644
--- a/pricing/index.html
+++ b/pricing/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1709,6 +1709,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../docs/examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2326,7 +2353,7 @@ <h2>FAQ</h2>
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../assets/javascripts/extra.js"></script>
       
diff --git a/privacy/index.html b/privacy/index.html
index d32f1e2c..e8b11cec 100644
--- a/privacy/index.html
+++ b/privacy/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1709,6 +1709,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../docs/examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2269,7 +2296,7 @@ <h2><strong>Children&#x27;s Information</strong></h2>
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../assets/javascripts/extra.js"></script>
       
diff --git a/search/search_index.json b/search/search_index.json
index 804f103f..d1bb6da2 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"],"fields":{"title":{"boost":1000.0},"text":{"boost":1.0},"tags":{"boost":1000000.0}}},"docs":[{"location":"terms/","title":"Terms of service","text":""},{"location":"terms/#agreement-to-terms","title":"Agreement to terms","text":"<p>We are dstack GmbH (\"Company,\" \"we,\" \"us,\" \"our\"), a company registered in Germany at Franz-Joseph-Stra\u00dfe, 11, Munich, Bayern 80801.</p> <p>These Legal Terms constitute a legally binding agreement made between you, whether personally or on behalf of an entity (\"you\"), and dstack GmbH, concerning your access to and use of the Services. You agree that by accessing the Services, you have read, understood, and agreed to be bound by all of these Legal Terms. IF YOU DO NOT AGREE WITH ALL OF THESE LEGAL TERMS, THEN YOU ARE EXPRESSLY PROHIBITED FROM USING THE SERVICES AND YOU MUST DISCONTINUE USE IMMEDIATELY.</p> <p>Supplemental terms and conditions or documents that may be posted on the Services from time to time are hereby expressly incorporated herein by reference. We reserve the right, in our sole discretion, to make changes or modifications to these Legal Terms from time to time. We will alert you about any changes by updating the \"Last updated\" date of these Legal Terms, and you waive any right to receive specific notice of each such change. It is your responsibility to periodically review these Legal Terms to stay informed of updates. You will be subject to, and will be deemed to have been made aware of and to have accepted, the changes in any revised Legal Terms by your continued use of the Services after the date such revised Legal Terms are posted.</p>"},{"location":"terms/#1-our-services","title":"1. Our services","text":"<p>The information provided when using the Services is not intended for distribution to or use by any person or entity in any jurisdiction or country where such distribution or use would be contrary to law or regulation or which would subject us to any registration requirement within such jurisdiction or country. Accordingly, those persons who choose to access the Services from other locations do so on their own initiative and are solely responsible for compliance with local laws, if and to the extent local laws are applicable.</p> <p>The Services are not tailored to comply with industry-specific regulations (Health Insurance Portability and Accountability Act (HIPAA), Federal Information Security Management Act (FISMA), etc.), so if your interactions would be subjected to such laws, you may not use the Services. You may not use the Services in a way that would violate the Gramm-Leach-Bliley Act (GLBA).</p>"},{"location":"terms/#2-intelliectual-property-rights","title":"2. Intelliectual property rights","text":"<p>Our intellectual property</p> <p>We are the owner or the licensee of all intellectual property rights in our Services, including all source code, databases, functionality, software, website designs, audio, video, text, photographs, and graphics in the Services ( collectively, the \"Content\"), as well as the trademarks, service marks, and logos contained therein (the \"Marks\").</p> <p>Our Content and Marks are protected by copyright and trademark laws (and various other intellectual property rights and unfair competition laws) and treaties in the United States and around the world.</p> <p>The Content and Marks are provided in or through the Services \"AS IS\" for your personal, non-commercial use or internal business purpose only.</p> <p>Your use of our Services</p> <p>Subject to your compliance with these Legal Terms, including the \"Prohibited activities\" section below, we grant you a non-exclusive, non-transferable, revocable license to:</p> <ul> <li>access the Services; and</li> <li>download or print a copy of any portion of the Content to which you have properly gained access. solely for your personal, non-commercial use or internal business purpose.</li> </ul> <p>Except as set out in this section or elsewhere in our Legal Terms, no part of the Services and no Content or Marks may be copied, reproduced, aggregated, republished, uploaded, posted, publicly displayed, encoded, translated, transmitted, distributed, sold, licensed, or otherwise exploited for any commercial purpose whatsoever, without our express prior written permission.</p> <p>If you wish to make any use of the Services, Content, or Marks other than as set out in this section or elsewhere in our Legal Terms, please address your request to: hello@dstack.ai. If we ever grant you the permission to post, reproduce, or publicly display any part of our Services or Content, you must identify us as the owners or licensors of the Services, Content, or Marks and ensure that any copyright or proprietary notice appears or is visible on posting, reproducing, or displaying our Content.</p> <p>We reserve all rights not expressly granted to you in and to the Services, Content, and Marks.</p> <p>Any breach of these Intellectual Property Rights will constitute a material breach of our Legal Terms and your right to use our Services will terminate immediately.</p> <p>Your submissions</p> <p>Please review this section and the \"Prohibited activities\" section carefully prior to using our Services to understand the (a) rights you give us and (b) obligations you have when you post or upload any content through the Services.</p> <p>Submissions: By directly sending us any question, comment, suggestion, idea, feedback, or other information about the Services (\"Submissions\"), you agree to assign to us all intellectual property rights in such Submission. You agree that we shall own this Submission and be entitled to its unrestricted use and dissemination for any lawful purpose, commercial or otherwise, without acknowledgment or compensation to you.</p> <p>You are responsible for what you post or upload: By sending us Submissions through any part of the Services you: * confirm that you have read and agree with our \"Prohibited activities\" and will not post, send, publish, upload, or * transmit through the Services any Submission that is illegal, harassing, hateful, harmful, defamatory, obscene, * bullying, abusive, discriminatory, threatening to any person or group, sexually explicit, false, inaccurate, deceitful,   or misleading; * to the extent permissible by applicable law, waive any and all moral rights to any such Submission; * warrant that any such Submission are original to you or that you have the necessary rights and licenses to submit such    Submissions and that you have full authority to grant us the above-mentioned rights in relation to your Submissions; and * warrant and represent that your Submissions do not constitute confidential information.</p> <p>You are solely responsible for your Submissions and you expressly agree to reimburse us for any and all losses that we may suffer because of your breach of (a) this section, (b) any third party\u2019s intellectual property rights, or (c) applicable law.</p>"},{"location":"terms/#3-user-representations","title":"3. User representations","text":"<p>By using the Services, you represent and warrant that: (1) all registration information you submit will be true, accurate, current, and complete; (2) you will maintain the accuracy of such information and promptly update such registration information as necessary; (3) you have the legal capacity and you agree to comply with these Legal Terms; ( 4) you are not a minor in the jurisdiction in which you reside; (5) you will not access the Services through automated or non-human means, whether through a bot, script or otherwise; (6) you will not use the Services for any illegal or unauthorized purpose; and (7) your use of the Services will not violate any applicable law or regulation.</p> <p>If you provide any information that is untrue, inaccurate, not current, or incomplete, we have the right to suspend or terminate your account and refuse any and all current or future use of the Services (or any portion thereof).</p>"},{"location":"terms/#4-user-registration","title":"4. User registration","text":"<p>You may be required to register to use the Services. You agree to keep your password confidential and will be responsible for all use of your account and password. We reserve the right to remove, reclaim, or change a username you select if we determine, in our sole discretion, that such username is inappropriate, obscene, or otherwise objectionable.</p>"},{"location":"terms/#5-purchases-and-payment","title":"5. Purchases and payment","text":"<p>We accept the following forms of payment:</p> <ul> <li>Visa</li> <li>Mastercard</li> </ul> <p>You agree to provide current, complete, and accurate purchase and account information for all purchases made via the Services. You further agree to promptly update account and payment information, including email address, payment method, and payment card expiration date, so that we can complete your transactions and contact you as needed. Sales tax will be added to the price of purchases as deemed required by us. We may change prices at any time. All payments shall be in US dollars.</p> <p>You agree to pay all charges at the prices then in effect for your purchases and any applicable shipping fees, and you authorize us to charge your chosen payment provider for any such amounts upon placing your order. We reserve the right to correct any errors or mistakes in pricing, even if we have already requested or received payment.</p> <p>We reserve the right to refuse any order placed through the Services. We may, in our sole discretion, limit or cancel quantities purchased per person, per household, or per order. These restrictions may include orders placed by or under the same customer account, the same payment method, and/or orders that use the same billing or shipping address. We reserve the right to limit or prohibit orders that, in our sole judgment, appear to be placed by dealers, resellers, or distributors.</p>"},{"location":"terms/#6-subscriptions","title":"6. Subscriptions","text":"<p>Billing and Renewal</p> <p>e.g. by topping up their balance manually using their credit card.</p> <p>Cancellation</p> <p>You can cancel your subscription at any time by contacting us using the contact information provided below. Your cancellation will take effect at the end of the current paid term. If you have any questions or are unsatisfied with our Services, please email us at hello@dstack.ai .</p> <p>Fee Changes</p> <p>We may, from time to time, make changes to the subscription fee and will communicate any price changes to you in accordance with applicable law.</p>"},{"location":"terms/#7-software","title":"7. Software","text":"<p>We may include software for use in connection with our Services. If such software is accompanied by an end user license agreement (\"EULA\"), the terms of the EULA will govern your use of the software. If such software is not accompanied by a EULA, then we grant to you a non-exclusive, revocable, personal, and non-transferable license to use such software solely in connection with our services and in accordance with these Legal Terms. Any software and any related documentation is provided \"AS IS\" without warranty of any kind, either express or implied, including, without limitation, the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. You accept any and all risk arising out of use or performance of any software. You may not reproduce or redistribute any software except in accordance with the EULA or these Legal Terms.</p>"},{"location":"terms/#8-prohibited-activities","title":"8. Prohibited activities","text":"<p>You may not access or use the Services for any purpose other than that for which we make the Services available. The Services may not be used in connection with any commercial endeavors except those that are specifically endorsed or approved by us.</p> <p>As a user of the Services, you agree not to:</p> <ul> <li>Systematically retrieve data or other content from the Services to create or compile, directly or indirectly, a   collection, compilation, database, or directory without written permission from us.</li> <li>Trick, defraud, or mislead us and other users, especially in any attempt to learn sensitive account information such   as user passwords.</li> <li>Circumvent, disable, or otherwise interfere with security-related features of the Services, including features that   prevent or restrict the use or copying of any Content or enforce limitations on the use of the Services and/or the   Content contained therein.</li> <li>Disparage, tarnish, or otherwise harm, in our opinion, us and/or the Services.</li> <li>Use any information obtained from the Services in order to harass, abuse, or harm another person.</li> <li>Make improper use of our support services or submit false reports of abuse or misconduct.</li> <li>Use the Services in a manner inconsistent with any applicable laws or regulations.</li> <li>Engage in unauthorized framing of or linking to the Services.</li> <li>Upload or transmit (or attempt to upload or to transmit) viruses, Trojan horses, or other material, including   excessive use of capital letters and spamming (continuous posting of repetitive text), that interferes with any   party\u2019s uninterrupted use and enjoyment of the Services or modifies, impairs, disrupts, alters, or interferes with the   use, features, functions, operation, or maintenance of the Services.</li> <li>Engage in any automated use of the system, such as using scripts to send comments or messages, or using any data   mining, robots, or similar data gathering and extraction tools.</li> <li>Delete the copyright or other proprietary rights notice from any Content.</li> <li>Attempt to impersonate another user or person or use the username of another user.</li> <li>Upload or transmit (or attempt to upload or to transmit) any material that acts as a passive or active information   collection or transmission mechanism, including without limitation, clear graphics interchange formats (\"gifs\"), 1\u00d71   pixels, web bugs, cookies, or other similar devices (sometimes referred to as \"spyware\" or \"passive collection   mechanisms\" or \"pcms\").</li> <li>Interfere with, disrupt, or create an undue burden on the Services or the networks or services connected to the   Services.</li> <li>Harass, annoy, intimidate, or threaten any of our employees or agents engaged in providing any portion of the Services   to you.</li> <li>Attempt to bypass any measures of the Services designed to prevent or restrict access to the Services, or any portion   of the Services.</li> <li>Copy or adapt the Services' software, including but not limited to Flash, PHP, HTML, JavaScript, or other code.</li> <li>Except as permitted by applicable law, decipher, decompile, disassemble, or reverse engineer any of the software   comprising or in any way making up a part of the Services.</li> <li>Except as may be the result of standard search engine or Internet browser usage, use, launch, develop, or distribute   any automated system, including without limitation, any spider, robot, cheat utility, scraper, or offline reader that   accesses the Services, or use or launch any unauthorized script or other software.</li> <li>Use a buying agent or purchasing agent to make purchases on the Services.</li> <li>Make any unauthorized use of the Services, including collecting usernames and/or email addresses of users by   electronic or other means for the purpose of sending unsolicited email, or creating user accounts by automated means   or under false pretenses.</li> <li>Use the Services as part of any effort to compete with us or otherwise use the Services and/or the Content for any   revenue-generating endeavor or commercial enterprise.</li> </ul>"},{"location":"terms/#9-user-generated-contributions","title":"9. User generated contributions","text":"<p>The Services does not offer users to submit or post content.</p>"},{"location":"terms/#10-contribution-license","title":"10. Contribution license","text":"<p>You and Services agree that we may access, store, process, and use any information and personal data that you provide following the terms of the Privacy Policy and your choices (including settings).</p> <p>By submitting suggestions or other feedback regarding the Services, you agree that we can use and share such feedback for any purpose without compensation to you.</p>"},{"location":"terms/#11-social-media","title":"11. Social media","text":"<p>As part of the functionality of the Services, you may link your account with online accounts you have with third-party service providers (each such account, a \"Third-Party Account\") by either: (1) providing your Third-Party Account login information through the Services; or (2) allowing us to access your Third-Party Account, as is permitted under the applicable terms and conditions that govern your use of each Third-Party Account. You represent and warrant that you are entitled to disclose your Third-Party Account login information to us and/or grant us access to your Third-Party Account, without breach by you of any of the terms and conditions that govern your use of the applicable Third-Party Account, and without obligating us to pay any fees or making us subject to any usage limitations imposed by the third-party service provider of the Third-Party Account. By granting us access to any Third-Party Accounts, you understand that (1) we may access, make available, and store (if applicable) any content that you have provided to and stored in your Third-Party Account (the \"Social Network Content\") so that it is available on and through the Services via your account, including without limitation any friend lists and (2) we may submit to and receive from your Third-Party Account additional information to the extent you are notified when you link your account with the Third-Party Account. Depending on the Third-Party Accounts you choose and subject to the privacy settings that you have set in such Third-Party Accounts, personally identifiable information that you post to your Third-Party Accounts may be available on and through your account on the Services. Please note that if a Third-Party Account or associated service becomes unavailable or our access to such Third-Party Account is terminated by the third-party service provider, then Social Network Content may no longer be available on and through the Services. You will have the ability to disable the connection between your account on the Services and your Third-Party Accounts at any time. PLEASE NOTE THAT YOUR RELATIONSHIP WITH THE THIRD-PARTY SERVICE PROVIDERS ASSOCIATED WITH YOUR THIRD-PARTY ACCOUNTS IS GOVERNED SOLELY BY YOUR AGREEMENT(S) WITH SUCH THIRD-PARTY SERVICE PROVIDERS. We make no effort to review any Social Network Content for any purpose, including but not limited to, for accuracy, legality, or non-infringement, and we are not responsible for any Social Network Content. You acknowledge and agree that we may access your email address book associated with a Third-Party Account and your contacts list stored on your mobile device or tablet computer solely for purposes of identifying and informing you of those contacts who have also registered to use the Services. You can deactivate the connection between the Services and your Third-Party Account by contacting us using the contact information below or through your account settings (if applicable). We will attempt to delete any information stored on our servers that was obtained through such Third-Party Account, except the username and profile picture that become associated with your account.</p>"},{"location":"terms/#12-third-party-websites-and-content","title":"12. Third-party websites and content","text":"<p>The Services may contain (or you may be sent via the Site) links to other websites (\"Third-Party Websites\") as well as articles, photographs, text, graphics, pictures, designs, music, sound, video, information, applications, software, and other content or items belonging to or originating from third parties (\"Third-Party Content\"). Such Third-Party Websites and Third-Party Content are not investigated, monitored, or checked for accuracy, appropriateness, or completeness by us, and we are not responsible for any Third-Party Websites accessed through the Services or any Third-Party Content posted on, available through, or installed from the Services, including the content, accuracy, offensiveness, opinions, reliability, privacy practices, or other policies of or contained in the Third-Party Websites or the Third-Party Content. Inclusion of, linking to, or permitting the use or installation of any Third-Party Websites or any Third-Party Content does not imply approval or endorsement thereof by us. If you decide to leave the Services and access the Third-Party Websites or to use or install any Third-Party Content, you do so at your own risk, and you should be aware these Legal Terms no longer govern. You should review the applicable terms and policies, including privacy and data gathering practices, of any website to which you navigate from the Services or relating to any applications you use or install from the Services. Any purchases you make through Third-Party Websites will be through other websites and from other companies, and we take no responsibility whatsoever in relation to such purchases which are exclusively between you and the applicable third party. You agree and acknowledge that we do not endorse the products or services offered on Third-Party Websites and you shall hold us blameless from any harm caused by your purchase of such products or services. Additionally, you shall hold us blameless from any losses sustained by you or harm caused to you relating to or resulting in any way from any Third-Party Content or any contact with Third-Party Websites.</p>"},{"location":"terms/#13-services-management","title":"13. Services management","text":"<p>We reserve the right, but not the obligation, to: (1) monitor the Services for violations of these Legal Terms; (2) take appropriate legal action against anyone who, in our sole discretion, violates the law or these Legal Terms, including without limitation, reporting such user to law enforcement authorities; (3) in our sole discretion and without limitation, refuse, restrict access to, limit the availability of, or disable (to the extent technologically feasible) any of your Contributions or any portion thereof; (4) in our sole discretion and without limitation, notice, or liability, to remove from the Services or otherwise disable all files and content that are excessive in size or are in any way burdensome to our systems; and (5) otherwise manage the Services in a manner designed to protect our rights and property and to facilitate the proper functioning of the Services.</p>"},{"location":"terms/#14-privacy-policy","title":"14. Privacy policy","text":"<p>We care about data privacy and security. Please review our Privacy Policy. By using the Services, you agree to be bound by our Privacy Policy, which is incorporated into these Legal Terms. Please be advised the Services are hosted in Germany and United States. If you access the Services from any other region of the world with laws or other requirements governing personal data collection, use, or disclosure that differ from applicable laws in Germany and United States, then through your continued use of the Services, you are transferring your data to Germany and United States, and you expressly consent to have your data transferred to and processed in Germany and United States.</p>"},{"location":"terms/#15-term-and-termination","title":"15. Term and termination","text":"<p>These Legal Terms shall remain in full force and effect while you use the Services. WITHOUT LIMITING ANY OTHER PROVISION OF THESE LEGAL TERMS, WE RESERVE THE RIGHT TO, IN OUR SOLE DISCRETION AND WITHOUT NOTICE OR LIABILITY, DENY ACCESS TO AND USE OF THE SERVICES (INCLUDING BLOCKING CERTAIN IP ADDRESSES), TO ANY PERSON FOR ANY REASON OR FOR NO REASON, INCLUDING WITHOUT LIMITATION FOR BREACH OF ANY REPRESENTATION, WARRANTY, OR COVENANT CONTAINED IN THESE LEGAL TERMS OR OF ANY APPLICABLE LAW OR REGULATION. WE MAY TERMINATE YOUR USE OR PARTICIPATION IN THE SERVICES OR DELETE YOUR ACCOUNT AND ANY CONTENT OR INFORMATION THAT YOU POSTED AT ANY TIME, WITHOUT WARNING, IN OUR SOLE DISCRETION.</p> <p>If we terminate or suspend your account for any reason, you are prohibited from registering and creating a new account under your name, a fake or borrowed name, or the name of any third party, even if you may be acting on behalf of the third party. In addition to terminating or suspending your account, we reserve the right to take appropriate legal action, including without limitation pursuing civil, criminal, and injunctive redress.</p>"},{"location":"terms/#16-modifications-and-interruptions","title":"16. Modifications and interruptions","text":"<p>We reserve the right to change, modify, or remove the contents of the Services at any time or for any reason at our sole discretion without notice. However, we have no obligation to update any information on our Services. We will not be liable to you or any third party for any modification, price change, suspension, or discontinuance of the Services.</p> <p>We cannot guarantee the Services will be available at all times. We may experience hardware, software, or other problems or need to perform maintenance related to the Services, resulting in interruptions, delays, or errors. We reserve the right to change, revise, update, suspend, discontinue, or otherwise modify the Services at any time or for any reason without notice to you. You agree that we have no liability whatsoever for any loss, damage, or inconvenience caused by your inability to access or use the Services during any downtime or discontinuance of the Services. Nothing in these Legal Terms will be construed to obligate us to maintain and support the Services or to supply any corrections, updates, or releases in connection therewith.</p>"},{"location":"terms/#17-governing-law","title":"17. Governing law","text":"<p>These Legal Terms are governed by and interpreted following the laws of Germany, and the use of the United Nations Convention of Contracts for the International Sales of Goods is expressly excluded. If your habitual residence is in the EU, and you are a consumer, you additionally possess the protection provided to you by obligatory provisions of the law in your country to residence. dstack GmbH and yourself both agree to submit to the non-exclusive jurisdiction of the courts of Bayern, which means that you may make a claim to defend your consumer protection rights in regards to these Legal Terms in Germany, or in the EU country in which you reside.</p>"},{"location":"terms/#18-dispute-resolution","title":"18. Dispute resolution","text":"<p>Informal Negotiations</p> <p>To expedite resolution and control the cost of any dispute, controversy, or claim related to these Legal Terms (each a \" Dispute\" and collectively, the \"Disputes\") brought by either you or us (individually, a \"Party\" and collectively, the \" Parties\"), the Parties agree to first attempt to negotiate any Dispute (except those Disputes expressly provided below) informally for at least thirty (30) days before initiating arbitration. Such informal negotiations commence upon written notice from one Party to the other Party.</p> <p>Binding Arbitration</p> <p>Any dispute arising from the relationships between the Parties to these Legal Terms shall be determined by one arbitrator who will be chosen in accordance with the Arbitration and Internal Rules of the European Court of Arbitration being part of the European Centre of Arbitration having its seat in Strasbourg, and which are in force at the time the application for arbitration is filed, and of which adoption of this clause constitutes acceptance. The seat of arbitration shall be Munich , Germany . The language of the proceedings shall be German . Applicable rules of substantive law shall be the law of Germany .</p> <p>Restrictions</p> <p>The Parties agree that any arbitration shall be limited to the Dispute between the Parties individually. To the full extent permitted by law, (a) no arbitration shall be joined with any other proceeding; (b) there is no right or authority for any Dispute to be arbitrated on a class-action basis or to utilize class action procedures; and (c) there is no right or authority for any Dispute to be brought in a purported representative capacity on behalf of the general public or any other persons.</p> <p>Exceptions to Informal Negotiations and Arbitration</p> <p>The Parties agree that the following Disputes are not subject to the above provisions concerning informal negotiations binding arbitration: (a) any Disputes seeking to enforce or protect, or concerning the validity of, any of the intellectual property rights of a Party; (b) any Dispute related to, or arising from, allegations of theft, piracy, invasion of privacy, or unauthorized use; and (c) any claim for injunctive relief. If this provision is found to be illegal or unenforceable, then neither Party will elect to arbitrate any Dispute falling within that portion of this provision found to be illegal or unenforceable and such Dispute shall be decided by a court of competent jurisdiction within the courts listed for jurisdiction above, and the Parties agree to submit to the personal jurisdiction of that court.</p>"},{"location":"terms/#19-corrections","title":"19. Corrections","text":"<p>There may be information on the Services that contains typographical errors, inaccuracies, or omissions, including descriptions, pricing, availability, and various other information. We reserve the right to correct any errors, inaccuracies, or omissions and to change or update the information on the Services at any time, without prior notice.</p>"},{"location":"terms/#20-disclaimer","title":"20. Disclaimer","text":"<p>THE SERVICES ARE PROVIDED ON AN AS-IS AND AS-AVAILABLE BASIS. YOU AGREE THAT YOUR USE OF THE SERVICES WILL BE AT YOUR SOLE RISK. TO THE FULLEST EXTENT PERMITTED BY LAW, WE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, IN CONNECTION WITH THE SERVICES AND YOUR USE THEREOF, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. WE MAKE NO WARRANTIES OR REPRESENTATIONS ABOUT THE ACCURACY OR COMPLETENESS OF THE SERVICES' CONTENT OR THE CONTENT OF ANY WEBSITES OR MOBILE APPLICATIONS LINKED TO THE SERVICES AND WE WILL ASSUME NO LIABILITY OR RESPONSIBILITY FOR ANY (1) ERRORS, MISTAKES, OR INACCURACIES OF CONTENT AND MATERIALS, (2) PERSONAL INJURY OR PROPERTY DAMAGE, OF ANY NATURE WHATSOEVER, RESULTING FROM YOUR ACCESS TO AND USE OF THE SERVICES, (3) ANY UNAUTHORIZED ACCESS TO OR USE OF OUR SECURE SERVERS AND/OR ANY AND ALL PERSONAL INFORMATION AND/OR FINANCIAL INFORMATION STORED THEREIN, (4) ANY INTERRUPTION OR CESSATION OF TRANSMISSION TO OR FROM THE SERVICES, (5) ANY BUGS, VIRUSES, TROJAN HORSES, OR THE LIKE WHICH MAY BE TRANSMITTED TO OR THROUGH THE SERVICES BY ANY THIRD PARTY, AND/OR (6) ANY ERRORS OR OMISSIONS IN ANY CONTENT AND MATERIALS OR FOR ANY LOSS OR DAMAGE OF ANY KIND INCURRED AS A RESULT OF THE USE OF ANY CONTENT POSTED, TRANSMITTED, OR OTHERWISE MADE AVAILABLE VIA THE SERVICES. WE DO NOT WARRANT, ENDORSE, GUARANTEE, OR ASSUME RESPONSIBILITY FOR ANY PRODUCT OR SERVICE ADVERTISED OR OFFERED BY A THIRD PARTY THROUGH THE SERVICES, ANY HYPERLINKED WEBSITE, OR ANY WEBSITE OR MOBILE APPLICATION FEATURED IN ANY BANNER OR OTHER ADVERTISING, AND WE WILL NOT BE A PARTY TO OR IN ANY WAY BE RESPONSIBLE FOR MONITORING ANY TRANSACTION BETWEEN YOU AND ANY THIRD-PARTY PROVIDERS OF PRODUCTS OR SERVICES. AS WITH THE PURCHASE OF A PRODUCT OR SERVICE THROUGH ANY MEDIUM OR IN ANY ENVIRONMENT, YOU SHOULD USE YOUR BEST JUDGMENT AND EXERCISE CAUTION WHERE APPROPRIATE.</p>"},{"location":"terms/#21-limitations-of-liability","title":"21. Limitations of liability","text":"<p>IN NO EVENT WILL WE OR OUR DIRECTORS, EMPLOYEES, OR AGENTS BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, SPECIAL, OR PUNITIVE DAMAGES, INCLUDING LOST PROFIT, LOST REVENUE, LOSS OF DATA, OR OTHER DAMAGES ARISING FROM YOUR USE OF THE SERVICES, EVEN IF WE HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. NOTWITHSTANDING ANYTHING TO THE CONTRARY CONTAINED HEREIN, OUR LIABILITY TO YOU FOR ANY CAUSE WHATSOEVER AND REGARDLESS OF THE FORM OF THE ACTION, WILL AT ALL TIMES BE LIMITED TO THE LESSER OF THE AMOUNT PAID, IF ANY, BY YOU TO US DURING THE zero (0) MONTH PERIOD PRIOR TO ANY CAUSE OF ACTION ARISING OR $0.00 USD. CERTAIN US STATE LAWS AND INTERNATIONAL LAWS DO NOT ALLOW LIMITATIONS ON IMPLIED WARRANTIES OR THE EXCLUSION OR LIMITATION OF CERTAIN DAMAGES. IF THESE LAWS APPLY TO YOU, SOME OR ALL OF THE ABOVE DISCLAIMERS OR LIMITATIONS MAY NOT APPLY TO YOU, AND YOU MAY HAVE ADDITIONAL RIGHTS.</p>"},{"location":"terms/#22-indemnification","title":"22. Indemnification","text":"<p>You agree to defend, indemnify, and hold us harmless, including our subsidiaries, affiliates, and all of our respective officers, agents, partners, and employees, from and against any loss, damage, liability, claim, or demand, including reasonable attorneys\u2019 fees and expenses, made by any third party due to or arising out of: (1) use of the Services; (2) breach of these Legal Terms; (3) any breach of your representations and warranties set forth in these Legal Terms; (4) your violation of the rights of a third party, including but not limited to intellectual property rights; or (5) any overt harmful act toward any other user of the Services with whom you connected via the Services. Notwithstanding the foregoing, we reserve the right, at your expense, to assume the exclusive defense and control of any matter for which you are required to indemnify us, and you agree to cooperate, at your expense, with our defense of such claims. We will use reasonable efforts to notify you of any such claim, action, or proceeding which is subject to this indemnification upon becoming aware of it.</p>"},{"location":"terms/#23-user-data","title":"23. User data","text":"<p>We will maintain certain data that you transmit to the Services for the purpose of managing the performance of the Services, as well as data relating to your use of the Services. Although we perform regular routine backups of data, you are solely responsible for all data that you transmit or that relates to any activity you have undertaken using the Services. You agree that we shall have no liability to you for any loss or corruption of any such data, and you hereby waive any right of action against us arising from any such loss or corruption of such data.</p>"},{"location":"terms/#24-electronic-communications-transactions-and-signatures","title":"24. Electronic communications, transactions, and signatures","text":"<p>Visiting the Services, sending us emails, and completing online forms constitute electronic communications. You consent to receive electronic communications, and you agree that all agreements, notices, disclosures, and other communications we provide to you electronically, via email and on the Services, satisfy any legal requirement that such communication be in writing. YOU HEREBY AGREE TO THE USE OF ELECTRONIC SIGNATURES, CONTRACTS, ORDERS, AND OTHER RECORDS, AND TO ELECTRONIC DELIVERY OF NOTICES, POLICIES, AND RECORDS OF TRANSACTIONS INITIATED OR COMPLETED BY US OR VIA THE SERVICES. You hereby waive any rights or requirements under any statutes, regulations, rules, ordinances, or other laws in any jurisdiction which require an original signature or delivery or retention of non-electronic records, or to payments or the granting of credits by any means other than electronic means.</p>"},{"location":"terms/#25-california-users-and-residents","title":"25. California users and residents","text":"<p>If any complaint with us is not satisfactorily resolved, you can contact the Complaint Assistance Unit of the Division of Consumer Services of the California Department of Consumer Affairs in writing at 1625 North Market Blvd., Suite N 112, Sacramento, California 95834 or by telephone at (800) 952-5210 or (916) 445-1254.</p>"},{"location":"terms/#26-miscellaneous","title":"26. Miscellaneous","text":"<p>These Legal Terms and any policies or operating rules posted by us on the Services or in respect to the Services constitute the entire agreement and understanding between you and us. Our failure to exercise or enforce any right or provision of these Legal Terms shall not operate as a waiver of such right or provision. These Legal Terms operate to the fullest extent permissible by law. We may assign any or all of our rights and obligations to others at any time. We shall not be responsible or liable for any loss, damage, delay, or failure to act caused by any cause beyond our reasonable control. If any provision or part of a provision of these Legal Terms is determined to be unlawful, void, or unenforceable, that provision or part of the provision is deemed severable from these Legal Terms and does not affect the validity and enforceability of any remaining provisions. There is no joint venture, partnership, employment or agency relationship created between you and us as a result of these Legal Terms or use of the Services. You agree that these Legal Terms will not be construed against us by virtue of having drafted them. You hereby waive any and all defenses you may have based on the electronic form of these Legal Terms and the lack of signing by the parties hereto to execute these Legal Terms.</p>"},{"location":"terms/#27-contact-us","title":"27. Contact us","text":"<p>In order to resolve a complaint regarding the Services or to receive further information regarding use of the Services, please contact us at hello@dstack.ai.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/","title":"Examples","text":""},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/#prerequisites","title":"Prerequisites","text":"<p>Once <code>dstack</code> is installed, clone the repo and run <code>dstack init</code></p> <pre><code>git clone https://github.com/dstackai/dstack\ncd dstack\ndstack init\n</code></pre> <p>Now you are ready to run examples! Select any example from the left-hand sidebar.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/#source-code","title":"Source code","text":"<p>The source-code of examples can be found in  <code>https://github.com/dstackai/dstack/examples</code>.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/#contributing","title":"Contributing","text":"<p>Can't find an important example? Raise an issue or send a pull request!</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/infinity/","title":"Infinity","text":"<p>The following command a text embedding model as a service:</p> <pre><code>dstack run . -f examples/deployment/infinity/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/lorax/","title":"LoRaX","text":"<p>LoRAX allows serving multiple fine-tuned models optimized on the same endpoint by dynamically loading and switching LoRA adapters.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/lorax/#service","title":"Service","text":"<p>The following command deploys Mistral 7B Instruct as a base model via a service:</p> <pre><code>dstack run . -f examples/deployment/lorax/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/lorax/#task","title":"Task","text":"<p>The following command runs Mistral 7B Instruct as a base model via a task:</p> <pre><code>dstack run . -f examples/deployment/lorax/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/ollama/","title":"Ollama","text":"<p>The following command deploys Mixtral 8x7B as a service:</p> <pre><code>dstack run . -f examples/deployment/ollama/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/tei/","title":"Text Embeddings Inference","text":"<p>The following command a text embedding model as a service:</p> <pre><code>dstack run . -f examples/deployment/tae/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/tgi/","title":"Text Generation Inference","text":""},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/tgi/#service","title":"Service","text":"<p>The following command deploys Llama 7B Instruct as a service:</p> <pre><code>dstack run . -f examples/deployment/tgi/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/tgi/#task","title":"Task","text":"<p>The following command runs Llama 7B Instruct as a task:</p> <pre><code>dstack run . -f examples/deployment/tgi/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/vllm/","title":"vLLM","text":""},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/vllm/#service","title":"Service","text":"<p>The following command deploys Llama 7B Instruct as a service:</p> <pre><code>dstack run . -f examples/deployment/vllm/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/vllm/#task","title":"Task","text":"<p>The following command runs Llama 7B Instruct as a task:</p> <pre><code>dstack run . -f examples/deployment/vllm/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/alignment-handbook/","title":"Alignment Handbook","text":"<p>Alignment Handbook by HuggingFace offers recipes, configs, and scripts for fine-tuning LLMs. It includes all the code needed to run CPT, SFT, DPO, and ORPO leveraging HuggingFace's libraries like <code>transformers</code>, <code>peft</code>, <code>accelerate</code>, and <code>trl</code>. You just need to modify the recipes and run the  appropriate script.</p> <p>This example shows how use Alignment Handbook to fine-tune Gemma 7B on your SFT dataset  with Alignment Handbook and <code>dstack</code>. </p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/alignment-handbook/#prerequisites","title":"Prerequisites","text":"<p>Once <code>dstack</code> is installed, clone the repo and run <code>dstack init</code></p> <pre><code>git clone https://github.com/dstackai/dstack\ncd dstack\ndstack init\n</code></pre>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/alignment-handbook/#training-configuration-recipe","title":"Training configuration recipe","text":"<p>Alignment Handbook's training script reads the model, LoRA, and dataset arguments, as well as trainer configuration from a YAML file. This file can be found at <code>examples/fine-tuning/alignment-handbook/config.yaml</code>. You can modify it as needed.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/alignment-handbook/#single-node-training","title":"Single-node training","text":"<p>The easiest way to run a training script with <code>dstack</code> is by creating a task configuration file. This file can be found at <code>examples/fine-tuning/alignment-handbook/train.dstack.yml</code>. Below is its content: </p> <pre><code>type: task\nname: ah-train\n\n# If `image` is not specified, dstack uses its default image\npython: \"3.10\"\n\n# Required environment variables\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - ACCELERATE_LOG_LEVEL=info\n  - WANDB_API_KEY\n# Commands of the task\ncommands:\n  - conda install cuda\n  - git clone https://github.com/huggingface/alignment-handbook.git\n  - cd alignment-handbook\n  - pip install .\n  - pip install flash-attn --no-build-isolation\n  - pip install wandb\n  - accelerate launch\n    --config_file recipes/accelerate_configs/multi_gpu.yaml\n    --num_processes=$DSTACK_GPUS_NUM\n    scripts/run_sft.py\n    ../examples/fine-tuning/alignment-handbook/config.yaml\n# Expose 6006 to access TensorBoard\nports:\n  - 6006\n\nresources:\n  # Required resources\n  gpu: 24GB\n</code></pre> <p>The task clones Alignment Handbook's repo, installs the dependencies, and runs the script.</p> <p>The <code>DSTACK_GPUS_NUM</code> environment variable is automatically passed to the container according to the <code>resoruce</code> property.</p> <p>To run the task, use <code>dstack apply</code>:</p> <pre><code>HUGGING_FACE_HUB_TOKEN=...\nACCELERATE_LOG_LEVEL=...\nWANDB_API_KEY=...\n\ndstack apply -f examples/fine-tuning/alignment-handbook/train.dstack.yml\n</code></pre> <p>If you list <code>tensorbord</code> via <code>report_to</code> in <code>examples/fine-tuning/alignment-handbook/config.yaml</code>, you'll be able to access experiment metrics via <code>http://localhost:6006</code> (while the task is running).</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/alignment-handbook/#multi-node-training","title":"Multi-node training","text":"<p>The multi-node training task configuration file can be found at <code>examples/fine-tuning/alignment-handbook/train-distrib.dstack.yml</code>. Below is its content:</p> <pre><code>type: task\nname: ah-train-distrib\n\n# If `image` is not specified, dstack uses its default image\npython: \"3.10\"\n\n# Required environment variables\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - ACCELERATE_LOG_LEVEL=info\n  - WANDB_API_KEY\n# Commands of the task (dstack runs it on each node)\ncommands:\n  - conda install cuda\n  - git clone https://github.com/huggingface/alignment-handbook.git\n  - cd alignment-handbook\n  - pip install .\n  - pip install flash-attn --no-build-isolation\n  - pip install wandb\n  - accelerate launch\n    --config_file ../examples/fine-tuning/alignment-handbook/fsdp_qlora_full_shard.yaml\n    --main_process_ip=$DSTACK_MASTER_NODE_IP\n    --main_process_port=8008\n    --machine_rank=$DSTACK_NODE_RANK\n    --num_processes=$DSTACK_GPUS_NUM\n    --num_machines=$DSTACK_NODES_NUM\n    scripts/run_sft.py \n    ../examples/fine-tuning/alignment-handbook/config.yaml\n# Expose 6006 to access TensorBoard\nports:\n  - 6006\n\n# The number of interconnected instances required\nnodes: 2\n\nresources:\n  # Required resources\n  gpu: 24GB\n  # Shared memory size for inter-process communication\n  shm_size: 24GB\n</code></pre> <p>Here's how the multi-node task is different from the single-node one:</p> <ol> <li>The <code>nodes</code> property is specified with a number of required nodes (should match the fleet's nodes number).</li> <li>Under <code>resoruces</code>, <code>shm_size</code> is specified with the shared memory size used for the communication of parallel    processes within a node (in case multiple GPUs per node are used).</li> <li>Instead of Alignment Handbook's <code>recipes/accelerate_configs/multi_gpu.yaml</code>, we use <code>examples/fine-tuning/alignment-handbook/fsdp_qlora_full_shard.yaml</code> as an accelerate config.</li> <li>We use <code>DSTACK_MASTER_NODE_IP</code>, <code>DSTACK_NODE_RANK</code>, <code>DSTACK_GPUS_NUM</code>, and <code>DSTACK_NODES_NUM</code> environment variables to    configure <code>accelerate</code>. The environment variables are automatically passed    to the container for each node based on the task configuration.</li> </ol>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/alignment-handbook/#fleets","title":"Fleets","text":"<p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets.  If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p> <p>The example folder includes two cloud fleet configurations: <code>examples/fine-tuning/alignment-handbook/fleet.dstack.yml</code> (a single node with a <code>24GB</code> GPU), and a <code>examples/fine-tuning/alignment-handbook/fleet-distrib.dstack.yml</code> (a cluster of two nodes each with a <code>24GB</code> GPU).</p> <p>You can update the fleet configurations to change the vRAM size, GPU model, number of GPUs per node, or number of nodes. </p> <p>A fleet can be provisioned with <code>dstack apply</code>:</p> <pre><code>dstack apply -f examples/fine-tuning/alignment-handbook/fleet.dstack.yml\n</code></pre> <p>Once provisioned, the fleet can run dev environments and fine-tuning tasks. To delete the fleet, use <code>dstack fleet delete</code>.</p> <p>To ensure <code>dstack apply</code> always reuses an existing fleet, pass <code>--reuse</code> to <code>dstack apply</code> (or set <code>creation_policy</code> to <code>reuse</code> in the task configuration). The default policy is <code>reuse_or_create</code>.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/alignment-handbook/#dev-environment","title":"Dev environment","text":"<p>If you'd like to play with the example using a dev environment, run .dstack.yml via <code>dstack apply</code>:</p> <pre><code>dstack apply -f examples/fine-tuning/alignment-handbook/.dstack.yaml \n</code></pre>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/alignment-handbook/#source-code","title":"Source code","text":"<p>The source-code of this example can be found in  <code>https://github.com/dstackai/dstack/examples/fine-tuning/alignment-handbook</code>.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/alignment-handbook/#contributing","title":"Contributing","text":"<p>Find a mistake or can't find an important example? Raise an issue or send a pull request!</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/alignment-handbook/#whats-next","title":"What's next?","text":"<ol> <li>Browse Alignment Handbook.</li> <li>Check dev environments, tasks,     services, and fleets.</li> <li>See other examples.</li> </ol>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/axolotl/","title":"Axolotl","text":"<p><code>axolotl</code> streamlines the fine-tuning of AI models, offering support for multiple configurations and architectures.</p> <p>Furthermore, <code>axolotl</code> provides a set of <code>yaml</code> examples for almost all kinds of LLMs such as LLaMA2 family, Gemma family, LLaMA3 family, Jamba, and so on. It's recommended to navigate through the examples to get a sense about the role of each parameters, and adjust them for your specific use cases. Also, it is worth checking out all configs/parameters options with a brief description from this doc.</p> <p>The example below replicates the FSDP+QLoRA on LLaMA3 70B, except that here we use Llama3 8B. You can see the <code>config.yaml</code>.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/axolotl/#running-with-dstack","title":"Running with <code>dstack</code>","text":"<p>Running <code>axolotl</code> with <code>dstack</code> is very straightforward.</p> <p>First, define the <code>train.dstack.yaml</code> task configuration file as follows:</p> <pre><code>type: task\n\nimage: winglian/axolotl-cloud:main-20240429-py3.11-cu121-2.2.1\n\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - WANDB_API_KEY\n\ncommands:\n  - accelerate launch -m axolotl.cli.train config.yaml\n\nports:\n  - 6006\n\nresources:\n  gpu:\n    memory: 24GB..\n    count: 2\n</code></pre> <p>[!NOTE] Feel free to adjust <code>resources</code> to specify the required resources.</p> <p>We are using the official Docker image provided by Axolotl team (<code>winglian/axolotl-cloud:main-20240429-py3.11-cu121-2.2.1</code>). If you want to see other images, their official repo. Note, <code>dstack</code> requires the CUDA driver to be 12.1+.</p> <p>To run the task, use the following command:</p> <pre><code>HUGGING_FACE_HUB_TOKEN=&lt;...&gt; \\\nWANDB_API_KEY=&lt;...&gt; \\\ndstack run . -f examples/fine-tuning/axolotl/train.dstack.yaml\n</code></pre> <p>To push the final fine-tuned model to Hugging Face Hub, set <code>hub_model_id</code> in <code>config.yaml</code>.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/axolotl/#building-axolotl-from-sources","title":"Building <code>axolotl</code> from sources","text":"<p>If you'd like to build <code>axolot</code> from sources (e.g. if you intend to modify its source code), follow its installation guide.</p> <p>Example:</p> <pre><code>type: task\n\npython: 3.11\n\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - WANDB_API_KEY\n\ncommands:\n  - conda install cuda\n  - pip3 install torch torchvision torchaudio\n\n  - git clone https://github.com/OpenAccess-AI-Collective/axolotl.git\n  - cd axolotl\n\n  - pip3 install packaging\n  - pip3 install -e '.[flash-attn,deepspeed]'\n\n  - accelerate launch -m axolotl.cli.train ../config.yaml\n\nports:\n  - 6006\n\nresources:\n  gpu:\n    memory: 24GB..\n    count: 2\n</code></pre>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/qlora/","title":"QLoRA","text":"<p>The following command runs the task to fine-tune an LLM using QLoRA:</p> <pre><code>dstack run . -f examples/fine-tuning/qlora/task.dstack.yml\n</code></pre> <p>See the configuration at train.dstack.yml.</p> <p>For more details, refer to tasks.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/llms/chat-ui/","title":"Chat UI","text":"<p>This example walks you through setting up Chat UI locally to chat with an LLM deployed using <code>dstack</code>.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/llms/chat-ui/#clone-the-repo","title":"Clone the repo","text":"<pre><code>git clone https://github.com/huggingface/chat-ui\ncd chat-ui\n</code></pre>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/llms/chat-ui/#run-local-mongodb","title":"Run local MongoDB","text":"<pre><code>docker run -d -p 27017:27017 --name mongo-chatui mongo:latest\n</code></pre>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/llms/chat-ui/#create-envlocal","title":"Create <code>.env.local</code>","text":"<pre><code>MONGODB_URL=mongodb://localhost:27017\n\nMODELS=`[\n   {\n      \"name\": \"&lt;model name&gt;\",\n      \"displayName\": \"My model\",\n      \"endpoints\": [\n        {\n         \"type\": \"openai\",\n         \"baseURL\" : \"https://gateway.&lt;gateway domain&gt;\",\n         \"apiKey\": \"&lt;dstack token&gt;\"\n        }\n      ]\n  }\n]`\n</code></pre> <p>Replace <code>&lt;gateway domain&gt;</code> with your <code>dstack</code> gateway's domain (e.g. <code>&lt;dstack project&gt;.sky.dstack.ai</code> if you are using dstack Sky).</p> <p>Replace <code>&lt;dstack token&gt;</code> with your <code>dstack</code> user's token.</p> <p>Replace <code>&lt;model name&gt;</code> with the name of the deployed mode,</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/llms/chat-ui/#run-chat-ui","title":"Run Chat UI","text":"<pre><code>npm run dev\n</code></pre> <p>Now you can conveniently chat with your model! \ud83e\udd17</p> <p></p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/llms/llama3/","title":"Llama 3","text":""},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/llms/llama3/#deploy-llama-8b","title":"Deploy Llama 8B","text":"<p>The following command deploys Llama 3 8B as a service:</p> <pre><code>dstack run . -f examples/llms/llama3/ollama-8b.dstack.yml\n</code></pre> <p>See the configuration at ollama-8b.dstack.yml.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/llms/llama3/#deploy-llama-70b","title":"Deploy Llama 70B","text":"<p>The following command deploys Llama 3 70B as a service:</p> <pre><code>dstack run . -f examples/llms/llama3/ollama-70b.dstack.yml\n</code></pre> <p>See the configuration at ollama-70b.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/llms/llama3/#run-chat-ui","title":"Run Chat UI","text":"<p>Refer to chat-ui to learn how to launch a UI for chatting with the LLM you've deployed to <code>dstack</code>.</p> <p></p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/llms/mixtral/","title":"Mixtral 8x7B","text":"<p>The following command deploys Mixtral 8x7B as a service:</p> <pre><code>dstack run . -f examples/llms/mixtral/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/misc/http.server/","title":"Streamlit","text":""},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/misc/http.server/#service","title":"Service","text":"<p>The following command runs <code>http.server</code> as a service:</p> <pre><code>dstack run . -f examples/misc/http.server/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/misc/http.server/#task","title":"Task","text":"<p>The following command runs <code>http.server</code> as a task:</p> <pre><code>dstack run . -f examples/misc/http.server/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/misc/streamlit/","title":"Streamlit","text":""},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/misc/streamlit/#service-no-auth","title":"Service (no auth)","text":"<p>The following command runs <code>streamlit hello</code> as a service with disabled authentication:</p> <pre><code>dstack run . -f examples/misc/streamlit/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/misc/streamlit/#task","title":"Task","text":"<p>The following command runs <code>streamlit hello</code> as a task:</p> <pre><code>dstack run . -f examples/misc/streamlit/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve-task.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"blog/","title":"Blog","text":""},{"location":"blog/archive/say-goodbye-to-managed-notebooks/","title":"Say goodbye to managed notebooks","text":"<p>Data science and ML tools have made significant advancements in recent years. This blog post aims to examine the advantages of cloud dev environments (CDE) for ML engineers and compare them with web-based managed notebooks.</p>"},{"location":"blog/archive/say-goodbye-to-managed-notebooks/#notebooks-are-here-to-stay","title":"Notebooks are here to stay","text":"<p>Jupyter notebooks are instrumental for interactive work with data. They provide numerous advantages such as high interactivity, visualization support, remote accessibility, and effortless sharing.</p> <p>Managed notebook platforms, like Google Colab and AWS SageMaker have become popular thanks to their easy integration with clouds. With pre-configured environments, managed notebooks remove the need to worry about infrastructure.</p> <p></p>"},{"location":"blog/archive/say-goodbye-to-managed-notebooks/#reproducibility-challenge","title":"Reproducibility challenge","text":"<p>As the code evolves, it needs to be converted into Python scripts and stored in Git for improved organization and version control. Notebooks alone cannot handle this task, which is why they must be a part of a developer environment that also supports Python scripts and Git.</p> <p>The JupyterLab project attempts to address this by turning notebooks into an IDE by adding a file browser, terminal, and Git support.</p> <p></p>"},{"location":"blog/archive/say-goodbye-to-managed-notebooks/#ides-get-equipped-for-ml","title":"IDEs get equipped for ML","text":"<p>Recently, IDEs have improved in their ability to support machine learning. They have started to combine the benefits of traditional IDEs and managed notebooks. </p> <p>IDEs have upgraded their remote capabilities, with better SSH support. Additionally, they now offer built-in support for editing notebooks.</p> <p>Two popular IDEs, VS Code and PyCharm, have both integrated remote capabilities and seamless notebook editing features.</p> <p></p>"},{"location":"blog/archive/say-goodbye-to-managed-notebooks/#the-rise-of-app-ecosystem","title":"The rise of app ecosystem","text":"<p>Notebooks have been beneficial for their interactivity and sharing features. However, there are new alternatives like Streamlit and Gradio that allow developers to build data apps using Python code. These frameworks not only simplify app-building but also enhance reproducibility by integrating with Git. </p> <p>Hugging Face Spaces, for example, is a popular tool today for sharing Streamlit and Gradio apps with others.</p> <p></p>"},{"location":"blog/archive/say-goodbye-to-managed-notebooks/#say-hello-to-cloud-dev-environments","title":"Say hello to cloud dev environments!","text":"<p>Remote development within IDEs is becoming increasingly popular, and as a result, cloud dev environments have emerged as a new concept. Various managed services, such as Codespaces and GitPod, offer scalable infrastructure while maintaining the familiar IDE experience.</p> <p>One such open-source tool is <code>dstack</code>, which enables you to define your dev environment declaratively as code and run it on any cloud.</p> <pre><code>type: dev-environment\nbuild:\n  - apt-get update\n  - apt-get install -y ffmpeg\n  - pip install -r requirements.txt\nide: vscode\n</code></pre> <p>With this tool, provisioning the required hardware, setting up the pre-built environment (no Docker is needed), and fetching your local code is automated.</p> <pre><code>$ dstack run .\n\n RUN                 CONFIGURATION  USER   PROJECT  INSTANCE       SPOT POLICY\n honest-jellyfish-1  .dstack.yml    peter  gcp      a2-highgpu-1g  on-demand\n\nStarting SSH tunnel...\n\nTo open in VS Code Desktop, use one of these link:\n  vscode://vscode-remote/ssh-remote+honest-jellyfish-1/workflow\n\nTo exit, press Ctrl+C.\n</code></pre> <p>You can securely access the cloud development environment with the desktop IDE of your choice.</p> <p></p> <p>Learn more</p> <p>Check out our guide for running dev environments in your cloud.</p>"},{"location":"blog/dstack-sky-own-cloud-accounts/","title":"dstack Sky now allows using your own cloud accounts","text":"<p>dstack Sky   enables you to access GPUs from the global marketplace at the most competitive rates. However, sometimes you may want to use your own cloud accounts.  With today's release, both options are now supported.</p> <p></p>"},{"location":"blog/dstack-sky-own-cloud-accounts/#configure-backends","title":"Configure backends","text":"<p>To use your own cloud account, open the project settings and edit the corresponding backend.</p> <p></p> <p>You can configure your cloud accounts for any of the supported providers, including AWS, GCP, Azure, TensorDock, Lambda, CUDO, RunPod, and Vast.ai.</p> <p>Additionally, you can disable certain backends if you do not plan to use them.</p> <p>Typically, if you prefer using your own cloud accounts, it's recommended that you use the  open-source version  of <code>dstack</code>. However, if you prefer not to host it yourself, now you can use <code>dstack Sky</code>  with your own cloud accounts as well.</p> <p>Seeking the cheapest on-demand and spot cloud GPUs? dstack Sky  has you covered!</p> <p>Need help, have a question, or just want to stay updated?</p> <p>Join Discord</p>"},{"location":"blog/dstack-sky/","title":"Introducing dstack Sky","text":"<p>Today we're previewing <code>dstack Sky</code>, a service built on top of  <code>dstack</code> that enables you to get GPUs at competitive rates from a wide pool of providers.</p> <p></p>"},{"location":"blog/dstack-sky/#tldr","title":"TL;DR","text":"<ul> <li>GPUs at competitive rates from multiple providers</li> <li>No need for your own cloud accounts</li> <li>Compatible with <code>dstack</code>'s CLI and API</li> <li>A pre-configured gateway for deploying services</li> </ul>"},{"location":"blog/dstack-sky/#introduction","title":"Introduction","text":"<p><code>dstack</code> is an open-source tool designed for managing AI infrastructure across various cloud platforms. It's lighter and more specifically geared towards AI tasks compared to Kubernetes.</p> <p>Due to its support for multiple cloud providers, <code>dstack</code> is frequently used to access on-demand and spot GPUs  across multiple clouds.  From our users, we've learned that managing various cloud accounts, quotas, and billing can be cumbersome.</p> <p>To streamline this process, we introduce <code>dstack Sky</code>, a managed service that enables users to access GPUs from multiple providers through <code>dstack</code> \u2013 without needing an account in each cloud provider. </p>"},{"location":"blog/dstack-sky/#what-is-dstack-sky","title":"What is dstack Sky?","text":"<p>Instead of running <code>dstack server</code> yourself, you point <code>dstack config</code> to a project set up with <code>dstack Sky</code>.</p> <pre><code>$ dstack config --url https://sky.dstack.ai \\\n    --project my-awesome-project \\\n    --token ca1ee60b-7b3f-8943-9a25-6974c50efa75\n</code></pre> <p>Now, you can use <code>dstack</code>'s CLI or API \u2013 just like you would with your own cloud accounts.</p> <pre><code>$ dstack run . -b tensordock -b vastai\n\n #  BACKEND     REGION  RESOURCES                    SPOT  PRICE \n 1  vastai      canada  16xCPU/64GB/1xRTX4090/1TB    no    $0.35\n 2  vastai      canada  16xCPU/64GB/1xRTX4090/400GB  no    $0.34\n 3  tensordock  us      8xCPU/48GB/1xRTX4090/480GB   no    $0.74\n    ...\n Shown 3 of 50 offers, $0.7424 max\n\nContinue? [y/n]:\n</code></pre> <p>Backends</p> <p><code>dstack Sky</code> supports the same backends as the open-source version, except that you don't need to set them up. By default, it uses all supported backends.</p> <p>You can use both on-demand and spot instances without needing to manage quotas, as they are automatically handled for you.</p> <p>With <code>dstack Sky</code> you can use all of <code>dstack</code>'s features, incl. dev environments,  tasks, services, and  fleets.</p> <p>To use services, the open-source version requires setting up a gateway with your own domain.  <code>dstack Sky</code> comes with a pre-configured gateway.</p> <pre><code>$ dstack gateway list\n BACKEND  REGION     NAME    ADDRESS       DOMAIN                            DEFAULT\n aws      eu-west-1  dstack  3.252.79.143  my-awesome-project.sky.dstack.ai  \u2713\n</code></pre> <p>If you run it with <code>dstack Sky</code>, the service's endpoint will be available at <code>https://&lt;run name&gt;.&lt;project name&gt;.sky.dstack.ai</code>.</p> <p>Let's say we define a service:</p> <pre><code>type: service\n# Deploys Mixtral 8x7B with Ollama\n\n# Serve model using Ollama's Docker image\nimage: ollama/ollama\ncommands:\n  - ollama serve &amp;\n  - sleep 3\n  - ollama pull mixtral\n  - fg\nport: 11434\n\n# Configure hardware requirements\nresources:\n  gpu: 48GB..80GB\n\n# Enable OpenAI compatible endpoint\nmodel:\n  type: chat\n  name: mixtral\n  format: openai\n</code></pre> <p>If it has a <code>model</code> mapping, the model will be accessible at <code>https://gateway.&lt;project name&gt;.sky.dstack.ai</code> via the OpenAI compatible interface.</p> <pre><code>from openai import OpenAI\n\n\nclient = OpenAI(\n  base_url=\"https://gateway.&lt;project name&gt;.sky.dstack.ai\",\n  api_key=\"&lt;dstack token&gt;\"\n)\n\ncompletion = client.chat.completions.create(\n  model=\"mixtral\",\n  messages=[\n    {\"role\": \"user\", \"content\": \"Compose a poem that explains the concept of recursion in programming.\"}\n  ]\n)\n\nprint(completion.choices[0].message)\n</code></pre> <p>Now, you can choose \u2014 either use <code>dstack</code> via the open-source version or via <code>dstack Sky</code>,  or even use them side by side.</p> <p>Credits</p> <p>Are you an active contributor to the AI community? Request free <code>dstack Sky</code> credits.</p> <p><code>dstack Sky</code>  is live on Product Hunt. Support it by giving it your vote!</p> <p>Join Discord</p>"},{"location":"changelog/","title":"Blog","text":""},{"location":"docs/","title":"What is dstack?","text":"<p><code>dstack</code> is an open-source container orchestration engine for AI.  It accelerates the development, training, and deployment of AI models, and simplifies the management of clusters.</p>"},{"location":"docs/#cloud-and-on-prem","title":"Cloud and on-prem","text":"<p><code>dstack</code> is easy to use with any cloud or on-prem servers. Supported cloud providers include AWS, GCP, Azure, OCI, Lambda, TensorDock, Vast.ai, RunPod, and CUDO. For using <code>dstack</code> with on-prem servers, see fleets.</p>"},{"location":"docs/#accelerators","title":"Accelerators","text":"<p><code>dstack</code> supports <code>NVIDIA GPU</code> and <code>Google Cloud TPU</code> out of the box.</p>"},{"location":"docs/#how-does-it-work","title":"How does it work?","text":"<p>Before using <code>dstack</code>, install the server and configure  backends for each cloud account (or Kubernetes cluster) that you intend to use.</p>"},{"location":"docs/#1-define-run-configurations","title":"1. Define run configurations","text":"<p><code>dstack</code> supports three types of run configurations:</p> <ul> <li>Dev environments \u2014 for interactive development using a desktop IDE</li> <li>Tasks \u2014 for any kind of batch jobs or web applications (supports distributed jobs)</li> <li>Services\u2014 for production-grade deployment (supports auto-scaling and authorization)</li> </ul> <p>Each type of run configuration allows you to specify commands for execution, required compute resources, retry policies, auto-scaling rules, authorization settings, and more.</p> <p>Configuration can be defined as YAML files within your repo.</p>"},{"location":"docs/#2-run-configurations","title":"2. Run configurations","text":"<p>Run any defined configuration either via <code>dstack</code> CLI or API.</p> <p><code>dstack</code> automatically handles provisioning, interruptions, port-forwarding, auto-scaling, network, volumes,  run failures, out-of-capacity errors, and more.</p>"},{"location":"docs/#3-manage-fleets","title":"3. Manage fleets","text":"<p>Use fleets to provision and manage clusters and instances, both in the cloud and on-prem.</p>"},{"location":"docs/#where-do-i-start","title":"Where do I start?","text":"<ol> <li>Proceed to installation</li> <li>See quickstart</li> <li>Browse examples </li> <li>Join Discord </li> </ol>"},{"location":"docs/dev-environments/","title":"Dev environments","text":"<p>Before scheduling a task or deploying a model, you may want to run code interactively. Dev environments allow you to provision a remote machine set up with your code and favorite IDE with just one command.</p>"},{"location":"docs/dev-environments/#configuration","title":"Configuration","text":"<p>First, create a YAML file in your project folder. Its name must end with <code>.dstack.yml</code> (e.g. <code>.dstack.yml</code> or <code>dev.dstack.yml</code> are both acceptable).</p> <pre><code>type: dev-environment\n\n# Specify the Python version, or your Docker image\npython: \"3.11\"\n\n# This pre-configures the IDE with required extensions\nide: vscode\n\n# Specify GPU, disk, and other resource requirements\nresources:\n  gpu: 80GB\n</code></pre> <p>If you don't specify your Docker image, <code>dstack</code> uses the base image (pre-configured with Python, Conda, and essential CUDA drivers).</p> <p>Reference</p> <p>See the .dstack.yml reference for all supported configuration options and examples.</p>"},{"location":"docs/dev-environments/#running","title":"Running","text":"<p>To run a configuration, use the <code>dstack run</code> command followed by the working directory path,  configuration file path, and other options.</p> <pre><code>$ dstack run . -f .dstack.yml\n\n BACKEND     REGION         RESOURCES                     SPOT  PRICE\n tensordock  unitedkingdom  10xCPU, 80GB, 1xA100 (80GB)   no    $1.595\n azure       westus3        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n azure       westus2        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n\nContinue? [y/n]: y\n\nProvisioning `fast-moth-1`...\n---&gt; 100%\n\nTo open in VS Code Desktop, use this link:\n  vscode://vscode-remote/ssh-remote+fast-moth-1/workflow\n</code></pre> <p>When <code>dstack</code> provisions the dev environment, it mounts the project folder contents.</p> .gitignore <p>If there are large files or folders you'd like to avoid uploading,  you can list them in <code>.gitignore</code>.</p> Fleets <p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets.  If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p> <p>To have the fleet deleted after a certain idle time automatically, set <code>termination_idle_time</code>. By default, it's set to <code>5min</code>.</p> <p>Reference</p> <p>See the CLI reference for more details on how <code>dstack run</code> works.</p>"},{"location":"docs/dev-environments/#vs-code","title":"VS Code","text":"<p>To open the dev environment in your desktop IDE, use the link from the output  (such as <code>vscode://vscode-remote/ssh-remote+fast-moth-1/workflow</code>).</p> <p></p>"},{"location":"docs/dev-environments/#ssh","title":"SSH","text":"<p>Alternatively, while the CLI is attached to the run, you can connect to the dev environment via SSH:</p> <pre><code>$ ssh fast-moth-1\n</code></pre>"},{"location":"docs/dev-environments/#managing-runs","title":"Managing runs","text":""},{"location":"docs/dev-environments/#listing-runs","title":"Listing runs","text":"<p>The <code>dstack ps</code> command lists all running runs and their status.</p>"},{"location":"docs/dev-environments/#stopping-runs","title":"Stopping runs","text":"<p>Once the run exceeds the max duration, or when you use <code>dstack stop</code>,  the dev environment and its cloud resources are deleted.</p>"},{"location":"docs/dev-environments/#whats-next","title":"What's next?","text":"<ol> <li>Check the <code>.dstack.yml</code> reference for more details and examples</li> <li>See fleets on how to manage fleets</li> </ol>"},{"location":"docs/fleets/","title":"Fleets","text":"<p>Fleets enable efficient provisioning and management of clusters and instances, both in the cloud and on-prem. Once a fleet is created, it can be reused by dev environments, tasks, and services.</p> <p>Fleets is a new feature. To use it, ensure you've installed version <code>0.18.7</code> or higher.</p>"},{"location":"docs/fleets/#configuration","title":"Configuration","text":"<p>To create a fleet, create a YAML file in your project folder. Its name must end with <code>.dstack.yml</code> (e.g. <code>.dstack.yml</code> or <code>fleet.dstack.yml</code> are both acceptable).</p> Cloud fleetsOn-prem fleets <p>To provision a fleet in the cloud using the configured backends, specify the required resources, number of nodes,  and other optional parameters.</p> <pre><code>type: fleet\nname: my-fleet\n\nnodes: 2\nplacement: cluster\n\nbackends: [aws]\n\nresources:\n  gpu: 24GB\n</code></pre> <p>Set <code>placement</code> to <code>cluster</code> if the nodes should be interconnected (e.g. if you'd like to use them for multi-node tasks).  In that case, <code>dstack</code> will provision all nodes in the same backend and region.</p> <p>Defining fleets with YAML isn't supported yet for the <code>kubernetes</code>, <code>vastai</code>, and <code>runpod</code> backends.</p> <p>To create a fleet from on-prem servers, specify their hosts along with the user, port, and SSH key for connection via SSH.</p> <p> <pre><code>type: fleet\nname: my-fleet\n\nplacement: cluster\n\nssh_config:\n  user: ubuntu\n  identity_file: ~/.ssh/id_rsa\n  hosts:\n    - 3.255.177.51\n    - 3.255.177.52\n</code></pre> <p>Requirements</p> <p>The on-prem servers should be pre-installed with CUDA 12.1 and NVIDIA Docker.  The user should have <code>sudo</code> access.</p> <p>Set <code>placement</code> to <code>cluster</code> if the nodes are interconnected (e.g. if you'd like to use them for multi-node tasks). In that case, by default, <code>dstack</code> will automatically detect the private network.  You can specify the <code>network</code> parameter manually.</p> <p>Reference</p> <p>See the .dstack.yml reference for all supported configuration options and examples.</p>"},{"location":"docs/fleets/#creating-and-updating-fleets","title":"Creating and updating fleets","text":"<p>To create or update the fleet, simply call the <code>dstack apply</code> command:</p> <pre><code>$ dstack apply -f examples/fleets/cluster.dstack.yml\nFleet my-fleet does not exist yet. Create the fleet? [y/n]: y\n FLEET     INSTANCE  BACKEND  RESOURCES  PRICE  STATUS   CREATED \n my-fleet  0                                    pending  now     \n           1                                    pending  now     \n</code></pre> <p>Once the status of instances change to <code>idle</code>, they can be used by <code>dstack run</code>.</p>"},{"location":"docs/fleets/#creation-policy","title":"Creation policy","text":"<p>By default, <code>dstack run</code> tries to reuse <code>idle</code> instances from existing fleets.  If no <code>idle</code> instances meet the requirements, <code>dstack run</code> creates a new fleet automatically. To avoid creating new fleet, specify pass <code>--reuse</code> to <code>dstack run</code>.</p>"},{"location":"docs/fleets/#termination-policy","title":"Termination policy","text":"<p>If you want a fleet to be automatically deleted after a certain idle time, you can set the  you can set the <code>termination_idle_time</code> property.</p>"},{"location":"docs/fleets/#managing-fleets","title":"Managing fleets","text":""},{"location":"docs/fleets/#listing-fleets","title":"Listing fleets","text":"<p>The <code>dstack fleet</code> command lists fleet instances and theri status:</p> <pre><code>$ dstack fleet\n FLEET     INSTANCE  BACKEND              GPU             PRICE    STATUS  CREATED \n my-fleet  0         gcp (europe-west-1)  L4:24GB (spot)  $0.1624  idle    3 mins ago      \n           1         gcp (europe-west-1)  L4:24GB (spot)  $0.1624  idle    3 mins ago    \n</code></pre>"},{"location":"docs/fleets/#deleting-fleets","title":"Deleting fleets","text":"<p>When a fleet isn't used by run, you can delete it via <code>dstack delete</code>:</p> <pre><code>$ dstack delete -f cluster.dstack.yaml\nDelete the fleet my-gcp-fleet? [y/n]: y\nFleet my-gcp-fleet deleted\n</code></pre> <p>You can pass either the path to the configuration file or the fleet name directly.</p> <p>To terminate and delete specific instances from a fleet, pass <code>-i INSTANCE_NUM</code>.</p>"},{"location":"docs/quickstart/","title":"Quickstart","text":"<p>Before using <code>dstack</code>, install the server and configure  backends.</p>"},{"location":"docs/quickstart/#initialize-a-repo","title":"Initialize a repo","text":"<p>To use <code>dstack</code>'s CLI in a folder, first run <code>dstack init</code> within that folder.</p> <pre><code>$ mkdir quickstart &amp;&amp; cd quickstart\n$ dstack init\n</code></pre> <p>Your folder can be a regular local folder or a Git repo.</p>"},{"location":"docs/quickstart/#define-a-configuration","title":"Define a configuration","text":"<p>Define what you want to run as a YAML file. The filename must end with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>train.dstack.yml</code> are both acceptable).</p> Dev environmentTaskService <p>Dev environments allow you to quickly provision a machine with a pre-configured environment, resources, IDE, code, etc.</p> <p> <pre><code>type: dev-environment\n\n# Use either `python` or `image` to configure environment\npython: \"3.11\"\n# image: ghcr.io/huggingface/text-generation-inference:latest\n\nide: vscode\n\n# (Optional) Configure `gpu`, `memory`, `disk`, etc\nresources:\n  gpu: 24GB\n</code></pre> <p>Tasks make it very easy to run any scripts, be it for training, data processing, or web apps. They allow you to pre-configure the environment, resources, code, etc.</p> <p> <pre><code>type: task\n\npython: \"3.11\"\nenv:\n  - HF_HUB_ENABLE_HF_TRANSFER=1\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n\n# (Optional) Configure `gpu`, `memory`, `disk`, etc\nresources:\n  gpu: 24GB\n</code></pre> <p>Ensure <code>requirements.txt</code> and <code>train.py</code> are in your folder. You can take them from <code>examples</code>.</p> <p>Services make it easy to deploy models and apps cost-effectively as public endpoints, allowing you to use any frameworks.</p> <p> <pre><code>type: service\n\nimage: ghcr.io/huggingface/text-generation-inference:latest\nenv:\n  - HUGGING_FACE_HUB_TOKEN # required to run gated models\n  - MODEL_ID=mistralai/Mistral-7B-Instruct-v0.1\ncommands:\n  - text-generation-launcher --port 8000 --trust-remote-code\nport: 8000\n\n# (Optional) Configure `gpu`, `memory`, `disk`, etc\nresources:\n  gpu: 24GB\n</code></pre>"},{"location":"docs/quickstart/#run-configuration","title":"Run configuration","text":"<p>Run a configuration using the <code>dstack run</code> command, followed by the working directory path (e.g., <code>.</code>),  and the path to the configuration file.</p> <pre><code>$ dstack run . -f train.dstack.yml\n\n BACKEND     REGION         RESOURCES                     SPOT  PRICE\n tensordock  unitedkingdom  10xCPU, 80GB, 1xA100 (80GB)   no    $1.595\n azure       westus3        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n azure       westus2        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n\nContinue? [y/n]: y\n\nProvisioning...\n---&gt; 100%\n\nEpoch 0:  100% 1719/1719 [00:18&lt;00:00, 92.32it/s, loss=0.0981, acc=0.969]\nEpoch 1:  100% 1719/1719 [00:18&lt;00:00, 92.32it/s, loss=0.0981, acc=0.969]\nEpoch 2:  100% 1719/1719 [00:18&lt;00:00, 92.32it/s, loss=0.0981, acc=0.969]\n</code></pre> <p>The <code>dstack run</code> command automatically uploads your code, including any local uncommitted changes. </p> <p>Fleets</p> <p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets.  If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p>"},{"location":"docs/quickstart/#whats-next","title":"What's next?","text":"<ol> <li>Read about dev environments, tasks,      services, and fleets </li> <li>Browse examples </li> <li>Join the community via Discord </li> </ol>"},{"location":"docs/services/","title":"Services","text":"<p>Services make it easy to deploy models and web applications as public, secure, and scalable endpoints. They are provisioned behind a gateway that automatically provides an HTTPS domain, handles authentication, distributes load, and performs auto-scaling.</p> Gateways <p>If you're using the open-source server, you must set up a gateway before you can run a service.</p> <p>If you're using dstack Sky , the gateway is already set up for you.</p>"},{"location":"docs/services/#configuration","title":"Configuration","text":"<p>First, create a YAML file in your project folder. Its name must end with <code>.dstack.yml</code> (e.g. <code>.dstack.yml</code> or <code>serve.dstack.yml</code> are both acceptable).</p> <pre><code>type: service\n\npython: \"3.11\"\nenv:\n  - MODEL=NousResearch/Llama-2-7b-chat-hf\ncommands:\n  - pip install vllm\n  - python -m vllm.entrypoints.openai.api_server --model $MODEL --port 8000\nport: 8000\n\nresources:\n  gpu: 80GB\n\n# (Optional) Enable the OpenAI-compatible endpoint\nmodel:\n  format: openai\n  type: chat\n  name: NousResearch/Llama-2-7b-chat-hf\n</code></pre> <p>If you don't specify your Docker image, <code>dstack</code> uses the base image (pre-configured with Python, Conda, and essential CUDA drivers).</p> <p>Auto-scaling</p> <p>By default, the service is deployed to a single instance. However, you can specify the number of replicas and scaling policy. In this case, <code>dstack</code> auto-scales it based on the load.</p> <p>Reference</p> <p>See the .dstack.yml reference for all supported configuration options and examples.</p>"},{"location":"docs/services/#running","title":"Running","text":"<p>To run a configuration, use the <code>dstack run</code> command followed by the working directory path,  configuration file path, and any other options.</p> <pre><code>$ dstack run . -f serve.dstack.yml\n\n BACKEND     REGION         RESOURCES                     SPOT  PRICE\n tensordock  unitedkingdom  10xCPU, 80GB, 1xA100 (80GB)   no    $1.595\n azure       westus3        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n azure       westus2        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n\nContinue? [y/n]: y\n\nProvisioning...\n---&gt; 100%\n\nService is published at https://yellow-cat-1.example.com\n</code></pre> <p>When deploying the service, <code>dstack run</code> mounts the current folder's contents.</p> .gitignore <p>If there are large files or folders you'd like to avoid uploading,  you can list them in <code>.gitignore</code>.</p> Fleets <p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets.  If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p> <p>To have the fleet deleted after a certain idle time automatically, set <code>termination_idle_time</code>. By default, it's set to <code>5min</code>.</p> <p>Reference</p> <p>See the CLI reference for more details on how <code>dstack run</code> works.</p>"},{"location":"docs/services/#service-endpoint","title":"Service endpoint","text":"<p>One the service is up, its endpoint is accessible at <code>https://&lt;run name&gt;.&lt;gateway domain&gt;</code>.</p> <p>By default, the service endpoint requires the <code>Authorization</code> header with <code>Bearer &lt;dstack token&gt;</code>. </p> <pre><code>$ curl https://yellow-cat-1.example.com/v1/chat/completions \\\n    -H 'Content-Type: application/json' \\\n    -H 'Authorization: Bearer &amp;lt;dstack token&amp;gt;' \\\n    -d '{\n        \"model\": \"NousResearch/Llama-2-7b-chat-hf\",\n        \"messages\": [\n            {\n                \"role\": \"user\",\n                \"content\": \"Compose a poem that explains the concept of recursion in programming.\"\n            }\n        ]\n    }'\n</code></pre> <p>Authorization can be disabled by setting <code>auth</code> to <code>false</code> in the service configuration file.</p>"},{"location":"docs/services/#model-endpoint","title":"Model endpoint","text":"<p>In case the service has the model mapping configured, you will also be able to access the model at <code>https://gateway.&lt;gateway domain&gt;</code> via the OpenAI-compatible interface.</p>"},{"location":"docs/services/#managing-runs","title":"Managing runs","text":""},{"location":"docs/services/#listing-runs","title":"Listing runs","text":"<p>The <code>dstack ps</code> command lists all running runs and their status.</p>"},{"location":"docs/services/#stopping-runs","title":"Stopping runs","text":"<p>When you use <code>dstack stop</code>, the service and its cloud resources are deleted.</p>"},{"location":"docs/services/#whats-next","title":"What's next?","text":"<ol> <li>Check the Text Generation Inference  and vLLM  examples</li> <li>Check the <code>.dstack.yml</code> reference for more details and examples</li> <li>See gateways on how to set up a gateway</li> <li>Browse examples </li> <li>See fleets on how to manage fleets</li> </ol>"},{"location":"docs/tasks/","title":"Tasks","text":"<p>Tasks allow for convenient scheduling of various batch jobs, such as training, fine-tuning, or data processing. They can also be used to run web applications when features offered by services are not needed, such as for debugging.</p> <p>You can run tasks on a single machine or on a cluster of nodes.</p>"},{"location":"docs/tasks/#configuration","title":"Configuration","text":"<p>First, create a YAML file in your project folder. Its name must end with <code>.dstack.yml</code> (e.g. <code>.dstack.yml</code> or <code>train.dstack.yml</code> are both acceptable).</p> <pre><code>type: task\n\npython: \"3.11\"\nenv:\n  - HF_HUB_ENABLE_HF_TRANSFER=1\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - tensorboard --logdir results/runs &amp;\n  - python fine-tuning/qlora/train.py\nports:\n  - 6000\n\n# (Optional) Configure `gpu`, `memory`, `disk`, etc\nresources:\n  gpu: 80GB\n</code></pre> <p>If you don't specify your Docker image, <code>dstack</code> uses the base image (pre-configured with Python, Conda, and essential CUDA drivers).</p> <p>Distributed tasks</p> <p>By default, tasks run on a single instance. However, you can specify the number of nodes. In this case, <code>dstack</code> provisions a cluster of instances.</p> <p>Reference</p> <p>See the .dstack.yml reference for all supported configuration options and examples.</p>"},{"location":"docs/tasks/#running","title":"Running","text":"<p>To run a configuration, use the <code>dstack run</code> command followed by the working directory path,  configuration file path, and other options.</p> <pre><code>$ dstack run . -f train.dstack.yml\n\n BACKEND     REGION         RESOURCES                     SPOT  PRICE\n tensordock  unitedkingdom  10xCPU, 80GB, 1xA100 (80GB)   no    $1.595\n azure       westus3        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n azure       westus2        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n\nContinue? [y/n]: y\n\nProvisioning...\n---&gt; 100%\n\nTensorBoard 2.13.0 at http://localhost:6006/ (Press CTRL+C to quit)\n\nEpoch 0:  100% 1719/1719 [00:18&lt;00:00, 92.32it/s, loss=0.0981, acc=0.969]\nEpoch 1:  100% 1719/1719 [00:18&lt;00:00, 92.32it/s, loss=0.0981, acc=0.969]\nEpoch 2:  100% 1719/1719 [00:18&lt;00:00, 92.32it/s, loss=0.0981, acc=0.969]\n</code></pre> <p>If the task specifies <code>ports</code>, <code>dstack run</code> automatically forwards them to your local machine for convenient and secure access.</p> <p>When running the task, <code>dstack run</code> mounts the current folder's contents.</p> .gitignore <p>If there are large files or folders you'd like to avoid uploading,  you can list them in <code>.gitignore</code>.</p> Fleets <p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets.  If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p> <p>To have the fleet deleted after a certain idle time automatically, set <code>termination_idle_time</code>. By default, it's set to <code>5min</code>.</p> <p>Reference</p> <p>See the CLI reference for more details on how <code>dstack run</code> works.</p>"},{"location":"docs/tasks/#managing-runs","title":"Managing runs","text":""},{"location":"docs/tasks/#listing-runs","title":"Listing runs","text":"<p>The <code>dstack ps</code> command lists all running runs and their status.</p>"},{"location":"docs/tasks/#stopping-runs","title":"Stopping runs","text":"<p>Once you use <code>dstack stop</code> (or when the run exceeds the <code>max_duration</code>), the instances return to the fleet.</p>"},{"location":"docs/tasks/#whats-next","title":"What's next?","text":"<ol> <li>Check the QLoRA  example</li> <li>Check the <code>.dstack.yml</code> reference for more details and examples</li> <li>Browse all examples </li> <li>See fleets on how to manage fleets</li> </ol>"},{"location":"docs/concepts/gateways/","title":"Gateways","text":"<p>Gateways handle the ingress traffic of running services. They provide services with HTTPS domains, handle authentication, distribute load, and perform auto-scaling. In order to run a service, you need to have at least one gateway set up.</p> <p>If you're using dstack Sky , the gateway is already set up for you.</p>"},{"location":"docs/concepts/gateways/#configuration","title":"Configuration","text":"<p>First, create a YAML file in your project folder. Its name must end with <code>.dstack.yml</code> (e.g. <code>.dstack.yml</code> or <code>gateway.dstack.yml</code> are both acceptable).</p> <pre><code>type: gateway\nname: example-gateway\n\nbackend: aws\nregion: eu-west-1\ndomain: example.com\n</code></pre> <p>A domain name is required to create a gateway.</p> <p>Reference</p> <p>See the .dstack.yml reference for all supported configuration options and examples.</p>"},{"location":"docs/concepts/gateways/#creating-and-updating-gateways","title":"Creating and updating gateways","text":"<p>To create or update the gateway, simply call the <code>dstack apply</code> command:</p> <pre><code>$ dstack apply . -f examples/deployment/gateway.dstack.yml\n\nThe example-gateway doesn't exist. Create it? [y/n]: y\n\n BACKEND  REGION     NAME             HOSTNAME  DOMAIN       DEFAULT  STATUS\n aws      eu-west-1  example-gateway            example.com  \u2713        submitted\n</code></pre>"},{"location":"docs/concepts/gateways/#updating-dns-records","title":"Updating DNS records","text":"<p>Once the gateway is assigned a hostname, go to your domain's DNS settings and add an <code>A</code> DNS record for <code>*.&lt;gateway domain&gt;</code> (e.g., <code>*.example.com</code>) pointing to the gateway's hostname.</p> <p>This will allow you to access runs and models using this domain.</p>"},{"location":"docs/concepts/gateways/#managing-gateways","title":"Managing gateways","text":""},{"location":"docs/concepts/gateways/#listing-gateways","title":"Listing gateways","text":"<p>The <code>dstack gateway list</code> command lists existing gateways and their status.</p>"},{"location":"docs/concepts/gateways/#deleting-gateways","title":"Deleting gateways","text":"<p>To delete a gateway, pass gateway configuration to <code>dstack delete</code>:</p> <pre><code>$ dstack delete . -f examples/deployment/gateway.dstack.yml\n</code></pre>"},{"location":"docs/concepts/gateways/#whats-next","title":"What's next?","text":"<ol> <li>See services on how to run services</li> <li>Check the <code>.dstack.yml</code> reference for more details and examples</li> </ol>"},{"location":"docs/concepts/pools/","title":"Pools","text":"<p>Pools enable the efficient reuse of cloud instances and on-premises servers across runs, simplifying their management.</p>"},{"location":"docs/concepts/pools/#adding-instances","title":"Adding instances","text":""},{"location":"docs/concepts/pools/#automatic-provisioning","title":"Automatic provisioning","text":"<p>By default, when using the <code>dstack run</code> command, it tries to reuse an instance from a pool. If no idle instance meets the requirements, <code>dstack</code> automatically provisions a new cloud instance and adds it to the pool.</p> Reuse policy <p>To avoid provisioning new cloud instances with <code>dstack run</code>, use <code>--reuse</code>. Your run will be assigned to an idle instance in the pool. If there are no available idle instances in the pool, the run will fail.</p> Idle duration <p>By default, <code>dstack run</code> sets the idle duration of a newly provisioned instance to <code>5m</code>. This means that if the run is finished and the instance remains idle for longer than five minutes, it is automatically removed from the pool. To override the default idle duration, use  <code>--idle-duration DURATION</code> with <code>dstack run</code>.</p>"},{"location":"docs/concepts/pools/#manual-provisioning","title":"Manual provisioning","text":"<p>To manually provision a cloud instance and add it to a pool, use <code>dstack pool add</code>:</p> <pre><code>$ dstack pool add --gpu 80GB\n\n BACKEND     REGION         RESOURCES                     SPOT  PRICE\n tensordock  unitedkingdom  10xCPU, 80GB, 1xA100 (80GB)   no    $1.595\n azure       westus3        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n azure       westus2        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n\nContinue? [y/n]: y\n</code></pre> <p>The <code>dstack pool add</code> command allows specifying resource requirements, along with the spot policy, idle duration, max price, retry policy, and other policies.</p> Idle duration <p>The default idle duration if you're using <code>dstack pool add</code> is <code>72h</code>. To override it, use the <code>--idle-duration DURATION</code> argument.</p> <p>You can also specify the policies via <code>.dstack/profiles.yml</code> instead of passing them as arguments. For more details on policies and their defaults, refer to <code>.dstack/profiles.yml</code>.</p> Limitations <p>The <code>dstack pool add</code> command is not supported for Kubernetes, VastAI, and RunPod backends yet.</p>"},{"location":"docs/concepts/pools/#adding-on-prem-clusters","title":"Adding on-prem clusters","text":"<p>Any on-prem server that can be accessed via SSH can be added to a pool and used to run workloads.</p> <p>To add on-prem servers to the pool, use the <code>dstack pool add-ssh</code> command and pass the hostname of your server along with the SSH key.</p> <pre><code>$ dstack pool add-ssh -i ~/.ssh/id_rsa ubuntu@54.73.155.119\n</code></pre> <p>The command accepts the same arguments as the standard <code>ssh</code> command.</p> <p>Requirements</p> <p>The on-prem server should be pre-installed with CUDA 12.1 and NVIDIA Docker.</p> <p>Once the instance is provisioned, you'll see it in the pool and will be able to run workloads on it.</p>"},{"location":"docs/concepts/pools/#clusters","title":"Clusters","text":"<p>If you want on-prem instances to run multi-node tasks, ensure these on-prem servers share the same private network. Additionally, you need to pass the <code>--network</code> option to <code>dstack pool add-ssh</code>:</p> <pre><code>$ dstack pool add-ssh -i ~/.ssh/id_rsa ubuntu@54.73.155.119 \\\n    --network 10.0.0.0/24\n</code></pre> <p>The <code>--network</code> argument accepts the IP address range (CIDR) of the private network of the instance.</p> <p>Once you've added multiple instances with the same network value, you can use them as a cluster to run multi-node tasks.</p>"},{"location":"docs/concepts/pools/#removing-instances","title":"Removing instances","text":"<p>If the instance remains idle for the configured idle duration, <code>dstack</code> removes it and deletes all cloud resources.</p> <p>To remove an instance from the pool manually, use the <code>dstack pool rm</code> command. </p> <pre><code>$ dstack pool rm &amp;lt;instance name&amp;gt;\n</code></pre>"},{"location":"docs/concepts/pools/#list-instances","title":"List instances","text":"<p>The <code>dstack pool ps</code> command lists active instances and their status (<code>busy</code> or <code>idle</code>).</p>"},{"location":"docs/concepts/volumes/","title":"Volumes","text":"<p>Volumes allow you to persist data between runs. <code>dstack</code> simplifies managing volumes and lets you mount them to a specific directory when working with dev environments, tasks, and services.</p> <p>Experimental</p> <p>Volumes are currently experimental and work with the <code>aws</code>, <code>gcp</code>, and <code>runpod</code> backends. Support for other backends is coming soon.</p>"},{"location":"docs/concepts/volumes/#configuration","title":"Configuration","text":"<p>First, create a YAML file in your project folder. Its name must end with <code>.dstack.yml</code> (e.g. <code>.dstack.yml</code> or <code>vol.dstack.yml</code> are both acceptable).</p> <pre><code>type: volume\nname: my-new-volume\nbackend: aws\nregion: eu-central-1\nsize: 100GB\n</code></pre> <p>If you use this configuration, <code>dstack</code> will create a new volume based on the specified options.</p> <p>Registering existing volumes</p> <p>If you prefer not to create a new volume but to reuse an existing one (e.g., created manually), you can  specify its ID via <code>volume_id</code>. In this case, <code>dstack</code> will register the specified volume so that you can use it with dev environments, tasks, and services.</p> <p>Reference</p> <p>See the .dstack.yml reference for all supported configuration options and examples.</p>"},{"location":"docs/concepts/volumes/#creating-and-registering-volumes","title":"Creating and registering volumes","text":"<p>To create or register the volume, simply call the <code>dstack apply</code> command:</p> <pre><code>$ dstack apply -f volume.dstack.yml\nVolume my-new-volume does not exist yet. Create the volume? [y/n]: y\n NAME           BACKEND  REGION        STATUS     CREATED \n my-new-volume  aws      eu-central-1  submitted  now     \n</code></pre> <p>When creating the volume <code>dstack</code> automatically creates an <code>ext4</code> file system on it.</p> <p>Once created, the volume can be attached with dev environments, tasks, and services.</p>"},{"location":"docs/concepts/volumes/#attaching-volumes","title":"Attaching volumes","text":"<p>Dev environments, tasks, and services let you attach any number of volumes. To attach a volume, simply specify its name using the <code>volumes</code> property and specify where to mount its contents:</p> <pre><code>type: dev-environment\nide: vscode\nvolumes:\n  - name: my-new-volume\n    path: /volume_data\n</code></pre> <p>Once you run this configuration, the contents of the volume will be attached to <code>/volume_data</code> inside the dev environment,  and its contents will persist across runs.</p> <p>Limitations</p> <p>When you're running a dev environment, task, or service with <code>dstack</code>, it automatically mounts the project folder contents to <code>/workflow</code> (and sets that as the current working directory). Right now, <code>dstack</code> doesn't allow you to  attach volumes to <code>/workflow</code> or any of its subdirectories.</p>"},{"location":"docs/concepts/volumes/#managing-volumes","title":"Managing volumes","text":""},{"location":"docs/concepts/volumes/#listing-volumes","title":"Listing volumes","text":"<p>The <code>dstack volume list</code> command lists created and registered volumes:</p> <pre><code>$ dstack volume list\nNAME            BACKEND  REGION        STATUS  CREATED\n my-new-volume  aws      eu-central-1  active  3 weeks ago\n</code></pre>"},{"location":"docs/concepts/volumes/#deleting-volumes","title":"Deleting volumes","text":"<p>When the volume isn't attached to any active dev environment, task, or service, you can delete it using <code>dstack delete</code>:</p> <pre><code>$ dstack delete -f vol.dstack.yaml\n</code></pre> <p>If the volume was created using <code>dstack</code>, it will be physically destroyed along with the data. If you've registered an existing volume, it will be de-registered with <code>dstack</code> but will keep the data.</p>"},{"location":"docs/concepts/volumes/#faq","title":"FAQ","text":"Using volumes across backends <p>Since volumes are backed up by cloud network disks, you can only use them within the same cloud. If you need to access data across different backends, you should either use object storage or replicate the data across multiple volumes.</p> Using volumes across regions <p>Typically, network volumes are associated with specific regions, so you can't use them in other regions. Often, volumes are also linked to availability zones, but some providers support volumes that can be used across different availability zones within the same region.</p> Attaching volumes to multiple runs and instances <p>You can mount a volume in multiple runs. This feature is currently supported only by the <code>runpod</code> backend.</p>"},{"location":"docs/examples/","title":"Examples","text":""},{"location":"docs/examples/#prerequisites","title":"Prerequisites","text":"<p>Once <code>dstack</code> is installed, clone the repo and run <code>dstack init</code></p> <pre><code>git clone https://github.com/dstackai/dstack\ncd dstack\ndstack init\n</code></pre> <p>Now you are ready to run examples! Select any example from the left-hand sidebar.</p>"},{"location":"docs/examples/#source-code","title":"Source code","text":"<p>The source-code of examples can be found in  <code>https://github.com/dstackai/dstack/examples</code>.</p>"},{"location":"docs/examples/#contributing","title":"Contributing","text":"<p>Can't find an important example? Raise an issue or send a pull request!</p>"},{"location":"docs/examples/deployment/infinity/","title":"Infinity","text":"<p>The following command a text embedding model as a service:</p> <pre><code>dstack run . -f examples/deployment/infinity/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"docs/examples/deployment/lorax/","title":"LoRaX","text":"<p>LoRAX allows serving multiple fine-tuned models optimized on the same endpoint by dynamically loading and switching LoRA adapters.</p>"},{"location":"docs/examples/deployment/lorax/#service","title":"Service","text":"<p>The following command deploys Mistral 7B Instruct as a base model via a service:</p> <pre><code>dstack run . -f examples/deployment/lorax/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"docs/examples/deployment/lorax/#task","title":"Task","text":"<p>The following command runs Mistral 7B Instruct as a base model via a task:</p> <pre><code>dstack run . -f examples/deployment/lorax/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"docs/examples/deployment/ollama/","title":"Ollama","text":"<p>The following command deploys Mixtral 8x7B as a service:</p> <pre><code>dstack run . -f examples/deployment/ollama/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"docs/examples/deployment/tei/","title":"Text Embeddings Inference","text":"<p>The following command a text embedding model as a service:</p> <pre><code>dstack run . -f examples/deployment/tae/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"docs/examples/deployment/tgi/","title":"Text Generation Inference","text":""},{"location":"docs/examples/deployment/tgi/#service","title":"Service","text":"<p>The following command deploys Llama 7B Instruct as a service:</p> <pre><code>dstack run . -f examples/deployment/tgi/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"docs/examples/deployment/tgi/#task","title":"Task","text":"<p>The following command runs Llama 7B Instruct as a task:</p> <pre><code>dstack run . -f examples/deployment/tgi/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"docs/examples/deployment/vllm/","title":"vLLM","text":""},{"location":"docs/examples/deployment/vllm/#service","title":"Service","text":"<p>The following command deploys Llama 7B Instruct as a service:</p> <pre><code>dstack run . -f examples/deployment/vllm/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"docs/examples/deployment/vllm/#task","title":"Task","text":"<p>The following command runs Llama 7B Instruct as a task:</p> <pre><code>dstack run . -f examples/deployment/vllm/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/","title":"Alignment Handbook","text":"<p>Alignment Handbook by HuggingFace offers recipes, configs, and scripts for fine-tuning LLMs. It includes all the code needed to run CPT, SFT, DPO, and ORPO leveraging HuggingFace's libraries like <code>transformers</code>, <code>peft</code>, <code>accelerate</code>, and <code>trl</code>. You just need to modify the recipes and run the  appropriate script.</p> <p>This example shows how use Alignment Handbook to fine-tune Gemma 7B on your SFT dataset  with Alignment Handbook and <code>dstack</code>. </p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#prerequisites","title":"Prerequisites","text":"<p>Once <code>dstack</code> is installed, clone the repo and run <code>dstack init</code></p> <pre><code>git clone https://github.com/dstackai/dstack\ncd dstack\ndstack init\n</code></pre>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#training-configuration-recipe","title":"Training configuration recipe","text":"<p>Alignment Handbook's training script reads the model, LoRA, and dataset arguments, as well as trainer configuration from a YAML file. This file can be found at <code>examples/fine-tuning/alignment-handbook/config.yaml</code>. You can modify it as needed.</p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#single-node-training","title":"Single-node training","text":"<p>The easiest way to run a training script with <code>dstack</code> is by creating a task configuration file. This file can be found at <code>examples/fine-tuning/alignment-handbook/train.dstack.yml</code>. Below is its content: </p> <pre><code>type: task\nname: ah-train\n\n# If `image` is not specified, dstack uses its default image\npython: \"3.10\"\n\n# Required environment variables\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - ACCELERATE_LOG_LEVEL=info\n  - WANDB_API_KEY\n# Commands of the task\ncommands:\n  - conda install cuda\n  - git clone https://github.com/huggingface/alignment-handbook.git\n  - cd alignment-handbook\n  - pip install .\n  - pip install flash-attn --no-build-isolation\n  - pip install wandb\n  - accelerate launch\n    --config_file recipes/accelerate_configs/multi_gpu.yaml\n    --num_processes=$DSTACK_GPUS_NUM\n    scripts/run_sft.py\n    ../examples/fine-tuning/alignment-handbook/config.yaml\n# Expose 6006 to access TensorBoard\nports:\n  - 6006\n\nresources:\n  # Required resources\n  gpu: 24GB\n</code></pre> <p>The task clones Alignment Handbook's repo, installs the dependencies, and runs the script.</p> <p>The <code>DSTACK_GPUS_NUM</code> environment variable is automatically passed to the container according to the <code>resoruce</code> property.</p> <p>To run the task, use <code>dstack apply</code>:</p> <pre><code>HUGGING_FACE_HUB_TOKEN=...\nACCELERATE_LOG_LEVEL=...\nWANDB_API_KEY=...\n\ndstack apply -f examples/fine-tuning/alignment-handbook/train.dstack.yml\n</code></pre> <p>If you list <code>tensorbord</code> via <code>report_to</code> in <code>examples/fine-tuning/alignment-handbook/config.yaml</code>, you'll be able to access experiment metrics via <code>http://localhost:6006</code> (while the task is running).</p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#multi-node-training","title":"Multi-node training","text":"<p>The multi-node training task configuration file can be found at <code>examples/fine-tuning/alignment-handbook/train-distrib.dstack.yml</code>. Below is its content:</p> <pre><code>type: task\nname: ah-train-distrib\n\n# If `image` is not specified, dstack uses its default image\npython: \"3.10\"\n\n# Required environment variables\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - ACCELERATE_LOG_LEVEL=info\n  - WANDB_API_KEY\n# Commands of the task (dstack runs it on each node)\ncommands:\n  - conda install cuda\n  - git clone https://github.com/huggingface/alignment-handbook.git\n  - cd alignment-handbook\n  - pip install .\n  - pip install flash-attn --no-build-isolation\n  - pip install wandb\n  - accelerate launch\n    --config_file ../examples/fine-tuning/alignment-handbook/fsdp_qlora_full_shard.yaml\n    --main_process_ip=$DSTACK_MASTER_NODE_IP\n    --main_process_port=8008\n    --machine_rank=$DSTACK_NODE_RANK\n    --num_processes=$DSTACK_GPUS_NUM\n    --num_machines=$DSTACK_NODES_NUM\n    scripts/run_sft.py \n    ../examples/fine-tuning/alignment-handbook/config.yaml\n# Expose 6006 to access TensorBoard\nports:\n  - 6006\n\n# The number of interconnected instances required\nnodes: 2\n\nresources:\n  # Required resources\n  gpu: 24GB\n  # Shared memory size for inter-process communication\n  shm_size: 24GB\n</code></pre> <p>Here's how the multi-node task is different from the single-node one:</p> <ol> <li>The <code>nodes</code> property is specified with a number of required nodes (should match the fleet's nodes number).</li> <li>Under <code>resoruces</code>, <code>shm_size</code> is specified with the shared memory size used for the communication of parallel    processes within a node (in case multiple GPUs per node are used).</li> <li>Instead of Alignment Handbook's <code>recipes/accelerate_configs/multi_gpu.yaml</code>, we use <code>examples/fine-tuning/alignment-handbook/fsdp_qlora_full_shard.yaml</code> as an accelerate config.</li> <li>We use <code>DSTACK_MASTER_NODE_IP</code>, <code>DSTACK_NODE_RANK</code>, <code>DSTACK_GPUS_NUM</code>, and <code>DSTACK_NODES_NUM</code> environment variables to    configure <code>accelerate</code>. The environment variables are automatically passed    to the container for each node based on the task configuration.</li> </ol>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#fleets","title":"Fleets","text":"<p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets.  If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p> <p>The example folder includes two cloud fleet configurations: <code>examples/fine-tuning/alignment-handbook/fleet.dstack.yml</code> (a single node with a <code>24GB</code> GPU), and a <code>examples/fine-tuning/alignment-handbook/fleet-distrib.dstack.yml</code> (a cluster of two nodes each with a <code>24GB</code> GPU).</p> <p>You can update the fleet configurations to change the vRAM size, GPU model, number of GPUs per node, or number of nodes. </p> <p>A fleet can be provisioned with <code>dstack apply</code>:</p> <pre><code>dstack apply -f examples/fine-tuning/alignment-handbook/fleet.dstack.yml\n</code></pre> <p>Once provisioned, the fleet can run dev environments and fine-tuning tasks. To delete the fleet, use <code>dstack fleet delete</code>.</p> <p>To ensure <code>dstack apply</code> always reuses an existing fleet, pass <code>--reuse</code> to <code>dstack apply</code> (or set <code>creation_policy</code> to <code>reuse</code> in the task configuration). The default policy is <code>reuse_or_create</code>.</p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#dev-environment","title":"Dev environment","text":"<p>If you'd like to play with the example using a dev environment, run .dstack.yml via <code>dstack apply</code>:</p> <pre><code>dstack apply -f examples/fine-tuning/alignment-handbook/.dstack.yaml \n</code></pre>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#source-code","title":"Source code","text":"<p>The source-code of this example can be found in  <code>https://github.com/dstackai/dstack/examples/fine-tuning/alignment-handbook</code>.</p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#contributing","title":"Contributing","text":"<p>Find a mistake or can't find an important example? Raise an issue or send a pull request!</p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#whats-next","title":"What's next?","text":"<ol> <li>Browse Alignment Handbook.</li> <li>Check dev environments, tasks,     services, and fleets.</li> <li>See other examples.</li> </ol>"},{"location":"docs/examples/fine-tuning/axolotl/","title":"Axolotl","text":"<p><code>axolotl</code> streamlines the fine-tuning of AI models, offering support for multiple configurations and architectures.</p> <p>Furthermore, <code>axolotl</code> provides a set of <code>yaml</code> examples for almost all kinds of LLMs such as LLaMA2 family, Gemma family, LLaMA3 family, Jamba, and so on. It's recommended to navigate through the examples to get a sense about the role of each parameters, and adjust them for your specific use cases. Also, it is worth checking out all configs/parameters options with a brief description from this doc.</p> <p>The example below replicates the FSDP+QLoRA on LLaMA3 70B, except that here we use Llama3 8B. You can see the <code>config.yaml</code>.</p>"},{"location":"docs/examples/fine-tuning/axolotl/#running-with-dstack","title":"Running with <code>dstack</code>","text":"<p>Running <code>axolotl</code> with <code>dstack</code> is very straightforward.</p> <p>First, define the <code>train.dstack.yaml</code> task configuration file as follows:</p> <pre><code>type: task\n\nimage: winglian/axolotl-cloud:main-20240429-py3.11-cu121-2.2.1\n\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - WANDB_API_KEY\n\ncommands:\n  - accelerate launch -m axolotl.cli.train config.yaml\n\nports:\n  - 6006\n\nresources:\n  gpu:\n    memory: 24GB..\n    count: 2\n</code></pre> <p>[!NOTE] Feel free to adjust <code>resources</code> to specify the required resources.</p> <p>We are using the official Docker image provided by Axolotl team (<code>winglian/axolotl-cloud:main-20240429-py3.11-cu121-2.2.1</code>). If you want to see other images, their official repo. Note, <code>dstack</code> requires the CUDA driver to be 12.1+.</p> <p>To run the task, use the following command:</p> <pre><code>HUGGING_FACE_HUB_TOKEN=&lt;...&gt; \\\nWANDB_API_KEY=&lt;...&gt; \\\ndstack run . -f examples/fine-tuning/axolotl/train.dstack.yaml\n</code></pre> <p>To push the final fine-tuned model to Hugging Face Hub, set <code>hub_model_id</code> in <code>config.yaml</code>.</p>"},{"location":"docs/examples/fine-tuning/axolotl/#building-axolotl-from-sources","title":"Building <code>axolotl</code> from sources","text":"<p>If you'd like to build <code>axolot</code> from sources (e.g. if you intend to modify its source code), follow its installation guide.</p> <p>Example:</p> <pre><code>type: task\n\npython: 3.11\n\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - WANDB_API_KEY\n\ncommands:\n  - conda install cuda\n  - pip3 install torch torchvision torchaudio\n\n  - git clone https://github.com/OpenAccess-AI-Collective/axolotl.git\n  - cd axolotl\n\n  - pip3 install packaging\n  - pip3 install -e '.[flash-attn,deepspeed]'\n\n  - accelerate launch -m axolotl.cli.train ../config.yaml\n\nports:\n  - 6006\n\nresources:\n  gpu:\n    memory: 24GB..\n    count: 2\n</code></pre>"},{"location":"docs/examples/fine-tuning/qlora/","title":"QLoRA","text":"<p>The following command runs the task to fine-tune an LLM using QLoRA:</p> <pre><code>dstack run . -f examples/fine-tuning/qlora/task.dstack.yml\n</code></pre> <p>See the configuration at train.dstack.yml.</p> <p>For more details, refer to tasks.</p>"},{"location":"docs/examples/llms/chat-ui/","title":"Chat UI","text":"<p>This example walks you through setting up Chat UI locally to chat with an LLM deployed using <code>dstack</code>.</p>"},{"location":"docs/examples/llms/chat-ui/#clone-the-repo","title":"Clone the repo","text":"<pre><code>git clone https://github.com/huggingface/chat-ui\ncd chat-ui\n</code></pre>"},{"location":"docs/examples/llms/chat-ui/#run-local-mongodb","title":"Run local MongoDB","text":"<pre><code>docker run -d -p 27017:27017 --name mongo-chatui mongo:latest\n</code></pre>"},{"location":"docs/examples/llms/chat-ui/#create-envlocal","title":"Create <code>.env.local</code>","text":"<pre><code>MONGODB_URL=mongodb://localhost:27017\n\nMODELS=`[\n   {\n      \"name\": \"&lt;model name&gt;\",\n      \"displayName\": \"My model\",\n      \"endpoints\": [\n        {\n         \"type\": \"openai\",\n         \"baseURL\" : \"https://gateway.&lt;gateway domain&gt;\",\n         \"apiKey\": \"&lt;dstack token&gt;\"\n        }\n      ]\n  }\n]`\n</code></pre> <p>Replace <code>&lt;gateway domain&gt;</code> with your <code>dstack</code> gateway's domain (e.g. <code>&lt;dstack project&gt;.sky.dstack.ai</code> if you are using dstack Sky).</p> <p>Replace <code>&lt;dstack token&gt;</code> with your <code>dstack</code> user's token.</p> <p>Replace <code>&lt;model name&gt;</code> with the name of the deployed mode,</p>"},{"location":"docs/examples/llms/chat-ui/#run-chat-ui","title":"Run Chat UI","text":"<pre><code>npm run dev\n</code></pre> <p>Now you can conveniently chat with your model! \ud83e\udd17</p> <p></p>"},{"location":"docs/examples/llms/llama3/","title":"Llama 3","text":""},{"location":"docs/examples/llms/llama3/#deploy-llama-8b","title":"Deploy Llama 8B","text":"<p>The following command deploys Llama 3 8B as a service:</p> <pre><code>dstack run . -f examples/llms/llama3/ollama-8b.dstack.yml\n</code></pre> <p>See the configuration at ollama-8b.dstack.yml.</p>"},{"location":"docs/examples/llms/llama3/#deploy-llama-70b","title":"Deploy Llama 70B","text":"<p>The following command deploys Llama 3 70B as a service:</p> <pre><code>dstack run . -f examples/llms/llama3/ollama-70b.dstack.yml\n</code></pre> <p>See the configuration at ollama-70b.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"docs/examples/llms/llama3/#run-chat-ui","title":"Run Chat UI","text":"<p>Refer to chat-ui to learn how to launch a UI for chatting with the LLM you've deployed to <code>dstack</code>.</p> <p></p>"},{"location":"docs/examples/llms/mixtral/","title":"Mixtral 8x7B","text":"<p>The following command deploys Mixtral 8x7B as a service:</p> <pre><code>dstack run . -f examples/llms/mixtral/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"docs/examples/misc/http.server/","title":"Streamlit","text":""},{"location":"docs/examples/misc/http.server/#service","title":"Service","text":"<p>The following command runs <code>http.server</code> as a service:</p> <pre><code>dstack run . -f examples/misc/http.server/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"docs/examples/misc/http.server/#task","title":"Task","text":"<p>The following command runs <code>http.server</code> as a task:</p> <pre><code>dstack run . -f examples/misc/http.server/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"docs/examples/misc/streamlit/","title":"Streamlit","text":""},{"location":"docs/examples/misc/streamlit/#service-no-auth","title":"Service (no auth)","text":"<p>The following command runs <code>streamlit hello</code> as a service with disabled authentication:</p> <pre><code>dstack run . -f examples/misc/streamlit/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"docs/examples/misc/streamlit/#task","title":"Task","text":"<p>The following command runs <code>streamlit hello</code> as a task:</p> <pre><code>dstack run . -f examples/misc/streamlit/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve-task.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"docs/guides/protips/","title":"Protips","text":"<p>Below are tips and tricks to use <code>dstack</code> more efficiently.</p>"},{"location":"docs/guides/protips/#dev-environments","title":"Dev environments","text":"<p>Before running a task or service, it's recommended that you first start with a dev environment. Dev environments allow you to run commands interactively.</p> <p>Once the commands work, go ahead and run them as a task or a service.</p> Notebooks <p>VS Code</p> <p>When you access a dev environment using your desktop VS Code, it allows you to work with Jupyter notebooks via its pre-configured and easy-to-use extension.</p> <p>JupyterLab</p> <p>If you prefer to use JupyterLab, you can run it as a task:</p> <pre><code>type: task\n\ncommands:\n    - pip install jupyterlab\n    - jupyter lab --allow-root\n\nports:\n    - 8888\n</code></pre>"},{"location":"docs/guides/protips/#tasks-vs-services-for-web-applications","title":"Tasks vs services for web applications","text":"<p>Tasks can be used not only for batch jobs but also for web applications.</p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip3 install streamlit\n  - streamlit hello\n\nports: \n  - 8501\n</code></pre> <p>While you run a task, <code>dstack</code> forwards the remote ports to <code>localhost</code>.</p> <pre><code>$ dstack run . -f app.dstack.yml\n\n  Welcome to Streamlit. Check out our demo in your browser.\n\n  Local URL: http://localhost:8501\n</code></pre> <p>This allows you to access the remote <code>8501</code> port on <code>localhost:8501</code> while the CLI is attached.</p> Port mapping <p>If you want to override the local port, use the <code>--port</code> option:</p> <pre><code>$ dstack run . -f app.dstack.yml --port 3000:8501\n</code></pre> <p>This will forward the remote <code>8501</code> port to <code>localhost:3000</code>.</p> <p>Services require a gateway but they also provide additional features for production-grade service deployment not offered by tasks, such as HTTPS domains and auto-scaling. If you run a web app as a task and it works, go ahead and run it as a service.</p>"},{"location":"docs/guides/protips/#environment-variables","title":"Environment variables","text":"<p>If a configuration requires an environment variable that you don't want to hardcode in the YAML, you can define it without assigning a value:</p> <pre><code>type: dev-environment\n\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n\npython: \"3.11\"\nide: vscode\n</code></pre> <p>Then, you can pass the environment variable either via the shell:</p> <pre><code>HUGGING_FACE_HUB_TOKEN=... dstack run . -f .dstack.yml\n</code></pre> <p>Or via the <code>-e</code> option of the <code>dstack run</code> command:</p> <pre><code>dstack run . -f .dstack.yml -e HUGGING_FACE_HUB_TOKEN=...\n</code></pre> .env <p>A better way to configure environment variables not hardcoded in YAML is by specifying them in a <code>.env</code> file:</p> <pre><code>HUGGING_FACE_HUB_TOKEN=...\n</code></pre> <p>If you install <code>direnv</code> , it will automatically pass the environment variables from the <code>.env</code> file to the <code>dstack run</code> command.</p> <p>Remember to add <code>.env</code> to <code>.gitignore</code> to avoid pushing it to the repo.    </p>"},{"location":"docs/guides/protips/#data-and-models","title":"Data and models","text":"<p><code>dstack</code> has support for volumes to persist data across different runs and instance interruptions. Volumes are ideal for storing intermediate work and data that should be quickly accessible.</p> <p>You can also load and save data using an object storage like S3 or HuggingFace Datasets. For models, it's best to use services like HuggingFace Hub. <code>dstack</code> has no explicit support for object storage. You can load and save data directly from your code.</p>"},{"location":"docs/guides/protips/#idle-instances","title":"Idle instances","text":"<p>By default, the <code>dstack</code> run command reuses an idle instance from the pool. If no instance matches the requirements, it creates a new one.</p> <p>When the run finishes, the instance remains idle for the configured time (by default, <code>5m</code>) before it gets destroyed.</p> <p>You can change the default idle duration by using <code>--idle-duration DURATION</code> with <code>dstack run</code>, or set <code>termination_idle_duration</code> in the configuration or profile.</p> <p>An idle instance can be destroyed at any time via <code>dstack pool rm INSTANCE_NAME</code>.</p>"},{"location":"docs/guides/protips/#profiles","title":"Profiles","text":"<p>If you don't want to specify the same parameters for each configuration, you can define them once via profiles and reuse them across configurations.</p> <p>This can be handy, for example, for configuring parameters such as <code>max_duration</code>, <code>max_price</code>, <code>termination_idle_duration</code>, <code>regions</code>, etc.</p> <p>Set <code>default</code> to <code>true</code> in your profile, and it will be applied automatically to any run.</p>"},{"location":"docs/guides/protips/#attached-mode","title":"Attached mode","text":"<p>By default, <code>dstack run</code> runs in attached mode. This means it streams the logs as they come in and, in the case of a task, forwards its ports to <code>localhost</code>.</p> <p>If you detach the CLI, you can re-attach it using <code>dstack logs -a RUN_NAME</code>.</p> <p>To run in detached mode, use <code>-d</code> with <code>dstack run</code>.</p>"},{"location":"docs/guides/protips/#gpu","title":"GPU","text":"<p><code>dstack</code> natively supports NVIDIA GPU, and Google Cloud TPU accelerator chips.</p> <p>The <code>gpu</code> property withing <code>resources</code> (or the <code>--gpu</code> option with <code>dstack run</code>) allows specifying not only memory size but also GPU names, their memory, and quantity.</p> <p>Examples:</p> <ul> <li><code>1</code> (any GPU)</li> <li><code>A100</code> (A100)</li> <li><code>24GB..</code> (any GPU starting from 24GB)</li> <li><code>24GB..40GB:2</code> (two GPUs between 24GB and 40GB)</li> <li><code>A10G,A100</code> (either A10G or A100)</li> <li><code>A100:80GB</code> (one A100 of 80GB)</li> <li><code>A100:2</code> (two A100)</li> <li><code>A100:40GB:2</code> (two A100 40GB)</li> <li><code>tpu-v2-8</code> (<code>v2</code> with 8 TPU cores)</li> </ul> Google Cloud TPU <p>Currently, you can't specify other than 8 TPU cores. This means only single host workloads are supported. Support for multiple hosts is coming soon.</p>"},{"location":"docs/guides/protips/#service-quotas","title":"Service quotas","text":"<p>If you're using your own AWS, GCP, Azure, or OCI accounts, before you can use GPUs or spot instances, you have to request the corresponding service quotas for each type of instance in each region.</p> AWS <p>Check this guide   on EC2 service quotas. The relevant service quotas include:</p> <ul> <li><code>Running On-Demand P instances</code> (on-demand V100, A100 80GB x8)</li> <li><code>All P4, P3 and P2 Spot Instance Requests</code> (spot V100, A100 80GB x8)</li> <li><code>Running On-Demand G and VT instances</code> (on-demand T4, A10G, L4)</li> <li><code>All G and VT Spot Instance Requests</code> (spot T4, A10G, L4)</li> <li><code>Running Dedicated p5 Hosts</code> (on-demand H100)</li> <li><code>All P5 Spot Instance Requests</code> (spot H100)</li> </ul> GCP <p>Check this guide   on Compute Engine service quotas. The relevant service quotas include:</p> <ul> <li><code>NVIDIA V100 GPUs</code> (on-demand V100)</li> <li><code>Preemtible V100 GPUs</code> (spot V100)</li> <li><code>NVIDIA T4 GPUs</code> (on-demand T4)</li> <li><code>Preemtible T4 GPUs</code> (spot T4)</li> <li><code>NVIDIA L4 GPUs</code> (on-demand L4)</li> <li><code>Preemtible L4 GPUs</code> (spot L4)</li> <li><code>NVIDIA A100 GPUs</code> (on-demand A100)</li> <li><code>Preemtible A100 GPUs</code> (spot A100)</li> <li><code>NVIDIA A100 80GB GPUs</code> (on-demand A100 80GB)</li> <li><code>Preemtible A100 80GB GPUs</code> (spot A100 80GB)</li> <li><code>NVIDIA H100 GPUs</code> (on-demand H100)</li> <li><code>Preemtible H100 GPUs</code> (spot H100)</li> </ul> Azure <p>Check this guide   on Azure service quotas. The relevant service quotas include:</p> <ul> <li><code>Total Regional Spot vCPUs</code> (any spot instances)</li> <li><code>Standard NCASv3_T4 Family vCPUs</code> (on-demand T4)</li> <li><code>Standard NVADSA10v5 Family vCPUs</code> (on-demand A10)</li> <li><code>Standard NCADS_A100_v4 Family vCPUs</code> (on-demand A100 80GB)</li> <li><code>Standard NDASv4_A100 Family vCPUs</code> (on-demand A100 40GB x8)</li> <li><code>Standard NDAMSv4_A100Family vCPUs</code> (on-demand A100 80GB x8)</li> <li><code>Standard NCadsH100v5 Family vCPUs</code> (on-demand H100)</li> <li><code>Standard NDSH100v5 Family vCPUs</code> (on-demand H100 x8)</li> </ul> OCI <p>Check this guide   on requesting OCI service limits increase. The relevant service category is compute. The relevant resources include:</p> <ul> <li><code>GPUs for GPU.A10 based VM and BM instances</code> (on-demand A10)</li> <li><code>GPUs for GPU2 based VM and BM instances</code> (on-demand P100)</li> <li><code>GPUs for GPU3 based VM and BM instances</code> (on-demand V100)</li> </ul> <p>Note, for AWS, GCP, and Azure, service quota values are measured with the number of CPUs rather than GPUs.</p>"},{"location":"docs/installation/","title":"Installation","text":"<p>To use the open-source version of <code>dstack</code> with your own cloud accounts or on-prem servers,  you have to set up the server. </p>"},{"location":"docs/installation/#set-up-the-server","title":"Set up the server","text":"<p>Follow the steps below to set up the server.</p>"},{"location":"docs/installation/#1-configure-backends","title":"1. Configure backends","text":"<p>If you want the <code>dstack</code> server to run containers or manage clusters in your cloud accounts (or use Kubernetes), create the ~/.dstack/server/config.yml file and configure backends.</p>"},{"location":"docs/installation/#2-start-the-server","title":"2. Start the server","text":"<p>Once the <code>~/.dstack/server/config.yml</code> file is configured, proceed to start the server:</p> pipDocker <pre><code>$ pip install \"dstack[all]\" -U\n$ dstack server\n\nApplying ~/.dstack/server/config.yml...\n\nThe admin token is \"bbae0f28-d3dd-4820-bf61-8f4bb40815da\"\nThe server is running at http://127.0.0.1:3000/\n</code></pre> <pre><code>$ docker run -p 3000:3000 \\\n    -v $HOME/.dstack/server/:/root/.dstack/server \\\n    dstackai/dstack\n\nApplying ~/.dstack/server/config.yml...\n\nThe admin token is \"bbae0f28-d3dd-4820-bf61-8f4bb40815da\"\nThe server is running at http://127.0.0.1:3000/\n</code></pre> <p>For more details on how to deploy <code>dstack</code> using Docker, check its Docker repo.</p> <p>By default, the <code>dstack</code> server stores its state in <code>~/.dstack/server/data</code> using SQLite. To use a database, set the <code>DSTACK_DATABASE_URL</code> environment variable.</p> <p>The server can be set up anywhere: on your laptop, a dedicated server, or in the cloud. Once the <code>dstack</code> server is up, you can use the CLI or API.</p>"},{"location":"docs/installation/#3-set-up-the-cli","title":"3. Set up the CLI","text":"<p>To point the CLI to the <code>dstack</code> server, configure it with the server address, user token and project name:</p> <pre><code>$ pip install dstack\n$ dstack config --url http://127.0.0.1:3000 \\\n    --project main \\\n    --token bbae0f28-d3dd-4820-bf61-8f4bb40815da\n\nConfiguration is updated at ~/.dstack/config.yml\n</code></pre> <p>This configuration is stored in <code>~/.dstack/config.yml</code>.</p>"},{"location":"docs/installation/#4-add-on-prem-servers","title":"4. Add on-prem servers","text":"<p>Fleets</p> <p>If you want the <code>dstack</code> server to run containers on your on-prem servers, use fleets.</p>"},{"location":"docs/installation/#dstack-sky","title":"dstack Sky","text":"<p>If you don't want to host the <code>dstack</code> server yourself or would like to access GPU from the <code>dstack</code> marketplace, sign up with dstack Sky .</p>"},{"location":"docs/installation/#set-up-the-cli","title":"Set up the CLI","text":"<p>If you've signed up, open your project settings, and copy the <code>dstack config</code> command to point the CLI to the project.</p> <p></p> <p>Then, install the CLI on your machine and use the copied command.</p> <pre><code>$ pip install dstack\n$ dstack config --url https://sky.dstack.ai \\\n    --project peterschmidt85 \\\n    --token bbae0f28-d3dd-4820-bf61-8f4bb40815da\n\nConfiguration is updated at ~/.dstack/config.yml\n</code></pre>"},{"location":"docs/installation/#configure-clouds","title":"Configure clouds","text":"<p>By default, dstack Sky   uses the GPU from its marketplace, which requires a credit card to be attached in your account settings.</p> <p>To use your own cloud accounts, click the settings icon of the corresponding backend and specify credentials:</p> <p></p>"},{"location":"docs/installation/#whats-next","title":"What's next?","text":"<ol> <li>Check the server/config.yml reference on how to configure backends</li> <li>Follow quickstart</li> <li>Browse examples </li> <li>Join the community via Discord </li> </ol>"},{"location":"docs/reference/dstack.yml/","title":".dstack.yml","text":"<ul> <li><code>dev-environment</code></li> <li><code>task</code></li> <li><code>service</code></li> </ul>"},{"location":"docs/reference/profiles.yml/","title":"profiles.yml","text":"<p>Sometimes, you may want to reuse the same parameters across different <code>.dstack.yml</code> configurations.</p> <p>This can be achieved by defining those parameters in a profile.</p> <p>Profiles can be defined on the repository level (via the <code>.dstack/profiles.yml</code> file in the root directory of the repository) or on the global level (via the <code>~/.dstack/profiles.yml</code> file).</p> <p>Any profile can be marked as default so that it will be applied automatically for any run. Otherwise, you can refer to a specific profile via <code>--profile NAME</code> in <code>dstack run</code>.</p>"},{"location":"docs/reference/profiles.yml/#example","title":"Example","text":"<pre><code>profiles:\n  - name: my-profile\n\n    # The spot pololicy can be \"spot\", \"on-demand\", or \"auto\"\n    spot_policy: auto\n\n    # Limit the maximum price of the instance per hour\n    max_price: 1.5\n\n    # Stop any run if it runs longer that this duration\n    max_duration: 1d\n\n    # Use only these backends\n    backends: [azure, lambda]\n\n    # If set to true, this profile will be applied automatically\n    default: true\n</code></pre> <p>The profile configuration supports many properties. See below.</p>"},{"location":"docs/reference/profiles.yml/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/profiles.yml/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/profiles.yml/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/profiles.yml/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/profiles.yml/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/profiles.yml/#_retry","title":"<code>retry</code> - (Optional) The policy for resubmitting the run. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/profiles.yml/#_retry_policy","title":"<code>retry_policy</code> - (Optional) The policy for resubmitting the run. Deprecated in favor of <code>retry</code>.","text":""},{"location":"docs/reference/profiles.yml/#max_duration","title":"<code>max_duration</code> - (Optional) The maximum duration of a run (e.g., <code>2h</code>, <code>1d</code>, etc). After it elapses, the run is forced to stop. Defaults to <code>off</code>.","text":""},{"location":"docs/reference/profiles.yml/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/profiles.yml/#pool_name","title":"<code>pool_name</code> - (Optional) The name of the pool. If not set, dstack will use the default name.","text":""},{"location":"docs/reference/profiles.yml/#instance_name","title":"<code>instance_name</code> - (Optional) The name of the instance.","text":""},{"location":"docs/reference/profiles.yml/#creation_policy","title":"<code>creation_policy</code> - (Optional) The policy for using instances from the pool. Defaults to <code>reuse-or-create</code>.","text":""},{"location":"docs/reference/profiles.yml/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/profiles.yml/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying the idle instance. Defaults to <code>5m</code> for <code>dstack run</code> and to <code>3d</code> for <code>dstack pool add</code>.","text":""},{"location":"docs/reference/profiles.yml/#name","title":"<code>name</code> -  The name of the profile that can be passed as <code>--profile</code> to <code>dstack run</code>.","text":""},{"location":"docs/reference/profiles.yml/#default","title":"<code>default</code> - (Optional) If set to true, <code>dstack run</code> will use this profile by default..","text":""},{"location":"docs/reference/profiles.yml/#retry","title":"<code>retry</code>","text":""},{"location":"docs/reference/profiles.yml/#on_events","title":"<code>on_events</code> -  The list of events that should be handled with retry. Supported events are <code>no-capacity</code>, <code>interruption</code>, and <code>error</code>.","text":""},{"location":"docs/reference/profiles.yml/#duration","title":"<code>duration</code> - (Optional) The maximum period of retrying the run, e.g., <code>4h</code> or <code>1d</code>.","text":""},{"location":"docs/reference/api/python/","title":"Python API","text":"<p>The Python API enables running tasks, services, and managing runs programmatically.</p>"},{"location":"docs/reference/api/python/#usage-example","title":"Usage example","text":"<p>Below is a quick example of submitting a task for running and displaying its logs.</p> <pre><code>import sys\n\nfrom dstack.api import Task, GPU, Client, Resources\n\nclient = Client.from_config()\n\ntask = Task(\n    image=\"ghcr.io/huggingface/text-generation-inference:latest\",\n    env={\"MODEL_ID\": \"TheBloke/Llama-2-13B-chat-GPTQ\"},\n    commands=[\n        \"text-generation-launcher --trust-remote-code --quantize gptq\",\n    ],\n    ports=[\"80\"],\n    resources=Resources(gpu=GPU(memory=\"24GB\")),\n)\n\nrun = client.runs.submit(\n    run_name=\"my-awesome-run\",  # If not specified, a random name is assigned \n    configuration=task,\n    repo=None, # Specify to mount additional files\n)\n\nrun.attach()\n\ntry:\n    for log in run.logs():\n        sys.stdout.buffer.write(log)\n        sys.stdout.buffer.flush()\nexcept KeyboardInterrupt:\n    run.stop(abort=True)\nfinally:\n    run.detach()\n</code></pre> <p>NOTE:</p> <ol> <li>The <code>configuration</code> argument in the <code>submit</code> method can be either <code>dstack.api.Task</code> or <code>dstack.api.Service</code>. </li> <li>If you create <code>dstack.api.Task</code> or <code>dstack.api.Service</code>, you may specify the <code>image</code> argument. If <code>image</code> isn't    specified, the default image will be used. For a private Docker registry, ensure you also pass the <code>registry_auth</code> argument.</li> <li>The <code>repo</code> argument in the <code>submit</code> method allows the mounting of a local folder, a remote repo, or a    programmatically created repo. In this case, the <code>commands</code> argument can refer to the files within this repo.</li> <li>The <code>attach</code> method waits for the run to start and, for <code>dstack.api.Task</code> sets up an SSH tunnel and forwards configured <code>ports</code> to <code>localhost</code>.</li> </ol>"},{"location":"docs/reference/api/python/#dstack.api","title":"<code>dstack.api</code>","text":""},{"location":"docs/reference/api/python/#dstack.api.Client","title":"<code>dstack.api.Client</code>","text":"<p>High-level API client for interacting with dstack server</p> <p>Attributes:</p> Name Type Description <code>runs</code> <code>RunCollection</code> <p>Operations with runs.</p> <code>repos</code> <code>RepoCollection</code> <p>Operations with repositories.</p> <code>backends</code> <code>BackendCollection</code> <p>Operations with backends.</p>"},{"location":"docs/reference/api/python/#dstack.api.Client.from_config","title":"<code>from_config(project_name=None, server_url=None, user_token=None, ssh_identity_file=None)</code>  <code>staticmethod</code>","text":"<p>Creates a Client using the default configuration from <code>~/.dstack/config.yml</code> if it exists.</p> <p>Parameters:</p> Name Type Description Default <code>project_name</code> <code>Optional[str]</code> <p>The name of the project, required if <code>server_url</code> and <code>user_token</code> are specified</p> <code>None</code> <code>server_url</code> <code>Optional[str]</code> <p>The dstack server URL (e.g. <code>http://localhost:3000/</code> or <code>https://sky.dstack.ai</code>)</p> <code>None</code> <code>user_token</code> <code>Optional[str]</code> <p>The dstack user token</p> <code>None</code> <code>ssh_identity_file</code> <code>Optional[PathLike]</code> <p>The private SSH key path for SSH tunneling</p> <code>None</code> <p>Returns:</p> Type Description <code>Client</code> <p>A client instance</p>"},{"location":"docs/reference/api/python/#dstack.api.Client.runs","title":"<code>dstack.api.RunCollection</code>","text":"<p>Operations with runs</p>"},{"location":"docs/reference/api/python/#dstack.api.RunCollection.get","title":"<code>get(run_name)</code>","text":"<p>Get run by run name</p> <p>Parameters:</p> Name Type Description Default <code>run_name</code> <code>str</code> <p>run name</p> required <p>Returns:</p> Type Description <code>Optional[Run]</code> <p>The run or <code>None</code> if not found</p>"},{"location":"docs/reference/api/python/#dstack.api.RunCollection.list","title":"<code>list(all=False)</code>","text":"<p>List runs</p> <p>Parameters:</p> Name Type Description Default <code>all</code> <code>bool</code> <p>show all runs (active and finished) if <code>True</code></p> <code>False</code> <p>Returns:</p> Type Description <code>List[Run]</code> <p>list of runs</p>"},{"location":"docs/reference/api/python/#dstack.api.RunCollection.submit","title":"<code>submit(configuration, configuration_path=None, repo=None, backends=None, regions=None, instance_types=None, resources=None, spot_policy=None, retry_policy=None, max_duration=None, max_price=None, working_dir=None, run_name=None, reserve_ports=True)</code>","text":"<p>Submit a run</p> <p>Parameters:</p> Name Type Description Default <code>configuration</code> <code>Union[Task, Service]</code> <p>A run configuration.</p> required <code>configuration_path</code> <code>Optional[str]</code> <p>The path to the configuration file, relative to the root directory of the repo.</p> <code>None</code> <code>repo</code> <code>Union[LocalRepo, RemoteRepo, VirtualRepo]</code> <p>A repo to mount to the run.</p> <code>None</code> <code>backends</code> <code>Optional[List[BackendType]]</code> <p>A list of allowed backend for provisioning.</p> <code>None</code> <code>regions</code> <code>Optional[List[str]]</code> <p>A list of cloud regions for provisioning.</p> <code>None</code> <code>resources</code> <code>Optional[ResourcesSpec]</code> <p>The requirements to run the configuration. Overrides the configuration's resources.</p> <code>None</code> <code>spot_policy</code> <code>Optional[SpotPolicy]</code> <p>A spot policy for provisioning.</p> <code>None</code> <code>retry_policy</code> <code>RetryPolicy</code> <p>A retry policy.</p> <code>None</code> <code>max_duration</code> <code>Optional[Union[int, str]]</code> <p>The max instance running duration in seconds.</p> <code>None</code> <code>max_price</code> <code>Optional[float]</code> <p>The max instance price in dollars per hour for provisioning.</p> <code>None</code> <code>working_dir</code> <code>Optional[str]</code> <p>A working directory relative to the repo root directory</p> <code>None</code> <code>run_name</code> <code>Optional[str]</code> <p>A desired name of the run. Must be unique in the project. If not specified, a random name is assigned.</p> <code>None</code> <code>reserve_ports</code> <code>bool</code> <p>Whether local ports should be reserved in advance.</p> <code>True</code> <p>Returns:</p> Type Description <code>Run</code> <p>submitted run</p>"},{"location":"docs/reference/api/python/#dstack.api.Client.repos","title":"<code>dstack.api.RepoCollection</code>","text":"<p>Operations with repos</p>"},{"location":"docs/reference/api/python/#dstack.api.RepoCollection.init","title":"<code>init(repo, git_identity_file=None, oauth_token=None)</code>","text":"<p>Initializes the repo and configures its credentials in the project. Must be invoked before mounting the repo to a run.</p> <p>Example:</p> <pre><code>repo=RemoteRepo.from_url(\n    repo_url=\"https://github.com/dstackai/dstack-examples\",\n    repo_branch=\"main\",\n)\nclient.repos.init(repo)\n</code></pre> <p>By default, it uses the default Git credentials configured on the machine. You can override these credentials via the <code>git_identity_file</code> or <code>oauth_token</code> arguments of the <code>init</code> method.</p> <p>Once the repo is initialized, you can pass the repo object to the run:</p> <pre><code>run = client.runs.submit(\n    configuration=...,\n    repo=repo,\n)\n</code></pre> <p>Parameters:</p> Name Type Description Default <code>repo</code> <code>Repo</code> <p>The repo to initialize.</p> required <code>git_identity_file</code> <code>Optional[PathLike]</code> <p>The private SSH key path for accessing the remote repo.</p> <code>None</code> <code>oauth_token</code> <code>Optional[str]</code> <p>The GitHub OAuth token to access the remote repo.</p> <code>None</code>"},{"location":"docs/reference/api/python/#dstack.api.Task","title":"<code>dstack.api.Task</code>","text":""},{"location":"docs/reference/api/python/#nodes","title":"<code>nodes</code> - (Optional) Number of nodes. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/api/python/#name","title":"<code>name</code> - (Optional) The run name.","text":""},{"location":"docs/reference/api/python/#image","title":"<code>image</code> - (Optional) The name of the Docker image to run.","text":""},{"location":"docs/reference/api/python/#entrypoint","title":"<code>entrypoint</code> - (Optional) The Docker entrypoint.","text":""},{"location":"docs/reference/api/python/#working_dir","title":"<code>working_dir</code> - (Optional) The path to the working directory inside the container. It's specified relative to the repository directory (<code>/workflow</code>) and should be inside it. Defaults to <code>\".\"</code> .","text":""},{"location":"docs/reference/api/python/#home_dir","title":"<code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.","text":""},{"location":"docs/reference/api/python/#_registry_auth","title":"<code>registry_auth</code> - (Optional) Credentials for pulling a private Docker image.","text":""},{"location":"docs/reference/api/python/#python","title":"<code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/api/python/#env","title":"<code>env</code> - (Optional) The mapping or the list of environment variables.","text":""},{"location":"docs/reference/api/python/#setup","title":"<code>setup</code> - (Optional) The bash commands to run on the boot.","text":""},{"location":"docs/reference/api/python/#_resources","title":"<code>resources</code> - (Optional) The resources requirements to run the configuration.","text":""},{"location":"docs/reference/api/python/#_volumes","title":"<code>volumes</code> - (Optional) The volumes mount points.","text":""},{"location":"docs/reference/api/python/#ports","title":"<code>ports</code> - (Optional) Port numbers/mapping to expose.","text":""},{"location":"docs/reference/api/python/#commands","title":"<code>commands</code> - (Optional) The bash commands to run.","text":""},{"location":"docs/reference/api/python/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/api/python/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/api/python/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/api/python/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/api/python/#_retry","title":"<code>retry</code> - (Optional) The policy for resubmitting the run. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/api/python/#_retry_policy","title":"<code>retry_policy</code> - (Optional) The policy for resubmitting the run. Deprecated in favor of <code>retry</code>.","text":""},{"location":"docs/reference/api/python/#max_duration","title":"<code>max_duration</code> - (Optional) The maximum duration of a run (e.g., <code>2h</code>, <code>1d</code>, etc). After it elapses, the run is forced to stop. Defaults to <code>off</code>.","text":""},{"location":"docs/reference/api/python/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/api/python/#pool_name","title":"<code>pool_name</code> - (Optional) The name of the pool. If not set, dstack will use the default name.","text":""},{"location":"docs/reference/api/python/#instance_name","title":"<code>instance_name</code> - (Optional) The name of the instance.","text":""},{"location":"docs/reference/api/python/#creation_policy","title":"<code>creation_policy</code> - (Optional) The policy for using instances from the pool. Defaults to <code>reuse-or-create</code>.","text":""},{"location":"docs/reference/api/python/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/api/python/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying the idle instance. Defaults to <code>5m</code> for <code>dstack run</code> and to <code>3d</code> for <code>dstack pool add</code>.","text":""},{"location":"docs/reference/api/python/#dstack.api.Service","title":"<code>dstack.api.Service</code>","text":""},{"location":"docs/reference/api/python/#port","title":"<code>port</code> -  The port, that application listens on or the mapping.","text":""},{"location":"docs/reference/api/python/#model","title":"<code>model</code> - (Optional) Mapping of the model for the OpenAI-compatible endpoint.","text":""},{"location":"docs/reference/api/python/#https","title":"<code>https</code> - (Optional) Enable HTTPS. Defaults to <code>True</code>.","text":""},{"location":"docs/reference/api/python/#auth","title":"<code>auth</code> - (Optional) Enable the authorization. Defaults to <code>True</code>.","text":""},{"location":"docs/reference/api/python/#replicas","title":"<code>replicas</code> - (Optional) The number of replicas. Can be a number (e.g. <code>2</code>) or a range (<code>0..4</code> or <code>1..8</code>). If it's a range, the <code>scaling</code> property is required. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/api/python/#_scaling","title":"<code>scaling</code> - (Optional) The auto-scaling rules. Required if <code>replicas</code> is set to a range.","text":""},{"location":"docs/reference/api/python/#name","title":"<code>name</code> - (Optional) The run name.","text":""},{"location":"docs/reference/api/python/#image","title":"<code>image</code> - (Optional) The name of the Docker image to run.","text":""},{"location":"docs/reference/api/python/#entrypoint","title":"<code>entrypoint</code> - (Optional) The Docker entrypoint.","text":""},{"location":"docs/reference/api/python/#working_dir","title":"<code>working_dir</code> - (Optional) The path to the working directory inside the container. It's specified relative to the repository directory (<code>/workflow</code>) and should be inside it. Defaults to <code>\".\"</code> .","text":""},{"location":"docs/reference/api/python/#home_dir","title":"<code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.","text":""},{"location":"docs/reference/api/python/#_registry_auth","title":"<code>registry_auth</code> - (Optional) Credentials for pulling a private Docker image.","text":""},{"location":"docs/reference/api/python/#python","title":"<code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/api/python/#env","title":"<code>env</code> - (Optional) The mapping or the list of environment variables.","text":""},{"location":"docs/reference/api/python/#setup","title":"<code>setup</code> - (Optional) The bash commands to run on the boot.","text":""},{"location":"docs/reference/api/python/#_resources","title":"<code>resources</code> - (Optional) The resources requirements to run the configuration.","text":""},{"location":"docs/reference/api/python/#_volumes","title":"<code>volumes</code> - (Optional) The volumes mount points.","text":""},{"location":"docs/reference/api/python/#commands","title":"<code>commands</code> - (Optional) The bash commands to run.","text":""},{"location":"docs/reference/api/python/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/api/python/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/api/python/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/api/python/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/api/python/#_retry","title":"<code>retry</code> - (Optional) The policy for resubmitting the run. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/api/python/#_retry_policy","title":"<code>retry_policy</code> - (Optional) The policy for resubmitting the run. Deprecated in favor of <code>retry</code>.","text":""},{"location":"docs/reference/api/python/#max_duration","title":"<code>max_duration</code> - (Optional) The maximum duration of a run (e.g., <code>2h</code>, <code>1d</code>, etc). After it elapses, the run is forced to stop. Defaults to <code>off</code>.","text":""},{"location":"docs/reference/api/python/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/api/python/#pool_name","title":"<code>pool_name</code> - (Optional) The name of the pool. If not set, dstack will use the default name.","text":""},{"location":"docs/reference/api/python/#instance_name","title":"<code>instance_name</code> - (Optional) The name of the instance.","text":""},{"location":"docs/reference/api/python/#creation_policy","title":"<code>creation_policy</code> - (Optional) The policy for using instances from the pool. Defaults to <code>reuse-or-create</code>.","text":""},{"location":"docs/reference/api/python/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/api/python/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying the idle instance. Defaults to <code>5m</code> for <code>dstack run</code> and to <code>3d</code> for <code>dstack pool add</code>.","text":""},{"location":"docs/reference/api/python/#dstack.api.Run","title":"<code>dstack.api.Run</code>","text":"<p>Attributes:</p> Name Type Description <code>name</code> <code>str</code> <p>run name</p> <code>ports</code> <code>Optional[Dict[int, int]]</code> <p>ports mapping, if run is attached</p> <code>backend</code> <code>Optional[BackendType]</code> <p>backend type</p> <code>status</code> <code>RunStatus</code> <p>run status</p> <code>hostname</code> <code>str</code> <p>instance hostname</p>"},{"location":"docs/reference/api/python/#dstack.api.Run.attach","title":"<code>attach(ssh_identity_file=None)</code>","text":"<p>Establish an SSH tunnel to the instance and update SSH config</p> <p>Parameters:</p> Name Type Description Default <code>ssh_identity_file</code> <code>Optional[PathLike]</code> <p>SSH keypair to access instances</p> <code>None</code> <p>Raises:</p> Type Description <code>PortUsedError</code> <p>If ports are in use or the run is attached by another process.</p>"},{"location":"docs/reference/api/python/#dstack.api.Run.detach","title":"<code>detach()</code>","text":"<p>Stop the SSH tunnel to the instance and update SSH config</p>"},{"location":"docs/reference/api/python/#dstack.api.Run.logs","title":"<code>logs(start_time=None, diagnose=False, replica_num=0, job_num=0)</code>","text":"<p>Iterate through run's log messages</p> <p>Parameters:</p> Name Type Description Default <code>start_time</code> <code>Optional[datetime]</code> <p>minimal log timestamp</p> <code>None</code> <code>diagnose</code> <code>bool</code> <p>return runner logs if <code>True</code></p> <code>False</code> <p>Yields:</p> Type Description <code>Iterable[bytes]</code> <p>log messages</p>"},{"location":"docs/reference/api/python/#dstack.api.Run.refresh","title":"<code>refresh()</code>","text":"<p>Get up-to-date run info</p>"},{"location":"docs/reference/api/python/#dstack.api.Run.stop","title":"<code>stop(abort=False)</code>","text":"<p>Terminate the instance and detach</p> <p>Parameters:</p> Name Type Description Default <code>abort</code> <code>bool</code> <p>gracefully stop the run if <code>False</code></p> <code>False</code>"},{"location":"docs/reference/api/python/#dstack.api.Resources","title":"<code>dstack.api.Resources</code>","text":""},{"location":"docs/reference/api/python/#cpu","title":"<code>cpu</code> - (Optional) The number of CPU cores. Defaults to <code>2..</code>.","text":""},{"location":"docs/reference/api/python/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>8GB</code>). Defaults to <code>8GB..</code>.","text":""},{"location":"docs/reference/api/python/#shm_size","title":"<code>shm_size</code> - (Optional) The size of shared memory (e.g., <code>8GB</code>). If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure this.","text":""},{"location":"docs/reference/api/python/#_gpu","title":"<code>gpu</code> - (Optional) The GPU requirements.","text":""},{"location":"docs/reference/api/python/#_disk","title":"<code>disk</code> - (Optional) The disk resources.","text":""},{"location":"docs/reference/api/python/#dstack.api.GPU","title":"<code>dstack.api.GPU</code>","text":""},{"location":"docs/reference/api/python/#name","title":"<code>name</code> - (Optional) The name of the GPU (e.g., <code>A100</code> or <code>H100</code>).","text":""},{"location":"docs/reference/api/python/#count","title":"<code>count</code> - (Optional) The number of GPUs. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/api/python/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>16GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/api/python/#total_memory","title":"<code>total_memory</code> - (Optional) The total RAM size (e.g., <code>32GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/api/python/#compute_capability","title":"<code>compute_capability</code> - (Optional) The minimum compute capability of the GPU (e.g., <code>7.5</code>).","text":""},{"location":"docs/reference/api/python/#dstack.api.Disk","title":"<code>dstack.api.Disk</code>","text":""},{"location":"docs/reference/api/python/#size","title":"<code>size</code> -  Disk size.","text":""},{"location":"docs/reference/api/python/#dstack.api.LocalRepo","title":"<code>dstack.api.LocalRepo</code>","text":"<p>Creates an instance of a local repo from a local path.</p> <p>Example:</p> <pre><code>run = client.runs.submit(\n    configuration=...,\n    repo=LocalRepo.from_dir(\".\"), # Mount the current folder to the run\n)\n</code></pre>"},{"location":"docs/reference/api/python/#dstack.api.LocalRepo.from_dir","title":"<code>from_dir(repo_dir)</code>  <code>staticmethod</code>","text":"<p>Creates an instance of a local repo from a local path.</p> <p>Parameters:</p> Name Type Description Default <code>repo_dir</code> <code>PathLike</code> <p>The path to a local folder</p> required <p>Returns:</p> Type Description <code>LocalRepo</code> <p>A local repo instance</p>"},{"location":"docs/reference/api/python/#dstack.api.RemoteRepo","title":"<code>dstack.api.RemoteRepo</code>","text":"<p>Creates an instance of a remote Git repo for mounting to a submitted run.</p> <p>Using a locally checked-out remote Git repo:</p> <pre><code>repo=RemoteRepo.from_dir(repo_dir=\".\")\n</code></pre> <p>Using a remote Git repo by a URL:</p> <pre><code>repo=RemoteRepo.from_url(\n    repo_url=\"https://github.com/dstackai/dstack-examples\",\n    repo_branch=\"main\"\n)\n</code></pre> <p>Initialize the repo before mounting it.</p> <pre><code>client.repos.init(repo)\n</code></pre> <p>By default, it uses the default Git credentials configured on the machine. You can override these credentials via the <code>git_identity_file</code> or <code>oauth_token</code> arguments of the <code>init</code> method.</p> <p>Finally, you can pass the repo object to the run:</p> <pre><code>run = client.runs.submit(\n    configuration=...,\n    repo=repo,\n)\n</code></pre>"},{"location":"docs/reference/api/python/#dstack.api.RemoteRepo.from_dir","title":"<code>from_dir(repo_dir)</code>  <code>staticmethod</code>","text":"<p>Creates an instance of a remote repo from a local path.</p> <p>Parameters:</p> Name Type Description Default <code>repo_dir</code> <code>PathLike</code> <p>The path to a local folder</p> required <p>Returns:</p> Type Description <code>RemoteRepo</code> <p>A remote repo instance</p>"},{"location":"docs/reference/api/python/#dstack.api.RemoteRepo.from_url","title":"<code>from_url(repo_url, repo_branch=None, repo_hash=None)</code>  <code>staticmethod</code>","text":"<p>Creates an instance of a remote repo from a URL.</p> <p>Parameters:</p> Name Type Description Default <code>repo_url</code> <code>str</code> <p>The URL of a remote Git repo</p> required <code>repo_branch</code> <code>Optional[str]</code> <p>The name of the remote branch. Must be specified if <code>hash</code> is not specified.</p> <code>None</code> <code>repo_hash</code> <code>Optional[str]</code> <p>The hash of the revision. Must be specified if <code>branch</code> is not specified.</p> <code>None</code> <p>Returns:</p> Type Description <code>RemoteRepo</code> <p>A remote repo instance</p>"},{"location":"docs/reference/api/python/#dstack.api.VirtualRepo","title":"<code>dstack.api.VirtualRepo</code>","text":"<p>Allows mounting a repo created programmatically.</p> <p>Example:</p> <pre><code>virtual_repo = VirtualRepo(repo_id=\"some-unique-repo-id\")\nvirtual_repo.add_file_from_package(package=some_package, path=\"requirements.txt\")\nvirtual_repo.add_file_from_package(package=some_package, path=\"train.py\")\n\nrun = client.runs.submit(\n    configuration=...,\n    repo=virtual_repo,\n)\n</code></pre> <p>Attributes:</p> Name Type Description <code>repo_id</code> <p>A unique identifier of the repo</p>"},{"location":"docs/reference/api/python/#dstack.api.VirtualRepo.add_file","title":"<code>add_file(path, content)</code>","text":"<p>Adds a given file to the repo.</p> <p>Attributes:</p> Name Type Description <code>path</code> <code>str</code> <p>The path inside the repo to add the file.</p> <code>content</code> <code>bytes</code> <p>The contents of the file.</p>"},{"location":"docs/reference/api/python/#dstack.api.VirtualRepo.add_file_from_package","title":"<code>add_file_from_package(package, path)</code>","text":"<p>Includes a file from a given package to the repo.</p> <p>Attributes:</p> Name Type Description <code>package</code> <code>Union[ModuleType, str]</code> <p>A package to include the file from.</p> <code>path</code> <code>str</code> <p>The path to the file to include to the repo. Must be relative to the package directory.</p>"},{"location":"docs/reference/api/python/#dstack.api.RegistryAuth","title":"<code>dstack.api.RegistryAuth</code>","text":""},{"location":"docs/reference/api/python/#username","title":"<code>username</code> -  The username.","text":""},{"location":"docs/reference/api/python/#password","title":"<code>password</code> -  The password or access token.","text":""},{"location":"docs/reference/api/python/#dstack.api.Scaling","title":"<code>dstack.api.Scaling</code>","text":""},{"location":"docs/reference/api/python/#metric","title":"<code>metric</code> -  The target metric to track. Currently, the only supported value is <code>rps</code> (meaning requests per second).","text":""},{"location":"docs/reference/api/python/#target","title":"<code>target</code> -  The target value of the metric. The number of replicas is calculated based on this number and automatically adjusts (scales up or down) as this metric changes.","text":""},{"location":"docs/reference/api/python/#scale_up_delay","title":"<code>scale_up_delay</code> - (Optional) The delay in seconds before scaling up. Defaults to <code>300</code>.","text":""},{"location":"docs/reference/api/python/#scale_down_delay","title":"<code>scale_down_delay</code> - (Optional) The delay in seconds before scaling down. Defaults to <code>600</code>.","text":""},{"location":"docs/reference/api/python/#dstack.api.BackendType","title":"<code>dstack.api.BackendType</code>","text":"<p>Attributes:</p> Name Type Description <code>AWS</code> <code>BackendType</code> <p>Amazon Web Services</p> <code>AZURE</code> <code>BackendType</code> <p>Microsoft Azure</p> <code>CUDO</code> <code>BackendType</code> <p>Cudo</p> <code>DSTACK</code> <code>BackendType</code> <p>dstack Sky</p> <code>GCP</code> <code>BackendType</code> <p>Google Cloud Platform</p> <code>DATACRUNCH</code> <code>BackendType</code> <p>DataCrunch</p> <code>KUBERNETES</code> <code>BackendType</code> <p>Kubernetes</p> <code>LAMBDA</code> <code>BackendType</code> <p>Lambda Cloud</p> <code>RUNPOD</code> <code>BackendType</code> <p>Runpod Cloud</p> <code>TENSORDOCK</code> <code>BackendType</code> <p>TensorDock Marketplace</p> <code>VASTAI</code> <code>BackendType</code> <p>Vast.ai Marketplace</p>"},{"location":"docs/reference/api/rest/","title":"REST API","text":""},{"location":"docs/reference/cli/","title":"CLI","text":""},{"location":"docs/reference/cli/#commands","title":"Commands","text":""},{"location":"docs/reference/cli/#dstack-server","title":"dstack server","text":"<p>This command starts the <code>dstack</code> server.</p> <pre><code>$ dstack server --help\nUsage: dstack server [-h] [--host HOST] [-p PORT] [-l LOG_LEVEL] [--default]\n                     [--no-default] [--token TOKEN]\n\nOptions:\n  -h, --help            Show this help message and exit\n  --host HOST           Bind socket to this host. Defaults to 127.0.0.1\n  -p, --port PORT       Bind socket to this port. Defaults to 3000.\n  -l, --log-level LOG_LEVEL\n                        Server logging level. Defaults to INFO.\n  --default             Update the default project configuration\n  --no-default          Do not update the default project configuration\n  --token TOKEN         The admin user token\n</code></pre>"},{"location":"docs/reference/cli/#dstack-init","title":"dstack init","text":"<p>This command must be called inside a folder before you can run <code>dstack apply</code>.</p> <p>Git credentials</p> <p>If the current folder is a remote Git repository, <code>dstack init</code> ensures that <code>dstack</code> can access it. By default, the command uses the remote repo's default Git credentials. These can be overridden with  <code>--git-identity</code> (private SSH key) or <code>--token</code> (OAuth token).</p> <pre><code>$ dstack init --help\nUsage: dstack init [-h] [--project PROJECT] [-t OAUTH_TOKEN]\n                   [--git-identity SSH_PRIVATE_KEY]\n                   [--ssh-identity SSH_PRIVATE_KEY] [--local]\n\nOptions:\n  -h, --help            Show this help message and exit\n  --project PROJECT     The name of the project\n  -t, --token OAUTH_TOKEN\n                        An authentication token for Git\n  --git-identity SSH_PRIVATE_KEY\n                        The private SSH key path to access the remote repo\n  --ssh-identity SSH_PRIVATE_KEY\n                        The private SSH key path for SSH tunneling\n  --local               Do not use git\n</code></pre> <p>User SSH key</p> <p>By default, <code>dstack</code> uses its own SSH key to access instances (<code>~/.dstack/ssh/id_rsa</code>).  It is possible to override this key via the <code>--ssh-identity</code> argument.</p>"},{"location":"docs/reference/cli/#dstack-apply","title":"dstack apply","text":"<p>This command applies a given configuration. If a resource does not exist, <code>dstack apply</code> creates the resource. If a resource exists, <code>dstack apply</code> updates the resource in-place or re-creates the resource if the update is not possible.</p> <pre><code>$ dstack apply --help\nUsage: dstack apply [--project NAME] [-h [TYPE]] [-f FILE] [--force] [-y]\n\nOptions:\n  --project NAME        The name of the project. Defaults to $DSTACK_PROJECT\n  -h, --help [TYPE]     Show this help message and exit.\n  -f, --file FILE       The path to the configuration file. Defaults to\n                        $PWD/.dstack.yml\n  --force               Force apply when no changes detected\n  -y, --yes             Do not ask for confirmation\n</code></pre>"},{"location":"docs/reference/cli/#dstack-delete","title":"dstack delete","text":"<p>This command deletes the resources defined by a given configuration.</p> <pre><code>$ dstack delete --help\nUsage: dstack delete [-h] [--project NAME] [-f FILE] [-y]\n\nOptions:\n  -h, --help            Show this help message and exit\n  --project NAME        The name of the project. Defaults to $DSTACK_PROJECT\n  -f, --file FILE       The path to the configuration file. Defaults to\n                        $PWD/.dstack.yml\n  -y, --yes             Do not ask for confirmation\n</code></pre> <p>NOTE:</p> <p>The <code>dstack delete</code> command currently supports only <code>gateway</code> configurations. Support for other configuration types is coming soon.</p>"},{"location":"docs/reference/cli/#dstack-ps","title":"dstack ps","text":"<p>This command shows the status of runs.</p> <pre><code>$ dstack ps --help\nUsage: dstack ps [-h] [--project NAME] [-a] [-v] [-w]\n\nOptions:\n  -h, --help      Show this help message and exit\n  --project NAME  The name of the project. Defaults to $DSTACK_PROJECT\n  -a, --all       Show all runs. By default, it only shows unfinished runs or\n                  the last finished.\n  -v, --verbose   Show more information about runs\n  -w, --watch     Watch statuses of runs in realtime\n</code></pre>"},{"location":"docs/reference/cli/#dstack-stop","title":"dstack stop","text":"<p>This command stops run(s) within the current repository.</p> <pre><code>$ dstack stop --help\nUsage: dstack stop [-h] [--project NAME] [-x] [-y] run_name\n\nPositional Arguments:\n  run_name\n\nOptions:\n  -h, --help      Show this help message and exit\n  --project NAME  The name of the project. Defaults to $DSTACK_PROJECT\n  -x, --abort\n  -y, --yes\n</code></pre>"},{"location":"docs/reference/cli/#dstack-logs","title":"dstack logs","text":"<p>This command shows the output of a given run within the current repository.</p> <pre><code>$ dstack logs --help\nUsage: dstack logs [-h] [--project NAME] [-d] [-a]\n                   [--ssh-identity SSH_PRIVATE_KEY] [--replica REPLICA]\n                   [--job JOB]\n                   run_name\n\nPositional Arguments:\n  run_name\n\nOptions:\n  -h, --help            Show this help message and exit\n  --project NAME        The name of the project. Defaults to $DSTACK_PROJECT\n  -d, --diagnose\n  -a, --attach          Set up an SSH tunnel, and print logs as they follow.\n  --ssh-identity SSH_PRIVATE_KEY\n                        The private SSH key path for SSH tunneling\n  --replica REPLICA     The relica number. Defaults to 0.\n  --job JOB             The job number inside the replica. Defaults to 0.\n</code></pre>"},{"location":"docs/reference/cli/#dstack-config","title":"dstack config","text":"<p>Both the CLI and API need to be configured with the server address, user token, and project name via <code>~/.dstack/config.yml</code>.</p> <p>At startup, the server automatically configures CLI and API with the server address, user token, and the default project name (<code>main</code>). This configuration is stored via <code>~/.dstack/config.yml</code>.</p> <p>To use CLI and API on different machines or projects, use the <code>dstack config</code> command.</p> <pre><code>$ dstack config --help\nUsage: dstack config [-h] [--project PROJECT] [--url URL] [--token TOKEN]\n                     [--default] [--remove] [--no-default]\n\nOptions:\n  -h, --help         Show this help message and exit\n  --project PROJECT  The name of the project to configure\n  --url URL          Server url\n  --token TOKEN      User token\n  --default          Set the project as default. It will be used when\n                     --project is omitted in commands.\n  --remove           Delete project configuration\n  --no-default       Do not prompt to set the project as default\n</code></pre>"},{"location":"docs/reference/cli/#dstack-fleet","title":"dstack fleet","text":"<p>Fleets enable efficient provisioning and management of clusters and instances.</p>"},{"location":"docs/reference/cli/#dstack-fleet-list","title":"dstack fleet list","text":"<p>The <code>dstack fleet list</code> command displays fleets and instances.</p> <pre><code>$ dstack fleet list --help\nUsage: dstack fleet list [-h] [-w] [-v]\n\nOptions:\n  -h, --help     show this help message and exit\n  -w, --watch    Update listing in realtime\n  -v, --verbose  Show more information\n</code></pre>"},{"location":"docs/reference/cli/#dstack-fleet-delete","title":"dstack fleet delete","text":"<p>The <code>dstack fleet delete</code> deletes fleets and instances. Cloud instances are terminated upon deletion.</p> <pre><code>$ dstack fleet delete --help\nUsage: dstack fleet delete [-h] [-i INSTANCE_NUM] [-y] name\n\nPositional Arguments:\n  name                  The name of the fleet\n\nOptions:\n  -h, --help            show this help message and exit\n  -i, --instance INSTANCE_NUM\n                        The instances to delete\n  -y, --yes             Don't ask for confirmation\n</code></pre>"},{"location":"docs/reference/cli/#dstack-gateway","title":"dstack gateway","text":"<p>A gateway is required for running services. It handles ingress traffic, authorization, domain mapping, model mapping for the OpenAI-compatible endpoint, and so on.</p>"},{"location":"docs/reference/cli/#dstack-gateway-list","title":"dstack gateway list","text":"<p>The <code>dstack gateway list</code> command displays the names and addresses of the gateways configured in the project.</p> <pre><code>$ dstack gateway list --help\nUsage: dstack gateway list [-h] [-w] [-v]\n\nOptions:\n  -h, --help     show this help message and exit\n  -w, --watch    Update listing in realtime\n  -v, --verbose  Show more information\n</code></pre>"},{"location":"docs/reference/cli/#dstack-gateway-create","title":"dstack gateway create","text":"<p>The <code>dstack gateway create</code> command creates a new gateway instance in the project.</p> <pre><code>$ dstack gateway create --help\nUsage: dstack gateway create [-h] --backend {aws,azure,gcp,kubernetes}\n                             --region REGION [--set-default] [--name NAME]\n                             --domain DOMAIN\n\nOptions:\n  -h, --help            show this help message and exit\n  --backend {aws,azure,gcp,kubernetes}\n  --region REGION\n  --set-default         Set as default gateway for the project\n  --name NAME           Set a custom name for the gateway\n  --domain DOMAIN       Set the domain for the gateway\n</code></pre>"},{"location":"docs/reference/cli/#dstack-gateway-delete","title":"dstack gateway delete","text":"<p>The <code>dstack gateway delete</code> command deletes the specified gateway.</p> <pre><code>$ dstack gateway delete --help\nUsage: dstack gateway delete [-h] [-y] name\n\nPositional Arguments:\n  name        The name of the gateway\n\nOptions:\n  -h, --help  show this help message and exit\n  -y, --yes   Don't ask for confirmation\n</code></pre>"},{"location":"docs/reference/cli/#dstack-gateway-update","title":"dstack gateway update","text":"<p>The <code>dstack gateway update</code> command updates the specified gateway.</p> <pre><code>$ dstack gateway update --help\nUsage: dstack gateway update [-h] [--set-default] [--domain DOMAIN] name\n\nPositional Arguments:\n  name             The name of the gateway\n\nOptions:\n  -h, --help       show this help message and exit\n  --set-default    Set it the default gateway for the project\n  --domain DOMAIN  Set the domain for the gateway\n</code></pre>"},{"location":"docs/reference/cli/#dstack-volume","title":"dstack volume","text":"<p>The volumes commands.</p>"},{"location":"docs/reference/cli/#dstack-volume-list","title":"dstack volume list","text":"<p>The <code>dstack volume list</code> command lists volumes.</p> <pre><code>$ dstack volume list --help\nUsage: dstack volume list [-h] [-w] [-v]\n\nOptions:\n  -h, --help     show this help message and exit\n  -w, --watch    Update listing in realtime\n  -v, --verbose  Show more information\n</code></pre>"},{"location":"docs/reference/cli/#dstack-volume-delete","title":"dstack volume delete","text":"<p>The <code>dstack volume delete</code> command deletes volumes.</p> <pre><code>$ dstack volume delete --help\nUsage: dstack volume delete [-h] [-y] name\n\nPositional Arguments:\n  name        The name of the volume\n\nOptions:\n  -h, --help  show this help message and exit\n  -y, --yes   Don't ask for confirmation\n</code></pre>"},{"location":"docs/reference/cli/#dstack-run","title":"dstack run","text":"<p>This command runs a given configuration.</p> <p>Deprecation</p> <p><code>dstack run</code> is deprecated in favor of <code>dstack apply</code>.</p> <pre><code>$ dstack run . --help\nUsage: dstack run [--project NAME] [-h [TYPE]] [-f FILE] [-y] [-n RUN_NAME]\n                  [-d] [--max-offers MAX_OFFERS] [-e KEY=VALUE] [--gpu SPEC]\n                  [--disk RANGE] [--profile NAME] [--max-price PRICE]\n                  [--max-duration DURATION] [-b NAME] [-r NAME]\n                  [--instance-type NAME]\n                  [--pool POOL_NAME | --reuse | --dont-destroy | --idle-duration IDLE_DURATION | --instance NAME]\n                  [--spot | --on-demand | --spot-auto | --spot-policy POLICY]\n                  [--retry | --no-retry | --retry-duration DURATION]\n                  working_dir\n\nPositional Arguments:\n  working_dir\n\nOptions:\n  --project NAME        The name of the project. Defaults to $DSTACK_PROJECT\n  -h, --help [TYPE]     Show this help message and exit. TYPE is one of task,\n                        dev-environment, service\n  -f, --file FILE       The path to the configuration file. Defaults to\n                        $PWD/.dstack.yml\n  -y, --yes             Do not ask for confirmation\n  -n, --name RUN_NAME   The name of the run. If not specified, a random name\n                        is assigned\n  -d, --detach          Do not poll logs and run status\n  --max-offers MAX_OFFERS\n                        Number of offers to show in the run plan\n  -e, --env KEY=VALUE   Environment variables\n  --gpu SPEC            Request GPU for the run. The format is\n                        NAME:COUNT:MEMORY (all parts are optional)\n  --disk RANGE          Request the size range of disk for the run. Example\n                        --disk 100GB...\n\nProfile:\n  --profile NAME        The name of the profile. Defaults to $DSTACK_PROFILE\n  --max-price PRICE     The maximum price per hour, in dollars\n  --max-duration DURATION\n                        The maximum duration of the run\n  -b, --backend NAME    The backends that will be tried for provisioning\n  -r, --region NAME     The regions that will be tried for provisioning\n  --instance-type NAME  The cloud-specific instance types that will be tried\n                        for provisioning\n\nPools:\n  --pool POOL_NAME      The name of the pool. If not set, the default pool\n                        will be used\n  --reuse               Reuse instance from pool\n  --dont-destroy        Do not destroy instance after the run is finished\n  --idle-duration IDLE_DURATION\n                        Time to wait before destroying the idle instance\n  --instance NAME       Reuse instance from pool with name NAME\n\nSpot Policy:\n  --spot                Consider only spot instances\n  --on-demand           Consider only on-demand instances\n  --spot-auto           Consider both spot and on-demand instances\n  --spot-policy POLICY  One of spot, on-demand, auto\n\nRetry Policy:\n  --retry\n  --no-retry\n  --retry-duration DURATION\n</code></pre> .gitignore <p>When running anything via CLI, <code>dstack</code> uses the exact version of code from your project directory.</p> <p>If there are large files, consider creating a <code>.gitignore</code> file to exclude them for better performance.</p>"},{"location":"docs/reference/cli/#dstack-pool","title":"dstack pool","text":"<p>Pools allow for managing the lifecycle of instances and reusing them across runs.  The default pool is created automatically.</p> <p>Deprecation</p> <p>Pools are deprecated in favor of fleets and will be removed in 0.19.0.</p>"},{"location":"docs/reference/cli/#dstack-pool-add","title":"dstack pool add","text":"<p>The <code>dstack pool add</code> command provisions a cloud instance and adds it to a pool. If no pool name is specified, the instance goes to the default pool.</p> <pre><code>$ dstack pool add --help\nUsage: dstack pool add [-h] [-y] [--profile NAME] [--max-price PRICE]\n                       [-b NAME] [-r NAME] [--instance-type NAME]\n                       [--pool POOL_NAME] [--reuse] [--dont-destroy]\n                       [--idle-duration IDLE_DURATION]\n                       [--spot | --on-demand | --spot-auto | --spot-policy POLICY]\n                       [--retry | --no-retry | --retry-duration DURATION]\n                       [--cpu SPEC] [--memory SIZE] [--shared-memory SIZE]\n                       [--gpu SPEC] [--disk SIZE]\n\nOptions:\n  -h, --help            show this help message and exit\n  -y, --yes             Don't ask for confirmation\n  --pool POOL_NAME      The name of the pool. If not set, the default pool\n                        will be used\n  --reuse               Reuse instance from pool\n  --dont-destroy        Do not destroy instance after the run is finished\n  --idle-duration IDLE_DURATION\n                        Time to wait before destroying the idle instance\n\nProfile:\n  --profile NAME        The name of the profile. Defaults to $DSTACK_PROFILE\n  --max-price PRICE     The maximum price per hour, in dollars\n  -b, --backend NAME    The backends that will be tried for provisioning\n  -r, --region NAME     The regions that will be tried for provisioning\n  --instance-type NAME  The cloud-specific instance types that will be tried\n                        for provisioning\n\nSpot Policy:\n  --spot                Consider only spot instances\n  --on-demand           Consider only on-demand instances\n  --spot-auto           Consider both spot and on-demand instances\n  --spot-policy POLICY  One of spot, on-demand, auto\n\nRetry Policy:\n  --retry\n  --no-retry\n  --retry-duration DURATION\n\nResources:\n  --cpu SPEC            Request the CPU count. Default: 2..\n  --memory SIZE         Request the size of RAM. The format is SIZE:MB|GB|TB.\n                        Default: 8GB..\n  --shared-memory SIZE  Request the size of Shared Memory. The format is\n                        SIZE:MB|GB|TB.\n  --gpu SPEC            Request GPU for the run. The format is\n                        NAME:COUNT:MEMORY (all parts are optional)\n  --disk SIZE           Request the size of disk for the run. Example --disk\n                        100GB...\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-add-ssh","title":"dstack pool add-ssh","text":"<p>The <code>dstack pool add-ssh</code> command adds an existing remote instance to a pool. If no pool name is specified, the instance goes to the default pool.</p> <pre><code>$ dstack pool add-ssh --help\nUsage: dstack pool add-ssh [-h] -i SSH_PRIVATE_KEY [-p SSH_PORT]\n                           [-l LOGIN_NAME] [--region REGION]\n                           [--pool POOL_NAME] [--name INSTANCE_NAME]\n                           [--network NETWORK]\n                           destination\n\nPositional Arguments:\n  destination\n\nOptions:\n  -h, --help            show this help message and exit\n  -i SSH_PRIVATE_KEY    The private SSH key path for SSH\n  -p SSH_PORT           SSH port to connect\n  -l LOGIN_NAME         User to login\n  --region REGION       Host region\n  --pool POOL_NAME      Pool name\n  --name INSTANCE_NAME  Set the name of the instance\n  --network NETWORK     Network address for multinode setup. Format &lt;ip\n                        address&gt;/&lt;netmask&gt;\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-ps","title":"dstack pool ps","text":"<p>The <code>dstack pool ps</code> command lists all active instances of a pool. If no pool name is specified, default pool instances are displayed.</p> <pre><code>$ dstack pool ps --help\nUsage: dstack pool ps [-h] [--pool POOL_NAME] [-w]\n\nShow instances in the pool\n\nOptions:\n  -h, --help        show this help message and exit\n  --pool POOL_NAME  The name of the pool. If not set, the default pool will be\n                    used\n  -w, --watch       Watch instances in realtime\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-rm","title":"dstack pool rm","text":"<p>The <code>dstack pool rm</code> command removes an instance from a pool. Cloud instances are terminated upon removal.</p> <pre><code>$ dstack pool rm --help\nUsage: dstack pool rm [-h] [--pool POOL_NAME] [--force] [-y] instance_name\n\nPositional Arguments:\n  instance_name     The name of the instance\n\nOptions:\n  -h, --help        show this help message and exit\n  --pool POOL_NAME  The name of the pool. If not set, the default pool will be\n                    used\n  --force           The name of the instance\n  -y, --yes         Don't ask for confirmation\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-create","title":"dstack pool create","text":"<p>The <code>dstack pool create</code> command creates a new pool.</p> <pre><code>$ dstack pool create --help\nUsage: dstack pool create [-h] -n POOL_NAME\n\nOptions:\n  -h, --help            show this help message and exit\n  -n, --name POOL_NAME  The name of the pool\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-list","title":"dstack pool list","text":"<p>The <code>dstack pool list</code> command lists all existing pools.</p> <pre><code>$ dstack pool list --help\nUsage: dstack pool list [-h] [-v VERBOSE]\n\nList available pools\n\nOptions:\n  -h, --help            show this help message and exit\n  -v, --verbose VERBOSE\n                        Show more information\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-set-default","title":"dstack pool set-default","text":"<p>The <code>dstack pool set-default</code> command sets the project's default pool.</p> <pre><code>$ dstack pool set-default --help\nUsage: dstack pool set-default [-h] --pool POOL_NAME\n\nOptions:\n  -h, --help        show this help message and exit\n  --pool POOL_NAME  The name of the pool\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-delete","title":"dstack pool delete","text":"<p>The <code>dstack pool delete</code> command deletes a specified pool.</p> <pre><code>$ dstack pool delete --help\nUsage: dstack pool delete [-h] -n POOL_NAME\n\nOptions:\n  -h, --help            show this help message and exit\n  -n, --name POOL_NAME  The name of the pool\n</code></pre>"},{"location":"docs/reference/cli/#environment-variables","title":"Environment variables","text":"<ul> <li><code>DSTACK_CLI_LOG_LEVEL</code> \u2013 (Optional) Configures CLI logging level. Defaults to <code>INFO</code>.</li> <li><code>DSTACK_SERVER_LOG_LEVEL</code> \u2013 (Optional) Has the same effect as <code>--log-level</code>. Defaults to <code>INFO</code>.</li> <li><code>DSTACK_SERVER_HOST</code> \u2013 (Optional) Has the same effect as <code>--host</code>. Defaults to <code>127.0.0.1</code>.</li> <li><code>DSTACK_SERVER_PORT</code> \u2013 (Optional) Has the same effect as <code>--port</code>. Defaults to <code>3000</code>.</li> <li><code>DSTACK_SERVER_ADMIN_TOKEN</code> \u2013 (Optional) Has the same effect as <code>--token</code>. Defaults to <code>None</code>.</li> <li><code>DSTACK_DATABASE_URL</code> \u2013 (Optional) The database URL to use instead of default SQLite. Currently <code>dstack</code> supports Postgres. Example: <code>postgresql+asyncpg://myuser:mypassword@localhost:5432/mydatabase</code>. Defaults to <code>None</code>.</li> <li><code>DSTACK_SERVER_DIR</code> \u2013 (Optional) Sets path to store data and server configs. Defaults to <code>~/.dstack/server</code>.</li> </ul> Internal environment variables <ul> <li><code>DSTACK_SERVER_ROOT_LOG_LEVEL</code> \u2013 (Optional) Sets root logger log level. Defaults to <code>ERROR</code>.</li> <li><code>DSTACK_SERVER_LOG_FORMAT</code> \u2013 (Optional) Sets format of log output. Can be <code>rich</code>, <code>standard</code>, <code>json</code>.. Defaults to <code>rich</code>.</li> <li><code>DSTACK_SERVER_UVICORN_LOG_LEVEL</code> \u2013 (Optional) Sets uvicorn logger log level. Defaults to <code>ERROR</code>.</li> <li><code>DSTACK_PROFILE</code> \u2013 (Optional) Has the same effect as <code>--profile</code>. Defaults to <code>None</code>.</li> <li><code>DSTACK_PROJECT</code> \u2013 (Optional) Has the same effect as <code>--project</code>. Defaults to <code>None</code>.</li> <li><code>DSTACK_RUNNER_VERSION</code> \u2013 (Optional) Sets exact runner version for debug. Defaults to <code>latest</code>.</li> <li><code>DSTACK_DEFAULT_CREDS_DISABLED</code> \u2013 (Optional) Disables default credentials detection if set. Defaults to <code>None</code>.</li> <li><code>DSTACK_LOCAL_BACKEND_ENABLED</code> \u2013 (Optional) Enables local backend for debug if set. Defaults to <code>None</code>.</li> </ul>"},{"location":"docs/reference/dstack.yml/dev-environment/","title":"dev-environment","text":"<p>The <code>dev-environment</code> configuration type allows running dev environments.</p> <p>Configuration files must have a name ending with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>serve.dstack.yml</code> are both acceptable) and can be located in the project's root directory or any nested folder. Any configuration can be run via <code>dstack run</code>.</p>"},{"location":"docs/reference/dstack.yml/dev-environment/#examples","title":"Examples","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#python-version","title":"Python version","text":"<p>If you don't specify <code>image</code>, <code>dstack</code> uses the default Docker image pre-configured with  <code>python</code>, <code>pip</code>, <code>conda</code> (Miniforge), and essential CUDA drivers.  The <code>python</code> property determines which default Docker image is used.</p> <pre><code>type: dev-environment\n\npython: \"3.11\"\n\nide: vscode\n</code></pre> <p>nvcc</p> <p>Note that the default Docker image doesn't bundle <code>nvcc</code>, which is required for building custom CUDA kernels.  To install it, use <code>conda install cuda</code>.</p>"},{"location":"docs/reference/dstack.yml/dev-environment/#docker-image","title":"Docker image","text":"<pre><code>type: dev-environment\n\nimage: ghcr.io/huggingface/text-generation-inference:latest\n\nide: vscode\n</code></pre> Private registry <p>Use the <code>registry_auth</code> property to provide credentials for a private Docker registry. </p> <pre><code>type: dev-environment\n\nimage: ghcr.io/huggingface/text-generation-inference:latest\nregistry_auth:\n  username: peterschmidt85\n  password: ghp_e49HcZ9oYwBzUbcSk2080gXZOU2hiT9AeSR5\n\nide: vscode\n</code></pre>"},{"location":"docs/reference/dstack.yml/dev-environment/#_resources","title":"Resources","text":"<p>If you specify memory size, you can either specify an explicit size (e.g. <code>24GB</code>) or a  range (e.g. <code>24GB..</code>, or <code>24GB..80GB</code>, or <code>..80GB</code>).</p> <pre><code>type: dev-environment\n\nide: vscode\n\nresources:\n  # 200GB or more RAM\n  memory: 200GB..\n\n  # 4 GPUs from 40GB to 80GB\n  gpu: 40GB..80GB:4\n\n  # Shared memory\n  shm_size: 16GB\n\n  disk: 500GB\n</code></pre> <p>The <code>gpu</code> property allows specifying not only memory size but also GPU names and their quantity. Examples: <code>A100</code> (one A100), <code>A10G,A100</code> (either A10G or A100),  <code>A100:80GB</code> (one A100 of 80GB), <code>A100:2</code> (two A100), <code>24GB..40GB:2</code> (two GPUs between 24GB and 40GB),  <code>A100:40GB:2</code> (two A100 GPUs of 40GB).</p> Google Cloud TPU <p>To use TPUs, specify its architecture prefixed by <code>tpu-</code> via the <code>gpu</code> property.</p> <pre><code>type: dev-environment\n\nide: vscode\n\nresources:\n  gpu:  tpu-v2-8\n</code></pre> <p>Currently, only 8 TPU cores can be specified, supporting single TPU device workloads. Multi-TPU support is coming soon.</p> Shared memory <p>If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure  <code>shm_size</code>, e.g. set it to <code>16GB</code>.</p>"},{"location":"docs/reference/dstack.yml/dev-environment/#environment-variables","title":"Environment variables","text":"<pre><code>type: dev-environment\n\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - HF_HUB_ENABLE_HF_TRANSFER=1\n\nide: vscode\n</code></pre> <p>If you don't assign a value to an environment variable (see <code>HUGGING_FACE_HUB_TOKEN</code> above),  <code>dstack</code> will require the value to be passed via the CLI or set in the current process.</p> <p>For instance, you can define environment variables in a <code>.env</code> file and utilize tools like <code>direnv</code>.</p>"},{"location":"docs/reference/dstack.yml/dev-environment/#default-environment-variables","title":"Default environment variables","text":"<p>The following environment variables are available in any run and are passed by <code>dstack</code> by default:</p> Name Description <code>DSTACK_RUN_NAME</code> The name of the run <code>DSTACK_REPO_ID</code> The ID of the repo <code>DSTACK_GPUS_NUM</code> The total number of GPUs in the run"},{"location":"docs/reference/dstack.yml/dev-environment/#spot-policy","title":"Spot policy","text":"<p>You can choose whether to use spot instances, on-demand instances, or any available type.</p> <pre><code>type: dev-environment\n\nide: vscode\n\nspot_policy: auto\n</code></pre> <p>The <code>spot_policy</code> accepts <code>spot</code>, <code>on-demand</code>, and <code>auto</code>. The default for dev environments is <code>on-demand</code>.</p>"},{"location":"docs/reference/dstack.yml/dev-environment/#backends_1","title":"Backends","text":"<p>By default, <code>dstack</code> provisions instances in all configured backends. However, you can specify the list of backends:</p> <pre><code>type: dev-environment\n\nide: vscode\n\nbackends: [aws, gcp]\n</code></pre>"},{"location":"docs/reference/dstack.yml/dev-environment/#regions_1","title":"Regions","text":"<p>By default, <code>dstack</code> uses all configured regions. However, you can specify the list of regions:</p> <pre><code>type: dev-environment\n\nide: vscode\n\nregions: [eu-west-1, eu-west-2]\n</code></pre>"},{"location":"docs/reference/dstack.yml/dev-environment/#volumes","title":"Volumes","text":"<p>Volumes allow you to persist data between runs. To attach a volume, simply specify its name using the <code>volumes</code> property and specify where to mount its contents:</p> <pre><code>type: dev-environment\n\nide: vscode\n\nvolumes:\n  - name: my-new-volume\n    path: /volume_data\n</code></pre> <p>Once you run this configuration, the contents of the volume will be attached to <code>/volume_data</code> inside the dev environment, and its contents will persist across runs.</p> <p>Limitations</p> <p>When you're running a dev environment, task, or service with <code>dstack</code>, it automatically mounts the project folder contents to <code>/workflow</code> (and sets that as the current working directory). Right now, <code>dstack</code> doesn't allow you to  attach volumes to <code>/workflow</code> or any of its subdirectories.</p> <p>The <code>dev-environment</code> configuration type supports many other options. See below.</p>"},{"location":"docs/reference/dstack.yml/dev-environment/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#ide","title":"<code>ide</code> -  The IDE to run.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#version","title":"<code>version</code> - (Optional) The version of the IDE.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#init","title":"<code>init</code> - (Optional) The bash commands to run.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#name","title":"<code>name</code> - (Optional) The run name.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#image","title":"<code>image</code> - (Optional) The name of the Docker image to run.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#entrypoint","title":"<code>entrypoint</code> - (Optional) The Docker entrypoint.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#working_dir","title":"<code>working_dir</code> - (Optional) The path to the working directory inside the container. It's specified relative to the repository directory (<code>/workflow</code>) and should be inside it. Defaults to <code>\".\"</code> .","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#home_dir","title":"<code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_registry_auth","title":"<code>registry_auth</code> - (Optional) Credentials for pulling a private Docker image.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#python","title":"<code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#env","title":"<code>env</code> - (Optional) The mapping or the list of environment variables.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#setup","title":"<code>setup</code> - (Optional) The bash commands to run on the boot.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_resources","title":"<code>resources</code> - (Optional) The resources requirements to run the configuration.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_volumes","title":"<code>volumes</code> - (Optional) The volumes mount points.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#ports","title":"<code>ports</code> - (Optional) Port numbers/mapping to expose.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_retry","title":"<code>retry</code> - (Optional) The policy for resubmitting the run. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_retry_policy","title":"<code>retry_policy</code> - (Optional) The policy for resubmitting the run. Deprecated in favor of <code>retry</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#max_duration","title":"<code>max_duration</code> - (Optional) The maximum duration of a run (e.g., <code>2h</code>, <code>1d</code>, etc). After it elapses, the run is forced to stop. Defaults to <code>off</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#pool_name","title":"<code>pool_name</code> - (Optional) The name of the pool. If not set, dstack will use the default name.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#instance_name","title":"<code>instance_name</code> - (Optional) The name of the instance.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#creation_policy","title":"<code>creation_policy</code> - (Optional) The policy for using instances from the pool. Defaults to <code>reuse-or-create</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying the idle instance. Defaults to <code>5m</code> for <code>dstack run</code> and to <code>3d</code> for <code>dstack pool add</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#resources","title":"<code>resources</code>","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#cpu","title":"<code>cpu</code> - (Optional) The number of CPU cores. Defaults to <code>2..</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>8GB</code>). Defaults to <code>8GB..</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#shm_size","title":"<code>shm_size</code> - (Optional) The size of shared memory (e.g., <code>8GB</code>). If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure this.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_gpu","title":"<code>gpu</code> - (Optional) The GPU requirements. Can be set to a number, a string (e.g. <code>A100</code>, <code>80GB:2</code>, etc.), or an object.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_disk","title":"<code>disk</code> - (Optional) The disk resources.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#resources-gpu","title":"<code>resources.gpu</code>","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#name","title":"<code>name</code> - (Optional) The GPU name or list of names.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#count","title":"<code>count</code> - (Optional) The number of GPUs. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>16GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#total_memory","title":"<code>total_memory</code> - (Optional) The total RAM size (e.g., <code>32GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#compute_capability","title":"<code>compute_capability</code> - (Optional) The minimum compute capability of the GPU (e.g., <code>7.5</code>).","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#resources-disk","title":"<code>resources.disk</code>","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#size","title":"<code>size</code> -  The disk size. Can be a string (e.g., <code>100GB</code> or <code>100GB..</code>) or an object.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#registry_auth","title":"<code>registry_auth</code>","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#username","title":"<code>username</code> -  The username.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#password","title":"<code>password</code> -  The password or access token.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#volumes_1","title":"<code>volumes</code>","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#name","title":"<code>name</code> -  The name of the volume to mount.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#path","title":"<code>path</code> -  The container path to mount the volume at.","text":""},{"location":"docs/reference/dstack.yml/fleet/","title":"fleet","text":"<p>The <code>fleet</code> configuration type allows creating and updating fleets.</p> <p>Configuration files must have a name ending with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>fleet.dstack.yml</code> are both acceptable) and can be located in the project's root directory or any nested folder. Any configuration can be applied via <code>dstack apply</code>.</p>"},{"location":"docs/reference/dstack.yml/fleet/#examples","title":"Examples","text":""},{"location":"docs/reference/dstack.yml/fleet/#create-cloud-fleet","title":"Creating a cloud fleet","text":"<pre><code>type: fleet\nname: my-gcp-fleet\nnodes: 4\nplacement: cluster\nbackends: [gcp]\nresources:\n  gpu: 1\n</code></pre>"},{"location":"docs/reference/dstack.yml/fleet/#create-ssh-fleet","title":"Creating an on-prem fleet","text":"<pre><code>type: fleet\nname: my-ssh-fleet\nssh_config:\n  user: ubuntu\n  identity_file: ~/.ssh/id_rsa\n  hosts:\n    - 3.255.177.51\n    - 3.255.177.52\n</code></pre>"},{"location":"docs/reference/dstack.yml/fleet/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/dstack.yml/fleet/#name","title":"<code>name</code> - (Optional) The fleet name.","text":""},{"location":"docs/reference/dstack.yml/fleet/#_ssh_config","title":"<code>ssh_config</code> - (Optional) The parameters for adding instances via SSH.","text":""},{"location":"docs/reference/dstack.yml/fleet/#nodes","title":"<code>nodes</code> - (Optional) The number of instances.","text":""},{"location":"docs/reference/dstack.yml/fleet/#placement","title":"<code>placement</code> - (Optional) The placement of instances: <code>any</code> or <code>cluster</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#_resources","title":"<code>resources</code> - (Optional) The resources requirements.","text":""},{"location":"docs/reference/dstack.yml/fleet/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/dstack.yml/fleet/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/dstack.yml/fleet/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/dstack.yml/fleet/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#_retry","title":"<code>retry</code> - (Optional) The policy for provisioning retry. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/dstack.yml/fleet/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying idle instances. Defaults to <code>3d</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#ssh","title":"<code>ssh</code>","text":""},{"location":"docs/reference/dstack.yml/fleet/#user","title":"<code>user</code> - (Optional) The user to log in with on all hosts.","text":""},{"location":"docs/reference/dstack.yml/fleet/#port","title":"<code>port</code> - (Optional) The SSH port to connect to.","text":""},{"location":"docs/reference/dstack.yml/fleet/#identity_file","title":"<code>identity_file</code> - (Optional) The private key to use for all hosts.","text":""},{"location":"docs/reference/dstack.yml/fleet/#hosts","title":"<code>hosts</code> -  The per host connection parameters: a hostname or an object that overrides default ssh parameters.","text":""},{"location":"docs/reference/dstack.yml/fleet/#network","title":"<code>network</code> - (Optional) The network address for cluster setup in the format <code>&lt;ip&gt;/&lt;netmask&gt;</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#sshhostsn","title":"<code>ssh.hosts[n]</code>","text":""},{"location":"docs/reference/dstack.yml/fleet/#hostname","title":"<code>hostname</code> -  The IP address or domain to connect to.","text":""},{"location":"docs/reference/dstack.yml/fleet/#port","title":"<code>port</code> - (Optional) The SSH port to connect to for this host.","text":""},{"location":"docs/reference/dstack.yml/fleet/#user","title":"<code>user</code> - (Optional) The user to log in with for this host.","text":""},{"location":"docs/reference/dstack.yml/fleet/#identity_file","title":"<code>identity_file</code> - (Optional) The private key to use for this host.","text":""},{"location":"docs/reference/dstack.yml/fleet/#resources","title":"<code>resources</code>","text":""},{"location":"docs/reference/dstack.yml/fleet/#cpu","title":"<code>cpu</code> - (Optional) The number of CPU cores. Defaults to <code>2..</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>8GB</code>). Defaults to <code>8GB..</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#shm_size","title":"<code>shm_size</code> - (Optional) The size of shared memory (e.g., <code>8GB</code>). If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure this.","text":""},{"location":"docs/reference/dstack.yml/fleet/#_gpu","title":"<code>gpu</code> - (Optional) The GPU requirements. Can be set to a number, a string (e.g. <code>A100</code>, <code>80GB:2</code>, etc.), or an object.","text":""},{"location":"docs/reference/dstack.yml/fleet/#_disk","title":"<code>disk</code> - (Optional) The disk resources.","text":""},{"location":"docs/reference/dstack.yml/fleet/#resources-gpu","title":"<code>resouces.gpu</code>","text":""},{"location":"docs/reference/dstack.yml/fleet/#name","title":"<code>name</code> - (Optional) The GPU name or list of names.","text":""},{"location":"docs/reference/dstack.yml/fleet/#count","title":"<code>count</code> - (Optional) The number of GPUs. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>16GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/fleet/#total_memory","title":"<code>total_memory</code> - (Optional) The total RAM size (e.g., <code>32GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/fleet/#compute_capability","title":"<code>compute_capability</code> - (Optional) The minimum compute capability of the GPU (e.g., <code>7.5</code>).","text":""},{"location":"docs/reference/dstack.yml/fleet/#resources-disk","title":"<code>resouces.disk</code>","text":""},{"location":"docs/reference/dstack.yml/fleet/#size","title":"<code>size</code> -  The disk size. Can be a string (e.g., <code>100GB</code> or <code>100GB..</code>) or an object.","text":""},{"location":"docs/reference/dstack.yml/fleet/#retry","title":"<code>retry</code>","text":""},{"location":"docs/reference/dstack.yml/fleet/#on_events","title":"<code>on_events</code> -  The list of events that should be handled with retry. Supported events are <code>no-capacity</code>, <code>interruption</code>, and <code>error</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#duration","title":"<code>duration</code> - (Optional) The maximum period of retrying the run, e.g., <code>4h</code> or <code>1d</code>.","text":""},{"location":"docs/reference/dstack.yml/gateway/","title":"gateway","text":"<p>The <code>gateway</code> configuration type allows creating and updating gateways.</p> <p>Configuration files must have a name ending with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>gateway.dstack.yml</code> are both acceptable) and can be located in the project's root directory or any nested folder. Any configuration can be applied via <code>dstack apply</code>.</p>"},{"location":"docs/reference/dstack.yml/gateway/#examples","title":"Examples","text":"<pre><code>type: gateway\nname: example-gateway\n\nbackend: aws\nregion: eu-west-1\ndomain: example.com\n</code></pre>"},{"location":"docs/reference/dstack.yml/gateway/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/dstack.yml/gateway/#name","title":"<code>name</code> - (Optional) The gateway name.","text":""},{"location":"docs/reference/dstack.yml/gateway/#default","title":"<code>default</code> - (Optional) Make the gateway default.","text":""},{"location":"docs/reference/dstack.yml/gateway/#backend","title":"<code>backend</code> -  The gateway backend.","text":""},{"location":"docs/reference/dstack.yml/gateway/#region","title":"<code>region</code> -  The gateway region.","text":""},{"location":"docs/reference/dstack.yml/gateway/#domain","title":"<code>domain</code> - (Optional) The gateway domain, e.g. <code>example.com</code>.","text":""},{"location":"docs/reference/dstack.yml/gateway/#public_ip","title":"<code>public_ip</code> - (Optional) Allocate public IP for the gateway. Defaults to <code>True</code>.","text":""},{"location":"docs/reference/dstack.yml/gateway/#_certificate","title":"<code>certificate</code> - (Optional) The SSL certificate configuration. Defaults to <code>type: lets-encrypt</code>.","text":""},{"location":"docs/reference/dstack.yml/gateway/#certificatetypelets-encrypt","title":"<code>certificate[type=lets-encrypt]</code>","text":""},{"location":"docs/reference/dstack.yml/gateway/#type","title":"<code>type</code> -  Automatic certificates by Let's Encrypt. Must be <code>lets-encrypt</code>.","text":""},{"location":"docs/reference/dstack.yml/gateway/#certificatetypeacm","title":"<code>certificate[type=acm]</code>","text":""},{"location":"docs/reference/dstack.yml/gateway/#type","title":"<code>type</code> -  Certificates by AWS Certificate Manager (ACM). Must be <code>acm</code>.","text":""},{"location":"docs/reference/dstack.yml/gateway/#arn","title":"<code>arn</code> -  The ARN of the wildcard ACM certificate for the domain.","text":""},{"location":"docs/reference/dstack.yml/service/","title":"service","text":"<p>The <code>service</code> configuration type allows running services.</p> <p>Configuration files must have a name ending with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>serve.dstack.yml</code> are both acceptable) and can be located in the project's root directory or any nested folder. Any configuration can be run via <code>dstack run . -f PATH</code>.</p>"},{"location":"docs/reference/dstack.yml/service/#examples","title":"Examples","text":""},{"location":"docs/reference/dstack.yml/service/#python-version","title":"Python version","text":"<p>If you don't specify <code>image</code>, <code>dstack</code> uses the default Docker image pre-configured with  <code>python</code>, <code>pip</code>, <code>conda</code> (Miniforge), and essential CUDA drivers.  The <code>python</code> property determines which default Docker image is used.</p> <pre><code>type: service\n\npython: \"3.11\"\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n</code></pre> <p>nvcc</p> <p>Note that the default Docker image doesn't bundle <code>nvcc</code>, which is required for building custom CUDA kernels.  To install it, use <code>conda install cuda</code>.</p>"},{"location":"docs/reference/dstack.yml/service/#docker-image","title":"Docker image","text":"<pre><code>type: service\n\nimage: dstackai/base:py3.11-0.4-cuda-12.1\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n</code></pre> Private Docker registry <p>Use the <code>registry_auth</code> property to provide credentials for a private Docker registry.</p> <pre><code>type: service\n\nimage: dstackai/base:py3.11-0.4-cuda-12.1\n\ncommands:\n  - python3 -m http.server\nregistry_auth:\n  username: peterschmidt85\n  password: ghp_e49HcZ9oYwBzUbcSk2080gXZOU2hiT9AeSR5\n\nport: 8000\n</code></pre>"},{"location":"docs/reference/dstack.yml/service/#model-mapping","title":"OpenAI-compatible interface","text":"<p>By default, if you run a service, its endpoint is accessible at <code>https://&lt;run name&gt;.&lt;gateway domain&gt;</code>.</p> <p>If you run a model, you can optionally configure the mapping to make it accessible via the  OpenAI-compatible interface.</p> <pre><code>type: service\n\npython: \"3.11\"\n\nenv:\n  - MODEL=NousResearch/Llama-2-7b-chat-hf\ncommands:\n  - pip install vllm\n  - python -m vllm.entrypoints.openai.api_server --model $MODEL --port 8000\nport: 8000\n\nresources:\n  gpu: 24GB\n\n# Enable the OpenAI-compatible endpoint\nmodel:\n  format: openai\n  type: chat\n  name: NousResearch/Llama-2-7b-chat-hf\n</code></pre> <p>In this case, with such a configuration, once the service is up, you'll be able to access the model at <code>https://gateway.&lt;gateway domain&gt;</code> via the OpenAI-compatible interface.</p> <p>The <code>format</code> supports only <code>tgi</code> (Text Generation Inference) and <code>openai</code> (if you are using Text Generation Inference or vLLM with OpenAI-compatible mode).</p> Chat template <p>By default, <code>dstack</code> loads the chat template from the model's repository. If it is not present there, manual configuration is required.</p> <pre><code>type: service\n\nimage: ghcr.io/huggingface/text-generation-inference:latest\nenv:\n  - MODEL_ID=TheBloke/Llama-2-13B-chat-GPTQ\ncommands:\n  - text-generation-launcher --port 8000 --trust-remote-code --quantize gptq\nport: 8000\n\nresources:\n  gpu: 80GB\n\n# Enable the OpenAI-compatible endpoint\nmodel:\n  type: chat\n  name: TheBloke/Llama-2-13B-chat-GPTQ\n  format: tgi\n  chat_template: \"{% if messages[0]['role'] == 'system' %}{% set loop_messages = messages[1:] %}{% set system_message = messages[0]['content'] %}{% else %}{% set loop_messages = messages %}{% set system_message = false %}{% endif %}{% for message in loop_messages %}{% if (message['role'] == 'user') != (loop.index0 % 2 == 0) %}{{ raise_exception('Conversation roles must alternate user/assistant/user/assistant/...') }}{% endif %}{% if loop.index0 == 0 and system_message != false %}{% set content = '&lt;&lt;SYS&gt;&gt;\\\\n' + system_message + '\\\\n&lt;&lt;/SYS&gt;&gt;\\\\n\\\\n' + message['content'] %}{% else %}{% set content = message['content'] %}{% endif %}{% if message['role'] == 'user' %}{{ '&lt;s&gt;[INST] ' + content.strip() + ' [/INST]' }}{% elif message['role'] == 'assistant' %}{{ ' '  + content.strip() + ' &lt;/s&gt;' }}{% endif %}{% endfor %}\"\n  eos_token: \"&lt;/s&gt;\"\n</code></pre>"},{"location":"docs/reference/dstack.yml/service/#limitations","title":"Limitations","text":"<p>Please note that model mapping is an experimental feature with the following limitations:</p> <ol> <li>Doesn't work if your <code>chat_template</code> uses <code>bos_token</code>. As a workaround, replace <code>bos_token</code> inside <code>chat_template</code> with the token content itself.</li> <li>Doesn't work if <code>eos_token</code> is defined in the model repository as a dictionary. As a workaround, set <code>eos_token</code> manually, as shown in the example above (see Chat template).</li> </ol> <p>If you encounter any other issues, please make sure to file a GitHub issue.</p>"},{"location":"docs/reference/dstack.yml/service/#auto-scaling","title":"Auto-scaling","text":"<p>By default, <code>dstack</code> runs a single replica of the service. You can configure the number of replicas as well as the auto-scaling rules.</p> <pre><code>type: service\n\npython: \"3.11\"\n\nenv:\n  - MODEL=NousResearch/Llama-2-7b-chat-hf\ncommands:\n  - pip install vllm\n  - python -m vllm.entrypoints.openai.api_server --model $MODEL --port 8000\nport: 8000\n\nresources:\n  gpu: 24GB\n\n# Enable the OpenAI-compatible endpoint\nmodel:\n  format: openai\n  type: chat\n  name: NousResearch/Llama-2-7b-chat-hf\n\nreplicas: 1..4\nscaling:\n  metric: rps\n  target: 10\n</code></pre> <p>The <code>replicas</code> property can be a number or a range.</p> <p>The <code>metric</code> property of <code>scaling</code> only supports the <code>rps</code> metric (requests per second). In this  case <code>dstack</code> adjusts the number of replicas (scales up or down) automatically based on the load. </p> <p>Setting the minimum number of replicas to <code>0</code> allows the service to scale down to zero when there are no requests.</p>"},{"location":"docs/reference/dstack.yml/service/#_resources","title":"Resources","text":"<p>If you specify memory size, you can either specify an explicit size (e.g. <code>24GB</code>) or a  range (e.g. <code>24GB..</code>, or <code>24GB..80GB</code>, or <code>..80GB</code>).</p> <pre><code>type: service\n\npython: \"3.11\"\ncommands:\n  - pip install vllm\n  - python -m vllm.entrypoints.openai.api_server\n    --model mistralai/Mixtral-8X7B-Instruct-v0.1\n    --host 0.0.0.0\n    --tensor-parallel-size 2 # Match the number of GPUs\nport: 8000\n\nresources:\n  # 2 GPUs of 80GB\n  gpu: 80GB:2\n\n  disk: 200GB\n\n# Enable the OpenAI-compatible endpoint\nmodel:\n  type: chat\n  name: TheBloke/Mixtral-8x7B-Instruct-v0.1-GPTQ\n  format: openai\n</code></pre> <p>The <code>gpu</code> property allows specifying not only memory size but also GPU names and their quantity. Examples: <code>A100</code> (one A100), <code>A10G,A100</code> (either A10G or A100),  <code>A100:80GB</code> (one A100 of 80GB), <code>A100:2</code> (two A100), <code>24GB..40GB:2</code> (two GPUs between 24GB and 40GB),  <code>A100:40GB:2</code> (two A100 GPUs of 40GB).</p> Shared memory <p>If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure  <code>shm_size</code>, e.g. set it to <code>16GB</code>.</p>"},{"location":"docs/reference/dstack.yml/service/#authorization","title":"Authorization","text":"<p>By default, the service endpoint requires the <code>Authorization</code> header with <code>\"Bearer &lt;dstack token&gt;\"</code>. Authorization can be disabled by setting <code>auth</code> to <code>false</code>.</p> <pre><code>type: service\n\npython: \"3.11\"\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n\nauth: false\n</code></pre>"},{"location":"docs/reference/dstack.yml/service/#environment-variables","title":"Environment variables","text":"<pre><code>type: service\n\npython: \"3.11\"\n\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - MODEL=NousResearch/Llama-2-7b-chat-hf\ncommands:\n  - pip install vllm\n  - python -m vllm.entrypoints.openai.api_server --model $MODEL --port 8000\nport: 8000\n\nresources:\n  gpu: 24GB\n</code></pre> <p>If you don't assign a value to an environment variable (see <code>HUGGING_FACE_HUB_TOKEN</code> above), <code>dstack</code> will require the value to be passed via the CLI or set in the current process.</p> <p>For instance, you can define environment variables in a <code>.env</code> file and utilize tools like <code>direnv</code>.</p>"},{"location":"docs/reference/dstack.yml/service/#default-environment-variables","title":"Default environment variables","text":"<p>The following environment variables are available in any run and are passed by <code>dstack</code> by default:</p> Name Description <code>DSTACK_RUN_NAME</code> The name of the run <code>DSTACK_REPO_ID</code> The ID of the repo <code>DSTACK_GPUS_NUM</code> The total number of GPUs in the run"},{"location":"docs/reference/dstack.yml/service/#spot-policy","title":"Spot policy","text":"<p>You can choose whether to use spot instances, on-demand instances, or any available type.</p> <pre><code>type: service\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n\nspot_policy: auto\n</code></pre> <p>The <code>spot_policy</code> accepts <code>spot</code>, <code>on-demand</code>, and <code>auto</code>. The default for services is <code>auto</code>.</p>"},{"location":"docs/reference/dstack.yml/service/#backends_1","title":"Backends","text":"<p>By default, <code>dstack</code> provisions instances in all configured backends. However, you can specify the list of backends:</p> <pre><code>type: service\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n\nbackends: [aws, gcp]\n</code></pre>"},{"location":"docs/reference/dstack.yml/service/#regions_1","title":"Regions","text":"<p>By default, <code>dstack</code> uses all configured regions. However, you can specify the list of regions:</p> <pre><code>type: service\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n\nregions: [eu-west-1, eu-west-2]\n</code></pre>"},{"location":"docs/reference/dstack.yml/service/#volumes","title":"Volumes","text":"<p>Volumes allow you to persist data between runs. To attach a volume, simply specify its name using the <code>volumes</code> property and specify where to mount its contents:</p> <pre><code>type: service\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n\nvolumes:\n  - name: my-new-volume\n    path: /volume_data\n</code></pre> <p>Once you run this configuration, the contents of the volume will be attached to <code>/volume_data</code> inside the service,  and its contents will persist across runs.</p> <p>The <code>service</code> configuration type supports many other options. See below.</p>"},{"location":"docs/reference/dstack.yml/service/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/dstack.yml/service/#port","title":"<code>port</code> -  The port, that application listens on or the mapping.","text":""},{"location":"docs/reference/dstack.yml/service/#model","title":"<code>model</code> - (Optional) Mapping of the model for the OpenAI-compatible endpoint.","text":""},{"location":"docs/reference/dstack.yml/service/#https","title":"<code>https</code> - (Optional) Enable HTTPS. Defaults to <code>True</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#auth","title":"<code>auth</code> - (Optional) Enable the authorization. Defaults to <code>True</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#replicas","title":"<code>replicas</code> - (Optional) The number of replicas. Can be a number (e.g. <code>2</code>) or a range (<code>0..4</code> or <code>1..8</code>). If it's a range, the <code>scaling</code> property is required. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#_scaling","title":"<code>scaling</code> - (Optional) The auto-scaling rules. Required if <code>replicas</code> is set to a range.","text":""},{"location":"docs/reference/dstack.yml/service/#name","title":"<code>name</code> - (Optional) The run name.","text":""},{"location":"docs/reference/dstack.yml/service/#image","title":"<code>image</code> - (Optional) The name of the Docker image to run.","text":""},{"location":"docs/reference/dstack.yml/service/#entrypoint","title":"<code>entrypoint</code> - (Optional) The Docker entrypoint.","text":""},{"location":"docs/reference/dstack.yml/service/#working_dir","title":"<code>working_dir</code> - (Optional) The path to the working directory inside the container. It's specified relative to the repository directory (<code>/workflow</code>) and should be inside it. Defaults to <code>\".\"</code> .","text":""},{"location":"docs/reference/dstack.yml/service/#home_dir","title":"<code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#_registry_auth","title":"<code>registry_auth</code> - (Optional) Credentials for pulling a private Docker image.","text":""},{"location":"docs/reference/dstack.yml/service/#python","title":"<code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#env","title":"<code>env</code> - (Optional) The mapping or the list of environment variables.","text":""},{"location":"docs/reference/dstack.yml/service/#setup","title":"<code>setup</code> - (Optional) The bash commands to run on the boot.","text":""},{"location":"docs/reference/dstack.yml/service/#_resources","title":"<code>resources</code> - (Optional) The resources requirements to run the configuration.","text":""},{"location":"docs/reference/dstack.yml/service/#_volumes","title":"<code>volumes</code> - (Optional) The volumes mount points.","text":""},{"location":"docs/reference/dstack.yml/service/#commands","title":"<code>commands</code> - (Optional) The bash commands to run.","text":""},{"location":"docs/reference/dstack.yml/service/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/dstack.yml/service/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/dstack.yml/service/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/dstack.yml/service/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#_retry","title":"<code>retry</code> - (Optional) The policy for resubmitting the run. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#_retry_policy","title":"<code>retry_policy</code> - (Optional) The policy for resubmitting the run. Deprecated in favor of <code>retry</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#max_duration","title":"<code>max_duration</code> - (Optional) The maximum duration of a run (e.g., <code>2h</code>, <code>1d</code>, etc). After it elapses, the run is forced to stop. Defaults to <code>off</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/dstack.yml/service/#pool_name","title":"<code>pool_name</code> - (Optional) The name of the pool. If not set, dstack will use the default name.","text":""},{"location":"docs/reference/dstack.yml/service/#instance_name","title":"<code>instance_name</code> - (Optional) The name of the instance.","text":""},{"location":"docs/reference/dstack.yml/service/#creation_policy","title":"<code>creation_policy</code> - (Optional) The policy for using instances from the pool. Defaults to <code>reuse-or-create</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying the idle instance. Defaults to <code>5m</code> for <code>dstack run</code> and to <code>3d</code> for <code>dstack pool add</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#model_1","title":"<code>model</code>","text":""},{"location":"docs/reference/dstack.yml/service/#type","title":"<code>type</code> -  The type of the model.","text":""},{"location":"docs/reference/dstack.yml/service/#name","title":"<code>name</code> -  The name of the model.","text":""},{"location":"docs/reference/dstack.yml/service/#format","title":"<code>format</code> -  The serving format. Supported values include <code>openai</code> and <code>tgi</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#scaling","title":"<code>scaling</code>","text":""},{"location":"docs/reference/dstack.yml/service/#metric","title":"<code>metric</code> -  The target metric to track. Currently, the only supported value is <code>rps</code> (meaning requests per second).","text":""},{"location":"docs/reference/dstack.yml/service/#target","title":"<code>target</code> -  The target value of the metric. The number of replicas is calculated based on this number and automatically adjusts (scales up or down) as this metric changes.","text":""},{"location":"docs/reference/dstack.yml/service/#scale_up_delay","title":"<code>scale_up_delay</code> - (Optional) The delay in seconds before scaling up. Defaults to <code>300</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#scale_down_delay","title":"<code>scale_down_delay</code> - (Optional) The delay in seconds before scaling down. Defaults to <code>600</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#resources","title":"<code>resources</code>","text":""},{"location":"docs/reference/dstack.yml/service/#cpu","title":"<code>cpu</code> - (Optional) The number of CPU cores. Defaults to <code>2..</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>8GB</code>). Defaults to <code>8GB..</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#shm_size","title":"<code>shm_size</code> - (Optional) The size of shared memory (e.g., <code>8GB</code>). If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure this.","text":""},{"location":"docs/reference/dstack.yml/service/#_gpu","title":"<code>gpu</code> - (Optional) The GPU requirements. Can be set to a number, a string (e.g. <code>A100</code>, <code>80GB:2</code>, etc.), or an object.","text":""},{"location":"docs/reference/dstack.yml/service/#_disk","title":"<code>disk</code> - (Optional) The disk resources.","text":""},{"location":"docs/reference/dstack.yml/service/#resources-gpu","title":"<code>resouces.gpu</code>","text":""},{"location":"docs/reference/dstack.yml/service/#name","title":"<code>name</code> - (Optional) The GPU name or list of names.","text":""},{"location":"docs/reference/dstack.yml/service/#count","title":"<code>count</code> - (Optional) The number of GPUs. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>16GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/service/#total_memory","title":"<code>total_memory</code> - (Optional) The total RAM size (e.g., <code>32GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/service/#compute_capability","title":"<code>compute_capability</code> - (Optional) The minimum compute capability of the GPU (e.g., <code>7.5</code>).","text":""},{"location":"docs/reference/dstack.yml/service/#resources-disk","title":"<code>resouces.disk</code>","text":""},{"location":"docs/reference/dstack.yml/service/#size","title":"<code>size</code> -  The disk size. Can be a string (e.g., <code>100GB</code> or <code>100GB..</code>) or an object.","text":""},{"location":"docs/reference/dstack.yml/service/#registry_auth","title":"<code>registry_auth</code>","text":""},{"location":"docs/reference/dstack.yml/service/#username","title":"<code>username</code> -  The username.","text":""},{"location":"docs/reference/dstack.yml/service/#password","title":"<code>password</code> -  The password or access token.","text":""},{"location":"docs/reference/dstack.yml/service/#volumes_1","title":"<code>volumes</code>","text":""},{"location":"docs/reference/dstack.yml/service/#name","title":"<code>name</code> -  The name of the volume to mount.","text":""},{"location":"docs/reference/dstack.yml/service/#path","title":"<code>path</code> -  The container path to mount the volume at.","text":""},{"location":"docs/reference/dstack.yml/task/","title":"task","text":"<p>The <code>task</code> configuration type allows running tasks.</p> <p>Configuration files must have a name ending with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>serve.dstack.yml</code> are both acceptable) and can be located in the project's root directory or any nested folder. Any configuration can be run via <code>dstack run</code>.</p>"},{"location":"docs/reference/dstack.yml/task/#examples","title":"Examples","text":""},{"location":"docs/reference/dstack.yml/task/#python-version","title":"Python version","text":"<p>If you don't specify <code>image</code>, <code>dstack</code> uses the default Docker image pre-configured with  <code>python</code>, <code>pip</code>, <code>conda</code> (Miniforge), and essential CUDA drivers.  The <code>python</code> property determines which default Docker image is used.</p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n</code></pre> <p>nvcc</p> <p>Note that the default Docker image doesn't bundle <code>nvcc</code>, which is required for building custom CUDA kernels.  To install it, use <code>conda install cuda</code>.</p>"},{"location":"docs/reference/dstack.yml/task/#_ports","title":"Ports","text":"<p>A task can configure ports. In this case, if the task is running an application on a port, <code>dstack run</code>  will securely allow you to access this port from your local machine through port forwarding.</p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - tensorboard --logdir results/runs &amp;\n  - python fine-tuning/qlora/train.py\n\nports:\n  - 6000\n</code></pre> <p>When running it, <code>dstack run</code> forwards <code>6000</code> port to <code>localhost:6000</code>, enabling secure access.</p>"},{"location":"docs/reference/dstack.yml/task/#docker-image","title":"Docker image","text":"<pre><code>type: dev-environment\n\nimage: dstackai/base:py3.11-0.4-cuda-12.1\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n</code></pre> Private registry <p>Use the <code>registry_auth</code> property to provide credentials for a private Docker registry.</p> <pre><code>type: dev-environment\n\nimage: dstackai/base:py3.11-0.4-cuda-12.1\nregistry_auth:\n  username: peterschmidt85\n  password: ghp_e49HcZ9oYwBzUbcSk2080gXZOU2hiT9AeSR5\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n</code></pre>"},{"location":"docs/reference/dstack.yml/task/#_resources","title":"Resources","text":"<p>If you specify memory size, you can either specify an explicit size (e.g. <code>24GB</code>) or a  range (e.g. <code>24GB..</code>, or <code>24GB..80GB</code>, or <code>..80GB</code>).</p> <pre><code>type: task\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n\nresources:\n  # 200GB or more RAM\n  memory: 200GB..\n\n  # 4 GPUs from 40GB to 80GB\n  gpu: 40GB..80GB:4\n\n  # Shared memory\n  shm_size: 16GB\n\n  disk: 500GB\n</code></pre> <p>The <code>gpu</code> property allows specifying not only memory size but also GPU names and their quantity. Examples: <code>A100</code> (one A100), <code>A10G,A100</code> (either A10G or A100),  <code>A100:80GB</code> (one A100 of 80GB), <code>A100:2</code> (two A100), <code>24GB..40GB:2</code> (two GPUs between 24GB and 40GB),  <code>A100:40GB:2</code> (two A100 GPUs of 40GB).</p> Google Cloud TPU <p>To use TPUs, specify its architecture prefixed by <code>tpu-</code> via the <code>gpu</code> property.</p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip install torch~=2.3.0 torch_xla[tpu]~=2.3.0 torchvision -f https://storage.googleapis.com/libtpu-releases/index.html\n  - git clone --recursive https://github.com/pytorch/xla.git\n  - python3 xla/test/test_train_mp_imagenet.py --fake_data --model=resnet50 --num_epochs=1\n\nresources:\n  gpu:  tpu-v2-8\n</code></pre> <p>Currently, only 8 TPU cores can be specified, supporting single host workloads. Multi-host support is coming soon.</p> Shared memory <p>If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure  <code>shm_size</code>, e.g. set it to <code>16GB</code>.</p>"},{"location":"docs/reference/dstack.yml/task/#environment-variables","title":"Environment variables","text":"<pre><code>type: task\n\npython: \"3.11\"\n\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - HF_HUB_ENABLE_HF_TRANSFER=1\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n</code></pre> <p>If you don't assign a value to an environment variable (see <code>HUGGING_FACE_HUB_TOKEN</code> above),  <code>dstack</code> will require the value to be passed via the CLI or set in the current process.</p> <p>For instance, you can define environment variables in a <code>.env</code> file and utilize tools like <code>direnv</code>.</p>"},{"location":"docs/reference/dstack.yml/task/#default-environment-variables","title":"Default environment variables","text":"<p>The following environment variables are available in any run and are passed by <code>dstack</code> by default:</p> Name Description <code>DSTACK_RUN_NAME</code> The name of the run <code>DSTACK_REPO_ID</code> The ID of the repo <code>DSTACK_GPUS_NUM</code> The total number of GPUs in the run <code>DSTACK_NODES_NUM</code> The number of nodes in the run <code>DSTACK_NODE_RANK</code> The rank of the node <code>DSTACK_MASTER_NODE_IP</code> The internal IP address the master node"},{"location":"docs/reference/dstack.yml/task/#_nodes","title":"Distributed tasks","text":"<p>By default, the task runs on a single node. However, you can run it on a cluster of nodes.</p> <pre><code>type: task\n\n# The size of the cluster\nnodes: 2\n\npython: \"3.11\"\nenv:\n  - HF_HUB_ENABLE_HF_TRANSFER=1\ncommands:\n  - pip install -r requirements.txt\n  - torchrun\n    --nproc_per_node=$DSTACK_GPUS_PER_NODE\n    --node_rank=$DSTACK_NODE_RANK\n    --nnodes=$DSTACK_NODES_NUM\n    --master_addr=$DSTACK_MASTER_NODE_IP\n    --master_port=8008 resnet_ddp.py\n    --num_epochs 20\n\nresources:\n  gpu: 24GB\n</code></pre> <p>If you run the task, <code>dstack</code> first provisions the master node and then runs the other nodes of the cluster. All nodes are provisioned in the same region.</p> <p><code>dstack</code> is easy to use with <code>accelerate</code>, <code>torchrun</code>, and other distributed frameworks. All you need to do is pass the corresponding environment variables such as <code>DSTACK_GPUS_PER_NODE</code>, <code>DSTACK_NODE_RANK</code>, <code>DSTACK_NODES_NUM</code>, <code>DSTACK_MASTER_NODE_IP</code>, and <code>DSTACK_GPUS_NUM</code> (see System environment variables).</p> Backends <p>Running on multiple nodes is supported only with <code>aws</code>, <code>gcp</code>, <code>azure</code>, <code>oci</code>, and instances added via <code>dstack pool add-ssh</code>.</p>"},{"location":"docs/reference/dstack.yml/task/#arguments","title":"Arguments","text":"<p>You can parameterize tasks with user arguments using <code>${{ run.args }}</code> in the configuration.</p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py ${{ run.args }}\n</code></pre> <p>Now, you can pass your arguments to the <code>dstack run</code> command:</p> <pre><code>$ dstack run . -f train.dstack.yml --train_batch_size=1 --num_train_epochs=100\n</code></pre>"},{"location":"docs/reference/dstack.yml/task/#web-applications","title":"Web applications","text":"<p>Here's an example of using <code>ports</code> to run web apps with <code>tasks</code>. </p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip3 install streamlit\n  - streamlit hello\n\nports: \n  - 8501\n</code></pre>"},{"location":"docs/reference/dstack.yml/task/#spot-policy","title":"Spot policy","text":"<p>You can choose whether to use spot instances, on-demand instances, or any available type.</p> <pre><code>type: task\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n\nspot_policy: auto\n</code></pre> <p>The <code>spot_policy</code> accepts <code>spot</code>, <code>on-demand</code>, and <code>auto</code>. The default for tasks is <code>auto</code>.</p>"},{"location":"docs/reference/dstack.yml/task/#backends_1","title":"Backends","text":"<p>By default, <code>dstack</code> provisions instances in all configured backends. However, you can specify the list of backends:</p> <pre><code>type: task\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n\nbackends: [aws, gcp]\n</code></pre>"},{"location":"docs/reference/dstack.yml/task/#regions_1","title":"Regions","text":"<p>By default, <code>dstack</code> uses all configured regions. However, you can specify the list of regions:</p> <pre><code>type: task\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n\nregions: [eu-west-1, eu-west-2]\n</code></pre>"},{"location":"docs/reference/dstack.yml/task/#volumes","title":"Volumes","text":"<p>Volumes allow you to persist data between runs. To attach a volume, simply specify its name using the <code>volumes</code> property and specify where to mount its contents:</p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n\nvolumes:\n  - name: my-new-volume\n    path: /volume_data\n</code></pre> <p>Once you run this configuration, the contents of the volume will be attached to <code>/volume_data</code> inside the task,  and its contents will persist across runs.</p> <p>Limitations</p> <p>When you're running a dev environment, task, or service with <code>dstack</code>, it automatically mounts the project folder contents to <code>/workflow</code> (and sets that as the current working directory). Right now, <code>dstack</code> doesn't allow you to  attach volumes to <code>/workflow</code> or any of its subdirectories.</p> <p>The <code>task</code> configuration type supports many other options. See below.</p>"},{"location":"docs/reference/dstack.yml/task/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/dstack.yml/task/#nodes","title":"<code>nodes</code> - (Optional) Number of nodes. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#name","title":"<code>name</code> - (Optional) The run name.","text":""},{"location":"docs/reference/dstack.yml/task/#image","title":"<code>image</code> - (Optional) The name of the Docker image to run.","text":""},{"location":"docs/reference/dstack.yml/task/#entrypoint","title":"<code>entrypoint</code> - (Optional) The Docker entrypoint.","text":""},{"location":"docs/reference/dstack.yml/task/#working_dir","title":"<code>working_dir</code> - (Optional) The path to the working directory inside the container. It's specified relative to the repository directory (<code>/workflow</code>) and should be inside it. Defaults to <code>\".\"</code> .","text":""},{"location":"docs/reference/dstack.yml/task/#home_dir","title":"<code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#_registry_auth","title":"<code>registry_auth</code> - (Optional) Credentials for pulling a private Docker image.","text":""},{"location":"docs/reference/dstack.yml/task/#python","title":"<code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#env","title":"<code>env</code> - (Optional) The mapping or the list of environment variables.","text":""},{"location":"docs/reference/dstack.yml/task/#setup","title":"<code>setup</code> - (Optional) The bash commands to run on the boot.","text":""},{"location":"docs/reference/dstack.yml/task/#_resources","title":"<code>resources</code> - (Optional) The resources requirements to run the configuration.","text":""},{"location":"docs/reference/dstack.yml/task/#_volumes","title":"<code>volumes</code> - (Optional) The volumes mount points.","text":""},{"location":"docs/reference/dstack.yml/task/#ports","title":"<code>ports</code> - (Optional) Port numbers/mapping to expose.","text":""},{"location":"docs/reference/dstack.yml/task/#commands","title":"<code>commands</code> - (Optional) The bash commands to run.","text":""},{"location":"docs/reference/dstack.yml/task/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/dstack.yml/task/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/dstack.yml/task/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/dstack.yml/task/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#_retry","title":"<code>retry</code> - (Optional) The policy for resubmitting the run. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#_retry_policy","title":"<code>retry_policy</code> - (Optional) The policy for resubmitting the run. Deprecated in favor of <code>retry</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#max_duration","title":"<code>max_duration</code> - (Optional) The maximum duration of a run (e.g., <code>2h</code>, <code>1d</code>, etc). After it elapses, the run is forced to stop. Defaults to <code>off</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/dstack.yml/task/#pool_name","title":"<code>pool_name</code> - (Optional) The name of the pool. If not set, dstack will use the default name.","text":""},{"location":"docs/reference/dstack.yml/task/#instance_name","title":"<code>instance_name</code> - (Optional) The name of the instance.","text":""},{"location":"docs/reference/dstack.yml/task/#creation_policy","title":"<code>creation_policy</code> - (Optional) The policy for using instances from the pool. Defaults to <code>reuse-or-create</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying the idle instance. Defaults to <code>5m</code> for <code>dstack run</code> and to <code>3d</code> for <code>dstack pool add</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#resources","title":"<code>resources</code>","text":""},{"location":"docs/reference/dstack.yml/task/#cpu","title":"<code>cpu</code> - (Optional) The number of CPU cores. Defaults to <code>2..</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>8GB</code>). Defaults to <code>8GB..</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#shm_size","title":"<code>shm_size</code> - (Optional) The size of shared memory (e.g., <code>8GB</code>). If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure this.","text":""},{"location":"docs/reference/dstack.yml/task/#_gpu","title":"<code>gpu</code> - (Optional) The GPU requirements. Can be set to a number, a string (e.g. <code>A100</code>, <code>80GB:2</code>, etc.), or an object.","text":""},{"location":"docs/reference/dstack.yml/task/#_disk","title":"<code>disk</code> - (Optional) The disk resources.","text":""},{"location":"docs/reference/dstack.yml/task/#resources-gpu","title":"<code>resouces.gpu</code>","text":""},{"location":"docs/reference/dstack.yml/task/#name","title":"<code>name</code> - (Optional) The GPU name or list of names.","text":""},{"location":"docs/reference/dstack.yml/task/#count","title":"<code>count</code> - (Optional) The number of GPUs. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>16GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/task/#total_memory","title":"<code>total_memory</code> - (Optional) The total RAM size (e.g., <code>32GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/task/#compute_capability","title":"<code>compute_capability</code> - (Optional) The minimum compute capability of the GPU (e.g., <code>7.5</code>).","text":""},{"location":"docs/reference/dstack.yml/task/#resources-disk","title":"<code>resouces.disk</code>","text":""},{"location":"docs/reference/dstack.yml/task/#size","title":"<code>size</code> -  The disk size. Can be a string (e.g., <code>100GB</code> or <code>100GB..</code>) or an object.","text":""},{"location":"docs/reference/dstack.yml/task/#registry_auth","title":"<code>registry_auth</code>","text":""},{"location":"docs/reference/dstack.yml/task/#username","title":"<code>username</code> -  The username.","text":""},{"location":"docs/reference/dstack.yml/task/#password","title":"<code>password</code> -  The password or access token.","text":""},{"location":"docs/reference/dstack.yml/task/#volumesn","title":"<code>volumes[n]</code>","text":""},{"location":"docs/reference/dstack.yml/task/#name","title":"<code>name</code> -  The name of the volume to mount.","text":""},{"location":"docs/reference/dstack.yml/task/#path","title":"<code>path</code> -  The container path to mount the volume at.","text":""},{"location":"docs/reference/dstack.yml/volume/","title":"volume","text":"<p>The <code>volume</code> configuration type allows creating, registering, and updating volumes.</p> <p>Configuration files must have a name ending with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>vol.dstack.yml</code> are both acceptable) and can be located in the project's root directory or any nested folder. Any configuration can be applied via <code>dstack apply</code>.</p>"},{"location":"docs/reference/dstack.yml/volume/#examples","title":"Examples","text":""},{"location":"docs/reference/dstack.yml/volume/#create-volume","title":"Creating a new volume","text":"<pre><code>type: volume\nname: my-aws-volume\nbackend: aws\nregion: eu-central-1\nsize: 100GB\n</code></pre>"},{"location":"docs/reference/dstack.yml/volume/#register-volume","title":"Registering an existing volume","text":"<pre><code>type: volume\nname: my-external-volume\nbackend: aws\nregion: eu-central-1\nvolume_id: vol1235\n</code></pre>"},{"location":"docs/reference/dstack.yml/volume/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/dstack.yml/volume/#name","title":"<code>name</code> - (Optional) The volume name.","text":""},{"location":"docs/reference/dstack.yml/volume/#backend","title":"<code>backend</code> -  The volume backend.","text":""},{"location":"docs/reference/dstack.yml/volume/#region","title":"<code>region</code> -  The volume region.","text":""},{"location":"docs/reference/dstack.yml/volume/#size","title":"<code>size</code> - (Optional) The volume size. Must be specified when creating new volumes.","text":""},{"location":"docs/reference/dstack.yml/volume/#volume_id","title":"<code>volume_id</code> - (Optional) The volume ID. Must be specified when registering external volumes.","text":""},{"location":"docs/reference/server/config.yml/","title":"~/.dstack/server/config.yml","text":"<p>The <code>~/.dstack/server/config.yml</code> file is used by the <code>dstack</code> server to configure cloud accounts.</p> <p>The <code>dstack</code> server allows you to configure backends for multiple projects. If you don't need multiple projects, use only the <code>main</code> project.</p> <p>Each cloud account must be configured under the <code>backends</code> property of the respective project. See the examples below.</p>"},{"location":"docs/reference/server/config.yml/#examples","title":"Examples","text":""},{"location":"docs/reference/server/config.yml/#aws_1","title":"AWS","text":"<p>There are two ways to configure AWS: using an access key or using the default credentials.</p> Access keyDefault credentials <p>Create an access key by following the this guide . Once you've downloaded the <code>.csv</code> file with your IAM user's Access key ID and Secret access key, proceed to configure the backend.</p> <pre><code>projects:\n- name: main\n  backends:\n    - type: aws\n      creds:\n        type: access_key\n        access_key: KKAAUKLIZ5EHKICAOASV\n        secret_key: pn158lMqSBJiySwpQ9ubwmI6VUU3/W2fdJdFwfgO\n</code></pre> <p>If you have default credentials set up (e.g. in <code>~/.aws/credentials</code>), configure the backend like this:</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: aws\n        creds:\n          type: default\n</code></pre> VPC <p>By default, <code>dstack</code> uses the default VPC. It's possible to customize it:</p> vpc_namevpc_ids <pre><code>projects:\n  - name: main\n    backends:\n      - type: aws\n        creds:\n          type: default\n\n        vpc_name: my-vpc\n</code></pre> <pre><code>projects:\n  - name: main\n    backends:\n      - type: aws\n        creds:\n          type: default\n\n        default_vpcs: true\n        vpc_ids:\n          us-east-1: vpc-0a2b3c4d5e6f7g8h\n          us-east-2: vpc-9i8h7g6f5e4d3c2b\n          us-west-1: vpc-4d3c2b1a0f9e8d7\n</code></pre> <p>For the regions without configured <code>vpc_ids</code>, enable default VPCs by setting <code>default_vpcs</code> to <code>true</code>.</p> Required AWS permissions <p>The following AWS policy permissions are sufficient for <code>dstack</code> to work:</p> <pre><code>{\n    \"Version\": \"2012-10-17\",\n    \"Statement\": [\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"ec2:AttachVolume\",\n                \"ec2:AuthorizeSecurityGroupEgress\",\n                \"ec2:AuthorizeSecurityGroupIngress\",\n                \"ec2:CancelSpotInstanceRequests\",\n                \"ec2:CreateSecurityGroup\",\n                \"ec2:CreateTags\",\n                \"ec2:CreateVolume\",\n                \"ec2:DeleteVolume\",\n                \"ec2:DescribeAvailabilityZones\",\n                \"ec2:DescribeImages\",\n                \"ec2:DescribeInstances\",\n                \"ec2:DescribeInstanceAttribute\",\n                \"ec2:DescribeRouteTables\",\n                \"ec2:DescribeSecurityGroups\",\n                \"ec2:DescribeSubnets\",\n                \"ec2:DescribeVpcs\",\n                \"ec2:DescribeVolumes\",\n                \"ec2:DetachVolume\",\n                \"ec2:RunInstances\",\n                \"ec2:TerminateInstances\"\n            ],\n            \"Resource\": \"*\"\n        },\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"servicequotas:ListServiceQuotas\",\n                \"servicequotas:GetServiceQuota\"\n            ],\n            \"Resource\": \"*\"\n        },\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"elasticloadbalancing:CreateLoadBalancer\",\n                \"elasticloadbalancing:CreateTargetGroup\",\n                \"elasticloadbalancing:CreateListener\",\n                \"elasticloadbalancing:RegisterTargets\",\n                \"elasticloadbalancing:AddTags\",\n                \"elasticloadbalancing:DeleteLoadBalancer\",\n                \"elasticloadbalancing:DeleteTargetGroup\",\n                \"elasticloadbalancing:DeleteListener\",\n                \"elasticloadbalancing:DeregisterTargets\"\n            ],\n            \"Resource\": \"*\"\n        },\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"acm:DescribeCertificate\",\n                \"acm:ListCertificates\"\n            ],\n            \"Resource\": \"*\"\n        }\n    ]\n}\n</code></pre> <p>The <code>elasticloadbalancing:*</code> and <code>acm:*</code> permissions are only needed for provisioning gateways with ACM (AWS Certificate Manager) certificates.</p> Private subnets <p>By default, <code>dstack</code> utilizes public subnets and permits inbound SSH traffic exclusively for any provisioned instances. If you want <code>dstack</code> to use private subnets, set <code>public_ips</code> to <code>false</code>.</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: aws\n        creds:\n          type: default\n\n        public_ips: false\n</code></pre> <p>Using private subnets assumes that both the <code>dstack</code> server and users can access the configured VPC's private subnets  (e.g., through VPC peering).</p>"},{"location":"docs/reference/server/config.yml/#azure_1","title":"Azure","text":"<p>There are two ways to configure Azure: using a client secret or using the default credentials.</p> Client secretDefault credentials <p>A client secret can be created using the Azure CLI :</p> <pre><code>SUBSCRIPTION_ID=...\naz ad sp create-for-rbac\n    --name dstack-app \\\n    --role $DSTACK_ROLE \\\n    --scopes /subscriptions/$SUBSCRIPTION_ID \\\n    --query \"{ tenant_id: tenant, client_id: appId, client_secret: password }\"\n</code></pre> <p>Once you have <code>tenant_id</code>, <code>client_id</code>, and <code>client_secret</code>, go ahead and configure the backend.</p> <pre><code>projects:\n- name: main\n  backends:\n  - type: azure\n    subscription_id: 06c82ce3-28ff-4285-a146-c5e981a9d808\n    tenant_id: f84a7584-88e4-4fd2-8e97-623f0a715ee1\n    creds:\n      type: client\n      client_id: acf3f73a-597b-46b6-98d9-748d75018ed0\n      client_secret: 1Kb8Q~o3Q2hdEvrul9yaj5DJDFkuL3RG7lger2VQ\n</code></pre> <p>Obtain the <code>subscription_id</code> and <code>tenant_id</code> via the Azure CLI :</p> <pre><code>az account show --query \"{subscription_id: id, tenant_id: tenantId}\"\n</code></pre> <p>Then proceed to configure the backend:</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: azure\n        subscription_id: 06c82ce3-28ff-4285-a146-c5e981a9d808\n        tenant_id: f84a7584-88e4-4fd2-8e97-623f0a715ee1\n        creds:\n          type: default\n</code></pre> <p>If you don't know your <code>subscription_id</code>, run</p> <pre><code>az account show --query \"{subscription_id: id}\"\n</code></pre> Required Azure permissions <p>The following Azure permissions are sufficient for <code>dstack</code> to work: <pre><code>{\n    \"properties\": {\n        \"roleName\": \"dstack-role\",\n        \"description\": \"Minimal required permissions for using Azure with dstack\",\n        \"assignableScopes\": [\n            \"/subscriptions/${YOUR_SUBSCRIPTION_ID}\"\n        ],\n        \"permissions\": [\n            {\n            \"actions\": [\n                \"Microsoft.Authorization/*/read\",\n                \"Microsoft.Compute/availabilitySets/*\",\n                \"Microsoft.Compute/locations/*\",\n                \"Microsoft.Compute/virtualMachines/*\",\n                \"Microsoft.Compute/virtualMachineScaleSets/*\",\n                \"Microsoft.Compute/cloudServices/*\",\n                \"Microsoft.Compute/disks/write\",\n                \"Microsoft.Compute/disks/read\",\n                \"Microsoft.Compute/disks/delete\",\n                \"Microsoft.Network/networkSecurityGroups/*\",\n                \"Microsoft.Network/locations/*\",\n                \"Microsoft.Network/virtualNetworks/*\",\n                \"Microsoft.Network/networkInterfaces/*\",\n                \"Microsoft.Network/publicIPAddresses/*\",\n                \"Microsoft.Resources/subscriptions/resourceGroups/read\",\n                \"Microsoft.Resources/subscriptions/resourceGroups/write\",\n                \"Microsoft.Resources/subscriptions/read\"\n            ],\n            \"notActions\": [],\n            \"dataActions\": [],\n            \"notDataActions\": []\n            }\n        ]\n    }\n}\n</code></pre></p>"},{"location":"docs/reference/server/config.yml/#gcp_1","title":"GCP","text":"Enable APIs <p>First, ensure the required APIs are enabled in your GCP <code>project_id</code>.</p> <pre><code>PROJECT_ID=...\ngcloud config set project $PROJECT_ID\ngcloud services enable cloudapis.googleapis.com\ngcloud services enable compute.googleapis.com\n</code></pre> <p>There are two ways to configure GCP: using a service account or using the default credentials.</p> Service accountDefault credentials <p>To create a service account, follow this guide . After setting up the service account create a key  for it and download the corresponding JSON file.</p> <p>Then go ahead and configure the backend by specifying the downloaded file path.</p> <pre><code>projects:\n- name: main\n  backends:\n    - type: gcp\n      project_id: gcp-project-id\n      creds:\n        type: service_account\n        filename: ~/.dstack/server/gcp-024ed630eab5.json\n</code></pre> <p>Enable GCP application default credentials:</p> <pre><code>gcloud auth application-default login \n</code></pre> <p>Then configure the backend like this:</p> <pre><code>projects:\n- name: main\n  backends:\n    - type: gcp\n      project_id: gcp-project-id\n      creds:\n        type: default\n</code></pre> <p>If you don't know your GCP project ID, run</p> <pre><code>gcloud projects list --format=\"json(projectId)\"\n</code></pre> VPCShared VPC <pre><code>projects:\n- name: main\n  backends:\n    - type: gcp\n      project_id: gcp-project-id\n      creds:\n        type: default\n\n      vpc_name: my-custom-vpc\n</code></pre> <pre><code>projects:\n- name: main\n  backends:\n    - type: gcp\n      project_id: gcp-project-id\n      creds:\n        type: default\n\n      vpc_name: my-custom-vpc\n      vpc_project_id: another-project-id\n</code></pre> <p>To use a shared VPC, that VPC has to be configured with two additional firewall rules:</p> <ul> <li>Allow <code>INGRESS</code> traffic on port <code>22</code>, with the target tag <code>dstack-runner-instance</code></li> <li>Allow <code>INGRESS</code> traffic on ports <code>22</code>, <code>80</code>, <code>443</code>, with the target tag <code>dstack-gateway-instance</code></li> </ul> Required GCP permissions <p>The following GCP permissions are sufficient for <code>dstack</code> to work:</p> <pre><code>compute.disks.create\ncompute.firewalls.create\ncompute.images.useReadOnly\ncompute.instances.create\ncompute.instances.delete\ncompute.instances.get\ncompute.instances.setLabels\ncompute.instances.setMetadata\ncompute.instances.setTags\ncompute.networks.get\ncompute.networks.updatePolicy\ncompute.regions.list\ncompute.subnetworks.list\ncompute.subnetworks.use\ncompute.subnetworks.useExternalIp\ncompute.zoneOperations.get\n</code></pre> <p>If you plan to use TPUs, additional permissions are required:</p> <pre><code>tpu.nodes.create\ntpu.nodes.delete\ntpu.nodes.get\ntpu.operations.get\ntpu.operations.list\n</code></pre> <p>Also, the use of TPUs requires the <code>serviceAccountUser</code> role. For TPU VMs, dstack will use the default service account.</p> Private subnets <p>By default, <code>dstack</code> utilizes public subnets and permits inbound SSH traffic exclusively for any provisioned instances. If you want <code>dstack</code> to use private subnets, set <code>public_ips</code> to <code>false</code>.</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: gcp\n        creds:\n          type: default\n\n        public_ips: false\n</code></pre> <p>Using private subnets assumes that both the <code>dstack</code> server and users can access the configured VPC's private subnets (e.g., through VPC peering). Additionally, Cloud NAT must be configured to provide access to external resources for provisioned instances.</p>"},{"location":"docs/reference/server/config.yml/#oci_1","title":"OCI","text":"<p>There are two ways to configure OCI: using client credentials or using the default credentials.</p> Client credentialsDefault credentials <p>Log into the OCI Console , go to <code>My profile</code>,  select <code>API keys</code>, and click <code>Add API key</code>.</p> <p>Once you add a key, you'll see the configuration file. Copy its values to configure the backend as follows:</p> <pre><code>projects:\n- name: main\n  backends:\n  - type: oci\n    creds:\n      type: client\n      user: ocid1.user.oc1..g5vlaeqfu47akmaafq665xsgmyaqjktyfxtacfxc4ftjxuca7aohnd2ev66m\n      tenancy: ocid1.tenancy.oc1..ajqsftvk4qarcfaak3ha4ycdsaahxmaita5frdwg3tqo2bcokpd3n7oizwai\n      region: eu-frankfurt-1\n      fingerprint: 77:32:77:00:49:7c:cb:56:84:75:8e:77:96:7d:53:17\n      key_file: ~/.oci/private_key.pem\n</code></pre> <p>Make sure to include either the path to your private key via <code>key_file</code> or the contents of the key via <code>key_content</code>.</p> <p>If you have default credentials set up in <code>~/.oci/config</code>, configure the backend like this:</p> <pre><code>projects:\n- name: main\n  backends:\n  - type: oci\n    creds:\n      type: default\n</code></pre> Required OCI permissions <p>This is an example of a restrictive policy for a group of <code>dstack</code> users:</p> <pre><code>Allow group &lt;dstack-users&gt; to read compartments in tenancy where target.compartment.name = '&lt;dstack-compartment&gt;'\nAllow group &lt;dstack-users&gt; to read marketplace-community-listings in compartment &lt;dstack-compartment&gt;\nAllow group &lt;dstack-users&gt; to manage app-catalog-listing in compartment &lt;dstack-compartment&gt;\nAllow group &lt;dstack-users&gt; to manage instances in compartment &lt;dstack-compartment&gt;\nAllow group &lt;dstack-users&gt; to manage compute-capacity-reports in compartment &lt;dstack-compartment&gt;\nAllow group &lt;dstack-users&gt; to manage volumes in compartment &lt;dstack-compartment&gt;\nAllow group &lt;dstack-users&gt; to manage volume-attachments in compartment &lt;dstack-compartment&gt;\nAllow group &lt;dstack-users&gt; to manage virtual-network-family in compartment &lt;dstack-compartment&gt;\n</code></pre> <p>To use this policy, create a compartment for <code>dstack</code> and specify it in <code>~/.dstack/server/config.yml</code>.</p> <pre><code>projects:\n- name: main\n  backends:\n  - type: oci\n    creds:\n      type: default\n    compartment_id: ocid1.compartment.oc1..aaaaaaaa\n</code></pre>"},{"location":"docs/reference/server/config.yml/#lambda_1","title":"Lambda","text":"<p>Log into your Lambda Cloud  account, click API keys in the sidebar, and then click the <code>Generate API key</code> button to create a new API key.</p> <p>Then, go ahead and configure the backend:</p> <pre><code>projects:\n- name: main\n  backends:\n    - type: lambda\n      creds:\n        type: api_key\n        api_key: eersct_yrpiey-naaeedst-tk-_cb6ba38e1128464aea9bcc619e4ba2a5.iijPMi07obgt6TZ87v5qAEj61RVxhd0p\n</code></pre>"},{"location":"docs/reference/server/config.yml/#tensordock_1","title":"TensorDock","text":"<p>Log into your TensorDock  account, click API in the sidebar, and use the <code>Create an Authorization</code> section to create a new authorization key.</p> <p>Then, go ahead and configure the backend:</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: tensordock\n        creds:\n          type: api_key\n          api_key: 248e621d-9317-7494-dc1557fa5825b-98b\n          api_token: FyBI3YbnFEYXdth2xqYRnQI7hiusssBC\n</code></pre> <p>The <code>tensordock</code> backend supports on-demand instances only. Spot instance support coming soon.</p>"},{"location":"docs/reference/server/config.yml/#vastai_1","title":"Vast.ai","text":"<p>Log into your Vast.ai  account, click Account in the sidebar, and copy your API Key.</p> <p>Then, go ahead and configure the backend:</p> <pre><code>projects:\n- name: main\n  backends:\n    - type: vastai\n      creds:\n        type: api_key\n        api_key: d75789f22f1908e0527c78a283b523dd73051c8c7d05456516fc91e9d4efd8c5\n</code></pre> <p>Also, the <code>vastai</code> backend supports on-demand instances only. Spot instance support coming soon.</p>"},{"location":"docs/reference/server/config.yml/#runpod","title":"RunPod","text":"<p>Log into your RunPod  console, click Settings in the sidebar, expand the <code>API Keys</code> section, and click the button to create a key.</p> <p>Then proceed to configuring the backend.</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: runpod\n        creds:\n          type: api_key\n          api_key: US9XTPDIV8AR42MMINY8TCKRB8S4E7LNRQ6CAUQ9\n</code></pre>"},{"location":"docs/reference/server/config.yml/#cudo_1","title":"CUDO","text":"<p>Log into your CUDO Compute  account, click API keys in the sidebar, and click the <code>Create an API key</code> button.</p> <p>Ensure you've created a project with CUDO Compute, then proceed to configuring the backend.</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: cudo\n        project_id: my-cudo-project\n        creds:\n          type: api_key\n          api_key: 7487240a466624b48de22865589\n</code></pre>"},{"location":"docs/reference/server/config.yml/#datacrunch_1","title":"DataCrunch","text":"<p>Log into your DataCrunch  account, click Account Settings in the sidebar, find <code>REST API Credentials</code> area and then click the <code>Generate Credentials</code> button.</p> <p>Then, go ahead and configure the backend:</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: datacrunch\n        creds:\n          type: api_key\n          client_id: xfaHBqYEsArqhKWX-e52x3HH7w8T\n          client_secret: B5ZU5Qx9Nt8oGMlmMhNI3iglK8bjMhagTbylZy4WzncZe39995f7Vxh8\n</code></pre>"},{"location":"docs/reference/server/config.yml/#kubernetes_1","title":"Kubernetes","text":"<p><code>dstack</code> supports both self-managed, and managed Kubernetes clusters.</p> Prerequisite <p>To use GPUs with Kubernetes, the cluster must be installed with the NVIDIA GPU Operator .</p> <p>To configure a Kubernetes backend, specify the path to the kubeconfig file, and the port that <code>dstack</code> can use for proxying SSH traffic. In case of a self-managed cluster, also specify the IP address of any node in the cluster.</p> Self-managedManaged <p>Here's how to configure the backend to use a self-managed cluster.</p> <pre><code>projects:\n- name: main\n  backends:\n    - type: kubernetes\n      kubeconfig:\n        filename: ~/.kube/config\n      networking:\n        ssh_host: localhost # The external IP address of any node\n        ssh_port: 32000 # Any port accessible outside of the cluster\n</code></pre> <p>The port specified to <code>ssh_port</code> must be accessible outside of the cluster.</p> Kind <p>If you are using Kind, make sure to make  to set up <code>ssh_port</code> via <code>extraPortMappings</code> for proxying SSH traffic:</p> <pre><code>kind: Cluster\napiVersion: kind.x-k8s.io/v1alpha4\nnodes:\n  - role: control-plane\n    extraPortMappings:\n      - containerPort: 32000 # Must be same as `ssh_port`\n        hostPort: 32000 # Must be same as `ssh_port`\n</code></pre> <p>Go ahead and create the cluster like this: </p> <pre><code>kind create cluster --config examples/misc/kubernetes/kind-config.yml\n</code></pre> <p>Here's how to configure the backend to use a managed cluster (AWS, GCP, Azure).</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: kubernetes\n        kubeconfig:\n          filename: ~/.kube/config\n        networking:\n          ssh_port: 32000 # Any port accessible outside of the cluster\n</code></pre> <p>The port specified to <code>ssh_port</code> must be accessible outside of the cluster.</p> EKS <p>For example, if you are using EKS, make sure to add it via an ingress rule of the corresponding security group:</p> <pre><code>aws ec2 authorize-security-group-ingress --group-id &lt;cluster-security-group-id&gt; --protocol tcp --port 32000 --cidr 0.0.0.0/0\n</code></pre>"},{"location":"docs/reference/server/config.yml/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/server/config.yml/#_projects","title":"<code>projects</code> -  The list of projects.","text":""},{"location":"docs/reference/server/config.yml/#projects","title":"<code>projects[n]</code>","text":""},{"location":"docs/reference/server/config.yml/#name","title":"<code>name</code> -  The name of the project.","text":""},{"location":"docs/reference/server/config.yml/#backends","title":"<code>backends</code> -  The list of backends.","text":""},{"location":"docs/reference/server/config.yml/#aws","title":"<code>projects[n].backends[type=aws]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of the backend. Must be <code>aws</code>.","text":""},{"location":"docs/reference/server/config.yml/#regions","title":"<code>regions</code> - (Optional) The list of AWS regions.","text":""},{"location":"docs/reference/server/config.yml/#vpc_name","title":"<code>vpc_name</code> - (Optional) The VPC name. All configured regions must have a VPC with this name.","text":""},{"location":"docs/reference/server/config.yml/#vpc_ids","title":"<code>vpc_ids</code> - (Optional) The mapping from AWS regions to VPC IDs. If <code>default_vpcs: true</code>, omitted regions will use default VPCs.","text":""},{"location":"docs/reference/server/config.yml/#default_vpcs","title":"<code>default_vpcs</code> - (Optional) A flag to enable/disable using default VPCs in regions not configured by <code>vpc_ids</code>. Set to <code>false</code> if default VPCs should never be used. Defaults to <code>true</code>.","text":""},{"location":"docs/reference/server/config.yml/#public_ips","title":"<code>public_ips</code> - (Optional) A flag to enable/disable public IP assigning on instances. Defaults to <code>true</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#aws-creds","title":"<code>projects[n].backends[type=aws].creds</code>","text":"Access keyDefault"},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>access_key</code>.","text":""},{"location":"docs/reference/server/config.yml/#access_key","title":"<code>access_key</code> -  The access key.","text":""},{"location":"docs/reference/server/config.yml/#secret_key","title":"<code>secret_key</code> -  The secret key.","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>default</code>.","text":""},{"location":"docs/reference/server/config.yml/#azure","title":"<code>projects[n].backends[type=azure]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of the backend. Must be <code>azure</code>.","text":""},{"location":"docs/reference/server/config.yml/#tenant_id","title":"<code>tenant_id</code> -  The tenant ID.","text":""},{"location":"docs/reference/server/config.yml/#subscription_id","title":"<code>subscription_id</code> -  The subscription ID.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#azure-creds","title":"<code>projects[n].backends[type=azure].creds</code>","text":"ClientDefault"},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>client</code>.","text":""},{"location":"docs/reference/server/config.yml/#client_id","title":"<code>client_id</code> -  The client ID.","text":""},{"location":"docs/reference/server/config.yml/#client_secret","title":"<code>client_secret</code> -  The client secret.","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>default</code>.","text":""},{"location":"docs/reference/server/config.yml/#datacrunch","title":"<code>projects[n].backends[type=datacrunch]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>datacrunch</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#datacrunch-creds","title":"<code>projects[n].backends[type=datacrunch].creds</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>api_key</code>.","text":""},{"location":"docs/reference/server/config.yml/#client_id","title":"<code>client_id</code> -  The client ID.","text":""},{"location":"docs/reference/server/config.yml/#client_secret","title":"<code>client_secret</code> -  The client secret.","text":""},{"location":"docs/reference/server/config.yml/#gcp","title":"<code>projects[n].backends[type=gcp]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>gcp</code>.","text":""},{"location":"docs/reference/server/config.yml/#project_id","title":"<code>project_id</code> -  The project ID.","text":""},{"location":"docs/reference/server/config.yml/#vpc_name","title":"<code>vpc_name</code> - (Optional) The VPC name.","text":""},{"location":"docs/reference/server/config.yml/#vpc_project_id","title":"<code>vpc_project_id</code> - (Optional) The shared VPC hosted project ID. Required for shared VPC only.","text":""},{"location":"docs/reference/server/config.yml/#public_ips","title":"<code>public_ips</code> - (Optional) A flag to enable/disable public IP assigning on instances. Defaults to <code>true</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#gcp-creds","title":"<code>projects[n].backends[type=gcp].creds</code>","text":"Service accountDefault"},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>service_account</code>.","text":""},{"location":"docs/reference/server/config.yml/#filename","title":"<code>filename</code> -  The path to the service account file.","text":""},{"location":"docs/reference/server/config.yml/#data","title":"<code>data</code> - (Optional) The contents of the service account file.","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>default</code>.","text":""},{"location":"docs/reference/server/config.yml/#lambda","title":"<code>projects[n].backends[type=lambda]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>lambda</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#lambda-creds","title":"<code>projects[n].backends[type=lambda].creds</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>api_key</code>.","text":""},{"location":"docs/reference/server/config.yml/#api_key","title":"<code>api_key</code> -  The API key.","text":""},{"location":"docs/reference/server/config.yml/#oci","title":"<code>projects[n].backends[type=oci]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>oci</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#regions","title":"<code>regions</code> - (Optional) List of region names for running <code>dstack</code> jobs. Omit to use all regions.","text":""},{"location":"docs/reference/server/config.yml/#compartment_id","title":"<code>compartment_id</code> - (Optional) Compartment where <code>dstack</code> will create all resources. Omit to instruct <code>dstack</code> to create a new compartment.","text":""},{"location":"docs/reference/server/config.yml/#oci-creds","title":"<code>projects[n].backends[type=oci].creds</code>","text":"ClientDefault"},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>client</code>.","text":""},{"location":"docs/reference/server/config.yml/#user","title":"<code>user</code> -  User OCID.","text":""},{"location":"docs/reference/server/config.yml/#tenancy","title":"<code>tenancy</code> -  Tenancy OCID.","text":""},{"location":"docs/reference/server/config.yml/#key_file","title":"<code>key_file</code> - (Optional) Path to the user's private PEM key. Either this or <code>key_content</code> should be set.","text":""},{"location":"docs/reference/server/config.yml/#key_content","title":"<code>key_content</code> - (Optional) Content of the user's private PEM key. Either this or <code>key_file</code> should be set.","text":""},{"location":"docs/reference/server/config.yml/#pass_phrase","title":"<code>pass_phrase</code> - (Optional) Passphrase for the private PEM key if it is encrypted.","text":""},{"location":"docs/reference/server/config.yml/#fingerprint","title":"<code>fingerprint</code> -  User's public key fingerprint.","text":""},{"location":"docs/reference/server/config.yml/#region","title":"<code>region</code> -  Name or key of any region the tenancy is subscribed to.","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>default</code>.","text":""},{"location":"docs/reference/server/config.yml/#file","title":"<code>file</code> - (Optional) Path to the OCI CLI-compatible config file. Defaults to <code>~/.oci/config</code>.","text":""},{"location":"docs/reference/server/config.yml/#profile","title":"<code>profile</code> - (Optional) Profile to load from the config file. Defaults to <code>DEFAULT</code>.","text":""},{"location":"docs/reference/server/config.yml/#tensordock","title":"<code>projects[n].backends[type=tensordock]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>tensordock</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#tensordock-creds","title":"<code>projects[n].backends[type=tensordock].creds</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>api_key</code>.","text":""},{"location":"docs/reference/server/config.yml/#api_key","title":"<code>api_key</code> -  The API key.","text":""},{"location":"docs/reference/server/config.yml/#api_token","title":"<code>api_token</code> -  The API token.","text":""},{"location":"docs/reference/server/config.yml/#vastai","title":"<code>projects[n].backends[type=vastai]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>vastai</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#vastai-creds","title":"<code>projects[n].backends[type=vastai].creds</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>api_key</code>.","text":""},{"location":"docs/reference/server/config.yml/#api_key","title":"<code>api_key</code> -  The API key.","text":""},{"location":"docs/reference/server/config.yml/#cudo","title":"<code>projects[n].backends[type=cudo]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>cudo</code>.","text":""},{"location":"docs/reference/server/config.yml/#project_id","title":"<code>project_id</code> -  The project ID.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#cudo-creds","title":"<code>projects[n].backends[type=cudo].creds</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>api_key</code>.","text":""},{"location":"docs/reference/server/config.yml/#api_key","title":"<code>api_key</code> -  The API key.","text":""},{"location":"docs/reference/server/config.yml/#kubernetes","title":"<code>projects[n].backends[type=kubernetes]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>kubernetes</code>.","text":""},{"location":"docs/reference/server/config.yml/#_kubeconfig","title":"<code>kubeconfig</code> -  The kubeconfig configuration.","text":""},{"location":"docs/reference/server/config.yml/#_networking","title":"<code>networking</code> - (Optional) The networking configuration.","text":""},{"location":"docs/reference/server/config.yml/#kubeconfig","title":"<code>projects[n].backends[type=kubernetes].kubeconfig</code>","text":""},{"location":"docs/reference/server/config.yml/#filename","title":"<code>filename</code> -  The path to the kubeconfig file.","text":""},{"location":"docs/reference/server/config.yml/#data","title":"<code>data</code> - (Optional) The contents of the kubeconfig file.","text":""},{"location":"docs/reference/server/config.yml/#networking","title":"<code>projects[n].backends[type=kubernetes].networking</code>","text":""},{"location":"docs/reference/server/config.yml/#ssh_host","title":"<code>ssh_host</code> - (Optional) The external IP address of any node.","text":""},{"location":"docs/reference/server/config.yml/#ssh_port","title":"<code>ssh_port</code> - (Optional) Any port accessible outside of the cluster.","text":""},{"location":"blog/archive/2024/","title":"2024","text":""}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"],"fields":{"title":{"boost":1000.0},"text":{"boost":1.0},"tags":{"boost":1000000.0}}},"docs":[{"location":"terms/","title":"Terms of service","text":""},{"location":"terms/#agreement-to-terms","title":"Agreement to terms","text":"<p>We are dstack GmbH (\"Company,\" \"we,\" \"us,\" \"our\"), a company registered in Germany at Franz-Joseph-Stra\u00dfe, 11, Munich, Bayern 80801.</p> <p>These Legal Terms constitute a legally binding agreement made between you, whether personally or on behalf of an entity (\"you\"), and dstack GmbH, concerning your access to and use of the Services. You agree that by accessing the Services, you have read, understood, and agreed to be bound by all of these Legal Terms. IF YOU DO NOT AGREE WITH ALL OF THESE LEGAL TERMS, THEN YOU ARE EXPRESSLY PROHIBITED FROM USING THE SERVICES AND YOU MUST DISCONTINUE USE IMMEDIATELY.</p> <p>Supplemental terms and conditions or documents that may be posted on the Services from time to time are hereby expressly incorporated herein by reference. We reserve the right, in our sole discretion, to make changes or modifications to these Legal Terms from time to time. We will alert you about any changes by updating the \"Last updated\" date of these Legal Terms, and you waive any right to receive specific notice of each such change. It is your responsibility to periodically review these Legal Terms to stay informed of updates. You will be subject to, and will be deemed to have been made aware of and to have accepted, the changes in any revised Legal Terms by your continued use of the Services after the date such revised Legal Terms are posted.</p>"},{"location":"terms/#1-our-services","title":"1. Our services","text":"<p>The information provided when using the Services is not intended for distribution to or use by any person or entity in any jurisdiction or country where such distribution or use would be contrary to law or regulation or which would subject us to any registration requirement within such jurisdiction or country. Accordingly, those persons who choose to access the Services from other locations do so on their own initiative and are solely responsible for compliance with local laws, if and to the extent local laws are applicable.</p> <p>The Services are not tailored to comply with industry-specific regulations (Health Insurance Portability and Accountability Act (HIPAA), Federal Information Security Management Act (FISMA), etc.), so if your interactions would be subjected to such laws, you may not use the Services. You may not use the Services in a way that would violate the Gramm-Leach-Bliley Act (GLBA).</p>"},{"location":"terms/#2-intelliectual-property-rights","title":"2. Intelliectual property rights","text":"<p>Our intellectual property</p> <p>We are the owner or the licensee of all intellectual property rights in our Services, including all source code, databases, functionality, software, website designs, audio, video, text, photographs, and graphics in the Services ( collectively, the \"Content\"), as well as the trademarks, service marks, and logos contained therein (the \"Marks\").</p> <p>Our Content and Marks are protected by copyright and trademark laws (and various other intellectual property rights and unfair competition laws) and treaties in the United States and around the world.</p> <p>The Content and Marks are provided in or through the Services \"AS IS\" for your personal, non-commercial use or internal business purpose only.</p> <p>Your use of our Services</p> <p>Subject to your compliance with these Legal Terms, including the \"Prohibited activities\" section below, we grant you a non-exclusive, non-transferable, revocable license to:</p> <ul> <li>access the Services; and</li> <li>download or print a copy of any portion of the Content to which you have properly gained access. solely for your personal, non-commercial use or internal business purpose.</li> </ul> <p>Except as set out in this section or elsewhere in our Legal Terms, no part of the Services and no Content or Marks may be copied, reproduced, aggregated, republished, uploaded, posted, publicly displayed, encoded, translated, transmitted, distributed, sold, licensed, or otherwise exploited for any commercial purpose whatsoever, without our express prior written permission.</p> <p>If you wish to make any use of the Services, Content, or Marks other than as set out in this section or elsewhere in our Legal Terms, please address your request to: hello@dstack.ai. If we ever grant you the permission to post, reproduce, or publicly display any part of our Services or Content, you must identify us as the owners or licensors of the Services, Content, or Marks and ensure that any copyright or proprietary notice appears or is visible on posting, reproducing, or displaying our Content.</p> <p>We reserve all rights not expressly granted to you in and to the Services, Content, and Marks.</p> <p>Any breach of these Intellectual Property Rights will constitute a material breach of our Legal Terms and your right to use our Services will terminate immediately.</p> <p>Your submissions</p> <p>Please review this section and the \"Prohibited activities\" section carefully prior to using our Services to understand the (a) rights you give us and (b) obligations you have when you post or upload any content through the Services.</p> <p>Submissions: By directly sending us any question, comment, suggestion, idea, feedback, or other information about the Services (\"Submissions\"), you agree to assign to us all intellectual property rights in such Submission. You agree that we shall own this Submission and be entitled to its unrestricted use and dissemination for any lawful purpose, commercial or otherwise, without acknowledgment or compensation to you.</p> <p>You are responsible for what you post or upload: By sending us Submissions through any part of the Services you: * confirm that you have read and agree with our \"Prohibited activities\" and will not post, send, publish, upload, or * transmit through the Services any Submission that is illegal, harassing, hateful, harmful, defamatory, obscene, * bullying, abusive, discriminatory, threatening to any person or group, sexually explicit, false, inaccurate, deceitful,   or misleading; * to the extent permissible by applicable law, waive any and all moral rights to any such Submission; * warrant that any such Submission are original to you or that you have the necessary rights and licenses to submit such    Submissions and that you have full authority to grant us the above-mentioned rights in relation to your Submissions; and * warrant and represent that your Submissions do not constitute confidential information.</p> <p>You are solely responsible for your Submissions and you expressly agree to reimburse us for any and all losses that we may suffer because of your breach of (a) this section, (b) any third party\u2019s intellectual property rights, or (c) applicable law.</p>"},{"location":"terms/#3-user-representations","title":"3. User representations","text":"<p>By using the Services, you represent and warrant that: (1) all registration information you submit will be true, accurate, current, and complete; (2) you will maintain the accuracy of such information and promptly update such registration information as necessary; (3) you have the legal capacity and you agree to comply with these Legal Terms; ( 4) you are not a minor in the jurisdiction in which you reside; (5) you will not access the Services through automated or non-human means, whether through a bot, script or otherwise; (6) you will not use the Services for any illegal or unauthorized purpose; and (7) your use of the Services will not violate any applicable law or regulation.</p> <p>If you provide any information that is untrue, inaccurate, not current, or incomplete, we have the right to suspend or terminate your account and refuse any and all current or future use of the Services (or any portion thereof).</p>"},{"location":"terms/#4-user-registration","title":"4. User registration","text":"<p>You may be required to register to use the Services. You agree to keep your password confidential and will be responsible for all use of your account and password. We reserve the right to remove, reclaim, or change a username you select if we determine, in our sole discretion, that such username is inappropriate, obscene, or otherwise objectionable.</p>"},{"location":"terms/#5-purchases-and-payment","title":"5. Purchases and payment","text":"<p>We accept the following forms of payment:</p> <ul> <li>Visa</li> <li>Mastercard</li> </ul> <p>You agree to provide current, complete, and accurate purchase and account information for all purchases made via the Services. You further agree to promptly update account and payment information, including email address, payment method, and payment card expiration date, so that we can complete your transactions and contact you as needed. Sales tax will be added to the price of purchases as deemed required by us. We may change prices at any time. All payments shall be in US dollars.</p> <p>You agree to pay all charges at the prices then in effect for your purchases and any applicable shipping fees, and you authorize us to charge your chosen payment provider for any such amounts upon placing your order. We reserve the right to correct any errors or mistakes in pricing, even if we have already requested or received payment.</p> <p>We reserve the right to refuse any order placed through the Services. We may, in our sole discretion, limit or cancel quantities purchased per person, per household, or per order. These restrictions may include orders placed by or under the same customer account, the same payment method, and/or orders that use the same billing or shipping address. We reserve the right to limit or prohibit orders that, in our sole judgment, appear to be placed by dealers, resellers, or distributors.</p>"},{"location":"terms/#6-subscriptions","title":"6. Subscriptions","text":"<p>Billing and Renewal</p> <p>e.g. by topping up their balance manually using their credit card.</p> <p>Cancellation</p> <p>You can cancel your subscription at any time by contacting us using the contact information provided below. Your cancellation will take effect at the end of the current paid term. If you have any questions or are unsatisfied with our Services, please email us at hello@dstack.ai .</p> <p>Fee Changes</p> <p>We may, from time to time, make changes to the subscription fee and will communicate any price changes to you in accordance with applicable law.</p>"},{"location":"terms/#7-software","title":"7. Software","text":"<p>We may include software for use in connection with our Services. If such software is accompanied by an end user license agreement (\"EULA\"), the terms of the EULA will govern your use of the software. If such software is not accompanied by a EULA, then we grant to you a non-exclusive, revocable, personal, and non-transferable license to use such software solely in connection with our services and in accordance with these Legal Terms. Any software and any related documentation is provided \"AS IS\" without warranty of any kind, either express or implied, including, without limitation, the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. You accept any and all risk arising out of use or performance of any software. You may not reproduce or redistribute any software except in accordance with the EULA or these Legal Terms.</p>"},{"location":"terms/#8-prohibited-activities","title":"8. Prohibited activities","text":"<p>You may not access or use the Services for any purpose other than that for which we make the Services available. The Services may not be used in connection with any commercial endeavors except those that are specifically endorsed or approved by us.</p> <p>As a user of the Services, you agree not to:</p> <ul> <li>Systematically retrieve data or other content from the Services to create or compile, directly or indirectly, a   collection, compilation, database, or directory without written permission from us.</li> <li>Trick, defraud, or mislead us and other users, especially in any attempt to learn sensitive account information such   as user passwords.</li> <li>Circumvent, disable, or otherwise interfere with security-related features of the Services, including features that   prevent or restrict the use or copying of any Content or enforce limitations on the use of the Services and/or the   Content contained therein.</li> <li>Disparage, tarnish, or otherwise harm, in our opinion, us and/or the Services.</li> <li>Use any information obtained from the Services in order to harass, abuse, or harm another person.</li> <li>Make improper use of our support services or submit false reports of abuse or misconduct.</li> <li>Use the Services in a manner inconsistent with any applicable laws or regulations.</li> <li>Engage in unauthorized framing of or linking to the Services.</li> <li>Upload or transmit (or attempt to upload or to transmit) viruses, Trojan horses, or other material, including   excessive use of capital letters and spamming (continuous posting of repetitive text), that interferes with any   party\u2019s uninterrupted use and enjoyment of the Services or modifies, impairs, disrupts, alters, or interferes with the   use, features, functions, operation, or maintenance of the Services.</li> <li>Engage in any automated use of the system, such as using scripts to send comments or messages, or using any data   mining, robots, or similar data gathering and extraction tools.</li> <li>Delete the copyright or other proprietary rights notice from any Content.</li> <li>Attempt to impersonate another user or person or use the username of another user.</li> <li>Upload or transmit (or attempt to upload or to transmit) any material that acts as a passive or active information   collection or transmission mechanism, including without limitation, clear graphics interchange formats (\"gifs\"), 1\u00d71   pixels, web bugs, cookies, or other similar devices (sometimes referred to as \"spyware\" or \"passive collection   mechanisms\" or \"pcms\").</li> <li>Interfere with, disrupt, or create an undue burden on the Services or the networks or services connected to the   Services.</li> <li>Harass, annoy, intimidate, or threaten any of our employees or agents engaged in providing any portion of the Services   to you.</li> <li>Attempt to bypass any measures of the Services designed to prevent or restrict access to the Services, or any portion   of the Services.</li> <li>Copy or adapt the Services' software, including but not limited to Flash, PHP, HTML, JavaScript, or other code.</li> <li>Except as permitted by applicable law, decipher, decompile, disassemble, or reverse engineer any of the software   comprising or in any way making up a part of the Services.</li> <li>Except as may be the result of standard search engine or Internet browser usage, use, launch, develop, or distribute   any automated system, including without limitation, any spider, robot, cheat utility, scraper, or offline reader that   accesses the Services, or use or launch any unauthorized script or other software.</li> <li>Use a buying agent or purchasing agent to make purchases on the Services.</li> <li>Make any unauthorized use of the Services, including collecting usernames and/or email addresses of users by   electronic or other means for the purpose of sending unsolicited email, or creating user accounts by automated means   or under false pretenses.</li> <li>Use the Services as part of any effort to compete with us or otherwise use the Services and/or the Content for any   revenue-generating endeavor or commercial enterprise.</li> </ul>"},{"location":"terms/#9-user-generated-contributions","title":"9. User generated contributions","text":"<p>The Services does not offer users to submit or post content.</p>"},{"location":"terms/#10-contribution-license","title":"10. Contribution license","text":"<p>You and Services agree that we may access, store, process, and use any information and personal data that you provide following the terms of the Privacy Policy and your choices (including settings).</p> <p>By submitting suggestions or other feedback regarding the Services, you agree that we can use and share such feedback for any purpose without compensation to you.</p>"},{"location":"terms/#11-social-media","title":"11. Social media","text":"<p>As part of the functionality of the Services, you may link your account with online accounts you have with third-party service providers (each such account, a \"Third-Party Account\") by either: (1) providing your Third-Party Account login information through the Services; or (2) allowing us to access your Third-Party Account, as is permitted under the applicable terms and conditions that govern your use of each Third-Party Account. You represent and warrant that you are entitled to disclose your Third-Party Account login information to us and/or grant us access to your Third-Party Account, without breach by you of any of the terms and conditions that govern your use of the applicable Third-Party Account, and without obligating us to pay any fees or making us subject to any usage limitations imposed by the third-party service provider of the Third-Party Account. By granting us access to any Third-Party Accounts, you understand that (1) we may access, make available, and store (if applicable) any content that you have provided to and stored in your Third-Party Account (the \"Social Network Content\") so that it is available on and through the Services via your account, including without limitation any friend lists and (2) we may submit to and receive from your Third-Party Account additional information to the extent you are notified when you link your account with the Third-Party Account. Depending on the Third-Party Accounts you choose and subject to the privacy settings that you have set in such Third-Party Accounts, personally identifiable information that you post to your Third-Party Accounts may be available on and through your account on the Services. Please note that if a Third-Party Account or associated service becomes unavailable or our access to such Third-Party Account is terminated by the third-party service provider, then Social Network Content may no longer be available on and through the Services. You will have the ability to disable the connection between your account on the Services and your Third-Party Accounts at any time. PLEASE NOTE THAT YOUR RELATIONSHIP WITH THE THIRD-PARTY SERVICE PROVIDERS ASSOCIATED WITH YOUR THIRD-PARTY ACCOUNTS IS GOVERNED SOLELY BY YOUR AGREEMENT(S) WITH SUCH THIRD-PARTY SERVICE PROVIDERS. We make no effort to review any Social Network Content for any purpose, including but not limited to, for accuracy, legality, or non-infringement, and we are not responsible for any Social Network Content. You acknowledge and agree that we may access your email address book associated with a Third-Party Account and your contacts list stored on your mobile device or tablet computer solely for purposes of identifying and informing you of those contacts who have also registered to use the Services. You can deactivate the connection between the Services and your Third-Party Account by contacting us using the contact information below or through your account settings (if applicable). We will attempt to delete any information stored on our servers that was obtained through such Third-Party Account, except the username and profile picture that become associated with your account.</p>"},{"location":"terms/#12-third-party-websites-and-content","title":"12. Third-party websites and content","text":"<p>The Services may contain (or you may be sent via the Site) links to other websites (\"Third-Party Websites\") as well as articles, photographs, text, graphics, pictures, designs, music, sound, video, information, applications, software, and other content or items belonging to or originating from third parties (\"Third-Party Content\"). Such Third-Party Websites and Third-Party Content are not investigated, monitored, or checked for accuracy, appropriateness, or completeness by us, and we are not responsible for any Third-Party Websites accessed through the Services or any Third-Party Content posted on, available through, or installed from the Services, including the content, accuracy, offensiveness, opinions, reliability, privacy practices, or other policies of or contained in the Third-Party Websites or the Third-Party Content. Inclusion of, linking to, or permitting the use or installation of any Third-Party Websites or any Third-Party Content does not imply approval or endorsement thereof by us. If you decide to leave the Services and access the Third-Party Websites or to use or install any Third-Party Content, you do so at your own risk, and you should be aware these Legal Terms no longer govern. You should review the applicable terms and policies, including privacy and data gathering practices, of any website to which you navigate from the Services or relating to any applications you use or install from the Services. Any purchases you make through Third-Party Websites will be through other websites and from other companies, and we take no responsibility whatsoever in relation to such purchases which are exclusively between you and the applicable third party. You agree and acknowledge that we do not endorse the products or services offered on Third-Party Websites and you shall hold us blameless from any harm caused by your purchase of such products or services. Additionally, you shall hold us blameless from any losses sustained by you or harm caused to you relating to or resulting in any way from any Third-Party Content or any contact with Third-Party Websites.</p>"},{"location":"terms/#13-services-management","title":"13. Services management","text":"<p>We reserve the right, but not the obligation, to: (1) monitor the Services for violations of these Legal Terms; (2) take appropriate legal action against anyone who, in our sole discretion, violates the law or these Legal Terms, including without limitation, reporting such user to law enforcement authorities; (3) in our sole discretion and without limitation, refuse, restrict access to, limit the availability of, or disable (to the extent technologically feasible) any of your Contributions or any portion thereof; (4) in our sole discretion and without limitation, notice, or liability, to remove from the Services or otherwise disable all files and content that are excessive in size or are in any way burdensome to our systems; and (5) otherwise manage the Services in a manner designed to protect our rights and property and to facilitate the proper functioning of the Services.</p>"},{"location":"terms/#14-privacy-policy","title":"14. Privacy policy","text":"<p>We care about data privacy and security. Please review our Privacy Policy. By using the Services, you agree to be bound by our Privacy Policy, which is incorporated into these Legal Terms. Please be advised the Services are hosted in Germany and United States. If you access the Services from any other region of the world with laws or other requirements governing personal data collection, use, or disclosure that differ from applicable laws in Germany and United States, then through your continued use of the Services, you are transferring your data to Germany and United States, and you expressly consent to have your data transferred to and processed in Germany and United States.</p>"},{"location":"terms/#15-term-and-termination","title":"15. Term and termination","text":"<p>These Legal Terms shall remain in full force and effect while you use the Services. WITHOUT LIMITING ANY OTHER PROVISION OF THESE LEGAL TERMS, WE RESERVE THE RIGHT TO, IN OUR SOLE DISCRETION AND WITHOUT NOTICE OR LIABILITY, DENY ACCESS TO AND USE OF THE SERVICES (INCLUDING BLOCKING CERTAIN IP ADDRESSES), TO ANY PERSON FOR ANY REASON OR FOR NO REASON, INCLUDING WITHOUT LIMITATION FOR BREACH OF ANY REPRESENTATION, WARRANTY, OR COVENANT CONTAINED IN THESE LEGAL TERMS OR OF ANY APPLICABLE LAW OR REGULATION. WE MAY TERMINATE YOUR USE OR PARTICIPATION IN THE SERVICES OR DELETE YOUR ACCOUNT AND ANY CONTENT OR INFORMATION THAT YOU POSTED AT ANY TIME, WITHOUT WARNING, IN OUR SOLE DISCRETION.</p> <p>If we terminate or suspend your account for any reason, you are prohibited from registering and creating a new account under your name, a fake or borrowed name, or the name of any third party, even if you may be acting on behalf of the third party. In addition to terminating or suspending your account, we reserve the right to take appropriate legal action, including without limitation pursuing civil, criminal, and injunctive redress.</p>"},{"location":"terms/#16-modifications-and-interruptions","title":"16. Modifications and interruptions","text":"<p>We reserve the right to change, modify, or remove the contents of the Services at any time or for any reason at our sole discretion without notice. However, we have no obligation to update any information on our Services. We will not be liable to you or any third party for any modification, price change, suspension, or discontinuance of the Services.</p> <p>We cannot guarantee the Services will be available at all times. We may experience hardware, software, or other problems or need to perform maintenance related to the Services, resulting in interruptions, delays, or errors. We reserve the right to change, revise, update, suspend, discontinue, or otherwise modify the Services at any time or for any reason without notice to you. You agree that we have no liability whatsoever for any loss, damage, or inconvenience caused by your inability to access or use the Services during any downtime or discontinuance of the Services. Nothing in these Legal Terms will be construed to obligate us to maintain and support the Services or to supply any corrections, updates, or releases in connection therewith.</p>"},{"location":"terms/#17-governing-law","title":"17. Governing law","text":"<p>These Legal Terms are governed by and interpreted following the laws of Germany, and the use of the United Nations Convention of Contracts for the International Sales of Goods is expressly excluded. If your habitual residence is in the EU, and you are a consumer, you additionally possess the protection provided to you by obligatory provisions of the law in your country to residence. dstack GmbH and yourself both agree to submit to the non-exclusive jurisdiction of the courts of Bayern, which means that you may make a claim to defend your consumer protection rights in regards to these Legal Terms in Germany, or in the EU country in which you reside.</p>"},{"location":"terms/#18-dispute-resolution","title":"18. Dispute resolution","text":"<p>Informal Negotiations</p> <p>To expedite resolution and control the cost of any dispute, controversy, or claim related to these Legal Terms (each a \" Dispute\" and collectively, the \"Disputes\") brought by either you or us (individually, a \"Party\" and collectively, the \" Parties\"), the Parties agree to first attempt to negotiate any Dispute (except those Disputes expressly provided below) informally for at least thirty (30) days before initiating arbitration. Such informal negotiations commence upon written notice from one Party to the other Party.</p> <p>Binding Arbitration</p> <p>Any dispute arising from the relationships between the Parties to these Legal Terms shall be determined by one arbitrator who will be chosen in accordance with the Arbitration and Internal Rules of the European Court of Arbitration being part of the European Centre of Arbitration having its seat in Strasbourg, and which are in force at the time the application for arbitration is filed, and of which adoption of this clause constitutes acceptance. The seat of arbitration shall be Munich , Germany . The language of the proceedings shall be German . Applicable rules of substantive law shall be the law of Germany .</p> <p>Restrictions</p> <p>The Parties agree that any arbitration shall be limited to the Dispute between the Parties individually. To the full extent permitted by law, (a) no arbitration shall be joined with any other proceeding; (b) there is no right or authority for any Dispute to be arbitrated on a class-action basis or to utilize class action procedures; and (c) there is no right or authority for any Dispute to be brought in a purported representative capacity on behalf of the general public or any other persons.</p> <p>Exceptions to Informal Negotiations and Arbitration</p> <p>The Parties agree that the following Disputes are not subject to the above provisions concerning informal negotiations binding arbitration: (a) any Disputes seeking to enforce or protect, or concerning the validity of, any of the intellectual property rights of a Party; (b) any Dispute related to, or arising from, allegations of theft, piracy, invasion of privacy, or unauthorized use; and (c) any claim for injunctive relief. If this provision is found to be illegal or unenforceable, then neither Party will elect to arbitrate any Dispute falling within that portion of this provision found to be illegal or unenforceable and such Dispute shall be decided by a court of competent jurisdiction within the courts listed for jurisdiction above, and the Parties agree to submit to the personal jurisdiction of that court.</p>"},{"location":"terms/#19-corrections","title":"19. Corrections","text":"<p>There may be information on the Services that contains typographical errors, inaccuracies, or omissions, including descriptions, pricing, availability, and various other information. We reserve the right to correct any errors, inaccuracies, or omissions and to change or update the information on the Services at any time, without prior notice.</p>"},{"location":"terms/#20-disclaimer","title":"20. Disclaimer","text":"<p>THE SERVICES ARE PROVIDED ON AN AS-IS AND AS-AVAILABLE BASIS. YOU AGREE THAT YOUR USE OF THE SERVICES WILL BE AT YOUR SOLE RISK. TO THE FULLEST EXTENT PERMITTED BY LAW, WE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, IN CONNECTION WITH THE SERVICES AND YOUR USE THEREOF, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. WE MAKE NO WARRANTIES OR REPRESENTATIONS ABOUT THE ACCURACY OR COMPLETENESS OF THE SERVICES' CONTENT OR THE CONTENT OF ANY WEBSITES OR MOBILE APPLICATIONS LINKED TO THE SERVICES AND WE WILL ASSUME NO LIABILITY OR RESPONSIBILITY FOR ANY (1) ERRORS, MISTAKES, OR INACCURACIES OF CONTENT AND MATERIALS, (2) PERSONAL INJURY OR PROPERTY DAMAGE, OF ANY NATURE WHATSOEVER, RESULTING FROM YOUR ACCESS TO AND USE OF THE SERVICES, (3) ANY UNAUTHORIZED ACCESS TO OR USE OF OUR SECURE SERVERS AND/OR ANY AND ALL PERSONAL INFORMATION AND/OR FINANCIAL INFORMATION STORED THEREIN, (4) ANY INTERRUPTION OR CESSATION OF TRANSMISSION TO OR FROM THE SERVICES, (5) ANY BUGS, VIRUSES, TROJAN HORSES, OR THE LIKE WHICH MAY BE TRANSMITTED TO OR THROUGH THE SERVICES BY ANY THIRD PARTY, AND/OR (6) ANY ERRORS OR OMISSIONS IN ANY CONTENT AND MATERIALS OR FOR ANY LOSS OR DAMAGE OF ANY KIND INCURRED AS A RESULT OF THE USE OF ANY CONTENT POSTED, TRANSMITTED, OR OTHERWISE MADE AVAILABLE VIA THE SERVICES. WE DO NOT WARRANT, ENDORSE, GUARANTEE, OR ASSUME RESPONSIBILITY FOR ANY PRODUCT OR SERVICE ADVERTISED OR OFFERED BY A THIRD PARTY THROUGH THE SERVICES, ANY HYPERLINKED WEBSITE, OR ANY WEBSITE OR MOBILE APPLICATION FEATURED IN ANY BANNER OR OTHER ADVERTISING, AND WE WILL NOT BE A PARTY TO OR IN ANY WAY BE RESPONSIBLE FOR MONITORING ANY TRANSACTION BETWEEN YOU AND ANY THIRD-PARTY PROVIDERS OF PRODUCTS OR SERVICES. AS WITH THE PURCHASE OF A PRODUCT OR SERVICE THROUGH ANY MEDIUM OR IN ANY ENVIRONMENT, YOU SHOULD USE YOUR BEST JUDGMENT AND EXERCISE CAUTION WHERE APPROPRIATE.</p>"},{"location":"terms/#21-limitations-of-liability","title":"21. Limitations of liability","text":"<p>IN NO EVENT WILL WE OR OUR DIRECTORS, EMPLOYEES, OR AGENTS BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, SPECIAL, OR PUNITIVE DAMAGES, INCLUDING LOST PROFIT, LOST REVENUE, LOSS OF DATA, OR OTHER DAMAGES ARISING FROM YOUR USE OF THE SERVICES, EVEN IF WE HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. NOTWITHSTANDING ANYTHING TO THE CONTRARY CONTAINED HEREIN, OUR LIABILITY TO YOU FOR ANY CAUSE WHATSOEVER AND REGARDLESS OF THE FORM OF THE ACTION, WILL AT ALL TIMES BE LIMITED TO THE LESSER OF THE AMOUNT PAID, IF ANY, BY YOU TO US DURING THE zero (0) MONTH PERIOD PRIOR TO ANY CAUSE OF ACTION ARISING OR $0.00 USD. CERTAIN US STATE LAWS AND INTERNATIONAL LAWS DO NOT ALLOW LIMITATIONS ON IMPLIED WARRANTIES OR THE EXCLUSION OR LIMITATION OF CERTAIN DAMAGES. IF THESE LAWS APPLY TO YOU, SOME OR ALL OF THE ABOVE DISCLAIMERS OR LIMITATIONS MAY NOT APPLY TO YOU, AND YOU MAY HAVE ADDITIONAL RIGHTS.</p>"},{"location":"terms/#22-indemnification","title":"22. Indemnification","text":"<p>You agree to defend, indemnify, and hold us harmless, including our subsidiaries, affiliates, and all of our respective officers, agents, partners, and employees, from and against any loss, damage, liability, claim, or demand, including reasonable attorneys\u2019 fees and expenses, made by any third party due to or arising out of: (1) use of the Services; (2) breach of these Legal Terms; (3) any breach of your representations and warranties set forth in these Legal Terms; (4) your violation of the rights of a third party, including but not limited to intellectual property rights; or (5) any overt harmful act toward any other user of the Services with whom you connected via the Services. Notwithstanding the foregoing, we reserve the right, at your expense, to assume the exclusive defense and control of any matter for which you are required to indemnify us, and you agree to cooperate, at your expense, with our defense of such claims. We will use reasonable efforts to notify you of any such claim, action, or proceeding which is subject to this indemnification upon becoming aware of it.</p>"},{"location":"terms/#23-user-data","title":"23. User data","text":"<p>We will maintain certain data that you transmit to the Services for the purpose of managing the performance of the Services, as well as data relating to your use of the Services. Although we perform regular routine backups of data, you are solely responsible for all data that you transmit or that relates to any activity you have undertaken using the Services. You agree that we shall have no liability to you for any loss or corruption of any such data, and you hereby waive any right of action against us arising from any such loss or corruption of such data.</p>"},{"location":"terms/#24-electronic-communications-transactions-and-signatures","title":"24. Electronic communications, transactions, and signatures","text":"<p>Visiting the Services, sending us emails, and completing online forms constitute electronic communications. You consent to receive electronic communications, and you agree that all agreements, notices, disclosures, and other communications we provide to you electronically, via email and on the Services, satisfy any legal requirement that such communication be in writing. YOU HEREBY AGREE TO THE USE OF ELECTRONIC SIGNATURES, CONTRACTS, ORDERS, AND OTHER RECORDS, AND TO ELECTRONIC DELIVERY OF NOTICES, POLICIES, AND RECORDS OF TRANSACTIONS INITIATED OR COMPLETED BY US OR VIA THE SERVICES. You hereby waive any rights or requirements under any statutes, regulations, rules, ordinances, or other laws in any jurisdiction which require an original signature or delivery or retention of non-electronic records, or to payments or the granting of credits by any means other than electronic means.</p>"},{"location":"terms/#25-california-users-and-residents","title":"25. California users and residents","text":"<p>If any complaint with us is not satisfactorily resolved, you can contact the Complaint Assistance Unit of the Division of Consumer Services of the California Department of Consumer Affairs in writing at 1625 North Market Blvd., Suite N 112, Sacramento, California 95834 or by telephone at (800) 952-5210 or (916) 445-1254.</p>"},{"location":"terms/#26-miscellaneous","title":"26. Miscellaneous","text":"<p>These Legal Terms and any policies or operating rules posted by us on the Services or in respect to the Services constitute the entire agreement and understanding between you and us. Our failure to exercise or enforce any right or provision of these Legal Terms shall not operate as a waiver of such right or provision. These Legal Terms operate to the fullest extent permissible by law. We may assign any or all of our rights and obligations to others at any time. We shall not be responsible or liable for any loss, damage, delay, or failure to act caused by any cause beyond our reasonable control. If any provision or part of a provision of these Legal Terms is determined to be unlawful, void, or unenforceable, that provision or part of the provision is deemed severable from these Legal Terms and does not affect the validity and enforceability of any remaining provisions. There is no joint venture, partnership, employment or agency relationship created between you and us as a result of these Legal Terms or use of the Services. You agree that these Legal Terms will not be construed against us by virtue of having drafted them. You hereby waive any and all defenses you may have based on the electronic form of these Legal Terms and the lack of signing by the parties hereto to execute these Legal Terms.</p>"},{"location":"terms/#27-contact-us","title":"27. Contact us","text":"<p>In order to resolve a complaint regarding the Services or to receive further information regarding use of the Services, please contact us at hello@dstack.ai.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/","title":"Examples","text":""},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/#prerequisites","title":"Prerequisites","text":"<p>Once <code>dstack</code> is installed, clone the repo and run <code>dstack init</code></p> <pre><code>git clone https://github.com/dstackai/dstack\ncd dstack\ndstack init\n</code></pre> <p>Now you are ready to run examples! Select any example from the left-hand sidebar.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/#source-code","title":"Source code","text":"<p>The source-code of examples can be found in  <code>https://github.com/dstackai/dstack/examples</code>.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/#contributing","title":"Contributing","text":"<p>Can't find an important example? Raise an issue or send a pull request!</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/infinity/","title":"Infinity","text":"<p>The following command a text embedding model as a service:</p> <pre><code>dstack run . -f examples/deployment/infinity/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/lorax/","title":"LoRaX","text":"<p>LoRAX allows serving multiple fine-tuned models optimized on the same endpoint by dynamically loading and switching LoRA adapters.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/lorax/#service","title":"Service","text":"<p>The following command deploys Mistral 7B Instruct as a base model via a service:</p> <pre><code>dstack run . -f examples/deployment/lorax/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/lorax/#task","title":"Task","text":"<p>The following command runs Mistral 7B Instruct as a base model via a task:</p> <pre><code>dstack run . -f examples/deployment/lorax/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/ollama/","title":"Ollama","text":"<p>The following command deploys Mixtral 8x7B as a service:</p> <pre><code>dstack run . -f examples/deployment/ollama/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/tei/","title":"Text Embeddings Inference","text":"<p>The following command a text embedding model as a service:</p> <pre><code>dstack run . -f examples/deployment/tae/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/tgi/","title":"Text Generation Inference","text":""},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/tgi/#service","title":"Service","text":"<p>The following command deploys Llama 7B Instruct as a service:</p> <pre><code>dstack run . -f examples/deployment/tgi/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/tgi/#task","title":"Task","text":"<p>The following command runs Llama 7B Instruct as a task:</p> <pre><code>dstack run . -f examples/deployment/tgi/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/vllm/","title":"vLLM","text":""},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/vllm/#service","title":"Service","text":"<p>The following command deploys Llama 7B Instruct as a service:</p> <pre><code>dstack run . -f examples/deployment/vllm/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/vllm/#task","title":"Task","text":"<p>The following command runs Llama 7B Instruct as a task:</p> <pre><code>dstack run . -f examples/deployment/vllm/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/alignment-handbook/","title":"Alignment Handbook","text":"<p>Alignment Handbook by HuggingFace offers recipes, configs, and scripts for fine-tuning LLMs. It includes all the code needed to run CPT, SFT, DPO, and ORPO leveraging HuggingFace's libraries like <code>transformers</code>, <code>peft</code>, <code>accelerate</code>, and <code>trl</code>. You just need to modify the recipes and run the  appropriate script.</p> <p>This example shows how use Alignment Handbook with <code>dstack</code> to fine-tune Gemma 7B on your  SFT dataset using one node or multiple nodes. </p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/alignment-handbook/#prerequisites","title":"Prerequisites","text":"<p>Once <code>dstack</code> is installed, clone the repo and run <code>dstack init</code>:</p> <pre><code>git clone https://github.com/dstackai/dstack\ncd dstack\ndstack init\n</code></pre>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/alignment-handbook/#training-configuration-recipe","title":"Training configuration recipe","text":"<p>Alignment Handbook's training script reads the model, LoRA, and dataset arguments, as well as trainer configuration from a YAML file. This file can be found at <code>examples/fine-tuning/alignment-handbook/config.yaml</code>. You can modify it as needed.</p> <p>Before you proceed with training, make sure to update the <code>hub_model_id</code> in <code>examples/fine-tuning/alignment-handbook/config.yaml</code> with your HuggingFace username.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/alignment-handbook/#single-node-training","title":"Single-node training","text":"<p>The easiest way to run a training script with <code>dstack</code> is by creating a task configuration file. This file can be found at <code>examples/fine-tuning/alignment-handbook/train.dstack.yml</code>. Below is its content: </p> <pre><code>type: task\nname: ah-train\n\n# If `image` is not specified, dstack uses its default image\npython: \"3.10\"\n\n# Required environment variables\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - ACCELERATE_LOG_LEVEL=info\n  - WANDB_API_KEY\n# Commands of the task\ncommands:\n  - conda install cuda\n  - git clone https://github.com/huggingface/alignment-handbook.git\n  - cd alignment-handbook\n  - pip install .\n  - pip install flash-attn --no-build-isolation\n  - pip install wandb\n  - accelerate launch\n    --config_file recipes/accelerate_configs/multi_gpu.yaml\n    --num_processes=$DSTACK_GPUS_NUM\n    scripts/run_sft.py\n    ../examples/fine-tuning/alignment-handbook/config.yaml\n# Uncomment to access TensorBoard\n#ports:\n#  - 6006\n\nresources:\n  # Required resources\n  gpu: 24GB\n</code></pre> <p>The task clones Alignment Handbook's repo, installs the dependencies, and runs the script.</p> <p>The <code>DSTACK_GPUS_NUM</code> environment variable is automatically passed to the container according to the <code>resoruce</code> property.</p> <p>To run the task, use <code>dstack apply</code>:</p> <pre><code>HUGGING_FACE_HUB_TOKEN=...\nWANDB_API_KEY=...\n\ndstack apply -f examples/fine-tuning/alignment-handbook/train.dstack.yml\n</code></pre> <p>If you list <code>tensorbord</code> via <code>report_to</code> in <code>examples/fine-tuning/alignment-handbook/config.yaml</code>, you'll be able to access experiment metrics via <code>http://localhost:6006</code> (while the task is running).</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/alignment-handbook/#multi-node-training","title":"Multi-node training","text":"<p>The multi-node training task configuration file can be found at <code>examples/fine-tuning/alignment-handbook/train-distrib.dstack.yml</code>. Below is its content:</p> <pre><code>type: task\nname: ah-train-distrib\n\n# If `image` is not specified, dstack uses its default image\npython: \"3.10\"\n\n# Required environment variables\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - ACCELERATE_LOG_LEVEL=info\n  - WANDB_API_KEY\n# Commands of the task (dstack runs it on each node)\ncommands:\n  - conda install cuda\n  - git clone https://github.com/huggingface/alignment-handbook.git\n  - cd alignment-handbook\n  - pip install .\n  - pip install flash-attn --no-build-isolation\n  - pip install wandb\n  - accelerate launch\n    --config_file ../examples/fine-tuning/alignment-handbook/fsdp_qlora_full_shard.yaml\n    --main_process_ip=$DSTACK_MASTER_NODE_IP\n    --main_process_port=8008\n    --machine_rank=$DSTACK_NODE_RANK\n    --num_processes=$DSTACK_GPUS_NUM\n    --num_machines=$DSTACK_NODES_NUM\n    scripts/run_sft.py \n    ../examples/fine-tuning/alignment-handbook/config.yaml\n# Expose 6006 to access TensorBoard\nports:\n  - 6006\n\n# The number of interconnected instances required\nnodes: 2\n\nresources:\n  # Required resources\n  gpu: 24GB\n  # Shared memory size for inter-process communication\n  shm_size: 24GB\n</code></pre> <p>Here's how the multi-node task is different from the single-node one:</p> <ol> <li>The <code>nodes</code> property is specified with a number of required nodes (should match the fleet's nodes number).</li> <li>Under <code>resoruces</code>, <code>shm_size</code> is specified with the shared memory size used for the communication of parallel    processes within a node (in case multiple GPUs per node are used).</li> <li>Instead of Alignment Handbook's <code>recipes/accelerate_configs/multi_gpu.yaml</code>, we use <code>examples/fine-tuning/alignment-handbook/fsdp_qlora_full_shard.yaml</code> as an accelerate config.</li> <li>We use <code>DSTACK_MASTER_NODE_IP</code>, <code>DSTACK_NODE_RANK</code>, <code>DSTACK_GPUS_NUM</code>, and <code>DSTACK_NODES_NUM</code> environment variables to    configure <code>accelerate</code>. The environment variables are automatically passed    to the container for each node based on the task configuration.</li> </ol>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/alignment-handbook/#fleets","title":"Fleets","text":"<p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets.  If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p> <p>The example folder includes two cloud fleet configurations: <code>examples/fine-tuning/alignment-handbook/fleet.dstack.yml</code> (a single node with a <code>24GB</code> GPU), and a <code>examples/fine-tuning/alignment-handbook/fleet-distrib.dstack.yml</code> (a cluster of two nodes each with a <code>24GB</code> GPU).</p> <p>You can update the fleet configurations to change the vRAM size, GPU model, number of GPUs per node, or number of nodes. </p> <p>A fleet can be provisioned with <code>dstack apply</code>:</p> <pre><code>dstack apply -f examples/fine-tuning/alignment-handbook/fleet.dstack.yml\n</code></pre> <p>Once provisioned, the fleet can run dev environments and fine-tuning tasks. To delete the fleet, use <code>dstack fleet delete</code>.</p> <p>To ensure <code>dstack apply</code> always reuses an existing fleet, pass <code>--reuse</code> to <code>dstack apply</code> (or set <code>creation_policy</code> to <code>reuse</code> in the task configuration). The default policy is <code>reuse_or_create</code>.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/alignment-handbook/#dev-environment","title":"Dev environment","text":"<p>If you'd like to play with the example using a dev environment, run .dstack.yml via <code>dstack apply</code>:</p> <pre><code>dstack apply -f examples/fine-tuning/alignment-handbook/.dstack.yaml \n</code></pre>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/alignment-handbook/#source-code","title":"Source code","text":"<p>The source-code of this example can be found in  <code>https://github.com/dstackai/dstack/examples/fine-tuning/alignment-handbook</code>.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/alignment-handbook/#contributing","title":"Contributing","text":"<p>Find a mistake or can't find an important example? Raise an issue or send a pull request!</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/alignment-handbook/#whats-next","title":"What's next?","text":"<ol> <li>Browse Alignment Handbook.</li> <li>Check dev environments, tasks,     services, and fleets.</li> <li>See other examples.</li> </ol>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/axolotl/","title":"Axolotl","text":"<p>Axolotl streamlines the fine-tuning of AI models It not only supports multiple configurations and architectures but also provides many ready-to-use recipes. You just need to pick a suitable recipe and adjust it for your use case.</p> <p>This example shows how use Axolotl with <code>dstack</code> to fine-tune Llama3 8B using FSDP and QLoRA on one node.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/axolotl/#prerequisites","title":"Prerequisites","text":"<p>Once <code>dstack</code> is installed, clone the repo and run <code>dstack init</code>:</p> <pre><code>git clone https://github.com/dstackai/dstack\ncd dstack\ndstack init\n</code></pre>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/axolotl/#training-configuration-recipe","title":"Training configuration recipe","text":"<p>Axolotl reads the model, LoRA, and dataset arguments, as well as trainer configuration from a YAML file. This file can be found at <code>examples/fine-tuning/axolotl/config.yaml</code>. You can modify it as needed.</p> <p>Before you proceed with training, make sure to update the <code>hub_model_id</code> in <code>examples/fine-tuning/axolotl/config.yaml</code> with your HuggingFace username.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/axolotl/#single-node-training","title":"Single-node training","text":"<p>The easiest way to run a training script with <code>dstack</code> is by creating a task configuration file. This file can be found at <code>examples/fine-tuning/axolotl/train.dstack.yml</code>. Below is its content: </p> <pre><code>type: task\n# The name is optional, if not specified, generated randomly\nname: axolotl-train\n\n# Using the official Axolotl's Docker image\nimage: winglian/axolotl-cloud:main-20240429-py3.11-cu121-2.2.1\n\n# Required environment variables\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - WANDB_API_KEY\n# Commands of the task\ncommands:\n  - accelerate launch -m axolotl.cli.train examples/fine-tuning/axolotl/config.yaml\n# Expose 6006 to access TensorBoard\nports:\n  - 6006\n\nresources:\n  # Two or more 24GB GPUs (required by FSDP)\n  gpu: 24GB:2..\n</code></pre> <p>The task uses Axolotl's Docker image, where Axolotl is already pre-installed.</p> <p>To run the task, use <code>dstack apply</code>:</p> <pre><code>HUGGING_FACE_HUB_TOKEN=...\nWANDB_API_KEY=...\n\ndstack apply -f examples/fine-tuning/axolotl/train.dstack.yml\n</code></pre> <p>If you list <code>tensorbord</code> via <code>report_to</code> in <code>examples/fine-tuning/axolotl/config.yaml</code>, you'll be able to access experiment metrics via <code>http://localhost:6006</code> (while the task is running).</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/axolotl/#fleets","title":"Fleets","text":"<p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets. If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p> <p>The example folder includes a fleet configuration:   <code>examples/fine-tuning/axolotl/fleet.dstack.yml</code>  ( a single node with a <code>24GB</code> GPU).</p> <p>You can update the fleet configuration to change the vRAM size, GPU model, number of GPUs per node, or number of nodes. </p> <p>A fleet can be provisioned with <code>dstack apply</code>:</p> <pre><code>dstack apply -f examples/fine-tuning/axolotl/fleet.dstack.yml\n</code></pre> <p>Once provisioned, the fleet can run dev environments and fine-tuning tasks. To delete the fleet, use <code>dstack fleet delete</code>.</p> <p>To ensure <code>dstack apply</code> always reuses an existing fleet, pass <code>--reuse</code> to <code>dstack apply</code> (or set <code>creation_policy</code> to <code>reuse</code> in the task configuration). The default policy is <code>reuse_or_create</code>.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/axolotl/#dev-environment","title":"Dev environment","text":"<p>If you'd like to play with the example using a dev environment, run .dstack.yml via <code>dstack apply</code>:</p> <pre><code>dstack apply -f examples/fine-tuning/axolotl/.dstack.yaml \n</code></pre>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/axolotl/#source-code","title":"Source code","text":"<p>The source-code of this example can be found in  <code>https://github.com/dstackai/dstack/examples/fine-tuning/axolotl</code>.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/axolotl/#contributing","title":"Contributing","text":"<p>Find a mistake or can't find an important example? Raise an issue or send a pull request!</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/axolotl/#whats-next","title":"What's next?","text":"<ol> <li>Browse Axolotl.</li> <li>Check dev environments, tasks,     services, and fleets.</li> <li>See other examples.</li> </ol>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/qlora/","title":"QLoRA","text":"<p>The following command runs the task to fine-tune an LLM using QLoRA:</p> <pre><code>dstack run . -f examples/fine-tuning/qlora/task.dstack.yml\n</code></pre> <p>See the configuration at train.dstack.yml.</p> <p>For more details, refer to tasks.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/llms/chat-ui/","title":"Chat UI","text":"<p>This example walks you through setting up Chat UI locally to chat with an LLM deployed using <code>dstack</code>.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/llms/chat-ui/#clone-the-repo","title":"Clone the repo","text":"<pre><code>git clone https://github.com/huggingface/chat-ui\ncd chat-ui\n</code></pre>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/llms/chat-ui/#run-local-mongodb","title":"Run local MongoDB","text":"<pre><code>docker run -d -p 27017:27017 --name mongo-chatui mongo:latest\n</code></pre>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/llms/chat-ui/#create-envlocal","title":"Create <code>.env.local</code>","text":"<pre><code>MONGODB_URL=mongodb://localhost:27017\n\nMODELS=`[\n   {\n      \"name\": \"&lt;model name&gt;\",\n      \"displayName\": \"My model\",\n      \"endpoints\": [\n        {\n         \"type\": \"openai\",\n         \"baseURL\" : \"https://gateway.&lt;gateway domain&gt;\",\n         \"apiKey\": \"&lt;dstack token&gt;\"\n        }\n      ]\n  }\n]`\n</code></pre> <p>Replace <code>&lt;gateway domain&gt;</code> with your <code>dstack</code> gateway's domain (e.g. <code>&lt;dstack project&gt;.sky.dstack.ai</code> if you are using dstack Sky).</p> <p>Replace <code>&lt;dstack token&gt;</code> with your <code>dstack</code> user's token.</p> <p>Replace <code>&lt;model name&gt;</code> with the name of the deployed mode,</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/llms/chat-ui/#run-chat-ui","title":"Run Chat UI","text":"<pre><code>npm run dev\n</code></pre> <p>Now you can conveniently chat with your model! \ud83e\udd17</p> <p></p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/llms/llama3/","title":"Llama 3","text":""},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/llms/llama3/#deploy-llama-8b","title":"Deploy Llama 8B","text":"<p>The following command deploys Llama 3 8B as a service:</p> <pre><code>dstack run . -f examples/llms/llama3/ollama-8b.dstack.yml\n</code></pre> <p>See the configuration at ollama-8b.dstack.yml.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/llms/llama3/#deploy-llama-70b","title":"Deploy Llama 70B","text":"<p>The following command deploys Llama 3 70B as a service:</p> <pre><code>dstack run . -f examples/llms/llama3/ollama-70b.dstack.yml\n</code></pre> <p>See the configuration at ollama-70b.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/llms/llama3/#run-chat-ui","title":"Run Chat UI","text":"<p>Refer to chat-ui to learn how to launch a UI for chatting with the LLM you've deployed to <code>dstack</code>.</p> <p></p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/llms/mixtral/","title":"Mixtral 8x7B","text":"<p>The following command deploys Mixtral 8x7B as a service:</p> <pre><code>dstack run . -f examples/llms/mixtral/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/misc/http.server/","title":"Streamlit","text":""},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/misc/http.server/#service","title":"Service","text":"<p>The following command runs <code>http.server</code> as a service:</p> <pre><code>dstack run . -f examples/misc/http.server/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/misc/http.server/#task","title":"Task","text":"<p>The following command runs <code>http.server</code> as a task:</p> <pre><code>dstack run . -f examples/misc/http.server/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/misc/streamlit/","title":"Streamlit","text":""},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/misc/streamlit/#service-no-auth","title":"Service (no auth)","text":"<p>The following command runs <code>streamlit hello</code> as a service with disabled authentication:</p> <pre><code>dstack run . -f examples/misc/streamlit/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"/tmp/mkdocs_gen_files_k763lh9v/docs/examples/misc/streamlit/#task","title":"Task","text":"<p>The following command runs <code>streamlit hello</code> as a task:</p> <pre><code>dstack run . -f examples/misc/streamlit/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve-task.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"blog/","title":"Blog","text":""},{"location":"blog/archive/say-goodbye-to-managed-notebooks/","title":"Say goodbye to managed notebooks","text":"<p>Data science and ML tools have made significant advancements in recent years. This blog post aims to examine the advantages of cloud dev environments (CDE) for ML engineers and compare them with web-based managed notebooks.</p>"},{"location":"blog/archive/say-goodbye-to-managed-notebooks/#notebooks-are-here-to-stay","title":"Notebooks are here to stay","text":"<p>Jupyter notebooks are instrumental for interactive work with data. They provide numerous advantages such as high interactivity, visualization support, remote accessibility, and effortless sharing.</p> <p>Managed notebook platforms, like Google Colab and AWS SageMaker have become popular thanks to their easy integration with clouds. With pre-configured environments, managed notebooks remove the need to worry about infrastructure.</p> <p></p>"},{"location":"blog/archive/say-goodbye-to-managed-notebooks/#reproducibility-challenge","title":"Reproducibility challenge","text":"<p>As the code evolves, it needs to be converted into Python scripts and stored in Git for improved organization and version control. Notebooks alone cannot handle this task, which is why they must be a part of a developer environment that also supports Python scripts and Git.</p> <p>The JupyterLab project attempts to address this by turning notebooks into an IDE by adding a file browser, terminal, and Git support.</p> <p></p>"},{"location":"blog/archive/say-goodbye-to-managed-notebooks/#ides-get-equipped-for-ml","title":"IDEs get equipped for ML","text":"<p>Recently, IDEs have improved in their ability to support machine learning. They have started to combine the benefits of traditional IDEs and managed notebooks. </p> <p>IDEs have upgraded their remote capabilities, with better SSH support. Additionally, they now offer built-in support for editing notebooks.</p> <p>Two popular IDEs, VS Code and PyCharm, have both integrated remote capabilities and seamless notebook editing features.</p> <p></p>"},{"location":"blog/archive/say-goodbye-to-managed-notebooks/#the-rise-of-app-ecosystem","title":"The rise of app ecosystem","text":"<p>Notebooks have been beneficial for their interactivity and sharing features. However, there are new alternatives like Streamlit and Gradio that allow developers to build data apps using Python code. These frameworks not only simplify app-building but also enhance reproducibility by integrating with Git. </p> <p>Hugging Face Spaces, for example, is a popular tool today for sharing Streamlit and Gradio apps with others.</p> <p></p>"},{"location":"blog/archive/say-goodbye-to-managed-notebooks/#say-hello-to-cloud-dev-environments","title":"Say hello to cloud dev environments!","text":"<p>Remote development within IDEs is becoming increasingly popular, and as a result, cloud dev environments have emerged as a new concept. Various managed services, such as Codespaces and GitPod, offer scalable infrastructure while maintaining the familiar IDE experience.</p> <p>One such open-source tool is <code>dstack</code>, which enables you to define your dev environment declaratively as code and run it on any cloud.</p> <pre><code>type: dev-environment\nbuild:\n  - apt-get update\n  - apt-get install -y ffmpeg\n  - pip install -r requirements.txt\nide: vscode\n</code></pre> <p>With this tool, provisioning the required hardware, setting up the pre-built environment (no Docker is needed), and fetching your local code is automated.</p> <pre><code>$ dstack run .\n\n RUN                 CONFIGURATION  USER   PROJECT  INSTANCE       SPOT POLICY\n honest-jellyfish-1  .dstack.yml    peter  gcp      a2-highgpu-1g  on-demand\n\nStarting SSH tunnel...\n\nTo open in VS Code Desktop, use one of these link:\n  vscode://vscode-remote/ssh-remote+honest-jellyfish-1/workflow\n\nTo exit, press Ctrl+C.\n</code></pre> <p>You can securely access the cloud development environment with the desktop IDE of your choice.</p> <p></p> <p>Learn more</p> <p>Check out our guide for running dev environments in your cloud.</p>"},{"location":"blog/dstack-sky-own-cloud-accounts/","title":"dstack Sky now allows using your own cloud accounts","text":"<p>dstack Sky   enables you to access GPUs from the global marketplace at the most competitive rates. However, sometimes you may want to use your own cloud accounts.  With today's release, both options are now supported.</p> <p></p>"},{"location":"blog/dstack-sky-own-cloud-accounts/#configure-backends","title":"Configure backends","text":"<p>To use your own cloud account, open the project settings and edit the corresponding backend.</p> <p></p> <p>You can configure your cloud accounts for any of the supported providers, including AWS, GCP, Azure, TensorDock, Lambda, CUDO, RunPod, and Vast.ai.</p> <p>Additionally, you can disable certain backends if you do not plan to use them.</p> <p>Typically, if you prefer using your own cloud accounts, it's recommended that you use the  open-source version  of <code>dstack</code>. However, if you prefer not to host it yourself, now you can use <code>dstack Sky</code>  with your own cloud accounts as well.</p> <p>Seeking the cheapest on-demand and spot cloud GPUs? dstack Sky  has you covered!</p> <p>Need help, have a question, or just want to stay updated?</p> <p>Join Discord</p>"},{"location":"blog/dstack-sky/","title":"Introducing dstack Sky","text":"<p>Today we're previewing <code>dstack Sky</code>, a service built on top of  <code>dstack</code> that enables you to get GPUs at competitive rates from a wide pool of providers.</p> <p></p>"},{"location":"blog/dstack-sky/#tldr","title":"TL;DR","text":"<ul> <li>GPUs at competitive rates from multiple providers</li> <li>No need for your own cloud accounts</li> <li>Compatible with <code>dstack</code>'s CLI and API</li> <li>A pre-configured gateway for deploying services</li> </ul>"},{"location":"blog/dstack-sky/#introduction","title":"Introduction","text":"<p><code>dstack</code> is an open-source tool designed for managing AI infrastructure across various cloud platforms. It's lighter and more specifically geared towards AI tasks compared to Kubernetes.</p> <p>Due to its support for multiple cloud providers, <code>dstack</code> is frequently used to access on-demand and spot GPUs  across multiple clouds.  From our users, we've learned that managing various cloud accounts, quotas, and billing can be cumbersome.</p> <p>To streamline this process, we introduce <code>dstack Sky</code>, a managed service that enables users to access GPUs from multiple providers through <code>dstack</code> \u2013 without needing an account in each cloud provider. </p>"},{"location":"blog/dstack-sky/#what-is-dstack-sky","title":"What is dstack Sky?","text":"<p>Instead of running <code>dstack server</code> yourself, you point <code>dstack config</code> to a project set up with <code>dstack Sky</code>.</p> <pre><code>$ dstack config --url https://sky.dstack.ai \\\n    --project my-awesome-project \\\n    --token ca1ee60b-7b3f-8943-9a25-6974c50efa75\n</code></pre> <p>Now, you can use <code>dstack</code>'s CLI or API \u2013 just like you would with your own cloud accounts.</p> <pre><code>$ dstack run . -b tensordock -b vastai\n\n #  BACKEND     REGION  RESOURCES                    SPOT  PRICE \n 1  vastai      canada  16xCPU/64GB/1xRTX4090/1TB    no    $0.35\n 2  vastai      canada  16xCPU/64GB/1xRTX4090/400GB  no    $0.34\n 3  tensordock  us      8xCPU/48GB/1xRTX4090/480GB   no    $0.74\n    ...\n Shown 3 of 50 offers, $0.7424 max\n\nContinue? [y/n]:\n</code></pre> <p>Backends</p> <p><code>dstack Sky</code> supports the same backends as the open-source version, except that you don't need to set them up. By default, it uses all supported backends.</p> <p>You can use both on-demand and spot instances without needing to manage quotas, as they are automatically handled for you.</p> <p>With <code>dstack Sky</code> you can use all of <code>dstack</code>'s features, incl. dev environments,  tasks, services, and  fleets.</p> <p>To use services, the open-source version requires setting up a gateway with your own domain.  <code>dstack Sky</code> comes with a pre-configured gateway.</p> <pre><code>$ dstack gateway list\n BACKEND  REGION     NAME    ADDRESS       DOMAIN                            DEFAULT\n aws      eu-west-1  dstack  3.252.79.143  my-awesome-project.sky.dstack.ai  \u2713\n</code></pre> <p>If you run it with <code>dstack Sky</code>, the service's endpoint will be available at <code>https://&lt;run name&gt;.&lt;project name&gt;.sky.dstack.ai</code>.</p> <p>Let's say we define a service:</p> <pre><code>type: service\n# Deploys Mixtral 8x7B with Ollama\n\n# Serve model using Ollama's Docker image\nimage: ollama/ollama\ncommands:\n  - ollama serve &amp;\n  - sleep 3\n  - ollama pull mixtral\n  - fg\nport: 11434\n\n# Configure hardware requirements\nresources:\n  gpu: 48GB..80GB\n\n# Enable OpenAI compatible endpoint\nmodel:\n  type: chat\n  name: mixtral\n  format: openai\n</code></pre> <p>If it has a <code>model</code> mapping, the model will be accessible at <code>https://gateway.&lt;project name&gt;.sky.dstack.ai</code> via the OpenAI compatible interface.</p> <pre><code>from openai import OpenAI\n\n\nclient = OpenAI(\n  base_url=\"https://gateway.&lt;project name&gt;.sky.dstack.ai\",\n  api_key=\"&lt;dstack token&gt;\"\n)\n\ncompletion = client.chat.completions.create(\n  model=\"mixtral\",\n  messages=[\n    {\"role\": \"user\", \"content\": \"Compose a poem that explains the concept of recursion in programming.\"}\n  ]\n)\n\nprint(completion.choices[0].message)\n</code></pre> <p>Now, you can choose \u2014 either use <code>dstack</code> via the open-source version or via <code>dstack Sky</code>,  or even use them side by side.</p> <p>Credits</p> <p>Are you an active contributor to the AI community? Request free <code>dstack Sky</code> credits.</p> <p><code>dstack Sky</code>  is live on Product Hunt. Support it by giving it your vote!</p> <p>Join Discord</p>"},{"location":"changelog/","title":"Blog","text":""},{"location":"docs/","title":"What is dstack?","text":"<p><code>dstack</code> is an open-source container orchestration engine for AI.  It accelerates the development, training, and deployment of AI models, and simplifies the management of clusters.</p>"},{"location":"docs/#cloud-and-on-prem","title":"Cloud and on-prem","text":"<p><code>dstack</code> is easy to use with any cloud or on-prem servers. Supported cloud providers include AWS, GCP, Azure, OCI, Lambda, TensorDock, Vast.ai, RunPod, and CUDO. For using <code>dstack</code> with on-prem servers, see fleets.</p>"},{"location":"docs/#accelerators","title":"Accelerators","text":"<p><code>dstack</code> supports <code>NVIDIA GPU</code> and <code>Google Cloud TPU</code> out of the box.</p>"},{"location":"docs/#how-does-it-work","title":"How does it work?","text":"<p>Before using <code>dstack</code>, install the server and configure  backends for each cloud account (or Kubernetes cluster) that you intend to use.</p>"},{"location":"docs/#1-define-run-configurations","title":"1. Define run configurations","text":"<p><code>dstack</code> supports three types of run configurations:</p> <ul> <li>Dev environments \u2014 for interactive development using a desktop IDE</li> <li>Tasks \u2014 for any kind of batch jobs or web applications (supports distributed jobs)</li> <li>Services\u2014 for production-grade deployment (supports auto-scaling and authorization)</li> </ul> <p>Each type of run configuration allows you to specify commands for execution, required compute resources, retry policies, auto-scaling rules, authorization settings, and more.</p> <p>Configuration can be defined as YAML files within your repo.</p>"},{"location":"docs/#2-run-configurations","title":"2. Run configurations","text":"<p>Run any defined configuration either via <code>dstack</code> CLI or API.</p> <p><code>dstack</code> automatically handles provisioning, interruptions, port-forwarding, auto-scaling, network, volumes,  run failures, out-of-capacity errors, and more.</p>"},{"location":"docs/#3-manage-fleets","title":"3. Manage fleets","text":"<p>Use fleets to provision and manage clusters and instances, both in the cloud and on-prem.</p>"},{"location":"docs/#where-do-i-start","title":"Where do I start?","text":"<ol> <li>Proceed to installation</li> <li>See quickstart</li> <li>Browse examples </li> <li>Join Discord </li> </ol>"},{"location":"docs/dev-environments/","title":"Dev environments","text":"<p>Before scheduling a task or deploying a model, you may want to run code interactively. Dev environments allow you to provision a remote machine set up with your code and favorite IDE with just one command.</p>"},{"location":"docs/dev-environments/#configuration","title":"Configuration","text":"<p>First, create a YAML file in your project folder. Its name must end with <code>.dstack.yml</code> (e.g. <code>.dstack.yml</code> or <code>dev.dstack.yml</code> are both acceptable).</p> <pre><code>type: dev-environment\n\n# Specify the Python version, or your Docker image\npython: \"3.11\"\n\n# This pre-configures the IDE with required extensions\nide: vscode\n\n# Specify GPU, disk, and other resource requirements\nresources:\n  gpu: 80GB\n</code></pre> <p>If you don't specify your Docker image, <code>dstack</code> uses the base image (pre-configured with Python, Conda, and essential CUDA drivers).</p> <p>Reference</p> <p>See the .dstack.yml reference for all supported configuration options and examples.</p>"},{"location":"docs/dev-environments/#running","title":"Running","text":"<p>To run a configuration, use the <code>dstack run</code> command followed by the working directory path,  configuration file path, and other options.</p> <pre><code>$ dstack run . -f .dstack.yml\n\n BACKEND     REGION         RESOURCES                     SPOT  PRICE\n tensordock  unitedkingdom  10xCPU, 80GB, 1xA100 (80GB)   no    $1.595\n azure       westus3        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n azure       westus2        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n\nContinue? [y/n]: y\n\nProvisioning `fast-moth-1`...\n---&gt; 100%\n\nTo open in VS Code Desktop, use this link:\n  vscode://vscode-remote/ssh-remote+fast-moth-1/workflow\n</code></pre> <p>When <code>dstack</code> provisions the dev environment, it mounts the project folder contents.</p> .gitignore <p>If there are large files or folders you'd like to avoid uploading,  you can list them in <code>.gitignore</code>.</p> Fleets <p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets.  If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p> <p>To have the fleet deleted after a certain idle time automatically, set <code>termination_idle_time</code>. By default, it's set to <code>5min</code>.</p> <p>Reference</p> <p>See the CLI reference for more details on how <code>dstack run</code> works.</p>"},{"location":"docs/dev-environments/#vs-code","title":"VS Code","text":"<p>To open the dev environment in your desktop IDE, use the link from the output  (such as <code>vscode://vscode-remote/ssh-remote+fast-moth-1/workflow</code>).</p> <p></p>"},{"location":"docs/dev-environments/#ssh","title":"SSH","text":"<p>Alternatively, while the CLI is attached to the run, you can connect to the dev environment via SSH:</p> <pre><code>$ ssh fast-moth-1\n</code></pre>"},{"location":"docs/dev-environments/#managing-runs","title":"Managing runs","text":""},{"location":"docs/dev-environments/#listing-runs","title":"Listing runs","text":"<p>The <code>dstack ps</code> command lists all running runs and their status.</p>"},{"location":"docs/dev-environments/#stopping-runs","title":"Stopping runs","text":"<p>Once the run exceeds the max duration, or when you use <code>dstack stop</code>,  the dev environment and its cloud resources are deleted.</p>"},{"location":"docs/dev-environments/#whats-next","title":"What's next?","text":"<ol> <li>Check the <code>.dstack.yml</code> reference for more details and examples</li> <li>See fleets on how to manage fleets</li> </ol>"},{"location":"docs/fleets/","title":"Fleets","text":"<p>Fleets enable efficient provisioning and management of clusters and instances, both in the cloud and on-prem. Once a fleet is created, it can be reused by dev environments, tasks, and services.</p> <p>Fleets is a new feature. To use it, ensure you've installed version <code>0.18.7</code> or higher.</p>"},{"location":"docs/fleets/#configuration","title":"Configuration","text":"<p>To create a fleet, create a YAML file in your project folder. Its name must end with <code>.dstack.yml</code> (e.g. <code>.dstack.yml</code> or <code>fleet.dstack.yml</code> are both acceptable).</p> Cloud fleetsOn-prem fleets <p>To provision a fleet in the cloud using the configured backends, specify the required resources, number of nodes,  and other optional parameters.</p> <pre><code>type: fleet\nname: my-fleet\n\nnodes: 2\nplacement: cluster\n\nbackends: [aws]\n\nresources:\n  gpu: 24GB\n</code></pre> <p>Set <code>placement</code> to <code>cluster</code> if the nodes should be interconnected (e.g. if you'd like to use them for multi-node tasks).  In that case, <code>dstack</code> will provision all nodes in the same backend and region.</p> <p>Defining fleets with YAML isn't supported yet for the <code>kubernetes</code>, <code>vastai</code>, and <code>runpod</code> backends.</p> <p>To create a fleet from on-prem servers, specify their hosts along with the user, port, and SSH key for connection via SSH.</p> <p> <pre><code>type: fleet\nname: my-fleet\n\nplacement: cluster\n\nssh_config:\n  user: ubuntu\n  identity_file: ~/.ssh/id_rsa\n  hosts:\n    - 3.255.177.51\n    - 3.255.177.52\n</code></pre> <p>Requirements</p> <p>The on-prem servers should be pre-installed with CUDA 12.1 and NVIDIA Docker.  The user should have <code>sudo</code> access.</p> <p>Set <code>placement</code> to <code>cluster</code> if the nodes are interconnected (e.g. if you'd like to use them for multi-node tasks). In that case, by default, <code>dstack</code> will automatically detect the private network.  You can specify the <code>network</code> parameter manually.</p> <p>Reference</p> <p>See the .dstack.yml reference for all supported configuration options and examples.</p>"},{"location":"docs/fleets/#creating-and-updating-fleets","title":"Creating and updating fleets","text":"<p>To create or update the fleet, simply call the <code>dstack apply</code> command:</p> <pre><code>$ dstack apply -f examples/fleets/cluster.dstack.yml\nFleet my-fleet does not exist yet. Create the fleet? [y/n]: y\n FLEET     INSTANCE  BACKEND  RESOURCES  PRICE  STATUS   CREATED \n my-fleet  0                                    pending  now     \n           1                                    pending  now     \n</code></pre> <p>Once the status of instances change to <code>idle</code>, they can be used by <code>dstack run</code>.</p>"},{"location":"docs/fleets/#creation-policy","title":"Creation policy","text":"<p>By default, <code>dstack run</code> tries to reuse <code>idle</code> instances from existing fleets.  If no <code>idle</code> instances meet the requirements, <code>dstack run</code> creates a new fleet automatically. To avoid creating new fleet, specify pass <code>--reuse</code> to <code>dstack run</code>.</p>"},{"location":"docs/fleets/#termination-policy","title":"Termination policy","text":"<p>If you want a fleet to be automatically deleted after a certain idle time, you can set the  you can set the <code>termination_idle_time</code> property.</p>"},{"location":"docs/fleets/#managing-fleets","title":"Managing fleets","text":""},{"location":"docs/fleets/#listing-fleets","title":"Listing fleets","text":"<p>The <code>dstack fleet</code> command lists fleet instances and theri status:</p> <pre><code>$ dstack fleet\n FLEET     INSTANCE  BACKEND              GPU             PRICE    STATUS  CREATED \n my-fleet  0         gcp (europe-west-1)  L4:24GB (spot)  $0.1624  idle    3 mins ago      \n           1         gcp (europe-west-1)  L4:24GB (spot)  $0.1624  idle    3 mins ago    \n</code></pre>"},{"location":"docs/fleets/#deleting-fleets","title":"Deleting fleets","text":"<p>When a fleet isn't used by run, you can delete it via <code>dstack delete</code>:</p> <pre><code>$ dstack delete -f cluster.dstack.yaml\nDelete the fleet my-gcp-fleet? [y/n]: y\nFleet my-gcp-fleet deleted\n</code></pre> <p>You can pass either the path to the configuration file or the fleet name directly.</p> <p>To terminate and delete specific instances from a fleet, pass <code>-i INSTANCE_NUM</code>.</p>"},{"location":"docs/quickstart/","title":"Quickstart","text":"<p>Before using <code>dstack</code>, install the server and configure  backends.</p>"},{"location":"docs/quickstart/#initialize-a-repo","title":"Initialize a repo","text":"<p>To use <code>dstack</code>'s CLI in a folder, first run <code>dstack init</code> within that folder.</p> <pre><code>$ mkdir quickstart &amp;&amp; cd quickstart\n$ dstack init\n</code></pre> <p>Your folder can be a regular local folder or a Git repo.</p>"},{"location":"docs/quickstart/#define-a-configuration","title":"Define a configuration","text":"<p>Define what you want to run as a YAML file. The filename must end with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>train.dstack.yml</code> are both acceptable).</p> Dev environmentTaskService <p>Dev environments allow you to quickly provision a machine with a pre-configured environment, resources, IDE, code, etc.</p> <p> <pre><code>type: dev-environment\n\n# Use either `python` or `image` to configure environment\npython: \"3.11\"\n# image: ghcr.io/huggingface/text-generation-inference:latest\n\nide: vscode\n\n# (Optional) Configure `gpu`, `memory`, `disk`, etc\nresources:\n  gpu: 24GB\n</code></pre> <p>Tasks make it very easy to run any scripts, be it for training, data processing, or web apps. They allow you to pre-configure the environment, resources, code, etc.</p> <p> <pre><code>type: task\n\npython: \"3.11\"\nenv:\n  - HF_HUB_ENABLE_HF_TRANSFER=1\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n\n# (Optional) Configure `gpu`, `memory`, `disk`, etc\nresources:\n  gpu: 24GB\n</code></pre> <p>Ensure <code>requirements.txt</code> and <code>train.py</code> are in your folder. You can take them from <code>examples</code>.</p> <p>Services make it easy to deploy models and apps cost-effectively as public endpoints, allowing you to use any frameworks.</p> <p> <pre><code>type: service\n\nimage: ghcr.io/huggingface/text-generation-inference:latest\nenv:\n  - HUGGING_FACE_HUB_TOKEN # required to run gated models\n  - MODEL_ID=mistralai/Mistral-7B-Instruct-v0.1\ncommands:\n  - text-generation-launcher --port 8000 --trust-remote-code\nport: 8000\n\n# (Optional) Configure `gpu`, `memory`, `disk`, etc\nresources:\n  gpu: 24GB\n</code></pre>"},{"location":"docs/quickstart/#run-configuration","title":"Run configuration","text":"<p>Run a configuration using the <code>dstack run</code> command, followed by the working directory path (e.g., <code>.</code>),  and the path to the configuration file.</p> <pre><code>$ dstack run . -f train.dstack.yml\n\n BACKEND     REGION         RESOURCES                     SPOT  PRICE\n tensordock  unitedkingdom  10xCPU, 80GB, 1xA100 (80GB)   no    $1.595\n azure       westus3        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n azure       westus2        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n\nContinue? [y/n]: y\n\nProvisioning...\n---&gt; 100%\n\nEpoch 0:  100% 1719/1719 [00:18&lt;00:00, 92.32it/s, loss=0.0981, acc=0.969]\nEpoch 1:  100% 1719/1719 [00:18&lt;00:00, 92.32it/s, loss=0.0981, acc=0.969]\nEpoch 2:  100% 1719/1719 [00:18&lt;00:00, 92.32it/s, loss=0.0981, acc=0.969]\n</code></pre> <p>The <code>dstack run</code> command automatically uploads your code, including any local uncommitted changes. </p> <p>Fleets</p> <p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets.  If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p>"},{"location":"docs/quickstart/#whats-next","title":"What's next?","text":"<ol> <li>Read about dev environments, tasks,      services, and fleets </li> <li>Browse examples </li> <li>Join the community via Discord </li> </ol>"},{"location":"docs/services/","title":"Services","text":"<p>Services make it easy to deploy models and web applications as public, secure, and scalable endpoints. They are provisioned behind a gateway that automatically provides an HTTPS domain, handles authentication, distributes load, and performs auto-scaling.</p> Gateways <p>If you're using the open-source server, you must set up a gateway before you can run a service.</p> <p>If you're using dstack Sky , the gateway is already set up for you.</p>"},{"location":"docs/services/#configuration","title":"Configuration","text":"<p>First, create a YAML file in your project folder. Its name must end with <code>.dstack.yml</code> (e.g. <code>.dstack.yml</code> or <code>serve.dstack.yml</code> are both acceptable).</p> <pre><code>type: service\n\npython: \"3.11\"\nenv:\n  - MODEL=NousResearch/Llama-2-7b-chat-hf\ncommands:\n  - pip install vllm\n  - python -m vllm.entrypoints.openai.api_server --model $MODEL --port 8000\nport: 8000\n\nresources:\n  gpu: 80GB\n\n# (Optional) Enable the OpenAI-compatible endpoint\nmodel:\n  format: openai\n  type: chat\n  name: NousResearch/Llama-2-7b-chat-hf\n</code></pre> <p>If you don't specify your Docker image, <code>dstack</code> uses the base image (pre-configured with Python, Conda, and essential CUDA drivers).</p> <p>Auto-scaling</p> <p>By default, the service is deployed to a single instance. However, you can specify the number of replicas and scaling policy. In this case, <code>dstack</code> auto-scales it based on the load.</p> <p>Reference</p> <p>See the .dstack.yml reference for all supported configuration options and examples.</p>"},{"location":"docs/services/#running","title":"Running","text":"<p>To run a configuration, use the <code>dstack run</code> command followed by the working directory path,  configuration file path, and any other options.</p> <pre><code>$ dstack run . -f serve.dstack.yml\n\n BACKEND     REGION         RESOURCES                     SPOT  PRICE\n tensordock  unitedkingdom  10xCPU, 80GB, 1xA100 (80GB)   no    $1.595\n azure       westus3        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n azure       westus2        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n\nContinue? [y/n]: y\n\nProvisioning...\n---&gt; 100%\n\nService is published at https://yellow-cat-1.example.com\n</code></pre> <p>When deploying the service, <code>dstack run</code> mounts the current folder's contents.</p> .gitignore <p>If there are large files or folders you'd like to avoid uploading,  you can list them in <code>.gitignore</code>.</p> Fleets <p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets.  If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p> <p>To have the fleet deleted after a certain idle time automatically, set <code>termination_idle_time</code>. By default, it's set to <code>5min</code>.</p> <p>Reference</p> <p>See the CLI reference for more details on how <code>dstack run</code> works.</p>"},{"location":"docs/services/#service-endpoint","title":"Service endpoint","text":"<p>One the service is up, its endpoint is accessible at <code>https://&lt;run name&gt;.&lt;gateway domain&gt;</code>.</p> <p>By default, the service endpoint requires the <code>Authorization</code> header with <code>Bearer &lt;dstack token&gt;</code>. </p> <pre><code>$ curl https://yellow-cat-1.example.com/v1/chat/completions \\\n    -H 'Content-Type: application/json' \\\n    -H 'Authorization: Bearer &amp;lt;dstack token&amp;gt;' \\\n    -d '{\n        \"model\": \"NousResearch/Llama-2-7b-chat-hf\",\n        \"messages\": [\n            {\n                \"role\": \"user\",\n                \"content\": \"Compose a poem that explains the concept of recursion in programming.\"\n            }\n        ]\n    }'\n</code></pre> <p>Authorization can be disabled by setting <code>auth</code> to <code>false</code> in the service configuration file.</p>"},{"location":"docs/services/#model-endpoint","title":"Model endpoint","text":"<p>In case the service has the model mapping configured, you will also be able to access the model at <code>https://gateway.&lt;gateway domain&gt;</code> via the OpenAI-compatible interface.</p>"},{"location":"docs/services/#managing-runs","title":"Managing runs","text":""},{"location":"docs/services/#listing-runs","title":"Listing runs","text":"<p>The <code>dstack ps</code> command lists all running runs and their status.</p>"},{"location":"docs/services/#stopping-runs","title":"Stopping runs","text":"<p>When you use <code>dstack stop</code>, the service and its cloud resources are deleted.</p>"},{"location":"docs/services/#whats-next","title":"What's next?","text":"<ol> <li>Check the Text Generation Inference  and vLLM  examples</li> <li>Check the <code>.dstack.yml</code> reference for more details and examples</li> <li>See gateways on how to set up a gateway</li> <li>Browse examples </li> <li>See fleets on how to manage fleets</li> </ol>"},{"location":"docs/tasks/","title":"Tasks","text":"<p>Tasks allow for convenient scheduling of various batch jobs, such as training, fine-tuning, or data processing. They can also be used to run web applications when features offered by services are not needed, such as for debugging.</p> <p>You can run tasks on a single machine or on a cluster of nodes.</p>"},{"location":"docs/tasks/#configuration","title":"Configuration","text":"<p>First, create a YAML file in your project folder. Its name must end with <code>.dstack.yml</code> (e.g. <code>.dstack.yml</code> or <code>train.dstack.yml</code> are both acceptable).</p> <pre><code>type: task\n\npython: \"3.11\"\nenv:\n  - HF_HUB_ENABLE_HF_TRANSFER=1\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - tensorboard --logdir results/runs &amp;\n  - python fine-tuning/qlora/train.py\nports:\n  - 6000\n\n# (Optional) Configure `gpu`, `memory`, `disk`, etc\nresources:\n  gpu: 80GB\n</code></pre> <p>If you don't specify your Docker image, <code>dstack</code> uses the base image (pre-configured with Python, Conda, and essential CUDA drivers).</p> <p>Distributed tasks</p> <p>By default, tasks run on a single instance. However, you can specify the number of nodes. In this case, <code>dstack</code> provisions a cluster of instances.</p> <p>Reference</p> <p>See the .dstack.yml reference for all supported configuration options and examples.</p>"},{"location":"docs/tasks/#running","title":"Running","text":"<p>To run a configuration, use the <code>dstack run</code> command followed by the working directory path,  configuration file path, and other options.</p> <pre><code>$ dstack run . -f train.dstack.yml\n\n BACKEND     REGION         RESOURCES                     SPOT  PRICE\n tensordock  unitedkingdom  10xCPU, 80GB, 1xA100 (80GB)   no    $1.595\n azure       westus3        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n azure       westus2        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n\nContinue? [y/n]: y\n\nProvisioning...\n---&gt; 100%\n\nTensorBoard 2.13.0 at http://localhost:6006/ (Press CTRL+C to quit)\n\nEpoch 0:  100% 1719/1719 [00:18&lt;00:00, 92.32it/s, loss=0.0981, acc=0.969]\nEpoch 1:  100% 1719/1719 [00:18&lt;00:00, 92.32it/s, loss=0.0981, acc=0.969]\nEpoch 2:  100% 1719/1719 [00:18&lt;00:00, 92.32it/s, loss=0.0981, acc=0.969]\n</code></pre> <p>If the task specifies <code>ports</code>, <code>dstack run</code> automatically forwards them to your local machine for convenient and secure access.</p> <p>When running the task, <code>dstack run</code> mounts the current folder's contents.</p> .gitignore <p>If there are large files or folders you'd like to avoid uploading,  you can list them in <code>.gitignore</code>.</p> Fleets <p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets.  If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p> <p>To have the fleet deleted after a certain idle time automatically, set <code>termination_idle_time</code>. By default, it's set to <code>5min</code>.</p> <p>Reference</p> <p>See the CLI reference for more details on how <code>dstack run</code> works.</p>"},{"location":"docs/tasks/#managing-runs","title":"Managing runs","text":""},{"location":"docs/tasks/#listing-runs","title":"Listing runs","text":"<p>The <code>dstack ps</code> command lists all running runs and their status.</p>"},{"location":"docs/tasks/#stopping-runs","title":"Stopping runs","text":"<p>Once you use <code>dstack stop</code> (or when the run exceeds the <code>max_duration</code>), the instances return to the fleet.</p>"},{"location":"docs/tasks/#whats-next","title":"What's next?","text":"<ol> <li>Check the QLoRA  example</li> <li>Check the <code>.dstack.yml</code> reference for more details and examples</li> <li>Browse all examples </li> <li>See fleets on how to manage fleets</li> </ol>"},{"location":"docs/concepts/gateways/","title":"Gateways","text":"<p>Gateways handle the ingress traffic of running services. They provide services with HTTPS domains, handle authentication, distribute load, and perform auto-scaling. In order to run a service, you need to have at least one gateway set up.</p> <p>If you're using dstack Sky , the gateway is already set up for you.</p>"},{"location":"docs/concepts/gateways/#configuration","title":"Configuration","text":"<p>First, create a YAML file in your project folder. Its name must end with <code>.dstack.yml</code> (e.g. <code>.dstack.yml</code> or <code>gateway.dstack.yml</code> are both acceptable).</p> <pre><code>type: gateway\nname: example-gateway\n\nbackend: aws\nregion: eu-west-1\ndomain: example.com\n</code></pre> <p>A domain name is required to create a gateway.</p> <p>Reference</p> <p>See the .dstack.yml reference for all supported configuration options and examples.</p>"},{"location":"docs/concepts/gateways/#creating-and-updating-gateways","title":"Creating and updating gateways","text":"<p>To create or update the gateway, simply call the <code>dstack apply</code> command:</p> <pre><code>$ dstack apply . -f examples/deployment/gateway.dstack.yml\n\nThe example-gateway doesn't exist. Create it? [y/n]: y\n\n BACKEND  REGION     NAME             HOSTNAME  DOMAIN       DEFAULT  STATUS\n aws      eu-west-1  example-gateway            example.com  \u2713        submitted\n</code></pre>"},{"location":"docs/concepts/gateways/#updating-dns-records","title":"Updating DNS records","text":"<p>Once the gateway is assigned a hostname, go to your domain's DNS settings and add an <code>A</code> DNS record for <code>*.&lt;gateway domain&gt;</code> (e.g., <code>*.example.com</code>) pointing to the gateway's hostname.</p> <p>This will allow you to access runs and models using this domain.</p>"},{"location":"docs/concepts/gateways/#managing-gateways","title":"Managing gateways","text":""},{"location":"docs/concepts/gateways/#listing-gateways","title":"Listing gateways","text":"<p>The <code>dstack gateway list</code> command lists existing gateways and their status.</p>"},{"location":"docs/concepts/gateways/#deleting-gateways","title":"Deleting gateways","text":"<p>To delete a gateway, pass gateway configuration to <code>dstack delete</code>:</p> <pre><code>$ dstack delete . -f examples/deployment/gateway.dstack.yml\n</code></pre>"},{"location":"docs/concepts/gateways/#whats-next","title":"What's next?","text":"<ol> <li>See services on how to run services</li> <li>Check the <code>.dstack.yml</code> reference for more details and examples</li> </ol>"},{"location":"docs/concepts/pools/","title":"Pools","text":"<p>Pools enable the efficient reuse of cloud instances and on-premises servers across runs, simplifying their management.</p>"},{"location":"docs/concepts/pools/#adding-instances","title":"Adding instances","text":""},{"location":"docs/concepts/pools/#automatic-provisioning","title":"Automatic provisioning","text":"<p>By default, when using the <code>dstack run</code> command, it tries to reuse an instance from a pool. If no idle instance meets the requirements, <code>dstack</code> automatically provisions a new cloud instance and adds it to the pool.</p> Reuse policy <p>To avoid provisioning new cloud instances with <code>dstack run</code>, use <code>--reuse</code>. Your run will be assigned to an idle instance in the pool. If there are no available idle instances in the pool, the run will fail.</p> Idle duration <p>By default, <code>dstack run</code> sets the idle duration of a newly provisioned instance to <code>5m</code>. This means that if the run is finished and the instance remains idle for longer than five minutes, it is automatically removed from the pool. To override the default idle duration, use  <code>--idle-duration DURATION</code> with <code>dstack run</code>.</p>"},{"location":"docs/concepts/pools/#manual-provisioning","title":"Manual provisioning","text":"<p>To manually provision a cloud instance and add it to a pool, use <code>dstack pool add</code>:</p> <pre><code>$ dstack pool add --gpu 80GB\n\n BACKEND     REGION         RESOURCES                     SPOT  PRICE\n tensordock  unitedkingdom  10xCPU, 80GB, 1xA100 (80GB)   no    $1.595\n azure       westus3        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n azure       westus2        24xCPU, 220GB, 1xA100 (80GB)  no    $3.673\n\nContinue? [y/n]: y\n</code></pre> <p>The <code>dstack pool add</code> command allows specifying resource requirements, along with the spot policy, idle duration, max price, retry policy, and other policies.</p> Idle duration <p>The default idle duration if you're using <code>dstack pool add</code> is <code>72h</code>. To override it, use the <code>--idle-duration DURATION</code> argument.</p> <p>You can also specify the policies via <code>.dstack/profiles.yml</code> instead of passing them as arguments. For more details on policies and their defaults, refer to <code>.dstack/profiles.yml</code>.</p> Limitations <p>The <code>dstack pool add</code> command is not supported for Kubernetes, VastAI, and RunPod backends yet.</p>"},{"location":"docs/concepts/pools/#adding-on-prem-clusters","title":"Adding on-prem clusters","text":"<p>Any on-prem server that can be accessed via SSH can be added to a pool and used to run workloads.</p> <p>To add on-prem servers to the pool, use the <code>dstack pool add-ssh</code> command and pass the hostname of your server along with the SSH key.</p> <pre><code>$ dstack pool add-ssh -i ~/.ssh/id_rsa ubuntu@54.73.155.119\n</code></pre> <p>The command accepts the same arguments as the standard <code>ssh</code> command.</p> <p>Requirements</p> <p>The on-prem server should be pre-installed with CUDA 12.1 and NVIDIA Docker.</p> <p>Once the instance is provisioned, you'll see it in the pool and will be able to run workloads on it.</p>"},{"location":"docs/concepts/pools/#clusters","title":"Clusters","text":"<p>If you want on-prem instances to run multi-node tasks, ensure these on-prem servers share the same private network. Additionally, you need to pass the <code>--network</code> option to <code>dstack pool add-ssh</code>:</p> <pre><code>$ dstack pool add-ssh -i ~/.ssh/id_rsa ubuntu@54.73.155.119 \\\n    --network 10.0.0.0/24\n</code></pre> <p>The <code>--network</code> argument accepts the IP address range (CIDR) of the private network of the instance.</p> <p>Once you've added multiple instances with the same network value, you can use them as a cluster to run multi-node tasks.</p>"},{"location":"docs/concepts/pools/#removing-instances","title":"Removing instances","text":"<p>If the instance remains idle for the configured idle duration, <code>dstack</code> removes it and deletes all cloud resources.</p> <p>To remove an instance from the pool manually, use the <code>dstack pool rm</code> command. </p> <pre><code>$ dstack pool rm &amp;lt;instance name&amp;gt;\n</code></pre>"},{"location":"docs/concepts/pools/#list-instances","title":"List instances","text":"<p>The <code>dstack pool ps</code> command lists active instances and their status (<code>busy</code> or <code>idle</code>).</p>"},{"location":"docs/concepts/volumes/","title":"Volumes","text":"<p>Volumes allow you to persist data between runs. <code>dstack</code> simplifies managing volumes and lets you mount them to a specific directory when working with dev environments, tasks, and services.</p> <p>Experimental</p> <p>Volumes are currently experimental and work with the <code>aws</code>, <code>gcp</code>, and <code>runpod</code> backends. Support for other backends is coming soon.</p>"},{"location":"docs/concepts/volumes/#configuration","title":"Configuration","text":"<p>First, create a YAML file in your project folder. Its name must end with <code>.dstack.yml</code> (e.g. <code>.dstack.yml</code> or <code>vol.dstack.yml</code> are both acceptable).</p> <pre><code>type: volume\nname: my-new-volume\nbackend: aws\nregion: eu-central-1\nsize: 100GB\n</code></pre> <p>If you use this configuration, <code>dstack</code> will create a new volume based on the specified options.</p> <p>Registering existing volumes</p> <p>If you prefer not to create a new volume but to reuse an existing one (e.g., created manually), you can  specify its ID via <code>volume_id</code>. In this case, <code>dstack</code> will register the specified volume so that you can use it with dev environments, tasks, and services.</p> <p>Reference</p> <p>See the .dstack.yml reference for all supported configuration options and examples.</p>"},{"location":"docs/concepts/volumes/#creating-and-registering-volumes","title":"Creating and registering volumes","text":"<p>To create or register the volume, simply call the <code>dstack apply</code> command:</p> <pre><code>$ dstack apply -f volume.dstack.yml\nVolume my-new-volume does not exist yet. Create the volume? [y/n]: y\n NAME           BACKEND  REGION        STATUS     CREATED \n my-new-volume  aws      eu-central-1  submitted  now     \n</code></pre> <p>When creating the volume <code>dstack</code> automatically creates an <code>ext4</code> file system on it.</p> <p>Once created, the volume can be attached with dev environments, tasks, and services.</p>"},{"location":"docs/concepts/volumes/#attaching-volumes","title":"Attaching volumes","text":"<p>Dev environments, tasks, and services let you attach any number of volumes. To attach a volume, simply specify its name using the <code>volumes</code> property and specify where to mount its contents:</p> <pre><code>type: dev-environment\nide: vscode\nvolumes:\n  - name: my-new-volume\n    path: /volume_data\n</code></pre> <p>Once you run this configuration, the contents of the volume will be attached to <code>/volume_data</code> inside the dev environment,  and its contents will persist across runs.</p> <p>Limitations</p> <p>When you're running a dev environment, task, or service with <code>dstack</code>, it automatically mounts the project folder contents to <code>/workflow</code> (and sets that as the current working directory). Right now, <code>dstack</code> doesn't allow you to  attach volumes to <code>/workflow</code> or any of its subdirectories.</p>"},{"location":"docs/concepts/volumes/#managing-volumes","title":"Managing volumes","text":""},{"location":"docs/concepts/volumes/#listing-volumes","title":"Listing volumes","text":"<p>The <code>dstack volume list</code> command lists created and registered volumes:</p> <pre><code>$ dstack volume list\nNAME            BACKEND  REGION        STATUS  CREATED\n my-new-volume  aws      eu-central-1  active  3 weeks ago\n</code></pre>"},{"location":"docs/concepts/volumes/#deleting-volumes","title":"Deleting volumes","text":"<p>When the volume isn't attached to any active dev environment, task, or service, you can delete it using <code>dstack delete</code>:</p> <pre><code>$ dstack delete -f vol.dstack.yaml\n</code></pre> <p>If the volume was created using <code>dstack</code>, it will be physically destroyed along with the data. If you've registered an existing volume, it will be de-registered with <code>dstack</code> but will keep the data.</p>"},{"location":"docs/concepts/volumes/#faq","title":"FAQ","text":"Using volumes across backends <p>Since volumes are backed up by cloud network disks, you can only use them within the same cloud. If you need to access data across different backends, you should either use object storage or replicate the data across multiple volumes.</p> Using volumes across regions <p>Typically, network volumes are associated with specific regions, so you can't use them in other regions. Often, volumes are also linked to availability zones, but some providers support volumes that can be used across different availability zones within the same region.</p> Attaching volumes to multiple runs and instances <p>You can mount a volume in multiple runs. This feature is currently supported only by the <code>runpod</code> backend.</p>"},{"location":"docs/examples/","title":"Examples","text":""},{"location":"docs/examples/#prerequisites","title":"Prerequisites","text":"<p>Once <code>dstack</code> is installed, clone the repo and run <code>dstack init</code></p> <pre><code>git clone https://github.com/dstackai/dstack\ncd dstack\ndstack init\n</code></pre> <p>Now you are ready to run examples! Select any example from the left-hand sidebar.</p>"},{"location":"docs/examples/#source-code","title":"Source code","text":"<p>The source-code of examples can be found in  <code>https://github.com/dstackai/dstack/examples</code>.</p>"},{"location":"docs/examples/#contributing","title":"Contributing","text":"<p>Can't find an important example? Raise an issue or send a pull request!</p>"},{"location":"docs/examples/deployment/infinity/","title":"Infinity","text":"<p>The following command a text embedding model as a service:</p> <pre><code>dstack run . -f examples/deployment/infinity/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"docs/examples/deployment/lorax/","title":"LoRaX","text":"<p>LoRAX allows serving multiple fine-tuned models optimized on the same endpoint by dynamically loading and switching LoRA adapters.</p>"},{"location":"docs/examples/deployment/lorax/#service","title":"Service","text":"<p>The following command deploys Mistral 7B Instruct as a base model via a service:</p> <pre><code>dstack run . -f examples/deployment/lorax/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"docs/examples/deployment/lorax/#task","title":"Task","text":"<p>The following command runs Mistral 7B Instruct as a base model via a task:</p> <pre><code>dstack run . -f examples/deployment/lorax/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"docs/examples/deployment/ollama/","title":"Ollama","text":"<p>The following command deploys Mixtral 8x7B as a service:</p> <pre><code>dstack run . -f examples/deployment/ollama/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"docs/examples/deployment/tei/","title":"Text Embeddings Inference","text":"<p>The following command a text embedding model as a service:</p> <pre><code>dstack run . -f examples/deployment/tae/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"docs/examples/deployment/tgi/","title":"Text Generation Inference","text":""},{"location":"docs/examples/deployment/tgi/#service","title":"Service","text":"<p>The following command deploys Llama 7B Instruct as a service:</p> <pre><code>dstack run . -f examples/deployment/tgi/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"docs/examples/deployment/tgi/#task","title":"Task","text":"<p>The following command runs Llama 7B Instruct as a task:</p> <pre><code>dstack run . -f examples/deployment/tgi/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"docs/examples/deployment/vllm/","title":"vLLM","text":""},{"location":"docs/examples/deployment/vllm/#service","title":"Service","text":"<p>The following command deploys Llama 7B Instruct as a service:</p> <pre><code>dstack run . -f examples/deployment/vllm/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"docs/examples/deployment/vllm/#task","title":"Task","text":"<p>The following command runs Llama 7B Instruct as a task:</p> <pre><code>dstack run . -f examples/deployment/vllm/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/","title":"Alignment Handbook","text":"<p>Alignment Handbook by HuggingFace offers recipes, configs, and scripts for fine-tuning LLMs. It includes all the code needed to run CPT, SFT, DPO, and ORPO leveraging HuggingFace's libraries like <code>transformers</code>, <code>peft</code>, <code>accelerate</code>, and <code>trl</code>. You just need to modify the recipes and run the  appropriate script.</p> <p>This example shows how use Alignment Handbook with <code>dstack</code> to fine-tune Gemma 7B on your  SFT dataset using one node or multiple nodes. </p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#prerequisites","title":"Prerequisites","text":"<p>Once <code>dstack</code> is installed, clone the repo and run <code>dstack init</code>:</p> <pre><code>git clone https://github.com/dstackai/dstack\ncd dstack\ndstack init\n</code></pre>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#training-configuration-recipe","title":"Training configuration recipe","text":"<p>Alignment Handbook's training script reads the model, LoRA, and dataset arguments, as well as trainer configuration from a YAML file. This file can be found at <code>examples/fine-tuning/alignment-handbook/config.yaml</code>. You can modify it as needed.</p> <p>Before you proceed with training, make sure to update the <code>hub_model_id</code> in <code>examples/fine-tuning/alignment-handbook/config.yaml</code> with your HuggingFace username.</p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#single-node-training","title":"Single-node training","text":"<p>The easiest way to run a training script with <code>dstack</code> is by creating a task configuration file. This file can be found at <code>examples/fine-tuning/alignment-handbook/train.dstack.yml</code>. Below is its content: </p> <pre><code>type: task\nname: ah-train\n\n# If `image` is not specified, dstack uses its default image\npython: \"3.10\"\n\n# Required environment variables\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - ACCELERATE_LOG_LEVEL=info\n  - WANDB_API_KEY\n# Commands of the task\ncommands:\n  - conda install cuda\n  - git clone https://github.com/huggingface/alignment-handbook.git\n  - cd alignment-handbook\n  - pip install .\n  - pip install flash-attn --no-build-isolation\n  - pip install wandb\n  - accelerate launch\n    --config_file recipes/accelerate_configs/multi_gpu.yaml\n    --num_processes=$DSTACK_GPUS_NUM\n    scripts/run_sft.py\n    ../examples/fine-tuning/alignment-handbook/config.yaml\n# Uncomment to access TensorBoard\n#ports:\n#  - 6006\n\nresources:\n  # Required resources\n  gpu: 24GB\n</code></pre> <p>The task clones Alignment Handbook's repo, installs the dependencies, and runs the script.</p> <p>The <code>DSTACK_GPUS_NUM</code> environment variable is automatically passed to the container according to the <code>resoruce</code> property.</p> <p>To run the task, use <code>dstack apply</code>:</p> <pre><code>HUGGING_FACE_HUB_TOKEN=...\nWANDB_API_KEY=...\n\ndstack apply -f examples/fine-tuning/alignment-handbook/train.dstack.yml\n</code></pre> <p>If you list <code>tensorbord</code> via <code>report_to</code> in <code>examples/fine-tuning/alignment-handbook/config.yaml</code>, you'll be able to access experiment metrics via <code>http://localhost:6006</code> (while the task is running).</p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#multi-node-training","title":"Multi-node training","text":"<p>The multi-node training task configuration file can be found at <code>examples/fine-tuning/alignment-handbook/train-distrib.dstack.yml</code>. Below is its content:</p> <pre><code>type: task\nname: ah-train-distrib\n\n# If `image` is not specified, dstack uses its default image\npython: \"3.10\"\n\n# Required environment variables\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - ACCELERATE_LOG_LEVEL=info\n  - WANDB_API_KEY\n# Commands of the task (dstack runs it on each node)\ncommands:\n  - conda install cuda\n  - git clone https://github.com/huggingface/alignment-handbook.git\n  - cd alignment-handbook\n  - pip install .\n  - pip install flash-attn --no-build-isolation\n  - pip install wandb\n  - accelerate launch\n    --config_file ../examples/fine-tuning/alignment-handbook/fsdp_qlora_full_shard.yaml\n    --main_process_ip=$DSTACK_MASTER_NODE_IP\n    --main_process_port=8008\n    --machine_rank=$DSTACK_NODE_RANK\n    --num_processes=$DSTACK_GPUS_NUM\n    --num_machines=$DSTACK_NODES_NUM\n    scripts/run_sft.py \n    ../examples/fine-tuning/alignment-handbook/config.yaml\n# Expose 6006 to access TensorBoard\nports:\n  - 6006\n\n# The number of interconnected instances required\nnodes: 2\n\nresources:\n  # Required resources\n  gpu: 24GB\n  # Shared memory size for inter-process communication\n  shm_size: 24GB\n</code></pre> <p>Here's how the multi-node task is different from the single-node one:</p> <ol> <li>The <code>nodes</code> property is specified with a number of required nodes (should match the fleet's nodes number).</li> <li>Under <code>resoruces</code>, <code>shm_size</code> is specified with the shared memory size used for the communication of parallel    processes within a node (in case multiple GPUs per node are used).</li> <li>Instead of Alignment Handbook's <code>recipes/accelerate_configs/multi_gpu.yaml</code>, we use <code>examples/fine-tuning/alignment-handbook/fsdp_qlora_full_shard.yaml</code> as an accelerate config.</li> <li>We use <code>DSTACK_MASTER_NODE_IP</code>, <code>DSTACK_NODE_RANK</code>, <code>DSTACK_GPUS_NUM</code>, and <code>DSTACK_NODES_NUM</code> environment variables to    configure <code>accelerate</code>. The environment variables are automatically passed    to the container for each node based on the task configuration.</li> </ol>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#fleets","title":"Fleets","text":"<p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets.  If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p> <p>The example folder includes two cloud fleet configurations: <code>examples/fine-tuning/alignment-handbook/fleet.dstack.yml</code> (a single node with a <code>24GB</code> GPU), and a <code>examples/fine-tuning/alignment-handbook/fleet-distrib.dstack.yml</code> (a cluster of two nodes each with a <code>24GB</code> GPU).</p> <p>You can update the fleet configurations to change the vRAM size, GPU model, number of GPUs per node, or number of nodes. </p> <p>A fleet can be provisioned with <code>dstack apply</code>:</p> <pre><code>dstack apply -f examples/fine-tuning/alignment-handbook/fleet.dstack.yml\n</code></pre> <p>Once provisioned, the fleet can run dev environments and fine-tuning tasks. To delete the fleet, use <code>dstack fleet delete</code>.</p> <p>To ensure <code>dstack apply</code> always reuses an existing fleet, pass <code>--reuse</code> to <code>dstack apply</code> (or set <code>creation_policy</code> to <code>reuse</code> in the task configuration). The default policy is <code>reuse_or_create</code>.</p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#dev-environment","title":"Dev environment","text":"<p>If you'd like to play with the example using a dev environment, run .dstack.yml via <code>dstack apply</code>:</p> <pre><code>dstack apply -f examples/fine-tuning/alignment-handbook/.dstack.yaml \n</code></pre>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#source-code","title":"Source code","text":"<p>The source-code of this example can be found in  <code>https://github.com/dstackai/dstack/examples/fine-tuning/alignment-handbook</code>.</p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#contributing","title":"Contributing","text":"<p>Find a mistake or can't find an important example? Raise an issue or send a pull request!</p>"},{"location":"docs/examples/fine-tuning/alignment-handbook/#whats-next","title":"What's next?","text":"<ol> <li>Browse Alignment Handbook.</li> <li>Check dev environments, tasks,     services, and fleets.</li> <li>See other examples.</li> </ol>"},{"location":"docs/examples/fine-tuning/axolotl/","title":"Axolotl","text":"<p>Axolotl streamlines the fine-tuning of AI models It not only supports multiple configurations and architectures but also provides many ready-to-use recipes. You just need to pick a suitable recipe and adjust it for your use case.</p> <p>This example shows how use Axolotl with <code>dstack</code> to fine-tune Llama3 8B using FSDP and QLoRA on one node.</p>"},{"location":"docs/examples/fine-tuning/axolotl/#prerequisites","title":"Prerequisites","text":"<p>Once <code>dstack</code> is installed, clone the repo and run <code>dstack init</code>:</p> <pre><code>git clone https://github.com/dstackai/dstack\ncd dstack\ndstack init\n</code></pre>"},{"location":"docs/examples/fine-tuning/axolotl/#training-configuration-recipe","title":"Training configuration recipe","text":"<p>Axolotl reads the model, LoRA, and dataset arguments, as well as trainer configuration from a YAML file. This file can be found at <code>examples/fine-tuning/axolotl/config.yaml</code>. You can modify it as needed.</p> <p>Before you proceed with training, make sure to update the <code>hub_model_id</code> in <code>examples/fine-tuning/axolotl/config.yaml</code> with your HuggingFace username.</p>"},{"location":"docs/examples/fine-tuning/axolotl/#single-node-training","title":"Single-node training","text":"<p>The easiest way to run a training script with <code>dstack</code> is by creating a task configuration file. This file can be found at <code>examples/fine-tuning/axolotl/train.dstack.yml</code>. Below is its content: </p> <pre><code>type: task\n# The name is optional, if not specified, generated randomly\nname: axolotl-train\n\n# Using the official Axolotl's Docker image\nimage: winglian/axolotl-cloud:main-20240429-py3.11-cu121-2.2.1\n\n# Required environment variables\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - WANDB_API_KEY\n# Commands of the task\ncommands:\n  - accelerate launch -m axolotl.cli.train examples/fine-tuning/axolotl/config.yaml\n# Expose 6006 to access TensorBoard\nports:\n  - 6006\n\nresources:\n  # Two or more 24GB GPUs (required by FSDP)\n  gpu: 24GB:2..\n</code></pre> <p>The task uses Axolotl's Docker image, where Axolotl is already pre-installed.</p> <p>To run the task, use <code>dstack apply</code>:</p> <pre><code>HUGGING_FACE_HUB_TOKEN=...\nWANDB_API_KEY=...\n\ndstack apply -f examples/fine-tuning/axolotl/train.dstack.yml\n</code></pre> <p>If you list <code>tensorbord</code> via <code>report_to</code> in <code>examples/fine-tuning/axolotl/config.yaml</code>, you'll be able to access experiment metrics via <code>http://localhost:6006</code> (while the task is running).</p>"},{"location":"docs/examples/fine-tuning/axolotl/#fleets","title":"Fleets","text":"<p>By default, <code>dstack run</code> reuses <code>idle</code> instances from one of the existing fleets. If no <code>idle</code> instances meet the requirements, it creates a new fleet using one of the configured backends.</p> <p>The example folder includes a fleet configuration:   <code>examples/fine-tuning/axolotl/fleet.dstack.yml</code>  ( a single node with a <code>24GB</code> GPU).</p> <p>You can update the fleet configuration to change the vRAM size, GPU model, number of GPUs per node, or number of nodes. </p> <p>A fleet can be provisioned with <code>dstack apply</code>:</p> <pre><code>dstack apply -f examples/fine-tuning/axolotl/fleet.dstack.yml\n</code></pre> <p>Once provisioned, the fleet can run dev environments and fine-tuning tasks. To delete the fleet, use <code>dstack fleet delete</code>.</p> <p>To ensure <code>dstack apply</code> always reuses an existing fleet, pass <code>--reuse</code> to <code>dstack apply</code> (or set <code>creation_policy</code> to <code>reuse</code> in the task configuration). The default policy is <code>reuse_or_create</code>.</p>"},{"location":"docs/examples/fine-tuning/axolotl/#dev-environment","title":"Dev environment","text":"<p>If you'd like to play with the example using a dev environment, run .dstack.yml via <code>dstack apply</code>:</p> <pre><code>dstack apply -f examples/fine-tuning/axolotl/.dstack.yaml \n</code></pre>"},{"location":"docs/examples/fine-tuning/axolotl/#source-code","title":"Source code","text":"<p>The source-code of this example can be found in  <code>https://github.com/dstackai/dstack/examples/fine-tuning/axolotl</code>.</p>"},{"location":"docs/examples/fine-tuning/axolotl/#contributing","title":"Contributing","text":"<p>Find a mistake or can't find an important example? Raise an issue or send a pull request!</p>"},{"location":"docs/examples/fine-tuning/axolotl/#whats-next","title":"What's next?","text":"<ol> <li>Browse Axolotl.</li> <li>Check dev environments, tasks,     services, and fleets.</li> <li>See other examples.</li> </ol>"},{"location":"docs/examples/fine-tuning/qlora/","title":"QLoRA","text":"<p>The following command runs the task to fine-tune an LLM using QLoRA:</p> <pre><code>dstack run . -f examples/fine-tuning/qlora/task.dstack.yml\n</code></pre> <p>See the configuration at train.dstack.yml.</p> <p>For more details, refer to tasks.</p>"},{"location":"docs/examples/llms/chat-ui/","title":"Chat UI","text":"<p>This example walks you through setting up Chat UI locally to chat with an LLM deployed using <code>dstack</code>.</p>"},{"location":"docs/examples/llms/chat-ui/#clone-the-repo","title":"Clone the repo","text":"<pre><code>git clone https://github.com/huggingface/chat-ui\ncd chat-ui\n</code></pre>"},{"location":"docs/examples/llms/chat-ui/#run-local-mongodb","title":"Run local MongoDB","text":"<pre><code>docker run -d -p 27017:27017 --name mongo-chatui mongo:latest\n</code></pre>"},{"location":"docs/examples/llms/chat-ui/#create-envlocal","title":"Create <code>.env.local</code>","text":"<pre><code>MONGODB_URL=mongodb://localhost:27017\n\nMODELS=`[\n   {\n      \"name\": \"&lt;model name&gt;\",\n      \"displayName\": \"My model\",\n      \"endpoints\": [\n        {\n         \"type\": \"openai\",\n         \"baseURL\" : \"https://gateway.&lt;gateway domain&gt;\",\n         \"apiKey\": \"&lt;dstack token&gt;\"\n        }\n      ]\n  }\n]`\n</code></pre> <p>Replace <code>&lt;gateway domain&gt;</code> with your <code>dstack</code> gateway's domain (e.g. <code>&lt;dstack project&gt;.sky.dstack.ai</code> if you are using dstack Sky).</p> <p>Replace <code>&lt;dstack token&gt;</code> with your <code>dstack</code> user's token.</p> <p>Replace <code>&lt;model name&gt;</code> with the name of the deployed mode,</p>"},{"location":"docs/examples/llms/chat-ui/#run-chat-ui","title":"Run Chat UI","text":"<pre><code>npm run dev\n</code></pre> <p>Now you can conveniently chat with your model! \ud83e\udd17</p> <p></p>"},{"location":"docs/examples/llms/llama3/","title":"Llama 3","text":""},{"location":"docs/examples/llms/llama3/#deploy-llama-8b","title":"Deploy Llama 8B","text":"<p>The following command deploys Llama 3 8B as a service:</p> <pre><code>dstack run . -f examples/llms/llama3/ollama-8b.dstack.yml\n</code></pre> <p>See the configuration at ollama-8b.dstack.yml.</p>"},{"location":"docs/examples/llms/llama3/#deploy-llama-70b","title":"Deploy Llama 70B","text":"<p>The following command deploys Llama 3 70B as a service:</p> <pre><code>dstack run . -f examples/llms/llama3/ollama-70b.dstack.yml\n</code></pre> <p>See the configuration at ollama-70b.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"docs/examples/llms/llama3/#run-chat-ui","title":"Run Chat UI","text":"<p>Refer to chat-ui to learn how to launch a UI for chatting with the LLM you've deployed to <code>dstack</code>.</p> <p></p>"},{"location":"docs/examples/llms/mixtral/","title":"Mixtral 8x7B","text":"<p>The following command deploys Mixtral 8x7B as a service:</p> <pre><code>dstack run . -f examples/llms/mixtral/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services.</p>"},{"location":"docs/examples/misc/http.server/","title":"Streamlit","text":""},{"location":"docs/examples/misc/http.server/#service","title":"Service","text":"<p>The following command runs <code>http.server</code> as a service:</p> <pre><code>dstack run . -f examples/misc/http.server/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"docs/examples/misc/http.server/#task","title":"Task","text":"<p>The following command runs <code>http.server</code> as a task:</p> <pre><code>dstack run . -f examples/misc/http.server/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"docs/examples/misc/streamlit/","title":"Streamlit","text":""},{"location":"docs/examples/misc/streamlit/#service-no-auth","title":"Service (no auth)","text":"<p>The following command runs <code>streamlit hello</code> as a service with disabled authentication:</p> <pre><code>dstack run . -f examples/misc/streamlit/serve.dstack.yml\n</code></pre> <p>See the configuration at serve.dstack.yml.</p>"},{"location":"docs/examples/misc/streamlit/#task","title":"Task","text":"<p>The following command runs <code>streamlit hello</code> as a task:</p> <pre><code>dstack run . -f examples/misc/streamlit/serve-task.dstack.yml\n</code></pre> <p>See the configuration at serve-task.dstack.yml.</p> <p>For more details, refer to services or tasks.</p>"},{"location":"docs/guides/protips/","title":"Protips","text":"<p>Below are tips and tricks to use <code>dstack</code> more efficiently.</p>"},{"location":"docs/guides/protips/#dev-environments","title":"Dev environments","text":"<p>Before running a task or service, it's recommended that you first start with a dev environment. Dev environments allow you to run commands interactively.</p> <p>Once the commands work, go ahead and run them as a task or a service.</p> Notebooks <p>VS Code</p> <p>When you access a dev environment using your desktop VS Code, it allows you to work with Jupyter notebooks via its pre-configured and easy-to-use extension.</p> <p>JupyterLab</p> <p>If you prefer to use JupyterLab, you can run it as a task:</p> <pre><code>type: task\n\ncommands:\n    - pip install jupyterlab\n    - jupyter lab --allow-root\n\nports:\n    - 8888\n</code></pre>"},{"location":"docs/guides/protips/#tasks-vs-services-for-web-applications","title":"Tasks vs services for web applications","text":"<p>Tasks can be used not only for batch jobs but also for web applications.</p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip3 install streamlit\n  - streamlit hello\n\nports: \n  - 8501\n</code></pre> <p>While you run a task, <code>dstack</code> forwards the remote ports to <code>localhost</code>.</p> <pre><code>$ dstack run . -f app.dstack.yml\n\n  Welcome to Streamlit. Check out our demo in your browser.\n\n  Local URL: http://localhost:8501\n</code></pre> <p>This allows you to access the remote <code>8501</code> port on <code>localhost:8501</code> while the CLI is attached.</p> Port mapping <p>If you want to override the local port, use the <code>--port</code> option:</p> <pre><code>$ dstack run . -f app.dstack.yml --port 3000:8501\n</code></pre> <p>This will forward the remote <code>8501</code> port to <code>localhost:3000</code>.</p> <p>Services require a gateway but they also provide additional features for production-grade service deployment not offered by tasks, such as HTTPS domains and auto-scaling. If you run a web app as a task and it works, go ahead and run it as a service.</p>"},{"location":"docs/guides/protips/#environment-variables","title":"Environment variables","text":"<p>If a configuration requires an environment variable that you don't want to hardcode in the YAML, you can define it without assigning a value:</p> <pre><code>type: dev-environment\n\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n\npython: \"3.11\"\nide: vscode\n</code></pre> <p>Then, you can pass the environment variable either via the shell:</p> <pre><code>HUGGING_FACE_HUB_TOKEN=... dstack run . -f .dstack.yml\n</code></pre> <p>Or via the <code>-e</code> option of the <code>dstack run</code> command:</p> <pre><code>dstack run . -f .dstack.yml -e HUGGING_FACE_HUB_TOKEN=...\n</code></pre> .env <p>A better way to configure environment variables not hardcoded in YAML is by specifying them in a <code>.env</code> file:</p> <pre><code>HUGGING_FACE_HUB_TOKEN=...\n</code></pre> <p>If you install <code>direnv</code> , it will automatically pass the environment variables from the <code>.env</code> file to the <code>dstack run</code> command.</p> <p>Remember to add <code>.env</code> to <code>.gitignore</code> to avoid pushing it to the repo.    </p>"},{"location":"docs/guides/protips/#data-and-models","title":"Data and models","text":"<p><code>dstack</code> has support for volumes to persist data across different runs and instance interruptions. Volumes are ideal for storing intermediate work and data that should be quickly accessible.</p> <p>You can also load and save data using an object storage like S3 or HuggingFace Datasets. For models, it's best to use services like HuggingFace Hub. <code>dstack</code> has no explicit support for object storage. You can load and save data directly from your code.</p>"},{"location":"docs/guides/protips/#idle-instances","title":"Idle instances","text":"<p>By default, the <code>dstack</code> run command reuses an idle instance from the pool. If no instance matches the requirements, it creates a new one.</p> <p>When the run finishes, the instance remains idle for the configured time (by default, <code>5m</code>) before it gets destroyed.</p> <p>You can change the default idle duration by using <code>--idle-duration DURATION</code> with <code>dstack run</code>, or set <code>termination_idle_duration</code> in the configuration or profile.</p> <p>An idle instance can be destroyed at any time via <code>dstack pool rm INSTANCE_NAME</code>.</p>"},{"location":"docs/guides/protips/#profiles","title":"Profiles","text":"<p>If you don't want to specify the same parameters for each configuration, you can define them once via profiles and reuse them across configurations.</p> <p>This can be handy, for example, for configuring parameters such as <code>max_duration</code>, <code>max_price</code>, <code>termination_idle_duration</code>, <code>regions</code>, etc.</p> <p>Set <code>default</code> to <code>true</code> in your profile, and it will be applied automatically to any run.</p>"},{"location":"docs/guides/protips/#attached-mode","title":"Attached mode","text":"<p>By default, <code>dstack run</code> runs in attached mode. This means it streams the logs as they come in and, in the case of a task, forwards its ports to <code>localhost</code>.</p> <p>If you detach the CLI, you can re-attach it using <code>dstack logs -a RUN_NAME</code>.</p> <p>To run in detached mode, use <code>-d</code> with <code>dstack run</code>.</p>"},{"location":"docs/guides/protips/#gpu","title":"GPU","text":"<p><code>dstack</code> natively supports NVIDIA GPU, and Google Cloud TPU accelerator chips.</p> <p>The <code>gpu</code> property withing <code>resources</code> (or the <code>--gpu</code> option with <code>dstack run</code>) allows specifying not only memory size but also GPU names, their memory, and quantity.</p> <p>Examples:</p> <ul> <li><code>1</code> (any GPU)</li> <li><code>A100</code> (A100)</li> <li><code>24GB..</code> (any GPU starting from 24GB)</li> <li><code>24GB..40GB:2</code> (two GPUs between 24GB and 40GB)</li> <li><code>A10G,A100</code> (either A10G or A100)</li> <li><code>A100:80GB</code> (one A100 of 80GB)</li> <li><code>A100:2</code> (two A100)</li> <li><code>A100:40GB:2</code> (two A100 40GB)</li> <li><code>tpu-v2-8</code> (<code>v2</code> with 8 TPU cores)</li> </ul> Google Cloud TPU <p>Currently, you can't specify other than 8 TPU cores. This means only single host workloads are supported. Support for multiple hosts is coming soon.</p>"},{"location":"docs/guides/protips/#service-quotas","title":"Service quotas","text":"<p>If you're using your own AWS, GCP, Azure, or OCI accounts, before you can use GPUs or spot instances, you have to request the corresponding service quotas for each type of instance in each region.</p> AWS <p>Check this guide   on EC2 service quotas. The relevant service quotas include:</p> <ul> <li><code>Running On-Demand P instances</code> (on-demand V100, A100 80GB x8)</li> <li><code>All P4, P3 and P2 Spot Instance Requests</code> (spot V100, A100 80GB x8)</li> <li><code>Running On-Demand G and VT instances</code> (on-demand T4, A10G, L4)</li> <li><code>All G and VT Spot Instance Requests</code> (spot T4, A10G, L4)</li> <li><code>Running Dedicated p5 Hosts</code> (on-demand H100)</li> <li><code>All P5 Spot Instance Requests</code> (spot H100)</li> </ul> GCP <p>Check this guide   on Compute Engine service quotas. The relevant service quotas include:</p> <ul> <li><code>NVIDIA V100 GPUs</code> (on-demand V100)</li> <li><code>Preemtible V100 GPUs</code> (spot V100)</li> <li><code>NVIDIA T4 GPUs</code> (on-demand T4)</li> <li><code>Preemtible T4 GPUs</code> (spot T4)</li> <li><code>NVIDIA L4 GPUs</code> (on-demand L4)</li> <li><code>Preemtible L4 GPUs</code> (spot L4)</li> <li><code>NVIDIA A100 GPUs</code> (on-demand A100)</li> <li><code>Preemtible A100 GPUs</code> (spot A100)</li> <li><code>NVIDIA A100 80GB GPUs</code> (on-demand A100 80GB)</li> <li><code>Preemtible A100 80GB GPUs</code> (spot A100 80GB)</li> <li><code>NVIDIA H100 GPUs</code> (on-demand H100)</li> <li><code>Preemtible H100 GPUs</code> (spot H100)</li> </ul> Azure <p>Check this guide   on Azure service quotas. The relevant service quotas include:</p> <ul> <li><code>Total Regional Spot vCPUs</code> (any spot instances)</li> <li><code>Standard NCASv3_T4 Family vCPUs</code> (on-demand T4)</li> <li><code>Standard NVADSA10v5 Family vCPUs</code> (on-demand A10)</li> <li><code>Standard NCADS_A100_v4 Family vCPUs</code> (on-demand A100 80GB)</li> <li><code>Standard NDASv4_A100 Family vCPUs</code> (on-demand A100 40GB x8)</li> <li><code>Standard NDAMSv4_A100Family vCPUs</code> (on-demand A100 80GB x8)</li> <li><code>Standard NCadsH100v5 Family vCPUs</code> (on-demand H100)</li> <li><code>Standard NDSH100v5 Family vCPUs</code> (on-demand H100 x8)</li> </ul> OCI <p>Check this guide   on requesting OCI service limits increase. The relevant service category is compute. The relevant resources include:</p> <ul> <li><code>GPUs for GPU.A10 based VM and BM instances</code> (on-demand A10)</li> <li><code>GPUs for GPU2 based VM and BM instances</code> (on-demand P100)</li> <li><code>GPUs for GPU3 based VM and BM instances</code> (on-demand V100)</li> </ul> <p>Note, for AWS, GCP, and Azure, service quota values are measured with the number of CPUs rather than GPUs.</p>"},{"location":"docs/installation/","title":"Installation","text":"<p>To use the open-source version of <code>dstack</code> with your own cloud accounts or on-prem servers,  you have to set up the server. </p>"},{"location":"docs/installation/#set-up-the-server","title":"Set up the server","text":"<p>Follow the steps below to set up the server.</p>"},{"location":"docs/installation/#1-configure-backends","title":"1. Configure backends","text":"<p>If you want the <code>dstack</code> server to run containers or manage clusters in your cloud accounts (or use Kubernetes), create the ~/.dstack/server/config.yml file and configure backends.</p>"},{"location":"docs/installation/#2-start-the-server","title":"2. Start the server","text":"<p>Once the <code>~/.dstack/server/config.yml</code> file is configured, proceed to start the server:</p> pipDocker <pre><code>$ pip install \"dstack[all]\" -U\n$ dstack server\n\nApplying ~/.dstack/server/config.yml...\n\nThe admin token is \"bbae0f28-d3dd-4820-bf61-8f4bb40815da\"\nThe server is running at http://127.0.0.1:3000/\n</code></pre> <pre><code>$ docker run -p 3000:3000 \\\n    -v $HOME/.dstack/server/:/root/.dstack/server \\\n    dstackai/dstack\n\nApplying ~/.dstack/server/config.yml...\n\nThe admin token is \"bbae0f28-d3dd-4820-bf61-8f4bb40815da\"\nThe server is running at http://127.0.0.1:3000/\n</code></pre> <p>For more details on how to deploy <code>dstack</code> using Docker, check its Docker repo.</p> <p>By default, the <code>dstack</code> server stores its state in <code>~/.dstack/server/data</code> using SQLite. To use a database, set the <code>DSTACK_DATABASE_URL</code> environment variable.</p> <p>The server can be set up anywhere: on your laptop, a dedicated server, or in the cloud. Once the <code>dstack</code> server is up, you can use the CLI or API.</p>"},{"location":"docs/installation/#3-set-up-the-cli","title":"3. Set up the CLI","text":"<p>To point the CLI to the <code>dstack</code> server, configure it with the server address, user token and project name:</p> <pre><code>$ pip install dstack\n$ dstack config --url http://127.0.0.1:3000 \\\n    --project main \\\n    --token bbae0f28-d3dd-4820-bf61-8f4bb40815da\n\nConfiguration is updated at ~/.dstack/config.yml\n</code></pre> <p>This configuration is stored in <code>~/.dstack/config.yml</code>.</p>"},{"location":"docs/installation/#4-add-on-prem-servers","title":"4. Add on-prem servers","text":"<p>Fleets</p> <p>If you want the <code>dstack</code> server to run containers on your on-prem servers, use fleets.</p>"},{"location":"docs/installation/#dstack-sky","title":"dstack Sky","text":"<p>If you don't want to host the <code>dstack</code> server yourself or would like to access GPU from the <code>dstack</code> marketplace, sign up with dstack Sky .</p>"},{"location":"docs/installation/#set-up-the-cli","title":"Set up the CLI","text":"<p>If you've signed up, open your project settings, and copy the <code>dstack config</code> command to point the CLI to the project.</p> <p></p> <p>Then, install the CLI on your machine and use the copied command.</p> <pre><code>$ pip install dstack\n$ dstack config --url https://sky.dstack.ai \\\n    --project peterschmidt85 \\\n    --token bbae0f28-d3dd-4820-bf61-8f4bb40815da\n\nConfiguration is updated at ~/.dstack/config.yml\n</code></pre>"},{"location":"docs/installation/#configure-clouds","title":"Configure clouds","text":"<p>By default, dstack Sky   uses the GPU from its marketplace, which requires a credit card to be attached in your account settings.</p> <p>To use your own cloud accounts, click the settings icon of the corresponding backend and specify credentials:</p> <p></p>"},{"location":"docs/installation/#whats-next","title":"What's next?","text":"<ol> <li>Check the server/config.yml reference on how to configure backends</li> <li>Follow quickstart</li> <li>Browse examples </li> <li>Join the community via Discord </li> </ol>"},{"location":"docs/reference/dstack.yml/","title":".dstack.yml","text":"<ul> <li><code>dev-environment</code></li> <li><code>task</code></li> <li><code>service</code></li> </ul>"},{"location":"docs/reference/profiles.yml/","title":"profiles.yml","text":"<p>Sometimes, you may want to reuse the same parameters across different <code>.dstack.yml</code> configurations.</p> <p>This can be achieved by defining those parameters in a profile.</p> <p>Profiles can be defined on the repository level (via the <code>.dstack/profiles.yml</code> file in the root directory of the repository) or on the global level (via the <code>~/.dstack/profiles.yml</code> file).</p> <p>Any profile can be marked as default so that it will be applied automatically for any run. Otherwise, you can refer to a specific profile via <code>--profile NAME</code> in <code>dstack run</code>.</p>"},{"location":"docs/reference/profiles.yml/#example","title":"Example","text":"<pre><code>profiles:\n  - name: my-profile\n\n    # The spot pololicy can be \"spot\", \"on-demand\", or \"auto\"\n    spot_policy: auto\n\n    # Limit the maximum price of the instance per hour\n    max_price: 1.5\n\n    # Stop any run if it runs longer that this duration\n    max_duration: 1d\n\n    # Use only these backends\n    backends: [azure, lambda]\n\n    # If set to true, this profile will be applied automatically\n    default: true\n</code></pre> <p>The profile configuration supports many properties. See below.</p>"},{"location":"docs/reference/profiles.yml/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/profiles.yml/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/profiles.yml/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/profiles.yml/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/profiles.yml/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/profiles.yml/#_retry","title":"<code>retry</code> - (Optional) The policy for resubmitting the run. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/profiles.yml/#_retry_policy","title":"<code>retry_policy</code> - (Optional) The policy for resubmitting the run. Deprecated in favor of <code>retry</code>.","text":""},{"location":"docs/reference/profiles.yml/#max_duration","title":"<code>max_duration</code> - (Optional) The maximum duration of a run (e.g., <code>2h</code>, <code>1d</code>, etc). After it elapses, the run is forced to stop. Defaults to <code>off</code>.","text":""},{"location":"docs/reference/profiles.yml/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/profiles.yml/#pool_name","title":"<code>pool_name</code> - (Optional) The name of the pool. If not set, dstack will use the default name.","text":""},{"location":"docs/reference/profiles.yml/#instance_name","title":"<code>instance_name</code> - (Optional) The name of the instance.","text":""},{"location":"docs/reference/profiles.yml/#creation_policy","title":"<code>creation_policy</code> - (Optional) The policy for using instances from the pool. Defaults to <code>reuse-or-create</code>.","text":""},{"location":"docs/reference/profiles.yml/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/profiles.yml/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying the idle instance. Defaults to <code>5m</code> for <code>dstack run</code> and to <code>3d</code> for <code>dstack pool add</code>.","text":""},{"location":"docs/reference/profiles.yml/#name","title":"<code>name</code> -  The name of the profile that can be passed as <code>--profile</code> to <code>dstack run</code>.","text":""},{"location":"docs/reference/profiles.yml/#default","title":"<code>default</code> - (Optional) If set to true, <code>dstack run</code> will use this profile by default..","text":""},{"location":"docs/reference/profiles.yml/#retry","title":"<code>retry</code>","text":""},{"location":"docs/reference/profiles.yml/#on_events","title":"<code>on_events</code> -  The list of events that should be handled with retry. Supported events are <code>no-capacity</code>, <code>interruption</code>, and <code>error</code>.","text":""},{"location":"docs/reference/profiles.yml/#duration","title":"<code>duration</code> - (Optional) The maximum period of retrying the run, e.g., <code>4h</code> or <code>1d</code>.","text":""},{"location":"docs/reference/api/python/","title":"Python API","text":"<p>The Python API enables running tasks, services, and managing runs programmatically.</p>"},{"location":"docs/reference/api/python/#usage-example","title":"Usage example","text":"<p>Below is a quick example of submitting a task for running and displaying its logs.</p> <pre><code>import sys\n\nfrom dstack.api import Task, GPU, Client, Resources\n\nclient = Client.from_config()\n\ntask = Task(\n    image=\"ghcr.io/huggingface/text-generation-inference:latest\",\n    env={\"MODEL_ID\": \"TheBloke/Llama-2-13B-chat-GPTQ\"},\n    commands=[\n        \"text-generation-launcher --trust-remote-code --quantize gptq\",\n    ],\n    ports=[\"80\"],\n    resources=Resources(gpu=GPU(memory=\"24GB\")),\n)\n\nrun = client.runs.submit(\n    run_name=\"my-awesome-run\",  # If not specified, a random name is assigned \n    configuration=task,\n    repo=None, # Specify to mount additional files\n)\n\nrun.attach()\n\ntry:\n    for log in run.logs():\n        sys.stdout.buffer.write(log)\n        sys.stdout.buffer.flush()\nexcept KeyboardInterrupt:\n    run.stop(abort=True)\nfinally:\n    run.detach()\n</code></pre> <p>NOTE:</p> <ol> <li>The <code>configuration</code> argument in the <code>submit</code> method can be either <code>dstack.api.Task</code> or <code>dstack.api.Service</code>. </li> <li>If you create <code>dstack.api.Task</code> or <code>dstack.api.Service</code>, you may specify the <code>image</code> argument. If <code>image</code> isn't    specified, the default image will be used. For a private Docker registry, ensure you also pass the <code>registry_auth</code> argument.</li> <li>The <code>repo</code> argument in the <code>submit</code> method allows the mounting of a local folder, a remote repo, or a    programmatically created repo. In this case, the <code>commands</code> argument can refer to the files within this repo.</li> <li>The <code>attach</code> method waits for the run to start and, for <code>dstack.api.Task</code> sets up an SSH tunnel and forwards configured <code>ports</code> to <code>localhost</code>.</li> </ol>"},{"location":"docs/reference/api/python/#dstack.api","title":"<code>dstack.api</code>","text":""},{"location":"docs/reference/api/python/#dstack.api.Client","title":"<code>dstack.api.Client</code>","text":"<p>High-level API client for interacting with dstack server</p> <p>Attributes:</p> Name Type Description <code>runs</code> <code>RunCollection</code> <p>Operations with runs.</p> <code>repos</code> <code>RepoCollection</code> <p>Operations with repositories.</p> <code>backends</code> <code>BackendCollection</code> <p>Operations with backends.</p>"},{"location":"docs/reference/api/python/#dstack.api.Client.from_config","title":"<code>from_config(project_name=None, server_url=None, user_token=None, ssh_identity_file=None)</code>  <code>staticmethod</code>","text":"<p>Creates a Client using the default configuration from <code>~/.dstack/config.yml</code> if it exists.</p> <p>Parameters:</p> Name Type Description Default <code>project_name</code> <code>Optional[str]</code> <p>The name of the project, required if <code>server_url</code> and <code>user_token</code> are specified</p> <code>None</code> <code>server_url</code> <code>Optional[str]</code> <p>The dstack server URL (e.g. <code>http://localhost:3000/</code> or <code>https://sky.dstack.ai</code>)</p> <code>None</code> <code>user_token</code> <code>Optional[str]</code> <p>The dstack user token</p> <code>None</code> <code>ssh_identity_file</code> <code>Optional[PathLike]</code> <p>The private SSH key path for SSH tunneling</p> <code>None</code> <p>Returns:</p> Type Description <code>Client</code> <p>A client instance</p>"},{"location":"docs/reference/api/python/#dstack.api.Client.runs","title":"<code>dstack.api.RunCollection</code>","text":"<p>Operations with runs</p>"},{"location":"docs/reference/api/python/#dstack.api.RunCollection.get","title":"<code>get(run_name)</code>","text":"<p>Get run by run name</p> <p>Parameters:</p> Name Type Description Default <code>run_name</code> <code>str</code> <p>run name</p> required <p>Returns:</p> Type Description <code>Optional[Run]</code> <p>The run or <code>None</code> if not found</p>"},{"location":"docs/reference/api/python/#dstack.api.RunCollection.list","title":"<code>list(all=False)</code>","text":"<p>List runs</p> <p>Parameters:</p> Name Type Description Default <code>all</code> <code>bool</code> <p>show all runs (active and finished) if <code>True</code></p> <code>False</code> <p>Returns:</p> Type Description <code>List[Run]</code> <p>list of runs</p>"},{"location":"docs/reference/api/python/#dstack.api.RunCollection.submit","title":"<code>submit(configuration, configuration_path=None, repo=None, backends=None, regions=None, instance_types=None, resources=None, spot_policy=None, retry_policy=None, max_duration=None, max_price=None, working_dir=None, run_name=None, reserve_ports=True)</code>","text":"<p>Submit a run</p> <p>Parameters:</p> Name Type Description Default <code>configuration</code> <code>Union[Task, Service]</code> <p>A run configuration.</p> required <code>configuration_path</code> <code>Optional[str]</code> <p>The path to the configuration file, relative to the root directory of the repo.</p> <code>None</code> <code>repo</code> <code>Union[LocalRepo, RemoteRepo, VirtualRepo]</code> <p>A repo to mount to the run.</p> <code>None</code> <code>backends</code> <code>Optional[List[BackendType]]</code> <p>A list of allowed backend for provisioning.</p> <code>None</code> <code>regions</code> <code>Optional[List[str]]</code> <p>A list of cloud regions for provisioning.</p> <code>None</code> <code>resources</code> <code>Optional[ResourcesSpec]</code> <p>The requirements to run the configuration. Overrides the configuration's resources.</p> <code>None</code> <code>spot_policy</code> <code>Optional[SpotPolicy]</code> <p>A spot policy for provisioning.</p> <code>None</code> <code>retry_policy</code> <code>RetryPolicy</code> <p>A retry policy.</p> <code>None</code> <code>max_duration</code> <code>Optional[Union[int, str]]</code> <p>The max instance running duration in seconds.</p> <code>None</code> <code>max_price</code> <code>Optional[float]</code> <p>The max instance price in dollars per hour for provisioning.</p> <code>None</code> <code>working_dir</code> <code>Optional[str]</code> <p>A working directory relative to the repo root directory</p> <code>None</code> <code>run_name</code> <code>Optional[str]</code> <p>A desired name of the run. Must be unique in the project. If not specified, a random name is assigned.</p> <code>None</code> <code>reserve_ports</code> <code>bool</code> <p>Whether local ports should be reserved in advance.</p> <code>True</code> <p>Returns:</p> Type Description <code>Run</code> <p>submitted run</p>"},{"location":"docs/reference/api/python/#dstack.api.Client.repos","title":"<code>dstack.api.RepoCollection</code>","text":"<p>Operations with repos</p>"},{"location":"docs/reference/api/python/#dstack.api.RepoCollection.init","title":"<code>init(repo, git_identity_file=None, oauth_token=None)</code>","text":"<p>Initializes the repo and configures its credentials in the project. Must be invoked before mounting the repo to a run.</p> <p>Example:</p> <pre><code>repo=RemoteRepo.from_url(\n    repo_url=\"https://github.com/dstackai/dstack-examples\",\n    repo_branch=\"main\",\n)\nclient.repos.init(repo)\n</code></pre> <p>By default, it uses the default Git credentials configured on the machine. You can override these credentials via the <code>git_identity_file</code> or <code>oauth_token</code> arguments of the <code>init</code> method.</p> <p>Once the repo is initialized, you can pass the repo object to the run:</p> <pre><code>run = client.runs.submit(\n    configuration=...,\n    repo=repo,\n)\n</code></pre> <p>Parameters:</p> Name Type Description Default <code>repo</code> <code>Repo</code> <p>The repo to initialize.</p> required <code>git_identity_file</code> <code>Optional[PathLike]</code> <p>The private SSH key path for accessing the remote repo.</p> <code>None</code> <code>oauth_token</code> <code>Optional[str]</code> <p>The GitHub OAuth token to access the remote repo.</p> <code>None</code>"},{"location":"docs/reference/api/python/#dstack.api.Task","title":"<code>dstack.api.Task</code>","text":""},{"location":"docs/reference/api/python/#nodes","title":"<code>nodes</code> - (Optional) Number of nodes. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/api/python/#name","title":"<code>name</code> - (Optional) The run name.","text":""},{"location":"docs/reference/api/python/#image","title":"<code>image</code> - (Optional) The name of the Docker image to run.","text":""},{"location":"docs/reference/api/python/#entrypoint","title":"<code>entrypoint</code> - (Optional) The Docker entrypoint.","text":""},{"location":"docs/reference/api/python/#working_dir","title":"<code>working_dir</code> - (Optional) The path to the working directory inside the container. It's specified relative to the repository directory (<code>/workflow</code>) and should be inside it. Defaults to <code>\".\"</code> .","text":""},{"location":"docs/reference/api/python/#home_dir","title":"<code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.","text":""},{"location":"docs/reference/api/python/#_registry_auth","title":"<code>registry_auth</code> - (Optional) Credentials for pulling a private Docker image.","text":""},{"location":"docs/reference/api/python/#python","title":"<code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/api/python/#nvcc","title":"<code>nvcc</code> - (Optional) Use image with NVIDIA CUDA Compiler (NVCC) included. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/api/python/#env","title":"<code>env</code> - (Optional) The mapping or the list of environment variables.","text":""},{"location":"docs/reference/api/python/#setup","title":"<code>setup</code> - (Optional) The bash commands to run on the boot.","text":""},{"location":"docs/reference/api/python/#_resources","title":"<code>resources</code> - (Optional) The resources requirements to run the configuration.","text":""},{"location":"docs/reference/api/python/#_volumes","title":"<code>volumes</code> - (Optional) The volumes mount points.","text":""},{"location":"docs/reference/api/python/#ports","title":"<code>ports</code> - (Optional) Port numbers/mapping to expose.","text":""},{"location":"docs/reference/api/python/#commands","title":"<code>commands</code> - (Optional) The bash commands to run.","text":""},{"location":"docs/reference/api/python/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/api/python/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/api/python/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/api/python/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/api/python/#_retry","title":"<code>retry</code> - (Optional) The policy for resubmitting the run. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/api/python/#_retry_policy","title":"<code>retry_policy</code> - (Optional) The policy for resubmitting the run. Deprecated in favor of <code>retry</code>.","text":""},{"location":"docs/reference/api/python/#max_duration","title":"<code>max_duration</code> - (Optional) The maximum duration of a run (e.g., <code>2h</code>, <code>1d</code>, etc). After it elapses, the run is forced to stop. Defaults to <code>off</code>.","text":""},{"location":"docs/reference/api/python/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/api/python/#pool_name","title":"<code>pool_name</code> - (Optional) The name of the pool. If not set, dstack will use the default name.","text":""},{"location":"docs/reference/api/python/#instance_name","title":"<code>instance_name</code> - (Optional) The name of the instance.","text":""},{"location":"docs/reference/api/python/#creation_policy","title":"<code>creation_policy</code> - (Optional) The policy for using instances from the pool. Defaults to <code>reuse-or-create</code>.","text":""},{"location":"docs/reference/api/python/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/api/python/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying the idle instance. Defaults to <code>5m</code> for <code>dstack run</code> and to <code>3d</code> for <code>dstack pool add</code>.","text":""},{"location":"docs/reference/api/python/#dstack.api.Service","title":"<code>dstack.api.Service</code>","text":""},{"location":"docs/reference/api/python/#port","title":"<code>port</code> -  The port, that application listens on or the mapping.","text":""},{"location":"docs/reference/api/python/#model","title":"<code>model</code> - (Optional) Mapping of the model for the OpenAI-compatible endpoint.","text":""},{"location":"docs/reference/api/python/#https","title":"<code>https</code> - (Optional) Enable HTTPS. Defaults to <code>True</code>.","text":""},{"location":"docs/reference/api/python/#auth","title":"<code>auth</code> - (Optional) Enable the authorization. Defaults to <code>True</code>.","text":""},{"location":"docs/reference/api/python/#replicas","title":"<code>replicas</code> - (Optional) The number of replicas. Can be a number (e.g. <code>2</code>) or a range (<code>0..4</code> or <code>1..8</code>). If it's a range, the <code>scaling</code> property is required. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/api/python/#_scaling","title":"<code>scaling</code> - (Optional) The auto-scaling rules. Required if <code>replicas</code> is set to a range.","text":""},{"location":"docs/reference/api/python/#name","title":"<code>name</code> - (Optional) The run name.","text":""},{"location":"docs/reference/api/python/#image","title":"<code>image</code> - (Optional) The name of the Docker image to run.","text":""},{"location":"docs/reference/api/python/#entrypoint","title":"<code>entrypoint</code> - (Optional) The Docker entrypoint.","text":""},{"location":"docs/reference/api/python/#working_dir","title":"<code>working_dir</code> - (Optional) The path to the working directory inside the container. It's specified relative to the repository directory (<code>/workflow</code>) and should be inside it. Defaults to <code>\".\"</code> .","text":""},{"location":"docs/reference/api/python/#home_dir","title":"<code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.","text":""},{"location":"docs/reference/api/python/#_registry_auth","title":"<code>registry_auth</code> - (Optional) Credentials for pulling a private Docker image.","text":""},{"location":"docs/reference/api/python/#python","title":"<code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/api/python/#nvcc","title":"<code>nvcc</code> - (Optional) Use image with NVIDIA CUDA Compiler (NVCC) included. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/api/python/#env","title":"<code>env</code> - (Optional) The mapping or the list of environment variables.","text":""},{"location":"docs/reference/api/python/#setup","title":"<code>setup</code> - (Optional) The bash commands to run on the boot.","text":""},{"location":"docs/reference/api/python/#_resources","title":"<code>resources</code> - (Optional) The resources requirements to run the configuration.","text":""},{"location":"docs/reference/api/python/#_volumes","title":"<code>volumes</code> - (Optional) The volumes mount points.","text":""},{"location":"docs/reference/api/python/#commands","title":"<code>commands</code> - (Optional) The bash commands to run.","text":""},{"location":"docs/reference/api/python/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/api/python/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/api/python/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/api/python/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/api/python/#_retry","title":"<code>retry</code> - (Optional) The policy for resubmitting the run. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/api/python/#_retry_policy","title":"<code>retry_policy</code> - (Optional) The policy for resubmitting the run. Deprecated in favor of <code>retry</code>.","text":""},{"location":"docs/reference/api/python/#max_duration","title":"<code>max_duration</code> - (Optional) The maximum duration of a run (e.g., <code>2h</code>, <code>1d</code>, etc). After it elapses, the run is forced to stop. Defaults to <code>off</code>.","text":""},{"location":"docs/reference/api/python/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/api/python/#pool_name","title":"<code>pool_name</code> - (Optional) The name of the pool. If not set, dstack will use the default name.","text":""},{"location":"docs/reference/api/python/#instance_name","title":"<code>instance_name</code> - (Optional) The name of the instance.","text":""},{"location":"docs/reference/api/python/#creation_policy","title":"<code>creation_policy</code> - (Optional) The policy for using instances from the pool. Defaults to <code>reuse-or-create</code>.","text":""},{"location":"docs/reference/api/python/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/api/python/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying the idle instance. Defaults to <code>5m</code> for <code>dstack run</code> and to <code>3d</code> for <code>dstack pool add</code>.","text":""},{"location":"docs/reference/api/python/#dstack.api.Run","title":"<code>dstack.api.Run</code>","text":"<p>Attributes:</p> Name Type Description <code>name</code> <code>str</code> <p>run name</p> <code>ports</code> <code>Optional[Dict[int, int]]</code> <p>ports mapping, if run is attached</p> <code>backend</code> <code>Optional[BackendType]</code> <p>backend type</p> <code>status</code> <code>RunStatus</code> <p>run status</p> <code>hostname</code> <code>str</code> <p>instance hostname</p>"},{"location":"docs/reference/api/python/#dstack.api.Run.attach","title":"<code>attach(ssh_identity_file=None)</code>","text":"<p>Establish an SSH tunnel to the instance and update SSH config</p> <p>Parameters:</p> Name Type Description Default <code>ssh_identity_file</code> <code>Optional[PathLike]</code> <p>SSH keypair to access instances</p> <code>None</code> <p>Raises:</p> Type Description <code>PortUsedError</code> <p>If ports are in use or the run is attached by another process.</p>"},{"location":"docs/reference/api/python/#dstack.api.Run.detach","title":"<code>detach()</code>","text":"<p>Stop the SSH tunnel to the instance and update SSH config</p>"},{"location":"docs/reference/api/python/#dstack.api.Run.logs","title":"<code>logs(start_time=None, diagnose=False, replica_num=0, job_num=0)</code>","text":"<p>Iterate through run's log messages</p> <p>Parameters:</p> Name Type Description Default <code>start_time</code> <code>Optional[datetime]</code> <p>minimal log timestamp</p> <code>None</code> <code>diagnose</code> <code>bool</code> <p>return runner logs if <code>True</code></p> <code>False</code> <p>Yields:</p> Type Description <code>Iterable[bytes]</code> <p>log messages</p>"},{"location":"docs/reference/api/python/#dstack.api.Run.refresh","title":"<code>refresh()</code>","text":"<p>Get up-to-date run info</p>"},{"location":"docs/reference/api/python/#dstack.api.Run.stop","title":"<code>stop(abort=False)</code>","text":"<p>Terminate the instance and detach</p> <p>Parameters:</p> Name Type Description Default <code>abort</code> <code>bool</code> <p>gracefully stop the run if <code>False</code></p> <code>False</code>"},{"location":"docs/reference/api/python/#dstack.api.Resources","title":"<code>dstack.api.Resources</code>","text":""},{"location":"docs/reference/api/python/#cpu","title":"<code>cpu</code> - (Optional) The number of CPU cores. Defaults to <code>2..</code>.","text":""},{"location":"docs/reference/api/python/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>8GB</code>). Defaults to <code>8GB..</code>.","text":""},{"location":"docs/reference/api/python/#shm_size","title":"<code>shm_size</code> - (Optional) The size of shared memory (e.g., <code>8GB</code>). If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure this.","text":""},{"location":"docs/reference/api/python/#_gpu","title":"<code>gpu</code> - (Optional) The GPU requirements.","text":""},{"location":"docs/reference/api/python/#_disk","title":"<code>disk</code> - (Optional) The disk resources.","text":""},{"location":"docs/reference/api/python/#dstack.api.GPU","title":"<code>dstack.api.GPU</code>","text":""},{"location":"docs/reference/api/python/#name","title":"<code>name</code> - (Optional) The name of the GPU (e.g., <code>A100</code> or <code>H100</code>).","text":""},{"location":"docs/reference/api/python/#count","title":"<code>count</code> - (Optional) The number of GPUs. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/api/python/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>16GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/api/python/#total_memory","title":"<code>total_memory</code> - (Optional) The total RAM size (e.g., <code>32GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/api/python/#compute_capability","title":"<code>compute_capability</code> - (Optional) The minimum compute capability of the GPU (e.g., <code>7.5</code>).","text":""},{"location":"docs/reference/api/python/#dstack.api.Disk","title":"<code>dstack.api.Disk</code>","text":""},{"location":"docs/reference/api/python/#size","title":"<code>size</code> -  Disk size.","text":""},{"location":"docs/reference/api/python/#dstack.api.LocalRepo","title":"<code>dstack.api.LocalRepo</code>","text":"<p>Creates an instance of a local repo from a local path.</p> <p>Example:</p> <pre><code>run = client.runs.submit(\n    configuration=...,\n    repo=LocalRepo.from_dir(\".\"), # Mount the current folder to the run\n)\n</code></pre>"},{"location":"docs/reference/api/python/#dstack.api.LocalRepo.from_dir","title":"<code>from_dir(repo_dir)</code>  <code>staticmethod</code>","text":"<p>Creates an instance of a local repo from a local path.</p> <p>Parameters:</p> Name Type Description Default <code>repo_dir</code> <code>PathLike</code> <p>The path to a local folder</p> required <p>Returns:</p> Type Description <code>LocalRepo</code> <p>A local repo instance</p>"},{"location":"docs/reference/api/python/#dstack.api.RemoteRepo","title":"<code>dstack.api.RemoteRepo</code>","text":"<p>Creates an instance of a remote Git repo for mounting to a submitted run.</p> <p>Using a locally checked-out remote Git repo:</p> <pre><code>repo=RemoteRepo.from_dir(repo_dir=\".\")\n</code></pre> <p>Using a remote Git repo by a URL:</p> <pre><code>repo=RemoteRepo.from_url(\n    repo_url=\"https://github.com/dstackai/dstack-examples\",\n    repo_branch=\"main\"\n)\n</code></pre> <p>Initialize the repo before mounting it.</p> <pre><code>client.repos.init(repo)\n</code></pre> <p>By default, it uses the default Git credentials configured on the machine. You can override these credentials via the <code>git_identity_file</code> or <code>oauth_token</code> arguments of the <code>init</code> method.</p> <p>Finally, you can pass the repo object to the run:</p> <pre><code>run = client.runs.submit(\n    configuration=...,\n    repo=repo,\n)\n</code></pre>"},{"location":"docs/reference/api/python/#dstack.api.RemoteRepo.from_dir","title":"<code>from_dir(repo_dir)</code>  <code>staticmethod</code>","text":"<p>Creates an instance of a remote repo from a local path.</p> <p>Parameters:</p> Name Type Description Default <code>repo_dir</code> <code>PathLike</code> <p>The path to a local folder</p> required <p>Returns:</p> Type Description <code>RemoteRepo</code> <p>A remote repo instance</p>"},{"location":"docs/reference/api/python/#dstack.api.RemoteRepo.from_url","title":"<code>from_url(repo_url, repo_branch=None, repo_hash=None)</code>  <code>staticmethod</code>","text":"<p>Creates an instance of a remote repo from a URL.</p> <p>Parameters:</p> Name Type Description Default <code>repo_url</code> <code>str</code> <p>The URL of a remote Git repo</p> required <code>repo_branch</code> <code>Optional[str]</code> <p>The name of the remote branch. Must be specified if <code>hash</code> is not specified.</p> <code>None</code> <code>repo_hash</code> <code>Optional[str]</code> <p>The hash of the revision. Must be specified if <code>branch</code> is not specified.</p> <code>None</code> <p>Returns:</p> Type Description <code>RemoteRepo</code> <p>A remote repo instance</p>"},{"location":"docs/reference/api/python/#dstack.api.VirtualRepo","title":"<code>dstack.api.VirtualRepo</code>","text":"<p>Allows mounting a repo created programmatically.</p> <p>Example:</p> <pre><code>virtual_repo = VirtualRepo(repo_id=\"some-unique-repo-id\")\nvirtual_repo.add_file_from_package(package=some_package, path=\"requirements.txt\")\nvirtual_repo.add_file_from_package(package=some_package, path=\"train.py\")\n\nrun = client.runs.submit(\n    configuration=...,\n    repo=virtual_repo,\n)\n</code></pre> <p>Attributes:</p> Name Type Description <code>repo_id</code> <p>A unique identifier of the repo</p>"},{"location":"docs/reference/api/python/#dstack.api.VirtualRepo.add_file","title":"<code>add_file(path, content)</code>","text":"<p>Adds a given file to the repo.</p> <p>Attributes:</p> Name Type Description <code>path</code> <code>str</code> <p>The path inside the repo to add the file.</p> <code>content</code> <code>bytes</code> <p>The contents of the file.</p>"},{"location":"docs/reference/api/python/#dstack.api.VirtualRepo.add_file_from_package","title":"<code>add_file_from_package(package, path)</code>","text":"<p>Includes a file from a given package to the repo.</p> <p>Attributes:</p> Name Type Description <code>package</code> <code>Union[ModuleType, str]</code> <p>A package to include the file from.</p> <code>path</code> <code>str</code> <p>The path to the file to include to the repo. Must be relative to the package directory.</p>"},{"location":"docs/reference/api/python/#dstack.api.RegistryAuth","title":"<code>dstack.api.RegistryAuth</code>","text":""},{"location":"docs/reference/api/python/#username","title":"<code>username</code> -  The username.","text":""},{"location":"docs/reference/api/python/#password","title":"<code>password</code> -  The password or access token.","text":""},{"location":"docs/reference/api/python/#dstack.api.Scaling","title":"<code>dstack.api.Scaling</code>","text":""},{"location":"docs/reference/api/python/#metric","title":"<code>metric</code> -  The target metric to track. Currently, the only supported value is <code>rps</code> (meaning requests per second).","text":""},{"location":"docs/reference/api/python/#target","title":"<code>target</code> -  The target value of the metric. The number of replicas is calculated based on this number and automatically adjusts (scales up or down) as this metric changes.","text":""},{"location":"docs/reference/api/python/#scale_up_delay","title":"<code>scale_up_delay</code> - (Optional) The delay in seconds before scaling up. Defaults to <code>300</code>.","text":""},{"location":"docs/reference/api/python/#scale_down_delay","title":"<code>scale_down_delay</code> - (Optional) The delay in seconds before scaling down. Defaults to <code>600</code>.","text":""},{"location":"docs/reference/api/python/#dstack.api.BackendType","title":"<code>dstack.api.BackendType</code>","text":"<p>Attributes:</p> Name Type Description <code>AWS</code> <code>BackendType</code> <p>Amazon Web Services</p> <code>AZURE</code> <code>BackendType</code> <p>Microsoft Azure</p> <code>CUDO</code> <code>BackendType</code> <p>Cudo</p> <code>DSTACK</code> <code>BackendType</code> <p>dstack Sky</p> <code>GCP</code> <code>BackendType</code> <p>Google Cloud Platform</p> <code>DATACRUNCH</code> <code>BackendType</code> <p>DataCrunch</p> <code>KUBERNETES</code> <code>BackendType</code> <p>Kubernetes</p> <code>LAMBDA</code> <code>BackendType</code> <p>Lambda Cloud</p> <code>RUNPOD</code> <code>BackendType</code> <p>Runpod Cloud</p> <code>TENSORDOCK</code> <code>BackendType</code> <p>TensorDock Marketplace</p> <code>VASTAI</code> <code>BackendType</code> <p>Vast.ai Marketplace</p>"},{"location":"docs/reference/api/rest/","title":"REST API","text":""},{"location":"docs/reference/cli/","title":"CLI","text":""},{"location":"docs/reference/cli/#commands","title":"Commands","text":""},{"location":"docs/reference/cli/#dstack-server","title":"dstack server","text":"<p>This command starts the <code>dstack</code> server.</p> <pre><code>$ dstack server --help\nUsage: dstack server [-h] [--host HOST] [-p PORT] [-l LOG_LEVEL] [--default]\n                     [--no-default] [--token TOKEN]\n\nOptions:\n  -h, --help            Show this help message and exit\n  --host HOST           Bind socket to this host. Defaults to 127.0.0.1\n  -p, --port PORT       Bind socket to this port. Defaults to 3000.\n  -l, --log-level LOG_LEVEL\n                        Server logging level. Defaults to INFO.\n  --default             Update the default project configuration\n  --no-default          Do not update the default project configuration\n  --token TOKEN         The admin user token\n</code></pre>"},{"location":"docs/reference/cli/#dstack-init","title":"dstack init","text":"<p>This command must be called inside a folder before you can run <code>dstack apply</code>.</p> <p>Git credentials</p> <p>If the current folder is a remote Git repository, <code>dstack init</code> ensures that <code>dstack</code> can access it. By default, the command uses the remote repo's default Git credentials. These can be overridden with  <code>--git-identity</code> (private SSH key) or <code>--token</code> (OAuth token).</p> <pre><code>$ dstack init --help\nUsage: dstack init [-h] [--project PROJECT] [-t OAUTH_TOKEN]\n                   [--git-identity SSH_PRIVATE_KEY]\n                   [--ssh-identity SSH_PRIVATE_KEY] [--local]\n\nOptions:\n  -h, --help            Show this help message and exit\n  --project PROJECT     The name of the project\n  -t, --token OAUTH_TOKEN\n                        An authentication token for Git\n  --git-identity SSH_PRIVATE_KEY\n                        The private SSH key path to access the remote repo\n  --ssh-identity SSH_PRIVATE_KEY\n                        The private SSH key path for SSH tunneling\n  --local               Do not use git\n</code></pre> <p>User SSH key</p> <p>By default, <code>dstack</code> uses its own SSH key to access instances (<code>~/.dstack/ssh/id_rsa</code>).  It is possible to override this key via the <code>--ssh-identity</code> argument.</p>"},{"location":"docs/reference/cli/#dstack-apply","title":"dstack apply","text":"<p>This command applies a given configuration. If a resource does not exist, <code>dstack apply</code> creates the resource. If a resource exists, <code>dstack apply</code> updates the resource in-place or re-creates the resource if the update is not possible.</p> <pre><code>$ dstack apply --help\nUsage: dstack apply [--project NAME] [-h [TYPE]] [-f FILE] [--force] [-y]\n\nOptions:\n  --project NAME        The name of the project. Defaults to $DSTACK_PROJECT\n  -h, --help [TYPE]     Show this help message and exit.\n  -f, --file FILE       The path to the configuration file. Defaults to\n                        $PWD/.dstack.yml\n  --force               Force apply when no changes detected\n  -y, --yes             Do not ask for confirmation\n</code></pre>"},{"location":"docs/reference/cli/#dstack-delete","title":"dstack delete","text":"<p>This command deletes the resources defined by a given configuration.</p> <pre><code>$ dstack delete --help\nUsage: dstack delete [-h] [--project NAME] [-f FILE] [-y]\n\nOptions:\n  -h, --help            Show this help message and exit\n  --project NAME        The name of the project. Defaults to $DSTACK_PROJECT\n  -f, --file FILE       The path to the configuration file. Defaults to\n                        $PWD/.dstack.yml\n  -y, --yes             Do not ask for confirmation\n</code></pre> <p>NOTE:</p> <p>The <code>dstack delete</code> command currently supports only <code>gateway</code> configurations. Support for other configuration types is coming soon.</p>"},{"location":"docs/reference/cli/#dstack-ps","title":"dstack ps","text":"<p>This command shows the status of runs.</p> <pre><code>$ dstack ps --help\nUsage: dstack ps [-h] [--project NAME] [-a] [-v] [-w]\n\nOptions:\n  -h, --help      Show this help message and exit\n  --project NAME  The name of the project. Defaults to $DSTACK_PROJECT\n  -a, --all       Show all runs. By default, it only shows unfinished runs or\n                  the last finished.\n  -v, --verbose   Show more information about runs\n  -w, --watch     Watch statuses of runs in realtime\n</code></pre>"},{"location":"docs/reference/cli/#dstack-stop","title":"dstack stop","text":"<p>This command stops run(s) within the current repository.</p> <pre><code>$ dstack stop --help\nUsage: dstack stop [-h] [--project NAME] [-x] [-y] run_name\n\nPositional Arguments:\n  run_name\n\nOptions:\n  -h, --help      Show this help message and exit\n  --project NAME  The name of the project. Defaults to $DSTACK_PROJECT\n  -x, --abort\n  -y, --yes\n</code></pre>"},{"location":"docs/reference/cli/#dstack-logs","title":"dstack logs","text":"<p>This command shows the output of a given run within the current repository.</p> <pre><code>$ dstack logs --help\nUsage: dstack logs [-h] [--project NAME] [-d] [-a]\n                   [--ssh-identity SSH_PRIVATE_KEY] [--replica REPLICA]\n                   [--job JOB]\n                   run_name\n\nPositional Arguments:\n  run_name\n\nOptions:\n  -h, --help            Show this help message and exit\n  --project NAME        The name of the project. Defaults to $DSTACK_PROJECT\n  -d, --diagnose\n  -a, --attach          Set up an SSH tunnel, and print logs as they follow.\n  --ssh-identity SSH_PRIVATE_KEY\n                        The private SSH key path for SSH tunneling\n  --replica REPLICA     The relica number. Defaults to 0.\n  --job JOB             The job number inside the replica. Defaults to 0.\n</code></pre>"},{"location":"docs/reference/cli/#dstack-config","title":"dstack config","text":"<p>Both the CLI and API need to be configured with the server address, user token, and project name via <code>~/.dstack/config.yml</code>.</p> <p>At startup, the server automatically configures CLI and API with the server address, user token, and the default project name (<code>main</code>). This configuration is stored via <code>~/.dstack/config.yml</code>.</p> <p>To use CLI and API on different machines or projects, use the <code>dstack config</code> command.</p> <pre><code>$ dstack config --help\nUsage: dstack config [-h] [--project PROJECT] [--url URL] [--token TOKEN]\n                     [--default] [--remove] [--no-default]\n\nOptions:\n  -h, --help         Show this help message and exit\n  --project PROJECT  The name of the project to configure\n  --url URL          Server url\n  --token TOKEN      User token\n  --default          Set the project as default. It will be used when\n                     --project is omitted in commands.\n  --remove           Delete project configuration\n  --no-default       Do not prompt to set the project as default\n</code></pre>"},{"location":"docs/reference/cli/#dstack-fleet","title":"dstack fleet","text":"<p>Fleets enable efficient provisioning and management of clusters and instances.</p>"},{"location":"docs/reference/cli/#dstack-fleet-list","title":"dstack fleet list","text":"<p>The <code>dstack fleet list</code> command displays fleets and instances.</p> <pre><code>$ dstack fleet list --help\nUsage: dstack fleet list [-h] [-w] [-v]\n\nOptions:\n  -h, --help     show this help message and exit\n  -w, --watch    Update listing in realtime\n  -v, --verbose  Show more information\n</code></pre>"},{"location":"docs/reference/cli/#dstack-fleet-delete","title":"dstack fleet delete","text":"<p>The <code>dstack fleet delete</code> deletes fleets and instances. Cloud instances are terminated upon deletion.</p> <pre><code>$ dstack fleet delete --help\nUsage: dstack fleet delete [-h] [-i INSTANCE_NUM] [-y] name\n\nPositional Arguments:\n  name                  The name of the fleet\n\nOptions:\n  -h, --help            show this help message and exit\n  -i, --instance INSTANCE_NUM\n                        The instances to delete\n  -y, --yes             Don't ask for confirmation\n</code></pre>"},{"location":"docs/reference/cli/#dstack-gateway","title":"dstack gateway","text":"<p>A gateway is required for running services. It handles ingress traffic, authorization, domain mapping, model mapping for the OpenAI-compatible endpoint, and so on.</p>"},{"location":"docs/reference/cli/#dstack-gateway-list","title":"dstack gateway list","text":"<p>The <code>dstack gateway list</code> command displays the names and addresses of the gateways configured in the project.</p> <pre><code>$ dstack gateway list --help\nUsage: dstack gateway list [-h] [-w] [-v]\n\nOptions:\n  -h, --help     show this help message and exit\n  -w, --watch    Update listing in realtime\n  -v, --verbose  Show more information\n</code></pre>"},{"location":"docs/reference/cli/#dstack-gateway-create","title":"dstack gateway create","text":"<p>The <code>dstack gateway create</code> command creates a new gateway instance in the project.</p> <pre><code>$ dstack gateway create --help\nUsage: dstack gateway create [-h] --backend {aws,azure,gcp,kubernetes}\n                             --region REGION [--set-default] [--name NAME]\n                             --domain DOMAIN\n\nOptions:\n  -h, --help            show this help message and exit\n  --backend {aws,azure,gcp,kubernetes}\n  --region REGION\n  --set-default         Set as default gateway for the project\n  --name NAME           Set a custom name for the gateway\n  --domain DOMAIN       Set the domain for the gateway\n</code></pre>"},{"location":"docs/reference/cli/#dstack-gateway-delete","title":"dstack gateway delete","text":"<p>The <code>dstack gateway delete</code> command deletes the specified gateway.</p> <pre><code>$ dstack gateway delete --help\nUsage: dstack gateway delete [-h] [-y] name\n\nPositional Arguments:\n  name        The name of the gateway\n\nOptions:\n  -h, --help  show this help message and exit\n  -y, --yes   Don't ask for confirmation\n</code></pre>"},{"location":"docs/reference/cli/#dstack-gateway-update","title":"dstack gateway update","text":"<p>The <code>dstack gateway update</code> command updates the specified gateway.</p> <pre><code>$ dstack gateway update --help\nUsage: dstack gateway update [-h] [--set-default] [--domain DOMAIN] name\n\nPositional Arguments:\n  name             The name of the gateway\n\nOptions:\n  -h, --help       show this help message and exit\n  --set-default    Set it the default gateway for the project\n  --domain DOMAIN  Set the domain for the gateway\n</code></pre>"},{"location":"docs/reference/cli/#dstack-volume","title":"dstack volume","text":"<p>The volumes commands.</p>"},{"location":"docs/reference/cli/#dstack-volume-list","title":"dstack volume list","text":"<p>The <code>dstack volume list</code> command lists volumes.</p> <pre><code>$ dstack volume list --help\nUsage: dstack volume list [-h] [-w] [-v]\n\nOptions:\n  -h, --help     show this help message and exit\n  -w, --watch    Update listing in realtime\n  -v, --verbose  Show more information\n</code></pre>"},{"location":"docs/reference/cli/#dstack-volume-delete","title":"dstack volume delete","text":"<p>The <code>dstack volume delete</code> command deletes volumes.</p> <pre><code>$ dstack volume delete --help\nUsage: dstack volume delete [-h] [-y] name\n\nPositional Arguments:\n  name        The name of the volume\n\nOptions:\n  -h, --help  show this help message and exit\n  -y, --yes   Don't ask for confirmation\n</code></pre>"},{"location":"docs/reference/cli/#dstack-run","title":"dstack run","text":"<p>This command runs a given configuration.</p> <p>Deprecation</p> <p><code>dstack run</code> is deprecated in favor of <code>dstack apply</code>.</p> <pre><code>$ dstack run . --help\nUsage: dstack run [--project NAME] [-h [TYPE]] [-f FILE] [-y] [-n RUN_NAME]\n                  [-d] [--max-offers MAX_OFFERS] [-e KEY=VALUE] [--gpu SPEC]\n                  [--disk RANGE] [--profile NAME] [--max-price PRICE]\n                  [--max-duration DURATION] [-b NAME] [-r NAME]\n                  [--instance-type NAME]\n                  [--pool POOL_NAME | --reuse | --dont-destroy | --idle-duration IDLE_DURATION | --instance NAME]\n                  [--spot | --on-demand | --spot-auto | --spot-policy POLICY]\n                  [--retry | --no-retry | --retry-duration DURATION]\n                  working_dir\n\nPositional Arguments:\n  working_dir\n\nOptions:\n  --project NAME        The name of the project. Defaults to $DSTACK_PROJECT\n  -h, --help [TYPE]     Show this help message and exit. TYPE is one of task,\n                        dev-environment, service\n  -f, --file FILE       The path to the configuration file. Defaults to\n                        $PWD/.dstack.yml\n  -y, --yes             Do not ask for confirmation\n  -n, --name RUN_NAME   The name of the run. If not specified, a random name\n                        is assigned\n  -d, --detach          Do not poll logs and run status\n  --max-offers MAX_OFFERS\n                        Number of offers to show in the run plan\n  -e, --env KEY=VALUE   Environment variables\n  --gpu SPEC            Request GPU for the run. The format is\n                        NAME:COUNT:MEMORY (all parts are optional)\n  --disk RANGE          Request the size range of disk for the run. Example\n                        --disk 100GB...\n\nProfile:\n  --profile NAME        The name of the profile. Defaults to $DSTACK_PROFILE\n  --max-price PRICE     The maximum price per hour, in dollars\n  --max-duration DURATION\n                        The maximum duration of the run\n  -b, --backend NAME    The backends that will be tried for provisioning\n  -r, --region NAME     The regions that will be tried for provisioning\n  --instance-type NAME  The cloud-specific instance types that will be tried\n                        for provisioning\n\nPools:\n  --pool POOL_NAME      The name of the pool. If not set, the default pool\n                        will be used\n  --reuse               Reuse instance from pool\n  --dont-destroy        Do not destroy instance after the run is finished\n  --idle-duration IDLE_DURATION\n                        Time to wait before destroying the idle instance\n  --instance NAME       Reuse instance from pool with name NAME\n\nSpot Policy:\n  --spot                Consider only spot instances\n  --on-demand           Consider only on-demand instances\n  --spot-auto           Consider both spot and on-demand instances\n  --spot-policy POLICY  One of spot, on-demand, auto\n\nRetry Policy:\n  --retry\n  --no-retry\n  --retry-duration DURATION\n</code></pre> .gitignore <p>When running anything via CLI, <code>dstack</code> uses the exact version of code from your project directory.</p> <p>If there are large files, consider creating a <code>.gitignore</code> file to exclude them for better performance.</p>"},{"location":"docs/reference/cli/#dstack-pool","title":"dstack pool","text":"<p>Pools allow for managing the lifecycle of instances and reusing them across runs.  The default pool is created automatically.</p> <p>Deprecation</p> <p>Pools are deprecated in favor of fleets and will be removed in 0.19.0.</p>"},{"location":"docs/reference/cli/#dstack-pool-add","title":"dstack pool add","text":"<p>The <code>dstack pool add</code> command provisions a cloud instance and adds it to a pool. If no pool name is specified, the instance goes to the default pool.</p> <pre><code>$ dstack pool add --help\nUsage: dstack pool add [-h] [-y] [--profile NAME] [--max-price PRICE]\n                       [-b NAME] [-r NAME] [--instance-type NAME]\n                       [--pool POOL_NAME] [--reuse] [--dont-destroy]\n                       [--idle-duration IDLE_DURATION]\n                       [--spot | --on-demand | --spot-auto | --spot-policy POLICY]\n                       [--retry | --no-retry | --retry-duration DURATION]\n                       [--cpu SPEC] [--memory SIZE] [--shared-memory SIZE]\n                       [--gpu SPEC] [--disk SIZE]\n\nOptions:\n  -h, --help            show this help message and exit\n  -y, --yes             Don't ask for confirmation\n  --pool POOL_NAME      The name of the pool. If not set, the default pool\n                        will be used\n  --reuse               Reuse instance from pool\n  --dont-destroy        Do not destroy instance after the run is finished\n  --idle-duration IDLE_DURATION\n                        Time to wait before destroying the idle instance\n\nProfile:\n  --profile NAME        The name of the profile. Defaults to $DSTACK_PROFILE\n  --max-price PRICE     The maximum price per hour, in dollars\n  -b, --backend NAME    The backends that will be tried for provisioning\n  -r, --region NAME     The regions that will be tried for provisioning\n  --instance-type NAME  The cloud-specific instance types that will be tried\n                        for provisioning\n\nSpot Policy:\n  --spot                Consider only spot instances\n  --on-demand           Consider only on-demand instances\n  --spot-auto           Consider both spot and on-demand instances\n  --spot-policy POLICY  One of spot, on-demand, auto\n\nRetry Policy:\n  --retry\n  --no-retry\n  --retry-duration DURATION\n\nResources:\n  --cpu SPEC            Request the CPU count. Default: 2..\n  --memory SIZE         Request the size of RAM. The format is SIZE:MB|GB|TB.\n                        Default: 8GB..\n  --shared-memory SIZE  Request the size of Shared Memory. The format is\n                        SIZE:MB|GB|TB.\n  --gpu SPEC            Request GPU for the run. The format is\n                        NAME:COUNT:MEMORY (all parts are optional)\n  --disk SIZE           Request the size of disk for the run. Example --disk\n                        100GB...\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-add-ssh","title":"dstack pool add-ssh","text":"<p>The <code>dstack pool add-ssh</code> command adds an existing remote instance to a pool. If no pool name is specified, the instance goes to the default pool.</p> <pre><code>$ dstack pool add-ssh --help\nUsage: dstack pool add-ssh [-h] -i SSH_PRIVATE_KEY [-p SSH_PORT]\n                           [-l LOGIN_NAME] [--region REGION]\n                           [--pool POOL_NAME] [--name INSTANCE_NAME]\n                           [--network NETWORK]\n                           destination\n\nPositional Arguments:\n  destination\n\nOptions:\n  -h, --help            show this help message and exit\n  -i SSH_PRIVATE_KEY    The private SSH key path for SSH\n  -p SSH_PORT           SSH port to connect\n  -l LOGIN_NAME         User to login\n  --region REGION       Host region\n  --pool POOL_NAME      Pool name\n  --name INSTANCE_NAME  Set the name of the instance\n  --network NETWORK     Network address for multinode setup. Format &lt;ip\n                        address&gt;/&lt;netmask&gt;\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-ps","title":"dstack pool ps","text":"<p>The <code>dstack pool ps</code> command lists all active instances of a pool. If no pool name is specified, default pool instances are displayed.</p> <pre><code>$ dstack pool ps --help\nUsage: dstack pool ps [-h] [--pool POOL_NAME] [-w]\n\nShow instances in the pool\n\nOptions:\n  -h, --help        show this help message and exit\n  --pool POOL_NAME  The name of the pool. If not set, the default pool will be\n                    used\n  -w, --watch       Watch instances in realtime\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-rm","title":"dstack pool rm","text":"<p>The <code>dstack pool rm</code> command removes an instance from a pool. Cloud instances are terminated upon removal.</p> <pre><code>$ dstack pool rm --help\nUsage: dstack pool rm [-h] [--pool POOL_NAME] [--force] [-y] instance_name\n\nPositional Arguments:\n  instance_name     The name of the instance\n\nOptions:\n  -h, --help        show this help message and exit\n  --pool POOL_NAME  The name of the pool. If not set, the default pool will be\n                    used\n  --force           The name of the instance\n  -y, --yes         Don't ask for confirmation\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-create","title":"dstack pool create","text":"<p>The <code>dstack pool create</code> command creates a new pool.</p> <pre><code>$ dstack pool create --help\nUsage: dstack pool create [-h] -n POOL_NAME\n\nOptions:\n  -h, --help            show this help message and exit\n  -n, --name POOL_NAME  The name of the pool\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-list","title":"dstack pool list","text":"<p>The <code>dstack pool list</code> command lists all existing pools.</p> <pre><code>$ dstack pool list --help\nUsage: dstack pool list [-h] [-v VERBOSE]\n\nList available pools\n\nOptions:\n  -h, --help            show this help message and exit\n  -v, --verbose VERBOSE\n                        Show more information\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-set-default","title":"dstack pool set-default","text":"<p>The <code>dstack pool set-default</code> command sets the project's default pool.</p> <pre><code>$ dstack pool set-default --help\nUsage: dstack pool set-default [-h] --pool POOL_NAME\n\nOptions:\n  -h, --help        show this help message and exit\n  --pool POOL_NAME  The name of the pool\n</code></pre>"},{"location":"docs/reference/cli/#dstack-pool-delete","title":"dstack pool delete","text":"<p>The <code>dstack pool delete</code> command deletes a specified pool.</p> <pre><code>$ dstack pool delete --help\nUsage: dstack pool delete [-h] -n POOL_NAME\n\nOptions:\n  -h, --help            show this help message and exit\n  -n, --name POOL_NAME  The name of the pool\n</code></pre>"},{"location":"docs/reference/cli/#environment-variables","title":"Environment variables","text":"<ul> <li><code>DSTACK_CLI_LOG_LEVEL</code> \u2013 (Optional) Configures CLI logging level. Defaults to <code>INFO</code>.</li> <li><code>DSTACK_SERVER_LOG_LEVEL</code> \u2013 (Optional) Has the same effect as <code>--log-level</code>. Defaults to <code>INFO</code>.</li> <li><code>DSTACK_SERVER_HOST</code> \u2013 (Optional) Has the same effect as <code>--host</code>. Defaults to <code>127.0.0.1</code>.</li> <li><code>DSTACK_SERVER_PORT</code> \u2013 (Optional) Has the same effect as <code>--port</code>. Defaults to <code>3000</code>.</li> <li><code>DSTACK_SERVER_ADMIN_TOKEN</code> \u2013 (Optional) Has the same effect as <code>--token</code>. Defaults to <code>None</code>.</li> <li><code>DSTACK_DATABASE_URL</code> \u2013 (Optional) The database URL to use instead of default SQLite. Currently <code>dstack</code> supports Postgres. Example: <code>postgresql+asyncpg://myuser:mypassword@localhost:5432/mydatabase</code>. Defaults to <code>None</code>.</li> <li><code>DSTACK_SERVER_DIR</code> \u2013 (Optional) Sets path to store data and server configs. Defaults to <code>~/.dstack/server</code>.</li> </ul> Internal environment variables <ul> <li><code>DSTACK_SERVER_ROOT_LOG_LEVEL</code> \u2013 (Optional) Sets root logger log level. Defaults to <code>ERROR</code>.</li> <li><code>DSTACK_SERVER_LOG_FORMAT</code> \u2013 (Optional) Sets format of log output. Can be <code>rich</code>, <code>standard</code>, <code>json</code>.. Defaults to <code>rich</code>.</li> <li><code>DSTACK_SERVER_UVICORN_LOG_LEVEL</code> \u2013 (Optional) Sets uvicorn logger log level. Defaults to <code>ERROR</code>.</li> <li><code>DSTACK_PROFILE</code> \u2013 (Optional) Has the same effect as <code>--profile</code>. Defaults to <code>None</code>.</li> <li><code>DSTACK_PROJECT</code> \u2013 (Optional) Has the same effect as <code>--project</code>. Defaults to <code>None</code>.</li> <li><code>DSTACK_RUNNER_VERSION</code> \u2013 (Optional) Sets exact runner version for debug. Defaults to <code>latest</code>.</li> <li><code>DSTACK_DEFAULT_CREDS_DISABLED</code> \u2013 (Optional) Disables default credentials detection if set. Defaults to <code>None</code>.</li> <li><code>DSTACK_LOCAL_BACKEND_ENABLED</code> \u2013 (Optional) Enables local backend for debug if set. Defaults to <code>None</code>.</li> </ul>"},{"location":"docs/reference/dstack.yml/dev-environment/","title":"dev-environment","text":"<p>The <code>dev-environment</code> configuration type allows running dev environments.</p> <p>Configuration files must have a name ending with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>serve.dstack.yml</code> are both acceptable) and can be located in the project's root directory or any nested folder. Any configuration can be run via <code>dstack run</code>.</p>"},{"location":"docs/reference/dstack.yml/dev-environment/#examples","title":"Examples","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#python-version","title":"Python version","text":"<p>If you don't specify <code>image</code>, <code>dstack</code> uses the default Docker image pre-configured with  <code>python</code>, <code>pip</code>, <code>conda</code> (Miniforge), and essential CUDA drivers.  The <code>python</code> property determines which default Docker image is used.</p> <pre><code>type: dev-environment\n\npython: \"3.11\"\n\nide: vscode\n</code></pre> <p>nvcc</p> <p>Note that the default Docker image doesn't bundle <code>nvcc</code>, which is required for building custom CUDA kernels.  To install it, use <code>conda install cuda</code>.</p>"},{"location":"docs/reference/dstack.yml/dev-environment/#docker-image","title":"Docker image","text":"<pre><code>type: dev-environment\n\nimage: ghcr.io/huggingface/text-generation-inference:latest\n\nide: vscode\n</code></pre> Private registry <p>Use the <code>registry_auth</code> property to provide credentials for a private Docker registry. </p> <pre><code>type: dev-environment\n\nimage: ghcr.io/huggingface/text-generation-inference:latest\nregistry_auth:\n  username: peterschmidt85\n  password: ghp_e49HcZ9oYwBzUbcSk2080gXZOU2hiT9AeSR5\n\nide: vscode\n</code></pre>"},{"location":"docs/reference/dstack.yml/dev-environment/#_resources","title":"Resources","text":"<p>If you specify memory size, you can either specify an explicit size (e.g. <code>24GB</code>) or a  range (e.g. <code>24GB..</code>, or <code>24GB..80GB</code>, or <code>..80GB</code>).</p> <pre><code>type: dev-environment\n\nide: vscode\n\nresources:\n  # 200GB or more RAM\n  memory: 200GB..\n\n  # 4 GPUs from 40GB to 80GB\n  gpu: 40GB..80GB:4\n\n  # Shared memory\n  shm_size: 16GB\n\n  disk: 500GB\n</code></pre> <p>The <code>gpu</code> property allows specifying not only memory size but also GPU names and their quantity. Examples: <code>A100</code> (one A100), <code>A10G,A100</code> (either A10G or A100),  <code>A100:80GB</code> (one A100 of 80GB), <code>A100:2</code> (two A100), <code>24GB..40GB:2</code> (two GPUs between 24GB and 40GB),  <code>A100:40GB:2</code> (two A100 GPUs of 40GB).</p> Google Cloud TPU <p>To use TPUs, specify its architecture prefixed by <code>tpu-</code> via the <code>gpu</code> property.</p> <pre><code>type: dev-environment\n\nide: vscode\n\nresources:\n  gpu:  tpu-v2-8\n</code></pre> <p>Currently, only 8 TPU cores can be specified, supporting single TPU device workloads. Multi-TPU support is coming soon.</p> Shared memory <p>If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure  <code>shm_size</code>, e.g. set it to <code>16GB</code>.</p>"},{"location":"docs/reference/dstack.yml/dev-environment/#environment-variables","title":"Environment variables","text":"<pre><code>type: dev-environment\n\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - HF_HUB_ENABLE_HF_TRANSFER=1\n\nide: vscode\n</code></pre> <p>If you don't assign a value to an environment variable (see <code>HUGGING_FACE_HUB_TOKEN</code> above),  <code>dstack</code> will require the value to be passed via the CLI or set in the current process.</p> <p>For instance, you can define environment variables in a <code>.env</code> file and utilize tools like <code>direnv</code>.</p>"},{"location":"docs/reference/dstack.yml/dev-environment/#default-environment-variables","title":"Default environment variables","text":"<p>The following environment variables are available in any run and are passed by <code>dstack</code> by default:</p> Name Description <code>DSTACK_RUN_NAME</code> The name of the run <code>DSTACK_REPO_ID</code> The ID of the repo <code>DSTACK_GPUS_NUM</code> The total number of GPUs in the run"},{"location":"docs/reference/dstack.yml/dev-environment/#spot-policy","title":"Spot policy","text":"<p>You can choose whether to use spot instances, on-demand instances, or any available type.</p> <pre><code>type: dev-environment\n\nide: vscode\n\nspot_policy: auto\n</code></pre> <p>The <code>spot_policy</code> accepts <code>spot</code>, <code>on-demand</code>, and <code>auto</code>. The default for dev environments is <code>on-demand</code>.</p>"},{"location":"docs/reference/dstack.yml/dev-environment/#backends_1","title":"Backends","text":"<p>By default, <code>dstack</code> provisions instances in all configured backends. However, you can specify the list of backends:</p> <pre><code>type: dev-environment\n\nide: vscode\n\nbackends: [aws, gcp]\n</code></pre>"},{"location":"docs/reference/dstack.yml/dev-environment/#regions_1","title":"Regions","text":"<p>By default, <code>dstack</code> uses all configured regions. However, you can specify the list of regions:</p> <pre><code>type: dev-environment\n\nide: vscode\n\nregions: [eu-west-1, eu-west-2]\n</code></pre>"},{"location":"docs/reference/dstack.yml/dev-environment/#volumes","title":"Volumes","text":"<p>Volumes allow you to persist data between runs. To attach a volume, simply specify its name using the <code>volumes</code> property and specify where to mount its contents:</p> <pre><code>type: dev-environment\n\nide: vscode\n\nvolumes:\n  - name: my-new-volume\n    path: /volume_data\n</code></pre> <p>Once you run this configuration, the contents of the volume will be attached to <code>/volume_data</code> inside the dev environment, and its contents will persist across runs.</p> <p>Limitations</p> <p>When you're running a dev environment, task, or service with <code>dstack</code>, it automatically mounts the project folder contents to <code>/workflow</code> (and sets that as the current working directory). Right now, <code>dstack</code> doesn't allow you to  attach volumes to <code>/workflow</code> or any of its subdirectories.</p> <p>The <code>dev-environment</code> configuration type supports many other options. See below.</p>"},{"location":"docs/reference/dstack.yml/dev-environment/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#ide","title":"<code>ide</code> -  The IDE to run.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#version","title":"<code>version</code> - (Optional) The version of the IDE.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#init","title":"<code>init</code> - (Optional) The bash commands to run.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#name","title":"<code>name</code> - (Optional) The run name.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#image","title":"<code>image</code> - (Optional) The name of the Docker image to run.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#entrypoint","title":"<code>entrypoint</code> - (Optional) The Docker entrypoint.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#working_dir","title":"<code>working_dir</code> - (Optional) The path to the working directory inside the container. It's specified relative to the repository directory (<code>/workflow</code>) and should be inside it. Defaults to <code>\".\"</code> .","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#home_dir","title":"<code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_registry_auth","title":"<code>registry_auth</code> - (Optional) Credentials for pulling a private Docker image.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#python","title":"<code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#nvcc","title":"<code>nvcc</code> - (Optional) Use image with NVIDIA CUDA Compiler (NVCC) included. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#env","title":"<code>env</code> - (Optional) The mapping or the list of environment variables.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#setup","title":"<code>setup</code> - (Optional) The bash commands to run on the boot.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_resources","title":"<code>resources</code> - (Optional) The resources requirements to run the configuration.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_volumes","title":"<code>volumes</code> - (Optional) The volumes mount points.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#ports","title":"<code>ports</code> - (Optional) Port numbers/mapping to expose.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_retry","title":"<code>retry</code> - (Optional) The policy for resubmitting the run. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_retry_policy","title":"<code>retry_policy</code> - (Optional) The policy for resubmitting the run. Deprecated in favor of <code>retry</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#max_duration","title":"<code>max_duration</code> - (Optional) The maximum duration of a run (e.g., <code>2h</code>, <code>1d</code>, etc). After it elapses, the run is forced to stop. Defaults to <code>off</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#pool_name","title":"<code>pool_name</code> - (Optional) The name of the pool. If not set, dstack will use the default name.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#instance_name","title":"<code>instance_name</code> - (Optional) The name of the instance.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#creation_policy","title":"<code>creation_policy</code> - (Optional) The policy for using instances from the pool. Defaults to <code>reuse-or-create</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying the idle instance. Defaults to <code>5m</code> for <code>dstack run</code> and to <code>3d</code> for <code>dstack pool add</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#resources","title":"<code>resources</code>","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#cpu","title":"<code>cpu</code> - (Optional) The number of CPU cores. Defaults to <code>2..</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>8GB</code>). Defaults to <code>8GB..</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#shm_size","title":"<code>shm_size</code> - (Optional) The size of shared memory (e.g., <code>8GB</code>). If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure this.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_gpu","title":"<code>gpu</code> - (Optional) The GPU requirements. Can be set to a number, a string (e.g. <code>A100</code>, <code>80GB:2</code>, etc.), or an object.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#_disk","title":"<code>disk</code> - (Optional) The disk resources.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#resources-gpu","title":"<code>resources.gpu</code>","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#name","title":"<code>name</code> - (Optional) The GPU name or list of names.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#count","title":"<code>count</code> - (Optional) The number of GPUs. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>16GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#total_memory","title":"<code>total_memory</code> - (Optional) The total RAM size (e.g., <code>32GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#compute_capability","title":"<code>compute_capability</code> - (Optional) The minimum compute capability of the GPU (e.g., <code>7.5</code>).","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#resources-disk","title":"<code>resources.disk</code>","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#size","title":"<code>size</code> -  The disk size. Can be a string (e.g., <code>100GB</code> or <code>100GB..</code>) or an object.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#registry_auth","title":"<code>registry_auth</code>","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#username","title":"<code>username</code> -  The username.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#password","title":"<code>password</code> -  The password or access token.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#volumes_1","title":"<code>volumes</code>","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#name","title":"<code>name</code> -  The name of the volume to mount.","text":""},{"location":"docs/reference/dstack.yml/dev-environment/#path","title":"<code>path</code> -  The container path to mount the volume at.","text":""},{"location":"docs/reference/dstack.yml/fleet/","title":"fleet","text":"<p>The <code>fleet</code> configuration type allows creating and updating fleets.</p> <p>Configuration files must have a name ending with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>fleet.dstack.yml</code> are both acceptable) and can be located in the project's root directory or any nested folder. Any configuration can be applied via <code>dstack apply</code>.</p>"},{"location":"docs/reference/dstack.yml/fleet/#examples","title":"Examples","text":""},{"location":"docs/reference/dstack.yml/fleet/#create-cloud-fleet","title":"Creating a cloud fleet","text":"<pre><code>type: fleet\nname: my-gcp-fleet\nnodes: 4\nplacement: cluster\nbackends: [gcp]\nresources:\n  gpu: 1\n</code></pre>"},{"location":"docs/reference/dstack.yml/fleet/#create-ssh-fleet","title":"Creating an on-prem fleet","text":"<pre><code>type: fleet\nname: my-ssh-fleet\nssh_config:\n  user: ubuntu\n  identity_file: ~/.ssh/id_rsa\n  hosts:\n    - 3.255.177.51\n    - 3.255.177.52\n</code></pre>"},{"location":"docs/reference/dstack.yml/fleet/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/dstack.yml/fleet/#name","title":"<code>name</code> - (Optional) The fleet name.","text":""},{"location":"docs/reference/dstack.yml/fleet/#_ssh_config","title":"<code>ssh_config</code> - (Optional) The parameters for adding instances via SSH.","text":""},{"location":"docs/reference/dstack.yml/fleet/#nodes","title":"<code>nodes</code> - (Optional) The number of instances.","text":""},{"location":"docs/reference/dstack.yml/fleet/#placement","title":"<code>placement</code> - (Optional) The placement of instances: <code>any</code> or <code>cluster</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#_resources","title":"<code>resources</code> - (Optional) The resources requirements.","text":""},{"location":"docs/reference/dstack.yml/fleet/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/dstack.yml/fleet/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/dstack.yml/fleet/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/dstack.yml/fleet/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#_retry","title":"<code>retry</code> - (Optional) The policy for provisioning retry. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/dstack.yml/fleet/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying idle instances. Defaults to <code>3d</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#ssh","title":"<code>ssh</code>","text":""},{"location":"docs/reference/dstack.yml/fleet/#user","title":"<code>user</code> - (Optional) The user to log in with on all hosts.","text":""},{"location":"docs/reference/dstack.yml/fleet/#port","title":"<code>port</code> - (Optional) The SSH port to connect to.","text":""},{"location":"docs/reference/dstack.yml/fleet/#identity_file","title":"<code>identity_file</code> - (Optional) The private key to use for all hosts.","text":""},{"location":"docs/reference/dstack.yml/fleet/#hosts","title":"<code>hosts</code> -  The per host connection parameters: a hostname or an object that overrides default ssh parameters.","text":""},{"location":"docs/reference/dstack.yml/fleet/#network","title":"<code>network</code> - (Optional) The network address for cluster setup in the format <code>&lt;ip&gt;/&lt;netmask&gt;</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#sshhostsn","title":"<code>ssh.hosts[n]</code>","text":""},{"location":"docs/reference/dstack.yml/fleet/#hostname","title":"<code>hostname</code> -  The IP address or domain to connect to.","text":""},{"location":"docs/reference/dstack.yml/fleet/#port","title":"<code>port</code> - (Optional) The SSH port to connect to for this host.","text":""},{"location":"docs/reference/dstack.yml/fleet/#user","title":"<code>user</code> - (Optional) The user to log in with for this host.","text":""},{"location":"docs/reference/dstack.yml/fleet/#identity_file","title":"<code>identity_file</code> - (Optional) The private key to use for this host.","text":""},{"location":"docs/reference/dstack.yml/fleet/#resources","title":"<code>resources</code>","text":""},{"location":"docs/reference/dstack.yml/fleet/#cpu","title":"<code>cpu</code> - (Optional) The number of CPU cores. Defaults to <code>2..</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>8GB</code>). Defaults to <code>8GB..</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#shm_size","title":"<code>shm_size</code> - (Optional) The size of shared memory (e.g., <code>8GB</code>). If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure this.","text":""},{"location":"docs/reference/dstack.yml/fleet/#_gpu","title":"<code>gpu</code> - (Optional) The GPU requirements. Can be set to a number, a string (e.g. <code>A100</code>, <code>80GB:2</code>, etc.), or an object.","text":""},{"location":"docs/reference/dstack.yml/fleet/#_disk","title":"<code>disk</code> - (Optional) The disk resources.","text":""},{"location":"docs/reference/dstack.yml/fleet/#resources-gpu","title":"<code>resouces.gpu</code>","text":""},{"location":"docs/reference/dstack.yml/fleet/#name","title":"<code>name</code> - (Optional) The GPU name or list of names.","text":""},{"location":"docs/reference/dstack.yml/fleet/#count","title":"<code>count</code> - (Optional) The number of GPUs. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>16GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/fleet/#total_memory","title":"<code>total_memory</code> - (Optional) The total RAM size (e.g., <code>32GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/fleet/#compute_capability","title":"<code>compute_capability</code> - (Optional) The minimum compute capability of the GPU (e.g., <code>7.5</code>).","text":""},{"location":"docs/reference/dstack.yml/fleet/#resources-disk","title":"<code>resouces.disk</code>","text":""},{"location":"docs/reference/dstack.yml/fleet/#size","title":"<code>size</code> -  The disk size. Can be a string (e.g., <code>100GB</code> or <code>100GB..</code>) or an object.","text":""},{"location":"docs/reference/dstack.yml/fleet/#retry","title":"<code>retry</code>","text":""},{"location":"docs/reference/dstack.yml/fleet/#on_events","title":"<code>on_events</code> -  The list of events that should be handled with retry. Supported events are <code>no-capacity</code>, <code>interruption</code>, and <code>error</code>.","text":""},{"location":"docs/reference/dstack.yml/fleet/#duration","title":"<code>duration</code> - (Optional) The maximum period of retrying the run, e.g., <code>4h</code> or <code>1d</code>.","text":""},{"location":"docs/reference/dstack.yml/gateway/","title":"gateway","text":"<p>The <code>gateway</code> configuration type allows creating and updating gateways.</p> <p>Configuration files must have a name ending with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>gateway.dstack.yml</code> are both acceptable) and can be located in the project's root directory or any nested folder. Any configuration can be applied via <code>dstack apply</code>.</p>"},{"location":"docs/reference/dstack.yml/gateway/#examples","title":"Examples","text":"<pre><code>type: gateway\nname: example-gateway\n\nbackend: aws\nregion: eu-west-1\ndomain: example.com\n</code></pre>"},{"location":"docs/reference/dstack.yml/gateway/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/dstack.yml/gateway/#name","title":"<code>name</code> - (Optional) The gateway name.","text":""},{"location":"docs/reference/dstack.yml/gateway/#default","title":"<code>default</code> - (Optional) Make the gateway default.","text":""},{"location":"docs/reference/dstack.yml/gateway/#backend","title":"<code>backend</code> -  The gateway backend.","text":""},{"location":"docs/reference/dstack.yml/gateway/#region","title":"<code>region</code> -  The gateway region.","text":""},{"location":"docs/reference/dstack.yml/gateway/#domain","title":"<code>domain</code> - (Optional) The gateway domain, e.g. <code>example.com</code>.","text":""},{"location":"docs/reference/dstack.yml/gateway/#public_ip","title":"<code>public_ip</code> - (Optional) Allocate public IP for the gateway. Defaults to <code>True</code>.","text":""},{"location":"docs/reference/dstack.yml/gateway/#_certificate","title":"<code>certificate</code> - (Optional) The SSL certificate configuration. Defaults to <code>type: lets-encrypt</code>.","text":""},{"location":"docs/reference/dstack.yml/gateway/#certificatetypelets-encrypt","title":"<code>certificate[type=lets-encrypt]</code>","text":""},{"location":"docs/reference/dstack.yml/gateway/#type","title":"<code>type</code> -  Automatic certificates by Let's Encrypt. Must be <code>lets-encrypt</code>.","text":""},{"location":"docs/reference/dstack.yml/gateway/#certificatetypeacm","title":"<code>certificate[type=acm]</code>","text":""},{"location":"docs/reference/dstack.yml/gateway/#type","title":"<code>type</code> -  Certificates by AWS Certificate Manager (ACM). Must be <code>acm</code>.","text":""},{"location":"docs/reference/dstack.yml/gateway/#arn","title":"<code>arn</code> -  The ARN of the wildcard ACM certificate for the domain.","text":""},{"location":"docs/reference/dstack.yml/service/","title":"service","text":"<p>The <code>service</code> configuration type allows running services.</p> <p>Configuration files must have a name ending with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>serve.dstack.yml</code> are both acceptable) and can be located in the project's root directory or any nested folder. Any configuration can be run via <code>dstack run . -f PATH</code>.</p>"},{"location":"docs/reference/dstack.yml/service/#examples","title":"Examples","text":""},{"location":"docs/reference/dstack.yml/service/#python-version","title":"Python version","text":"<p>If you don't specify <code>image</code>, <code>dstack</code> uses the default Docker image pre-configured with  <code>python</code>, <code>pip</code>, <code>conda</code> (Miniforge), and essential CUDA drivers.  The <code>python</code> property determines which default Docker image is used.</p> <pre><code>type: service\n\npython: \"3.11\"\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n</code></pre> <p>nvcc</p> <p>Note that the default Docker image doesn't bundle <code>nvcc</code>, which is required for building custom CUDA kernels.  To install it, use <code>conda install cuda</code>.</p>"},{"location":"docs/reference/dstack.yml/service/#docker-image","title":"Docker image","text":"<pre><code>type: service\n\nimage: dstackai/base:py3.11-0.4-cuda-12.1\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n</code></pre> Private Docker registry <p>Use the <code>registry_auth</code> property to provide credentials for a private Docker registry.</p> <pre><code>type: service\n\nimage: dstackai/base:py3.11-0.4-cuda-12.1\n\ncommands:\n  - python3 -m http.server\nregistry_auth:\n  username: peterschmidt85\n  password: ghp_e49HcZ9oYwBzUbcSk2080gXZOU2hiT9AeSR5\n\nport: 8000\n</code></pre>"},{"location":"docs/reference/dstack.yml/service/#model-mapping","title":"OpenAI-compatible interface","text":"<p>By default, if you run a service, its endpoint is accessible at <code>https://&lt;run name&gt;.&lt;gateway domain&gt;</code>.</p> <p>If you run a model, you can optionally configure the mapping to make it accessible via the  OpenAI-compatible interface.</p> <pre><code>type: service\n\npython: \"3.11\"\n\nenv:\n  - MODEL=NousResearch/Llama-2-7b-chat-hf\ncommands:\n  - pip install vllm\n  - python -m vllm.entrypoints.openai.api_server --model $MODEL --port 8000\nport: 8000\n\nresources:\n  gpu: 24GB\n\n# Enable the OpenAI-compatible endpoint\nmodel:\n  format: openai\n  type: chat\n  name: NousResearch/Llama-2-7b-chat-hf\n</code></pre> <p>In this case, with such a configuration, once the service is up, you'll be able to access the model at <code>https://gateway.&lt;gateway domain&gt;</code> via the OpenAI-compatible interface.</p> <p>The <code>format</code> supports only <code>tgi</code> (Text Generation Inference) and <code>openai</code> (if you are using Text Generation Inference or vLLM with OpenAI-compatible mode).</p> Chat template <p>By default, <code>dstack</code> loads the chat template from the model's repository. If it is not present there, manual configuration is required.</p> <pre><code>type: service\n\nimage: ghcr.io/huggingface/text-generation-inference:latest\nenv:\n  - MODEL_ID=TheBloke/Llama-2-13B-chat-GPTQ\ncommands:\n  - text-generation-launcher --port 8000 --trust-remote-code --quantize gptq\nport: 8000\n\nresources:\n  gpu: 80GB\n\n# Enable the OpenAI-compatible endpoint\nmodel:\n  type: chat\n  name: TheBloke/Llama-2-13B-chat-GPTQ\n  format: tgi\n  chat_template: \"{% if messages[0]['role'] == 'system' %}{% set loop_messages = messages[1:] %}{% set system_message = messages[0]['content'] %}{% else %}{% set loop_messages = messages %}{% set system_message = false %}{% endif %}{% for message in loop_messages %}{% if (message['role'] == 'user') != (loop.index0 % 2 == 0) %}{{ raise_exception('Conversation roles must alternate user/assistant/user/assistant/...') }}{% endif %}{% if loop.index0 == 0 and system_message != false %}{% set content = '&lt;&lt;SYS&gt;&gt;\\\\n' + system_message + '\\\\n&lt;&lt;/SYS&gt;&gt;\\\\n\\\\n' + message['content'] %}{% else %}{% set content = message['content'] %}{% endif %}{% if message['role'] == 'user' %}{{ '&lt;s&gt;[INST] ' + content.strip() + ' [/INST]' }}{% elif message['role'] == 'assistant' %}{{ ' '  + content.strip() + ' &lt;/s&gt;' }}{% endif %}{% endfor %}\"\n  eos_token: \"&lt;/s&gt;\"\n</code></pre>"},{"location":"docs/reference/dstack.yml/service/#limitations","title":"Limitations","text":"<p>Please note that model mapping is an experimental feature with the following limitations:</p> <ol> <li>Doesn't work if your <code>chat_template</code> uses <code>bos_token</code>. As a workaround, replace <code>bos_token</code> inside <code>chat_template</code> with the token content itself.</li> <li>Doesn't work if <code>eos_token</code> is defined in the model repository as a dictionary. As a workaround, set <code>eos_token</code> manually, as shown in the example above (see Chat template).</li> </ol> <p>If you encounter any other issues, please make sure to file a GitHub issue.</p>"},{"location":"docs/reference/dstack.yml/service/#auto-scaling","title":"Auto-scaling","text":"<p>By default, <code>dstack</code> runs a single replica of the service. You can configure the number of replicas as well as the auto-scaling rules.</p> <pre><code>type: service\n\npython: \"3.11\"\n\nenv:\n  - MODEL=NousResearch/Llama-2-7b-chat-hf\ncommands:\n  - pip install vllm\n  - python -m vllm.entrypoints.openai.api_server --model $MODEL --port 8000\nport: 8000\n\nresources:\n  gpu: 24GB\n\n# Enable the OpenAI-compatible endpoint\nmodel:\n  format: openai\n  type: chat\n  name: NousResearch/Llama-2-7b-chat-hf\n\nreplicas: 1..4\nscaling:\n  metric: rps\n  target: 10\n</code></pre> <p>The <code>replicas</code> property can be a number or a range.</p> <p>The <code>metric</code> property of <code>scaling</code> only supports the <code>rps</code> metric (requests per second). In this  case <code>dstack</code> adjusts the number of replicas (scales up or down) automatically based on the load. </p> <p>Setting the minimum number of replicas to <code>0</code> allows the service to scale down to zero when there are no requests.</p>"},{"location":"docs/reference/dstack.yml/service/#_resources","title":"Resources","text":"<p>If you specify memory size, you can either specify an explicit size (e.g. <code>24GB</code>) or a  range (e.g. <code>24GB..</code>, or <code>24GB..80GB</code>, or <code>..80GB</code>).</p> <pre><code>type: service\n\npython: \"3.11\"\ncommands:\n  - pip install vllm\n  - python -m vllm.entrypoints.openai.api_server\n    --model mistralai/Mixtral-8X7B-Instruct-v0.1\n    --host 0.0.0.0\n    --tensor-parallel-size 2 # Match the number of GPUs\nport: 8000\n\nresources:\n  # 2 GPUs of 80GB\n  gpu: 80GB:2\n\n  disk: 200GB\n\n# Enable the OpenAI-compatible endpoint\nmodel:\n  type: chat\n  name: TheBloke/Mixtral-8x7B-Instruct-v0.1-GPTQ\n  format: openai\n</code></pre> <p>The <code>gpu</code> property allows specifying not only memory size but also GPU names and their quantity. Examples: <code>A100</code> (one A100), <code>A10G,A100</code> (either A10G or A100),  <code>A100:80GB</code> (one A100 of 80GB), <code>A100:2</code> (two A100), <code>24GB..40GB:2</code> (two GPUs between 24GB and 40GB),  <code>A100:40GB:2</code> (two A100 GPUs of 40GB).</p> Shared memory <p>If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure  <code>shm_size</code>, e.g. set it to <code>16GB</code>.</p>"},{"location":"docs/reference/dstack.yml/service/#authorization","title":"Authorization","text":"<p>By default, the service endpoint requires the <code>Authorization</code> header with <code>\"Bearer &lt;dstack token&gt;\"</code>. Authorization can be disabled by setting <code>auth</code> to <code>false</code>.</p> <pre><code>type: service\n\npython: \"3.11\"\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n\nauth: false\n</code></pre>"},{"location":"docs/reference/dstack.yml/service/#environment-variables","title":"Environment variables","text":"<pre><code>type: service\n\npython: \"3.11\"\n\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - MODEL=NousResearch/Llama-2-7b-chat-hf\ncommands:\n  - pip install vllm\n  - python -m vllm.entrypoints.openai.api_server --model $MODEL --port 8000\nport: 8000\n\nresources:\n  gpu: 24GB\n</code></pre> <p>If you don't assign a value to an environment variable (see <code>HUGGING_FACE_HUB_TOKEN</code> above), <code>dstack</code> will require the value to be passed via the CLI or set in the current process.</p> <p>For instance, you can define environment variables in a <code>.env</code> file and utilize tools like <code>direnv</code>.</p>"},{"location":"docs/reference/dstack.yml/service/#default-environment-variables","title":"Default environment variables","text":"<p>The following environment variables are available in any run and are passed by <code>dstack</code> by default:</p> Name Description <code>DSTACK_RUN_NAME</code> The name of the run <code>DSTACK_REPO_ID</code> The ID of the repo <code>DSTACK_GPUS_NUM</code> The total number of GPUs in the run"},{"location":"docs/reference/dstack.yml/service/#spot-policy","title":"Spot policy","text":"<p>You can choose whether to use spot instances, on-demand instances, or any available type.</p> <pre><code>type: service\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n\nspot_policy: auto\n</code></pre> <p>The <code>spot_policy</code> accepts <code>spot</code>, <code>on-demand</code>, and <code>auto</code>. The default for services is <code>auto</code>.</p>"},{"location":"docs/reference/dstack.yml/service/#backends_1","title":"Backends","text":"<p>By default, <code>dstack</code> provisions instances in all configured backends. However, you can specify the list of backends:</p> <pre><code>type: service\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n\nbackends: [aws, gcp]\n</code></pre>"},{"location":"docs/reference/dstack.yml/service/#regions_1","title":"Regions","text":"<p>By default, <code>dstack</code> uses all configured regions. However, you can specify the list of regions:</p> <pre><code>type: service\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n\nregions: [eu-west-1, eu-west-2]\n</code></pre>"},{"location":"docs/reference/dstack.yml/service/#volumes","title":"Volumes","text":"<p>Volumes allow you to persist data between runs. To attach a volume, simply specify its name using the <code>volumes</code> property and specify where to mount its contents:</p> <pre><code>type: service\n\ncommands:\n  - python3 -m http.server\n\nport: 8000\n\nvolumes:\n  - name: my-new-volume\n    path: /volume_data\n</code></pre> <p>Once you run this configuration, the contents of the volume will be attached to <code>/volume_data</code> inside the service,  and its contents will persist across runs.</p> <p>The <code>service</code> configuration type supports many other options. See below.</p>"},{"location":"docs/reference/dstack.yml/service/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/dstack.yml/service/#port","title":"<code>port</code> -  The port, that application listens on or the mapping.","text":""},{"location":"docs/reference/dstack.yml/service/#model","title":"<code>model</code> - (Optional) Mapping of the model for the OpenAI-compatible endpoint.","text":""},{"location":"docs/reference/dstack.yml/service/#https","title":"<code>https</code> - (Optional) Enable HTTPS. Defaults to <code>True</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#auth","title":"<code>auth</code> - (Optional) Enable the authorization. Defaults to <code>True</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#replicas","title":"<code>replicas</code> - (Optional) The number of replicas. Can be a number (e.g. <code>2</code>) or a range (<code>0..4</code> or <code>1..8</code>). If it's a range, the <code>scaling</code> property is required. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#_scaling","title":"<code>scaling</code> - (Optional) The auto-scaling rules. Required if <code>replicas</code> is set to a range.","text":""},{"location":"docs/reference/dstack.yml/service/#name","title":"<code>name</code> - (Optional) The run name.","text":""},{"location":"docs/reference/dstack.yml/service/#image","title":"<code>image</code> - (Optional) The name of the Docker image to run.","text":""},{"location":"docs/reference/dstack.yml/service/#entrypoint","title":"<code>entrypoint</code> - (Optional) The Docker entrypoint.","text":""},{"location":"docs/reference/dstack.yml/service/#working_dir","title":"<code>working_dir</code> - (Optional) The path to the working directory inside the container. It's specified relative to the repository directory (<code>/workflow</code>) and should be inside it. Defaults to <code>\".\"</code> .","text":""},{"location":"docs/reference/dstack.yml/service/#home_dir","title":"<code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#_registry_auth","title":"<code>registry_auth</code> - (Optional) Credentials for pulling a private Docker image.","text":""},{"location":"docs/reference/dstack.yml/service/#python","title":"<code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#nvcc","title":"<code>nvcc</code> - (Optional) Use image with NVIDIA CUDA Compiler (NVCC) included. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#env","title":"<code>env</code> - (Optional) The mapping or the list of environment variables.","text":""},{"location":"docs/reference/dstack.yml/service/#setup","title":"<code>setup</code> - (Optional) The bash commands to run on the boot.","text":""},{"location":"docs/reference/dstack.yml/service/#_resources","title":"<code>resources</code> - (Optional) The resources requirements to run the configuration.","text":""},{"location":"docs/reference/dstack.yml/service/#_volumes","title":"<code>volumes</code> - (Optional) The volumes mount points.","text":""},{"location":"docs/reference/dstack.yml/service/#commands","title":"<code>commands</code> - (Optional) The bash commands to run.","text":""},{"location":"docs/reference/dstack.yml/service/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/dstack.yml/service/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/dstack.yml/service/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/dstack.yml/service/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#_retry","title":"<code>retry</code> - (Optional) The policy for resubmitting the run. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#_retry_policy","title":"<code>retry_policy</code> - (Optional) The policy for resubmitting the run. Deprecated in favor of <code>retry</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#max_duration","title":"<code>max_duration</code> - (Optional) The maximum duration of a run (e.g., <code>2h</code>, <code>1d</code>, etc). After it elapses, the run is forced to stop. Defaults to <code>off</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/dstack.yml/service/#pool_name","title":"<code>pool_name</code> - (Optional) The name of the pool. If not set, dstack will use the default name.","text":""},{"location":"docs/reference/dstack.yml/service/#instance_name","title":"<code>instance_name</code> - (Optional) The name of the instance.","text":""},{"location":"docs/reference/dstack.yml/service/#creation_policy","title":"<code>creation_policy</code> - (Optional) The policy for using instances from the pool. Defaults to <code>reuse-or-create</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying the idle instance. Defaults to <code>5m</code> for <code>dstack run</code> and to <code>3d</code> for <code>dstack pool add</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#model_1","title":"<code>model</code>","text":""},{"location":"docs/reference/dstack.yml/service/#type","title":"<code>type</code> -  The type of the model.","text":""},{"location":"docs/reference/dstack.yml/service/#name","title":"<code>name</code> -  The name of the model.","text":""},{"location":"docs/reference/dstack.yml/service/#format","title":"<code>format</code> -  The serving format. Supported values include <code>openai</code> and <code>tgi</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#scaling","title":"<code>scaling</code>","text":""},{"location":"docs/reference/dstack.yml/service/#metric","title":"<code>metric</code> -  The target metric to track. Currently, the only supported value is <code>rps</code> (meaning requests per second).","text":""},{"location":"docs/reference/dstack.yml/service/#target","title":"<code>target</code> -  The target value of the metric. The number of replicas is calculated based on this number and automatically adjusts (scales up or down) as this metric changes.","text":""},{"location":"docs/reference/dstack.yml/service/#scale_up_delay","title":"<code>scale_up_delay</code> - (Optional) The delay in seconds before scaling up. Defaults to <code>300</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#scale_down_delay","title":"<code>scale_down_delay</code> - (Optional) The delay in seconds before scaling down. Defaults to <code>600</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#resources","title":"<code>resources</code>","text":""},{"location":"docs/reference/dstack.yml/service/#cpu","title":"<code>cpu</code> - (Optional) The number of CPU cores. Defaults to <code>2..</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>8GB</code>). Defaults to <code>8GB..</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#shm_size","title":"<code>shm_size</code> - (Optional) The size of shared memory (e.g., <code>8GB</code>). If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure this.","text":""},{"location":"docs/reference/dstack.yml/service/#_gpu","title":"<code>gpu</code> - (Optional) The GPU requirements. Can be set to a number, a string (e.g. <code>A100</code>, <code>80GB:2</code>, etc.), or an object.","text":""},{"location":"docs/reference/dstack.yml/service/#_disk","title":"<code>disk</code> - (Optional) The disk resources.","text":""},{"location":"docs/reference/dstack.yml/service/#resources-gpu","title":"<code>resouces.gpu</code>","text":""},{"location":"docs/reference/dstack.yml/service/#name","title":"<code>name</code> - (Optional) The GPU name or list of names.","text":""},{"location":"docs/reference/dstack.yml/service/#count","title":"<code>count</code> - (Optional) The number of GPUs. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/dstack.yml/service/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>16GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/service/#total_memory","title":"<code>total_memory</code> - (Optional) The total RAM size (e.g., <code>32GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/service/#compute_capability","title":"<code>compute_capability</code> - (Optional) The minimum compute capability of the GPU (e.g., <code>7.5</code>).","text":""},{"location":"docs/reference/dstack.yml/service/#resources-disk","title":"<code>resouces.disk</code>","text":""},{"location":"docs/reference/dstack.yml/service/#size","title":"<code>size</code> -  The disk size. Can be a string (e.g., <code>100GB</code> or <code>100GB..</code>) or an object.","text":""},{"location":"docs/reference/dstack.yml/service/#registry_auth","title":"<code>registry_auth</code>","text":""},{"location":"docs/reference/dstack.yml/service/#username","title":"<code>username</code> -  The username.","text":""},{"location":"docs/reference/dstack.yml/service/#password","title":"<code>password</code> -  The password or access token.","text":""},{"location":"docs/reference/dstack.yml/service/#volumes_1","title":"<code>volumes</code>","text":""},{"location":"docs/reference/dstack.yml/service/#name","title":"<code>name</code> -  The name of the volume to mount.","text":""},{"location":"docs/reference/dstack.yml/service/#path","title":"<code>path</code> -  The container path to mount the volume at.","text":""},{"location":"docs/reference/dstack.yml/task/","title":"task","text":"<p>The <code>task</code> configuration type allows running tasks.</p> <p>Configuration files must have a name ending with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>serve.dstack.yml</code> are both acceptable) and can be located in the project's root directory or any nested folder. Any configuration can be run via <code>dstack run</code>.</p>"},{"location":"docs/reference/dstack.yml/task/#examples","title":"Examples","text":""},{"location":"docs/reference/dstack.yml/task/#python-version","title":"Python version","text":"<p>If you don't specify <code>image</code>, <code>dstack</code> uses the default Docker image pre-configured with  <code>python</code>, <code>pip</code>, <code>conda</code> (Miniforge), and essential CUDA drivers.  The <code>python</code> property determines which default Docker image is used.</p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n</code></pre> <p>nvcc</p> <p>Note that the default Docker image doesn't bundle <code>nvcc</code>, which is required for building custom CUDA kernels.  To install it, use <code>conda install cuda</code>.</p>"},{"location":"docs/reference/dstack.yml/task/#_ports","title":"Ports","text":"<p>A task can configure ports. In this case, if the task is running an application on a port, <code>dstack run</code>  will securely allow you to access this port from your local machine through port forwarding.</p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - tensorboard --logdir results/runs &amp;\n  - python fine-tuning/qlora/train.py\n\nports:\n  - 6000\n</code></pre> <p>When running it, <code>dstack run</code> forwards <code>6000</code> port to <code>localhost:6000</code>, enabling secure access.</p>"},{"location":"docs/reference/dstack.yml/task/#docker-image","title":"Docker image","text":"<pre><code>type: dev-environment\n\nimage: dstackai/base:py3.11-0.4-cuda-12.1\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n</code></pre> Private registry <p>Use the <code>registry_auth</code> property to provide credentials for a private Docker registry.</p> <pre><code>type: dev-environment\n\nimage: dstackai/base:py3.11-0.4-cuda-12.1\nregistry_auth:\n  username: peterschmidt85\n  password: ghp_e49HcZ9oYwBzUbcSk2080gXZOU2hiT9AeSR5\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n</code></pre>"},{"location":"docs/reference/dstack.yml/task/#_resources","title":"Resources","text":"<p>If you specify memory size, you can either specify an explicit size (e.g. <code>24GB</code>) or a  range (e.g. <code>24GB..</code>, or <code>24GB..80GB</code>, or <code>..80GB</code>).</p> <pre><code>type: task\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n\nresources:\n  # 200GB or more RAM\n  memory: 200GB..\n\n  # 4 GPUs from 40GB to 80GB\n  gpu: 40GB..80GB:4\n\n  # Shared memory\n  shm_size: 16GB\n\n  disk: 500GB\n</code></pre> <p>The <code>gpu</code> property allows specifying not only memory size but also GPU names and their quantity. Examples: <code>A100</code> (one A100), <code>A10G,A100</code> (either A10G or A100),  <code>A100:80GB</code> (one A100 of 80GB), <code>A100:2</code> (two A100), <code>24GB..40GB:2</code> (two GPUs between 24GB and 40GB),  <code>A100:40GB:2</code> (two A100 GPUs of 40GB).</p> Google Cloud TPU <p>To use TPUs, specify its architecture prefixed by <code>tpu-</code> via the <code>gpu</code> property.</p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip install torch~=2.3.0 torch_xla[tpu]~=2.3.0 torchvision -f https://storage.googleapis.com/libtpu-releases/index.html\n  - git clone --recursive https://github.com/pytorch/xla.git\n  - python3 xla/test/test_train_mp_imagenet.py --fake_data --model=resnet50 --num_epochs=1\n\nresources:\n  gpu:  tpu-v2-8\n</code></pre> <p>Currently, only 8 TPU cores can be specified, supporting single host workloads. Multi-host support is coming soon.</p> Shared memory <p>If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure  <code>shm_size</code>, e.g. set it to <code>16GB</code>.</p>"},{"location":"docs/reference/dstack.yml/task/#environment-variables","title":"Environment variables","text":"<pre><code>type: task\n\npython: \"3.11\"\n\nenv:\n  - HUGGING_FACE_HUB_TOKEN\n  - HF_HUB_ENABLE_HF_TRANSFER=1\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n</code></pre> <p>If you don't assign a value to an environment variable (see <code>HUGGING_FACE_HUB_TOKEN</code> above),  <code>dstack</code> will require the value to be passed via the CLI or set in the current process.</p> <p>For instance, you can define environment variables in a <code>.env</code> file and utilize tools like <code>direnv</code>.</p>"},{"location":"docs/reference/dstack.yml/task/#default-environment-variables","title":"Default environment variables","text":"<p>The following environment variables are available in any run and are passed by <code>dstack</code> by default:</p> Name Description <code>DSTACK_RUN_NAME</code> The name of the run <code>DSTACK_REPO_ID</code> The ID of the repo <code>DSTACK_GPUS_NUM</code> The total number of GPUs in the run <code>DSTACK_NODES_NUM</code> The number of nodes in the run <code>DSTACK_NODE_RANK</code> The rank of the node <code>DSTACK_MASTER_NODE_IP</code> The internal IP address the master node"},{"location":"docs/reference/dstack.yml/task/#_nodes","title":"Distributed tasks","text":"<p>By default, the task runs on a single node. However, you can run it on a cluster of nodes.</p> <pre><code>type: task\n\n# The size of the cluster\nnodes: 2\n\npython: \"3.11\"\nenv:\n  - HF_HUB_ENABLE_HF_TRANSFER=1\ncommands:\n  - pip install -r requirements.txt\n  - torchrun\n    --nproc_per_node=$DSTACK_GPUS_PER_NODE\n    --node_rank=$DSTACK_NODE_RANK\n    --nnodes=$DSTACK_NODES_NUM\n    --master_addr=$DSTACK_MASTER_NODE_IP\n    --master_port=8008 resnet_ddp.py\n    --num_epochs 20\n\nresources:\n  gpu: 24GB\n</code></pre> <p>If you run the task, <code>dstack</code> first provisions the master node and then runs the other nodes of the cluster. All nodes are provisioned in the same region.</p> <p><code>dstack</code> is easy to use with <code>accelerate</code>, <code>torchrun</code>, and other distributed frameworks. All you need to do is pass the corresponding environment variables such as <code>DSTACK_GPUS_PER_NODE</code>, <code>DSTACK_NODE_RANK</code>, <code>DSTACK_NODES_NUM</code>, <code>DSTACK_MASTER_NODE_IP</code>, and <code>DSTACK_GPUS_NUM</code> (see System environment variables).</p> Backends <p>Running on multiple nodes is supported only with <code>aws</code>, <code>gcp</code>, <code>azure</code>, <code>oci</code>, and instances added via <code>dstack pool add-ssh</code>.</p>"},{"location":"docs/reference/dstack.yml/task/#arguments","title":"Arguments","text":"<p>You can parameterize tasks with user arguments using <code>${{ run.args }}</code> in the configuration.</p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py ${{ run.args }}\n</code></pre> <p>Now, you can pass your arguments to the <code>dstack run</code> command:</p> <pre><code>$ dstack run . -f train.dstack.yml --train_batch_size=1 --num_train_epochs=100\n</code></pre>"},{"location":"docs/reference/dstack.yml/task/#web-applications","title":"Web applications","text":"<p>Here's an example of using <code>ports</code> to run web apps with <code>tasks</code>. </p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip3 install streamlit\n  - streamlit hello\n\nports: \n  - 8501\n</code></pre>"},{"location":"docs/reference/dstack.yml/task/#spot-policy","title":"Spot policy","text":"<p>You can choose whether to use spot instances, on-demand instances, or any available type.</p> <pre><code>type: task\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n\nspot_policy: auto\n</code></pre> <p>The <code>spot_policy</code> accepts <code>spot</code>, <code>on-demand</code>, and <code>auto</code>. The default for tasks is <code>auto</code>.</p>"},{"location":"docs/reference/dstack.yml/task/#backends_1","title":"Backends","text":"<p>By default, <code>dstack</code> provisions instances in all configured backends. However, you can specify the list of backends:</p> <pre><code>type: task\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n\nbackends: [aws, gcp]\n</code></pre>"},{"location":"docs/reference/dstack.yml/task/#regions_1","title":"Regions","text":"<p>By default, <code>dstack</code> uses all configured regions. However, you can specify the list of regions:</p> <pre><code>type: task\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n\nregions: [eu-west-1, eu-west-2]\n</code></pre>"},{"location":"docs/reference/dstack.yml/task/#volumes","title":"Volumes","text":"<p>Volumes allow you to persist data between runs. To attach a volume, simply specify its name using the <code>volumes</code> property and specify where to mount its contents:</p> <pre><code>type: task\n\npython: \"3.11\"\n\ncommands:\n  - pip install -r fine-tuning/qlora/requirements.txt\n  - python fine-tuning/qlora/train.py\n\nvolumes:\n  - name: my-new-volume\n    path: /volume_data\n</code></pre> <p>Once you run this configuration, the contents of the volume will be attached to <code>/volume_data</code> inside the task,  and its contents will persist across runs.</p> <p>Limitations</p> <p>When you're running a dev environment, task, or service with <code>dstack</code>, it automatically mounts the project folder contents to <code>/workflow</code> (and sets that as the current working directory). Right now, <code>dstack</code> doesn't allow you to  attach volumes to <code>/workflow</code> or any of its subdirectories.</p> <p>The <code>task</code> configuration type supports many other options. See below.</p>"},{"location":"docs/reference/dstack.yml/task/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/dstack.yml/task/#nodes","title":"<code>nodes</code> - (Optional) Number of nodes. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#name","title":"<code>name</code> - (Optional) The run name.","text":""},{"location":"docs/reference/dstack.yml/task/#image","title":"<code>image</code> - (Optional) The name of the Docker image to run.","text":""},{"location":"docs/reference/dstack.yml/task/#entrypoint","title":"<code>entrypoint</code> - (Optional) The Docker entrypoint.","text":""},{"location":"docs/reference/dstack.yml/task/#working_dir","title":"<code>working_dir</code> - (Optional) The path to the working directory inside the container. It's specified relative to the repository directory (<code>/workflow</code>) and should be inside it. Defaults to <code>\".\"</code> .","text":""},{"location":"docs/reference/dstack.yml/task/#home_dir","title":"<code>home_dir</code> - (Optional) The absolute path to the home directory inside the container. Defaults to <code>/root</code>. Defaults to <code>/root</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#_registry_auth","title":"<code>registry_auth</code> - (Optional) Credentials for pulling a private Docker image.","text":""},{"location":"docs/reference/dstack.yml/task/#python","title":"<code>python</code> - (Optional) The major version of Python. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#nvcc","title":"<code>nvcc</code> - (Optional) Use image with NVIDIA CUDA Compiler (NVCC) included. Mutually exclusive with <code>image</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#env","title":"<code>env</code> - (Optional) The mapping or the list of environment variables.","text":""},{"location":"docs/reference/dstack.yml/task/#setup","title":"<code>setup</code> - (Optional) The bash commands to run on the boot.","text":""},{"location":"docs/reference/dstack.yml/task/#_resources","title":"<code>resources</code> - (Optional) The resources requirements to run the configuration.","text":""},{"location":"docs/reference/dstack.yml/task/#_volumes","title":"<code>volumes</code> - (Optional) The volumes mount points.","text":""},{"location":"docs/reference/dstack.yml/task/#ports","title":"<code>ports</code> - (Optional) Port numbers/mapping to expose.","text":""},{"location":"docs/reference/dstack.yml/task/#commands","title":"<code>commands</code> - (Optional) The bash commands to run.","text":""},{"location":"docs/reference/dstack.yml/task/#backends","title":"<code>backends</code> - (Optional) The backends to consider for provisioning (e.g., <code>[aws, gcp]</code>).","text":""},{"location":"docs/reference/dstack.yml/task/#regions","title":"<code>regions</code> - (Optional) The regions to consider for provisioning (e.g., <code>[eu-west-1, us-west4, westeurope]</code>).","text":""},{"location":"docs/reference/dstack.yml/task/#instance_types","title":"<code>instance_types</code> - (Optional) The cloud-specific instance types to consider for provisioning (e.g., <code>[p3.8xlarge, n1-standard-4]</code>).","text":""},{"location":"docs/reference/dstack.yml/task/#spot_policy","title":"<code>spot_policy</code> - (Optional) The policy for provisioning spot or on-demand instances: <code>spot</code>, <code>on-demand</code>, or <code>auto</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#_retry","title":"<code>retry</code> - (Optional) The policy for resubmitting the run. Defaults to <code>false</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#_retry_policy","title":"<code>retry_policy</code> - (Optional) The policy for resubmitting the run. Deprecated in favor of <code>retry</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#max_duration","title":"<code>max_duration</code> - (Optional) The maximum duration of a run (e.g., <code>2h</code>, <code>1d</code>, etc). After it elapses, the run is forced to stop. Defaults to <code>off</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#max_price","title":"<code>max_price</code> - (Optional) The maximum instance price per hour, in dollars.","text":""},{"location":"docs/reference/dstack.yml/task/#pool_name","title":"<code>pool_name</code> - (Optional) The name of the pool. If not set, dstack will use the default name.","text":""},{"location":"docs/reference/dstack.yml/task/#instance_name","title":"<code>instance_name</code> - (Optional) The name of the instance.","text":""},{"location":"docs/reference/dstack.yml/task/#creation_policy","title":"<code>creation_policy</code> - (Optional) The policy for using instances from the pool. Defaults to <code>reuse-or-create</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#termination_policy","title":"<code>termination_policy</code> - (Optional) The policy for instance termination. Defaults to <code>destroy-after-idle</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#termination_idle_time","title":"<code>termination_idle_time</code> - (Optional) Time to wait before destroying the idle instance. Defaults to <code>5m</code> for <code>dstack run</code> and to <code>3d</code> for <code>dstack pool add</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#resources","title":"<code>resources</code>","text":""},{"location":"docs/reference/dstack.yml/task/#cpu","title":"<code>cpu</code> - (Optional) The number of CPU cores. Defaults to <code>2..</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>8GB</code>). Defaults to <code>8GB..</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#shm_size","title":"<code>shm_size</code> - (Optional) The size of shared memory (e.g., <code>8GB</code>). If you are using parallel communicating processes (e.g., dataloaders in PyTorch), you may need to configure this.","text":""},{"location":"docs/reference/dstack.yml/task/#_gpu","title":"<code>gpu</code> - (Optional) The GPU requirements. Can be set to a number, a string (e.g. <code>A100</code>, <code>80GB:2</code>, etc.), or an object.","text":""},{"location":"docs/reference/dstack.yml/task/#_disk","title":"<code>disk</code> - (Optional) The disk resources.","text":""},{"location":"docs/reference/dstack.yml/task/#resources-gpu","title":"<code>resouces.gpu</code>","text":""},{"location":"docs/reference/dstack.yml/task/#name","title":"<code>name</code> - (Optional) The GPU name or list of names.","text":""},{"location":"docs/reference/dstack.yml/task/#count","title":"<code>count</code> - (Optional) The number of GPUs. Defaults to <code>1</code>.","text":""},{"location":"docs/reference/dstack.yml/task/#memory","title":"<code>memory</code> - (Optional) The RAM size (e.g., <code>16GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/task/#total_memory","title":"<code>total_memory</code> - (Optional) The total RAM size (e.g., <code>32GB</code>). Can be set to a range (e.g. <code>16GB..</code>, or <code>16GB..80GB</code>).","text":""},{"location":"docs/reference/dstack.yml/task/#compute_capability","title":"<code>compute_capability</code> - (Optional) The minimum compute capability of the GPU (e.g., <code>7.5</code>).","text":""},{"location":"docs/reference/dstack.yml/task/#resources-disk","title":"<code>resouces.disk</code>","text":""},{"location":"docs/reference/dstack.yml/task/#size","title":"<code>size</code> -  The disk size. Can be a string (e.g., <code>100GB</code> or <code>100GB..</code>) or an object.","text":""},{"location":"docs/reference/dstack.yml/task/#registry_auth","title":"<code>registry_auth</code>","text":""},{"location":"docs/reference/dstack.yml/task/#username","title":"<code>username</code> -  The username.","text":""},{"location":"docs/reference/dstack.yml/task/#password","title":"<code>password</code> -  The password or access token.","text":""},{"location":"docs/reference/dstack.yml/task/#volumesn","title":"<code>volumes[n]</code>","text":""},{"location":"docs/reference/dstack.yml/task/#name","title":"<code>name</code> -  The name of the volume to mount.","text":""},{"location":"docs/reference/dstack.yml/task/#path","title":"<code>path</code> -  The container path to mount the volume at.","text":""},{"location":"docs/reference/dstack.yml/volume/","title":"volume","text":"<p>The <code>volume</code> configuration type allows creating, registering, and updating volumes.</p> <p>Configuration files must have a name ending with <code>.dstack.yml</code> (e.g., <code>.dstack.yml</code> or <code>vol.dstack.yml</code> are both acceptable) and can be located in the project's root directory or any nested folder. Any configuration can be applied via <code>dstack apply</code>.</p>"},{"location":"docs/reference/dstack.yml/volume/#examples","title":"Examples","text":""},{"location":"docs/reference/dstack.yml/volume/#create-volume","title":"Creating a new volume","text":"<pre><code>type: volume\nname: my-aws-volume\nbackend: aws\nregion: eu-central-1\nsize: 100GB\n</code></pre>"},{"location":"docs/reference/dstack.yml/volume/#register-volume","title":"Registering an existing volume","text":"<pre><code>type: volume\nname: my-external-volume\nbackend: aws\nregion: eu-central-1\nvolume_id: vol1235\n</code></pre>"},{"location":"docs/reference/dstack.yml/volume/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/dstack.yml/volume/#name","title":"<code>name</code> - (Optional) The volume name.","text":""},{"location":"docs/reference/dstack.yml/volume/#backend","title":"<code>backend</code> -  The volume backend.","text":""},{"location":"docs/reference/dstack.yml/volume/#region","title":"<code>region</code> -  The volume region.","text":""},{"location":"docs/reference/dstack.yml/volume/#size","title":"<code>size</code> - (Optional) The volume size. Must be specified when creating new volumes.","text":""},{"location":"docs/reference/dstack.yml/volume/#volume_id","title":"<code>volume_id</code> - (Optional) The volume ID. Must be specified when registering external volumes.","text":""},{"location":"docs/reference/server/config.yml/","title":"~/.dstack/server/config.yml","text":"<p>The <code>~/.dstack/server/config.yml</code> file is used by the <code>dstack</code> server to configure cloud accounts.</p> <p>The <code>dstack</code> server allows you to configure backends for multiple projects. If you don't need multiple projects, use only the <code>main</code> project.</p> <p>Each cloud account must be configured under the <code>backends</code> property of the respective project. See the examples below.</p>"},{"location":"docs/reference/server/config.yml/#examples","title":"Examples","text":""},{"location":"docs/reference/server/config.yml/#aws_1","title":"AWS","text":"<p>There are two ways to configure AWS: using an access key or using the default credentials.</p> Access keyDefault credentials <p>Create an access key by following the this guide . Once you've downloaded the <code>.csv</code> file with your IAM user's Access key ID and Secret access key, proceed to configure the backend.</p> <pre><code>projects:\n- name: main\n  backends:\n    - type: aws\n      creds:\n        type: access_key\n        access_key: KKAAUKLIZ5EHKICAOASV\n        secret_key: pn158lMqSBJiySwpQ9ubwmI6VUU3/W2fdJdFwfgO\n</code></pre> <p>If you have default credentials set up (e.g. in <code>~/.aws/credentials</code>), configure the backend like this:</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: aws\n        creds:\n          type: default\n</code></pre> VPC <p>By default, <code>dstack</code> uses the default VPC. It's possible to customize it:</p> vpc_namevpc_ids <pre><code>projects:\n  - name: main\n    backends:\n      - type: aws\n        creds:\n          type: default\n\n        vpc_name: my-vpc\n</code></pre> <pre><code>projects:\n  - name: main\n    backends:\n      - type: aws\n        creds:\n          type: default\n\n        default_vpcs: true\n        vpc_ids:\n          us-east-1: vpc-0a2b3c4d5e6f7g8h\n          us-east-2: vpc-9i8h7g6f5e4d3c2b\n          us-west-1: vpc-4d3c2b1a0f9e8d7\n</code></pre> <p>For the regions without configured <code>vpc_ids</code>, enable default VPCs by setting <code>default_vpcs</code> to <code>true</code>.</p> Required AWS permissions <p>The following AWS policy permissions are sufficient for <code>dstack</code> to work:</p> <pre><code>{\n    \"Version\": \"2012-10-17\",\n    \"Statement\": [\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"ec2:AttachVolume\",\n                \"ec2:AuthorizeSecurityGroupEgress\",\n                \"ec2:AuthorizeSecurityGroupIngress\",\n                \"ec2:CancelSpotInstanceRequests\",\n                \"ec2:CreateSecurityGroup\",\n                \"ec2:CreateTags\",\n                \"ec2:CreateVolume\",\n                \"ec2:DeleteVolume\",\n                \"ec2:DescribeAvailabilityZones\",\n                \"ec2:DescribeImages\",\n                \"ec2:DescribeInstances\",\n                \"ec2:DescribeInstanceAttribute\",\n                \"ec2:DescribeRouteTables\",\n                \"ec2:DescribeSecurityGroups\",\n                \"ec2:DescribeSubnets\",\n                \"ec2:DescribeVpcs\",\n                \"ec2:DescribeVolumes\",\n                \"ec2:DetachVolume\",\n                \"ec2:RunInstances\",\n                \"ec2:TerminateInstances\"\n            ],\n            \"Resource\": \"*\"\n        },\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"servicequotas:ListServiceQuotas\",\n                \"servicequotas:GetServiceQuota\"\n            ],\n            \"Resource\": \"*\"\n        },\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"elasticloadbalancing:CreateLoadBalancer\",\n                \"elasticloadbalancing:CreateTargetGroup\",\n                \"elasticloadbalancing:CreateListener\",\n                \"elasticloadbalancing:RegisterTargets\",\n                \"elasticloadbalancing:AddTags\",\n                \"elasticloadbalancing:DeleteLoadBalancer\",\n                \"elasticloadbalancing:DeleteTargetGroup\",\n                \"elasticloadbalancing:DeleteListener\",\n                \"elasticloadbalancing:DeregisterTargets\"\n            ],\n            \"Resource\": \"*\"\n        },\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"acm:DescribeCertificate\",\n                \"acm:ListCertificates\"\n            ],\n            \"Resource\": \"*\"\n        }\n    ]\n}\n</code></pre> <p>The <code>elasticloadbalancing:*</code> and <code>acm:*</code> permissions are only needed for provisioning gateways with ACM (AWS Certificate Manager) certificates.</p> Private subnets <p>By default, <code>dstack</code> utilizes public subnets and permits inbound SSH traffic exclusively for any provisioned instances. If you want <code>dstack</code> to use private subnets, set <code>public_ips</code> to <code>false</code>.</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: aws\n        creds:\n          type: default\n\n        public_ips: false\n</code></pre> <p>Using private subnets assumes that both the <code>dstack</code> server and users can access the configured VPC's private subnets  (e.g., through VPC peering).</p>"},{"location":"docs/reference/server/config.yml/#azure_1","title":"Azure","text":"<p>There are two ways to configure Azure: using a client secret or using the default credentials.</p> Client secretDefault credentials <p>A client secret can be created using the Azure CLI :</p> <pre><code>SUBSCRIPTION_ID=...\naz ad sp create-for-rbac\n    --name dstack-app \\\n    --role $DSTACK_ROLE \\\n    --scopes /subscriptions/$SUBSCRIPTION_ID \\\n    --query \"{ tenant_id: tenant, client_id: appId, client_secret: password }\"\n</code></pre> <p>Once you have <code>tenant_id</code>, <code>client_id</code>, and <code>client_secret</code>, go ahead and configure the backend.</p> <pre><code>projects:\n- name: main\n  backends:\n  - type: azure\n    subscription_id: 06c82ce3-28ff-4285-a146-c5e981a9d808\n    tenant_id: f84a7584-88e4-4fd2-8e97-623f0a715ee1\n    creds:\n      type: client\n      client_id: acf3f73a-597b-46b6-98d9-748d75018ed0\n      client_secret: 1Kb8Q~o3Q2hdEvrul9yaj5DJDFkuL3RG7lger2VQ\n</code></pre> <p>Obtain the <code>subscription_id</code> and <code>tenant_id</code> via the Azure CLI :</p> <pre><code>az account show --query \"{subscription_id: id, tenant_id: tenantId}\"\n</code></pre> <p>Then proceed to configure the backend:</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: azure\n        subscription_id: 06c82ce3-28ff-4285-a146-c5e981a9d808\n        tenant_id: f84a7584-88e4-4fd2-8e97-623f0a715ee1\n        creds:\n          type: default\n</code></pre> <p>If you don't know your <code>subscription_id</code>, run</p> <pre><code>az account show --query \"{subscription_id: id}\"\n</code></pre> Required Azure permissions <p>The following Azure permissions are sufficient for <code>dstack</code> to work: <pre><code>{\n    \"properties\": {\n        \"roleName\": \"dstack-role\",\n        \"description\": \"Minimal required permissions for using Azure with dstack\",\n        \"assignableScopes\": [\n            \"/subscriptions/${YOUR_SUBSCRIPTION_ID}\"\n        ],\n        \"permissions\": [\n            {\n            \"actions\": [\n                \"Microsoft.Authorization/*/read\",\n                \"Microsoft.Compute/availabilitySets/*\",\n                \"Microsoft.Compute/locations/*\",\n                \"Microsoft.Compute/virtualMachines/*\",\n                \"Microsoft.Compute/virtualMachineScaleSets/*\",\n                \"Microsoft.Compute/cloudServices/*\",\n                \"Microsoft.Compute/disks/write\",\n                \"Microsoft.Compute/disks/read\",\n                \"Microsoft.Compute/disks/delete\",\n                \"Microsoft.Network/networkSecurityGroups/*\",\n                \"Microsoft.Network/locations/*\",\n                \"Microsoft.Network/virtualNetworks/*\",\n                \"Microsoft.Network/networkInterfaces/*\",\n                \"Microsoft.Network/publicIPAddresses/*\",\n                \"Microsoft.Resources/subscriptions/resourceGroups/read\",\n                \"Microsoft.Resources/subscriptions/resourceGroups/write\",\n                \"Microsoft.Resources/subscriptions/read\"\n            ],\n            \"notActions\": [],\n            \"dataActions\": [],\n            \"notDataActions\": []\n            }\n        ]\n    }\n}\n</code></pre></p>"},{"location":"docs/reference/server/config.yml/#gcp_1","title":"GCP","text":"Enable APIs <p>First, ensure the required APIs are enabled in your GCP <code>project_id</code>.</p> <pre><code>PROJECT_ID=...\ngcloud config set project $PROJECT_ID\ngcloud services enable cloudapis.googleapis.com\ngcloud services enable compute.googleapis.com\n</code></pre> <p>There are two ways to configure GCP: using a service account or using the default credentials.</p> Service accountDefault credentials <p>To create a service account, follow this guide . After setting up the service account create a key  for it and download the corresponding JSON file.</p> <p>Then go ahead and configure the backend by specifying the downloaded file path.</p> <pre><code>projects:\n- name: main\n  backends:\n    - type: gcp\n      project_id: gcp-project-id\n      creds:\n        type: service_account\n        filename: ~/.dstack/server/gcp-024ed630eab5.json\n</code></pre> <p>Enable GCP application default credentials:</p> <pre><code>gcloud auth application-default login \n</code></pre> <p>Then configure the backend like this:</p> <pre><code>projects:\n- name: main\n  backends:\n    - type: gcp\n      project_id: gcp-project-id\n      creds:\n        type: default\n</code></pre> <p>If you don't know your GCP project ID, run</p> <pre><code>gcloud projects list --format=\"json(projectId)\"\n</code></pre> VPCShared VPC <pre><code>projects:\n- name: main\n  backends:\n    - type: gcp\n      project_id: gcp-project-id\n      creds:\n        type: default\n\n      vpc_name: my-custom-vpc\n</code></pre> <pre><code>projects:\n- name: main\n  backends:\n    - type: gcp\n      project_id: gcp-project-id\n      creds:\n        type: default\n\n      vpc_name: my-custom-vpc\n      vpc_project_id: another-project-id\n</code></pre> <p>To use a shared VPC, that VPC has to be configured with two additional firewall rules:</p> <ul> <li>Allow <code>INGRESS</code> traffic on port <code>22</code>, with the target tag <code>dstack-runner-instance</code></li> <li>Allow <code>INGRESS</code> traffic on ports <code>22</code>, <code>80</code>, <code>443</code>, with the target tag <code>dstack-gateway-instance</code></li> </ul> Required GCP permissions <p>The following GCP permissions are sufficient for <code>dstack</code> to work:</p> <pre><code>compute.disks.create\ncompute.firewalls.create\ncompute.images.useReadOnly\ncompute.instances.create\ncompute.instances.delete\ncompute.instances.get\ncompute.instances.setLabels\ncompute.instances.setMetadata\ncompute.instances.setTags\ncompute.networks.get\ncompute.networks.updatePolicy\ncompute.regions.list\ncompute.subnetworks.list\ncompute.subnetworks.use\ncompute.subnetworks.useExternalIp\ncompute.zoneOperations.get\n</code></pre> <p>If you plan to use TPUs, additional permissions are required:</p> <pre><code>tpu.nodes.create\ntpu.nodes.delete\ntpu.nodes.get\ntpu.operations.get\ntpu.operations.list\n</code></pre> <p>Also, the use of TPUs requires the <code>serviceAccountUser</code> role. For TPU VMs, dstack will use the default service account.</p> Private subnets <p>By default, <code>dstack</code> utilizes public subnets and permits inbound SSH traffic exclusively for any provisioned instances. If you want <code>dstack</code> to use private subnets, set <code>public_ips</code> to <code>false</code>.</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: gcp\n        creds:\n          type: default\n\n        public_ips: false\n</code></pre> <p>Using private subnets assumes that both the <code>dstack</code> server and users can access the configured VPC's private subnets (e.g., through VPC peering). Additionally, Cloud NAT must be configured to provide access to external resources for provisioned instances.</p>"},{"location":"docs/reference/server/config.yml/#oci_1","title":"OCI","text":"<p>There are two ways to configure OCI: using client credentials or using the default credentials.</p> Client credentialsDefault credentials <p>Log into the OCI Console , go to <code>My profile</code>,  select <code>API keys</code>, and click <code>Add API key</code>.</p> <p>Once you add a key, you'll see the configuration file. Copy its values to configure the backend as follows:</p> <pre><code>projects:\n- name: main\n  backends:\n  - type: oci\n    creds:\n      type: client\n      user: ocid1.user.oc1..g5vlaeqfu47akmaafq665xsgmyaqjktyfxtacfxc4ftjxuca7aohnd2ev66m\n      tenancy: ocid1.tenancy.oc1..ajqsftvk4qarcfaak3ha4ycdsaahxmaita5frdwg3tqo2bcokpd3n7oizwai\n      region: eu-frankfurt-1\n      fingerprint: 77:32:77:00:49:7c:cb:56:84:75:8e:77:96:7d:53:17\n      key_file: ~/.oci/private_key.pem\n</code></pre> <p>Make sure to include either the path to your private key via <code>key_file</code> or the contents of the key via <code>key_content</code>.</p> <p>If you have default credentials set up in <code>~/.oci/config</code>, configure the backend like this:</p> <pre><code>projects:\n- name: main\n  backends:\n  - type: oci\n    creds:\n      type: default\n</code></pre> Required OCI permissions <p>This is an example of a restrictive policy for a group of <code>dstack</code> users:</p> <pre><code>Allow group &lt;dstack-users&gt; to read compartments in tenancy where target.compartment.name = '&lt;dstack-compartment&gt;'\nAllow group &lt;dstack-users&gt; to read marketplace-community-listings in compartment &lt;dstack-compartment&gt;\nAllow group &lt;dstack-users&gt; to manage app-catalog-listing in compartment &lt;dstack-compartment&gt;\nAllow group &lt;dstack-users&gt; to manage instances in compartment &lt;dstack-compartment&gt;\nAllow group &lt;dstack-users&gt; to manage compute-capacity-reports in compartment &lt;dstack-compartment&gt;\nAllow group &lt;dstack-users&gt; to manage volumes in compartment &lt;dstack-compartment&gt;\nAllow group &lt;dstack-users&gt; to manage volume-attachments in compartment &lt;dstack-compartment&gt;\nAllow group &lt;dstack-users&gt; to manage virtual-network-family in compartment &lt;dstack-compartment&gt;\n</code></pre> <p>To use this policy, create a compartment for <code>dstack</code> and specify it in <code>~/.dstack/server/config.yml</code>.</p> <pre><code>projects:\n- name: main\n  backends:\n  - type: oci\n    creds:\n      type: default\n    compartment_id: ocid1.compartment.oc1..aaaaaaaa\n</code></pre>"},{"location":"docs/reference/server/config.yml/#lambda_1","title":"Lambda","text":"<p>Log into your Lambda Cloud  account, click API keys in the sidebar, and then click the <code>Generate API key</code> button to create a new API key.</p> <p>Then, go ahead and configure the backend:</p> <pre><code>projects:\n- name: main\n  backends:\n    - type: lambda\n      creds:\n        type: api_key\n        api_key: eersct_yrpiey-naaeedst-tk-_cb6ba38e1128464aea9bcc619e4ba2a5.iijPMi07obgt6TZ87v5qAEj61RVxhd0p\n</code></pre>"},{"location":"docs/reference/server/config.yml/#tensordock_1","title":"TensorDock","text":"<p>Log into your TensorDock  account, click API in the sidebar, and use the <code>Create an Authorization</code> section to create a new authorization key.</p> <p>Then, go ahead and configure the backend:</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: tensordock\n        creds:\n          type: api_key\n          api_key: 248e621d-9317-7494-dc1557fa5825b-98b\n          api_token: FyBI3YbnFEYXdth2xqYRnQI7hiusssBC\n</code></pre> <p>The <code>tensordock</code> backend supports on-demand instances only. Spot instance support coming soon.</p>"},{"location":"docs/reference/server/config.yml/#vastai_1","title":"Vast.ai","text":"<p>Log into your Vast.ai  account, click Account in the sidebar, and copy your API Key.</p> <p>Then, go ahead and configure the backend:</p> <pre><code>projects:\n- name: main\n  backends:\n    - type: vastai\n      creds:\n        type: api_key\n        api_key: d75789f22f1908e0527c78a283b523dd73051c8c7d05456516fc91e9d4efd8c5\n</code></pre> <p>Also, the <code>vastai</code> backend supports on-demand instances only. Spot instance support coming soon.</p>"},{"location":"docs/reference/server/config.yml/#runpod","title":"RunPod","text":"<p>Log into your RunPod  console, click Settings in the sidebar, expand the <code>API Keys</code> section, and click the button to create a key.</p> <p>Then proceed to configuring the backend.</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: runpod\n        creds:\n          type: api_key\n          api_key: US9XTPDIV8AR42MMINY8TCKRB8S4E7LNRQ6CAUQ9\n</code></pre>"},{"location":"docs/reference/server/config.yml/#cudo_1","title":"CUDO","text":"<p>Log into your CUDO Compute  account, click API keys in the sidebar, and click the <code>Create an API key</code> button.</p> <p>Ensure you've created a project with CUDO Compute, then proceed to configuring the backend.</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: cudo\n        project_id: my-cudo-project\n        creds:\n          type: api_key\n          api_key: 7487240a466624b48de22865589\n</code></pre>"},{"location":"docs/reference/server/config.yml/#datacrunch_1","title":"DataCrunch","text":"<p>Log into your DataCrunch  account, click Account Settings in the sidebar, find <code>REST API Credentials</code> area and then click the <code>Generate Credentials</code> button.</p> <p>Then, go ahead and configure the backend:</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: datacrunch\n        creds:\n          type: api_key\n          client_id: xfaHBqYEsArqhKWX-e52x3HH7w8T\n          client_secret: B5ZU5Qx9Nt8oGMlmMhNI3iglK8bjMhagTbylZy4WzncZe39995f7Vxh8\n</code></pre>"},{"location":"docs/reference/server/config.yml/#kubernetes_1","title":"Kubernetes","text":"<p><code>dstack</code> supports both self-managed, and managed Kubernetes clusters.</p> Prerequisite <p>To use GPUs with Kubernetes, the cluster must be installed with the NVIDIA GPU Operator .</p> <p>To configure a Kubernetes backend, specify the path to the kubeconfig file, and the port that <code>dstack</code> can use for proxying SSH traffic. In case of a self-managed cluster, also specify the IP address of any node in the cluster.</p> Self-managedManaged <p>Here's how to configure the backend to use a self-managed cluster.</p> <pre><code>projects:\n- name: main\n  backends:\n    - type: kubernetes\n      kubeconfig:\n        filename: ~/.kube/config\n      networking:\n        ssh_host: localhost # The external IP address of any node\n        ssh_port: 32000 # Any port accessible outside of the cluster\n</code></pre> <p>The port specified to <code>ssh_port</code> must be accessible outside of the cluster.</p> Kind <p>If you are using Kind, make sure to make  to set up <code>ssh_port</code> via <code>extraPortMappings</code> for proxying SSH traffic:</p> <pre><code>kind: Cluster\napiVersion: kind.x-k8s.io/v1alpha4\nnodes:\n  - role: control-plane\n    extraPortMappings:\n      - containerPort: 32000 # Must be same as `ssh_port`\n        hostPort: 32000 # Must be same as `ssh_port`\n</code></pre> <p>Go ahead and create the cluster like this: </p> <pre><code>kind create cluster --config examples/misc/kubernetes/kind-config.yml\n</code></pre> <p>Here's how to configure the backend to use a managed cluster (AWS, GCP, Azure).</p> <pre><code>projects:\n  - name: main\n    backends:\n      - type: kubernetes\n        kubeconfig:\n          filename: ~/.kube/config\n        networking:\n          ssh_port: 32000 # Any port accessible outside of the cluster\n</code></pre> <p>The port specified to <code>ssh_port</code> must be accessible outside of the cluster.</p> EKS <p>For example, if you are using EKS, make sure to add it via an ingress rule of the corresponding security group:</p> <pre><code>aws ec2 authorize-security-group-ingress --group-id &lt;cluster-security-group-id&gt; --protocol tcp --port 32000 --cidr 0.0.0.0/0\n</code></pre>"},{"location":"docs/reference/server/config.yml/#root-reference","title":"Root reference","text":""},{"location":"docs/reference/server/config.yml/#_projects","title":"<code>projects</code> -  The list of projects.","text":""},{"location":"docs/reference/server/config.yml/#projects","title":"<code>projects[n]</code>","text":""},{"location":"docs/reference/server/config.yml/#name","title":"<code>name</code> -  The name of the project.","text":""},{"location":"docs/reference/server/config.yml/#backends","title":"<code>backends</code> -  The list of backends.","text":""},{"location":"docs/reference/server/config.yml/#aws","title":"<code>projects[n].backends[type=aws]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of the backend. Must be <code>aws</code>.","text":""},{"location":"docs/reference/server/config.yml/#regions","title":"<code>regions</code> - (Optional) The list of AWS regions.","text":""},{"location":"docs/reference/server/config.yml/#vpc_name","title":"<code>vpc_name</code> - (Optional) The VPC name. All configured regions must have a VPC with this name.","text":""},{"location":"docs/reference/server/config.yml/#vpc_ids","title":"<code>vpc_ids</code> - (Optional) The mapping from AWS regions to VPC IDs. If <code>default_vpcs: true</code>, omitted regions will use default VPCs.","text":""},{"location":"docs/reference/server/config.yml/#default_vpcs","title":"<code>default_vpcs</code> - (Optional) A flag to enable/disable using default VPCs in regions not configured by <code>vpc_ids</code>. Set to <code>false</code> if default VPCs should never be used. Defaults to <code>true</code>.","text":""},{"location":"docs/reference/server/config.yml/#public_ips","title":"<code>public_ips</code> - (Optional) A flag to enable/disable public IP assigning on instances. Defaults to <code>true</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#aws-creds","title":"<code>projects[n].backends[type=aws].creds</code>","text":"Access keyDefault"},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>access_key</code>.","text":""},{"location":"docs/reference/server/config.yml/#access_key","title":"<code>access_key</code> -  The access key.","text":""},{"location":"docs/reference/server/config.yml/#secret_key","title":"<code>secret_key</code> -  The secret key.","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>default</code>.","text":""},{"location":"docs/reference/server/config.yml/#azure","title":"<code>projects[n].backends[type=azure]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of the backend. Must be <code>azure</code>.","text":""},{"location":"docs/reference/server/config.yml/#tenant_id","title":"<code>tenant_id</code> -  The tenant ID.","text":""},{"location":"docs/reference/server/config.yml/#subscription_id","title":"<code>subscription_id</code> -  The subscription ID.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#azure-creds","title":"<code>projects[n].backends[type=azure].creds</code>","text":"ClientDefault"},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>client</code>.","text":""},{"location":"docs/reference/server/config.yml/#client_id","title":"<code>client_id</code> -  The client ID.","text":""},{"location":"docs/reference/server/config.yml/#client_secret","title":"<code>client_secret</code> -  The client secret.","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>default</code>.","text":""},{"location":"docs/reference/server/config.yml/#datacrunch","title":"<code>projects[n].backends[type=datacrunch]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>datacrunch</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#datacrunch-creds","title":"<code>projects[n].backends[type=datacrunch].creds</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>api_key</code>.","text":""},{"location":"docs/reference/server/config.yml/#client_id","title":"<code>client_id</code> -  The client ID.","text":""},{"location":"docs/reference/server/config.yml/#client_secret","title":"<code>client_secret</code> -  The client secret.","text":""},{"location":"docs/reference/server/config.yml/#gcp","title":"<code>projects[n].backends[type=gcp]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>gcp</code>.","text":""},{"location":"docs/reference/server/config.yml/#project_id","title":"<code>project_id</code> -  The project ID.","text":""},{"location":"docs/reference/server/config.yml/#vpc_name","title":"<code>vpc_name</code> - (Optional) The VPC name.","text":""},{"location":"docs/reference/server/config.yml/#vpc_project_id","title":"<code>vpc_project_id</code> - (Optional) The shared VPC hosted project ID. Required for shared VPC only.","text":""},{"location":"docs/reference/server/config.yml/#public_ips","title":"<code>public_ips</code> - (Optional) A flag to enable/disable public IP assigning on instances. Defaults to <code>true</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#gcp-creds","title":"<code>projects[n].backends[type=gcp].creds</code>","text":"Service accountDefault"},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>service_account</code>.","text":""},{"location":"docs/reference/server/config.yml/#filename","title":"<code>filename</code> -  The path to the service account file.","text":""},{"location":"docs/reference/server/config.yml/#data","title":"<code>data</code> - (Optional) The contents of the service account file.","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>default</code>.","text":""},{"location":"docs/reference/server/config.yml/#lambda","title":"<code>projects[n].backends[type=lambda]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>lambda</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#lambda-creds","title":"<code>projects[n].backends[type=lambda].creds</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>api_key</code>.","text":""},{"location":"docs/reference/server/config.yml/#api_key","title":"<code>api_key</code> -  The API key.","text":""},{"location":"docs/reference/server/config.yml/#oci","title":"<code>projects[n].backends[type=oci]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>oci</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#regions","title":"<code>regions</code> - (Optional) List of region names for running <code>dstack</code> jobs. Omit to use all regions.","text":""},{"location":"docs/reference/server/config.yml/#compartment_id","title":"<code>compartment_id</code> - (Optional) Compartment where <code>dstack</code> will create all resources. Omit to instruct <code>dstack</code> to create a new compartment.","text":""},{"location":"docs/reference/server/config.yml/#oci-creds","title":"<code>projects[n].backends[type=oci].creds</code>","text":"ClientDefault"},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>client</code>.","text":""},{"location":"docs/reference/server/config.yml/#user","title":"<code>user</code> -  User OCID.","text":""},{"location":"docs/reference/server/config.yml/#tenancy","title":"<code>tenancy</code> -  Tenancy OCID.","text":""},{"location":"docs/reference/server/config.yml/#key_file","title":"<code>key_file</code> - (Optional) Path to the user's private PEM key. Either this or <code>key_content</code> should be set.","text":""},{"location":"docs/reference/server/config.yml/#key_content","title":"<code>key_content</code> - (Optional) Content of the user's private PEM key. Either this or <code>key_file</code> should be set.","text":""},{"location":"docs/reference/server/config.yml/#pass_phrase","title":"<code>pass_phrase</code> - (Optional) Passphrase for the private PEM key if it is encrypted.","text":""},{"location":"docs/reference/server/config.yml/#fingerprint","title":"<code>fingerprint</code> -  User's public key fingerprint.","text":""},{"location":"docs/reference/server/config.yml/#region","title":"<code>region</code> -  Name or key of any region the tenancy is subscribed to.","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>default</code>.","text":""},{"location":"docs/reference/server/config.yml/#file","title":"<code>file</code> - (Optional) Path to the OCI CLI-compatible config file. Defaults to <code>~/.oci/config</code>.","text":""},{"location":"docs/reference/server/config.yml/#profile","title":"<code>profile</code> - (Optional) Profile to load from the config file. Defaults to <code>DEFAULT</code>.","text":""},{"location":"docs/reference/server/config.yml/#tensordock","title":"<code>projects[n].backends[type=tensordock]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>tensordock</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#tensordock-creds","title":"<code>projects[n].backends[type=tensordock].creds</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>api_key</code>.","text":""},{"location":"docs/reference/server/config.yml/#api_key","title":"<code>api_key</code> -  The API key.","text":""},{"location":"docs/reference/server/config.yml/#api_token","title":"<code>api_token</code> -  The API token.","text":""},{"location":"docs/reference/server/config.yml/#vastai","title":"<code>projects[n].backends[type=vastai]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>vastai</code>.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#vastai-creds","title":"<code>projects[n].backends[type=vastai].creds</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>api_key</code>.","text":""},{"location":"docs/reference/server/config.yml/#api_key","title":"<code>api_key</code> -  The API key.","text":""},{"location":"docs/reference/server/config.yml/#cudo","title":"<code>projects[n].backends[type=cudo]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>cudo</code>.","text":""},{"location":"docs/reference/server/config.yml/#project_id","title":"<code>project_id</code> -  The project ID.","text":""},{"location":"docs/reference/server/config.yml/#_creds","title":"<code>creds</code> -  The credentials.","text":""},{"location":"docs/reference/server/config.yml/#cudo-creds","title":"<code>projects[n].backends[type=cudo].creds</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of credentials. Must be <code>api_key</code>.","text":""},{"location":"docs/reference/server/config.yml/#api_key","title":"<code>api_key</code> -  The API key.","text":""},{"location":"docs/reference/server/config.yml/#kubernetes","title":"<code>projects[n].backends[type=kubernetes]</code>","text":""},{"location":"docs/reference/server/config.yml/#type","title":"<code>type</code> -  The type of backend. Must be <code>kubernetes</code>.","text":""},{"location":"docs/reference/server/config.yml/#_kubeconfig","title":"<code>kubeconfig</code> -  The kubeconfig configuration.","text":""},{"location":"docs/reference/server/config.yml/#_networking","title":"<code>networking</code> - (Optional) The networking configuration.","text":""},{"location":"docs/reference/server/config.yml/#kubeconfig","title":"<code>projects[n].backends[type=kubernetes].kubeconfig</code>","text":""},{"location":"docs/reference/server/config.yml/#filename","title":"<code>filename</code> -  The path to the kubeconfig file.","text":""},{"location":"docs/reference/server/config.yml/#data","title":"<code>data</code> - (Optional) The contents of the kubeconfig file.","text":""},{"location":"docs/reference/server/config.yml/#networking","title":"<code>projects[n].backends[type=kubernetes].networking</code>","text":""},{"location":"docs/reference/server/config.yml/#ssh_host","title":"<code>ssh_host</code> - (Optional) The external IP address of any node.","text":""},{"location":"docs/reference/server/config.yml/#ssh_port","title":"<code>ssh_port</code> - (Optional) Any port accessible outside of the cluster.","text":""},{"location":"blog/archive/2024/","title":"2024","text":""}]}
\ No newline at end of file
diff --git a/sitemap.xml b/sitemap.xml
index 745b4a51..cf053f7e 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2,317 +2,317 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>https://dstack.ai/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/pricing/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/privacy/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/terms/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/infinity/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/infinity/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/lorax/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/lorax/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/ollama/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/ollama/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/tei/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/tei/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/tgi/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/tgi/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/deployment/vllm/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/deployment/vllm/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/alignment-handbook/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/alignment-handbook/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/axolotl/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/axolotl/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/fine-tuning/qlora/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/fine-tuning/qlora/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/llms/chat-ui/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/llms/chat-ui/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/llms/llama3/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/llms/llama3/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/llms/mixtral/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/llms/mixtral/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/misc/http.server/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/misc/http.server/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
-         <loc>https://dstack.ai/tmp/mkdocs_gen_files_mi6dnvvi/docs/examples/misc/streamlit/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <loc>https://dstack.ai/tmp/mkdocs_gen_files_k763lh9v/docs/examples/misc/streamlit/</loc>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/blog/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/blog/archive/say-goodbye-to-managed-notebooks/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/blog/dstack-sky-own-cloud-accounts/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/blog/dstack-sky/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/changelog/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/dev-environments/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/fleets/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/quickstart/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/services/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/tasks/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/concepts/gateways/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/concepts/pools/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/concepts/volumes/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/deployment/infinity/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/deployment/lorax/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/deployment/ollama/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/deployment/tei/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/deployment/tgi/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/deployment/vllm/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/fine-tuning/alignment-handbook/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/fine-tuning/axolotl/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/fine-tuning/qlora/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/llms/chat-ui/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/llms/llama3/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/llms/mixtral/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/misc/http.server/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/examples/misc/streamlit/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/guides/protips/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/installation/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/reference/dstack.yml/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/reference/profiles.yml/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/reference/api/python/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/reference/api/rest/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/reference/cli/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/reference/dstack.yml/dev-environment/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/reference/dstack.yml/fleet/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/reference/dstack.yml/gateway/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/reference/dstack.yml/service/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/reference/dstack.yml/task/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/reference/dstack.yml/volume/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/docs/reference/server/config.yml/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://dstack.ai/blog/archive/2024/</loc>
-         <lastmod>2024-07-31</lastmod>
+         <lastmod>2024-08-02</lastmod>
          <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index aae46e69..8a29fe9c 100644
Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ
diff --git a/terms/index.html b/terms/index.html
index e563d76e..13c2d367 100644
--- a/terms/index.html
+++ b/terms/index.html
@@ -21,7 +21,7 @@
       
       
       <link rel="icon" href="../assets/images/dstack-fav-32.ico">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.30+insiders-4.53.11">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.31+insiders-4.53.12">
     
     
       
@@ -29,7 +29,7 @@
       
     
     
-      <link rel="stylesheet" href="../assets/stylesheets/main.0e8c34cb.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.dad623df.min.css">
       
         
         <link rel="stylesheet" href="../assets/stylesheets/palette.ab4e12ef.min.css">
@@ -1750,6 +1750,33 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../docs/examples/fine-tuning/axolotl/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    
+  
+    Axolotl
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -2954,7 +2981,7 @@ <h2 id="27-contact-us">27. Contact us<a class="headerlink" href="#27-contact-us"
 <script src="/assets/javascripts/termynal.js" data-termynal-container="#termynal"></script>
 <script async src="https://tally.so/widgets/embed.js"></script>
 
-      <script src="../assets/javascripts/bundle.d249fdc4.min.js"></script>
+      <script src="../assets/javascripts/bundle.ef37796b.min.js"></script>
       
         <script src="../assets/javascripts/extra.js"></script>