[{"data":1,"prerenderedAt":529},["ShallowReactive",2],{"page-\u002Fcli\u002Fexec":3,"surround-\u002Fcli\u002Fexec":520},{"id":4,"title":5,"body":6,"description":512,"extension":513,"meta":514,"navigation":515,"path":516,"seo":517,"stem":518,"__hash__":519},"docs\u002Fcli\u002Fexec.md","exec",{"type":7,"value":8,"toc":508},"minimark",[9,22,61,175,178,183,432,439,443,495,504],[10,11,12,15,16,21],"p",{},[13,14,5],"code",{}," submits a ",[17,18,20],"a",{"href":19},"\u002Frun-jobs","Run Job",", streams its output while it runs, and exits with the command's exit code.",[23,24,29],"pre",{"className":25,"code":26,"language":27,"meta":28,"style":28},"language-bash shiki shiki-themes github-dark-default","featherless-cloud exec [options] -- \u003Ccommand> [args...]\n","bash","",[13,30,31],{"__ignoreMap":28},[32,33,36,40,44,48,52,55,58],"span",{"class":34,"line":35},"line",1,[32,37,39],{"class":38},"sQhOw","featherless-cloud",[32,41,43],{"class":42},"s9uIt"," exec",[32,45,47],{"class":46},"sZEs4"," [options] -- ",[32,49,51],{"class":50},"suJrU","\u003C",[32,53,54],{"class":46},"command",[32,56,57],{"class":50},">",[32,59,60],{"class":46}," [args...]\n",[23,62,64],{"className":25,"code":63,"language":27,"meta":28,"style":28},"featherless-cloud exec --gpu-count 1 -- python -c \"import torch; print(torch.cuda.is_available())\"\nfeatherless-cloud exec --cpu-cores 32 --volume data:\u002Fworkspace -- .\u002Fpreprocess.sh\nfeatherless-cloud exec --template trainer --gpu-count 8 -- python train.py --epochs 10\nfeatherless-cloud exec --detach --name nightly --timeout 7200 -- python eval.py\n",[13,65,66,91,115,146],{"__ignoreMap":28},[32,67,68,70,72,76,79,82,85,88],{"class":34,"line":35},[32,69,39],{"class":38},[32,71,43],{"class":42},[32,73,75],{"class":74},"sFSAA"," --gpu-count",[32,77,78],{"class":74}," 1",[32,80,81],{"class":74}," --",[32,83,84],{"class":42}," python",[32,86,87],{"class":74}," -c",[32,89,90],{"class":42}," \"import torch; print(torch.cuda.is_available())\"\n",[32,92,94,96,98,101,104,107,110,112],{"class":34,"line":93},2,[32,95,39],{"class":38},[32,97,43],{"class":42},[32,99,100],{"class":74}," --cpu-cores",[32,102,103],{"class":74}," 32",[32,105,106],{"class":74}," --volume",[32,108,109],{"class":42}," data:\u002Fworkspace",[32,111,81],{"class":74},[32,113,114],{"class":42}," .\u002Fpreprocess.sh\n",[32,116,118,120,122,125,128,130,133,135,137,140,143],{"class":34,"line":117},3,[32,119,39],{"class":38},[32,121,43],{"class":42},[32,123,124],{"class":74}," --template",[32,126,127],{"class":42}," trainer",[32,129,75],{"class":74},[32,131,132],{"class":74}," 8",[32,134,81],{"class":74},[32,136,84],{"class":42},[32,138,139],{"class":42}," train.py",[32,141,142],{"class":74}," --epochs",[32,144,145],{"class":74}," 10\n",[32,147,149,151,153,156,159,162,165,168,170,172],{"class":34,"line":148},4,[32,150,39],{"class":38},[32,152,43],{"class":42},[32,154,155],{"class":74}," --detach",[32,157,158],{"class":74}," --name",[32,160,161],{"class":42}," nightly",[32,163,164],{"class":74}," --timeout",[32,166,167],{"class":74}," 7200",[32,169,81],{"class":74},[32,171,84],{"class":42},[32,173,174],{"class":42}," eval.py\n",[10,176,177],{},"Your local files aren't uploaded. The command and its files must be in the image or on a mounted volume.",[179,180,182],"h2",{"id":181},"options","Options",[184,185,186,199],"table",{},[187,188,189],"thead",{},[190,191,192,196],"tr",{},[193,194,195],"th",{},"Option",[193,197,198],{},"Description",[200,201,202,213,231,241,251,261,271,281,291,301,311,321,335,345,359,369,379,392,402,412,422],"tbody",{},[190,203,204,210],{},[205,206,207],"td",{},[13,208,209],{},"--name \u003Cname>",[205,211,212],{},"Run Job name. Random when omitted.",[190,214,215,220],{},[205,216,217],{},[13,218,219],{},"--template \u003Cname>",[205,221,222,223,226,227,230],{},"Template: a name, ",[13,224,225],{},"org\u002F\u003Cname>",", ",[13,228,229],{},"featherless\u002F\u003Cname>"," or an ID. The default PyTorch environment when omitted.",[190,232,233,238],{},[205,234,235],{},[13,236,237],{},"--template-id \u003Cid>",[205,239,240],{},"Template, by ID.",[190,242,243,248],{},[205,244,245],{},[13,246,247],{},"--template-version \u003Cversion>",[205,249,250],{},"Version of an official template. Newest by default.",[190,252,253,258],{},[205,254,255],{},[13,256,257],{},"--image \u003Creference>",[205,259,260],{},"Container image to run, or to replace the template's.",[190,262,263,268],{},[205,264,265],{},[13,266,267],{},"--registry \u003Cname|id>",[205,269,270],{},"Registry credential for a private image.",[190,272,273,278],{},[205,274,275],{},[13,276,277],{},"--gpu-type \u003Ctext>",[205,279,280],{},"GPU model, matched on part of its name.",[190,282,283,288],{},[205,284,285],{},[13,286,287],{},"--gpu-count \u003Cn>",[205,289,290],{},"GPUs: 1, 2, 4 or 8.",[190,292,293,298],{},[205,294,295],{},[13,296,297],{},"--cpu-cores \u003Cn>",[205,299,300],{},"vCPUs. Can't be combined with GPU options.",[190,302,303,308],{},[205,304,305],{},[13,306,307],{},"--disk \u003Cgb>",[205,309,310],{},"Container disk, 20–2,000. Default 20.",[190,312,313,318],{},[205,314,315],{},[13,316,317],{},"--volume \u003Cname>:\u003Cpath>",[205,319,320],{},"Mount a network volume. Repeatable.",[190,322,323,328],{},[205,324,325],{},[13,326,327],{},"--workdir \u003Cpath>",[205,329,330,331,334],{},"Working directory. Default ",[13,332,333],{},"\u002Fworkspace",".",[190,336,337,342],{},[205,338,339],{},[13,340,341],{},"--env \u003CK=V>",[205,343,344],{},"Environment variable. Repeatable.",[190,346,347,352],{},[205,348,349],{},[13,350,351],{},"--secret \u003CK=V>",[205,353,354,355,358],{},"Secret variable, available as a file under ",[13,356,357],{},"$FEATHERLESS_SECRETS_PATH",". Repeatable.",[190,360,361,366],{},[205,362,363],{},[13,364,365],{},"--timeout \u003Cseconds>",[205,367,368],{},"Time limit once compute is assigned, 1–86,400. Default 86,400 (24 hours).",[190,370,371,376],{},[205,372,373],{},[13,374,375],{},"--preemption-retries \u003Cn>",[205,377,378],{},"Times to start again from the beginning if interrupted, 0–3. Default 0.",[190,380,381,386],{},[205,382,383],{},[13,384,385],{},"--no-retain-logs",[205,387,388,389,391],{},"Don't collect output, including the live output ",[13,390,5],{}," prints.",[190,393,394,399],{},[205,395,396],{},[13,397,398],{},"--idempotency-key \u003Ckey>",[205,400,401],{},"Reuse the first Run Job when the same command is retried with the same key.",[190,403,404,409],{},[205,405,406],{},[13,407,408],{},"--detach",[205,410,411],{},"Submit and return without waiting.",[190,413,414,419],{},[205,415,416],{},[13,417,418],{},"--cancel-on-interrupt",[205,420,421],{},"Cancel the job on Ctrl-C, instead of detaching.",[190,423,424,429],{},[205,425,426],{},[13,427,428],{},"--profile \u003Cname>",[205,430,431],{},"Profile to use.",[10,433,434,435,438],{},"With a template that has a start command, the command after ",[13,436,437],{},"--"," is optional.",[179,440,442],{"id":441},"exit-codes","Exit codes",[184,444,445,455],{},[187,446,447],{},[190,448,449,452],{},[193,450,451],{},"Code",[193,453,454],{},"Meaning",[200,456,457,465,475,485],{},[190,458,459,462],{},[205,460,461],{},"The command's own",[205,463,464],{},"The job finished.",[190,466,467,472],{},[205,468,469],{},[13,470,471],{},"124",[205,473,474],{},"The job reached its time limit.",[190,476,477,482],{},[205,478,479],{},[13,480,481],{},"130",[205,483,484],{},"The job was cancelled, or you detached.",[190,486,487,492],{},[205,488,489],{},[13,490,491],{},"1",[205,493,494],{},"The job failed to start, or another error.",[10,496,497,500,501,503],{},[13,498,499],{},"--json"," is available with ",[13,502,408],{}," only.",[505,506,507],"style",{},"html pre.shiki code .sQhOw, html code.shiki .sQhOw{--shiki-default:#FFA657}html pre.shiki code .s9uIt, html code.shiki .s9uIt{--shiki-default:#A5D6FF}html pre.shiki code .sZEs4, html code.shiki .sZEs4{--shiki-default:#E6EDF3}html pre.shiki code .suJrU, html code.shiki .suJrU{--shiki-default:#FF7B72}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .sFSAA, html code.shiki .sFSAA{--shiki-default:#79C0FF}",{"title":28,"searchDepth":93,"depth":93,"links":509},[510,511],{"id":181,"depth":93,"text":182},{"id":441,"depth":93,"text":442},"Run a script on a remote GPU from your terminal, as if it ran locally.","md",{},true,"\u002Fcli\u002Fexec",{"title":5,"description":512},"cli\u002Fexec","eRApVE4fzciqCyfCx2fWqzzHKHGQd7xVoTZ3ko-uNRk",[521,525],{"title":522,"path":523,"description":524},"instance","\u002Fcli\u002Finstance","Deploy, control and connect to instances from your terminal.",{"title":526,"path":527,"description":528},"runjob","\u002Fcli\u002Frunjob","Keep track of the Run Jobs you've submitted.",1794932602201]