+ j $Rt^RIt^RIt^RIt^RIt^RIt^RIt^RIHtH t H t H t ^RI H t ^RIHtHt^RIHt^RIHt^RIHtHt^RIHtHtHt^R IHt^R IHtH t H!t!H"t"H#t#H$t$^R I%H&t&H't'H(t(H)t)^R I*H+t+^R I,H-t-^RI.H/t/^RI0H1t1^RI2H3t3H4t4^RI5H6t6H7t7H8t8H9t9H:t:H;t;Ht>H?t?H@t@HAtAHBtBHCtC^RIDHEtEHFtF^RIGHHtHHItI^RIJHKtKHLtLHMtM]-P!]O4tPRRltQRRltR]!RR44tS] RRl4tTRR/RR lltUR!R"ltVR#RR$RR%R/R&R'lltWR(tXR)RRR/R*R+lltYR,R-ltZR.t[]]\]E!R/R073,t]]]\R,]F!R1R073,t^]]\R,]F!R2]:!] 4R373,t_]]`]\,R,]F!R4R5R6R073,ta]]\R,]F!R7R8R073,tb]]\R,]F!R9R073,tc]]d]F!R:R;RR073,tf]]\R,]F!R?R073,tg]]\R,]F!R@RAR073,th]]`]i,R,]F!RBRCR073,tj]]d]F!RDRER073,tk]]\R,]F!RFRGR073,tl]]`]\,R,]F!RHRIR073,tm]]`]\,R,]F!RJRKR073,tn]]\R,]F!RLRMRNR073,to]]dR,]F!ROR073,tp]]dR,]F!RPR073,tq]]\]E!RQR073,tr]]\]E!RRR073,ts]]`]\,R,]E!RSR073,tt]]`]\,]E!RTR073,tu]]\]E!RUR073,tv]]`]\,R,]E!RVR073,tw]]\]E!RWR073,tx]]`]\,R,]F!RXRYRZR073,ty]C!R[R07tzR\R]lt{]zPR^R_R`/.RORa7RRbRcll4t}]zPRd.RORe7RRfRgll4t~RhRiltRjRklt]zPRlRm.Re7RRnRoll4t]zPRp.RORe7RRqRrll4t]zPRsRt.Re7RuRvl4t]zPRwRx.Re7RRyRzll4t]zPR{R|.Re7RR}R~ll4t]zPR.RORe7RRRll4t]zPR.RORe7RRRll4t]zPR.RORe7RRRll4t]C!RR07t]zEP]RR7]PR^R_R`/.RORa7RRRll4t!RR]\]4t]C!RR07t]zEP]RR7]PR^R_R`/R.Ra7RRRll4t]PRp.RORe7RRRll4t]PRwR.Re7RRRll4t]PRR.Re7RRRll4t]PRR.Re7RRRll4t]PRR.Re7RRRll4t]PRR.Re7RRRll4t]PR.RORe7RRRll4t]C!RR07t]EP]RR7]PR^R_R`/RR.Ra7RRRll4tRRltRRRlltRR/RRlltRRlt]!R4tRRltRRltR#)z@Contains commands to interact with jobs on the Hugging Face Hub.N)Callable Collection GeneratorIterable)contextmanager) dataclassfield)Enum)Path)EmptyQueue) AnnotatedAnyTypeVar)urlsplit)HfApi JobHardwareJobInfoJobStageVolume constants)DEFAULT_UV_IMAGETERMINAL_JOB_STAGES_default_job_name_from_image_default_job_name_from_script)CLIError)logging) _format_size _split_mount)format_durationparse_duration) EnvFileOptEnvOptSecretsFileOpt SecretsOpt SoftChoice SshDryRunOptSshIdentityFileOptTokenOpt_get_extended_environexec_ssh get_hf_api parse_env_map parse_volumes typer_factory)ArgumentOption)_dataclass_to_dictout) TABLE_NAMEUvScriptHeaderload_uv_scriptc zV^8dQhR\R\R,R\\\R,3,/#)job_id namespaceNreturn)strtuple)formats"Y/home/luca/screen-checking/.venv/lib/python3.14/site-packages/huggingface_hub/cli/jobs.py __annotate__r@Ds5...t.cSVY]S]oH^.c*V'g \R4hVPR4^8d\RV R24hRV9dW3#VPR^4wr#V'd V'g\RV R24hVeW8wd\RV RV R24hW23#)aExtract namespace from job_id if provided in 'namespace/job_id' format. Allows users to pass job IDs copied from the Hub UI (e.g. 'username/job_id') instead of only bare job IDs. If the namespace is also provided explicitly via --namespace and conflicts, a CLIError is raised. zJob ID cannot be empty./zs"r?r@r@`sB)) #Y )',)9 __classdict__s"r?r@_UvJobConfig.__annotate__s K c8 : $J $J4ZTz :$ c3:o <#sTz/ "@ cN8!"s)9#$&\D '%&#Y<'*S6+rA)__name__ __module__ __qualname____firstlineno____doc__rrMrgrhrirjrkr:rlrsrmrnrorprKrqrtrr__annotate_func____static_attributes____classdictcell__)rus@r?rcrcsor"48KEFFG I $M!&t!s"r?r@r@sWpp p pcT! p s)d" p : p $Jp $Jp cT pDjp#Y p*p4Zp *p 9t p I !p"Tz#p$:%p&#Y%'p()p*|T4'(+prAc#a a!"\V4;_uu_4pVP;'g \4o!\4o RV V!3RllpV!RV4pV!RV4pV!RV4pV!RV 4p V!RV4pV!RV4pV'g0S!P'dS P R 4S!Pp\ Wx4pS!PP4UUu/uFwppVV9gKVVbK pppS PR V44/VCVCp\ W4p\S!PVVR 7pS PR V44/VCVCp\WR 7;'g/p/S!PCS!PeRS!P/M/CpVP4UUu/uFwppVV9gKVVbK pppS PRV44/VCVCp\T;'g.S!P 4wppS PRV44\#VP$T;'g.TTTT TTTTTTV'dRM \'VWR7T;'g.S R7pRVP9d\)TVP*\-VP.VP0VP2VPVPVP4VP6VPVP8;'g\:VP<;'gR.T;'g.OR7 R7VPR&VxRRR4R#uuppiuuppi +'giR#;i5i)a[Merge the CLI flags with the `[tool.hf-jobs]` table the script carries, if any. An explicit CLI flag always wins over the script; `env`, `labels`, `secrets` and `volumes` are merged entry by entry (by key, by name and by mount path respectively), so a script value and a CLI value only ever conflict when they target the same entry. `network_aliases` is the exception: the aliases a Job claims form a set, so `--network-alias` replaces the script's list rather than adding to it. A URL script is downloaded to a temporary file that lives until the `with` block exits: submit the Job inside the block. cXV^8dQhR\R\R,R\R,/#)r8key cli_valueNr;r<)r>s"r?r@,_resolve_uv_job_config..__annotate__s)  c cDj S4Z rAcZ<VeV#\SV4;peSPV4V#R#)z2Keep the CLI value, and fall back to the script's.N)getattradd)rr script_valuerrheaders&& r?pick$_resolve_uv_job_config..picks6$  ' 44 A$##rArhrirjrkr:rlrqc3,"TF pRV 2xK R#5i)zenv.Nrw.0rs& r? )_resolve_uv_job_config..s>:CT#<:rc3,"TF pRV 2xK R#5i)zsecrets.Nrwrs& r?rrsF~XcU+~rrNrc3,"TF pRV 2xK R#5i)zlabels.Nrwrs& r?rrsDmsWSE?mrc3,"TF pRV 2xK R#5i)zvolumes.Nrw)rspecs& r?rrsM9LXdV,9LrrLr:)rfrgrhrirjrkr:rlrmrnrorprKrqrr rirkr:rmrnrprlrqextra config_parts)r6rr5rtrqrr-rmitemsupdate_resolve_script_secretsrn_parse_labels_mapror_merge_volume_specsrKrcrfrarrg_name_hash_partsrirkr:rprlrhrrj)"rLrfrgrrhrirjrmrrnrrkrrr`r:rlrqrrZrenv_maprvalue script_env secrets_mapscript_secrets labels_map script_labelsrpscript_volume_specsconfigrrrs"$$$$$$$$$$$$$$$$$$$ @@r?_resolve_uv_job_configrs4B   622."2 #   We$h'h'y'*i0 _m< 6#9#9#9 OO- .$44O.39::3C3C3E\3EZS%T[I[jc5j3E \>:>>+Z+7+#G: 0V]^F~FF77;7 &u8>>B g6==gfkkF]ffkk-Bceg 6C6I6I6Ke6K UsZdOde6K eDmDD4 44 ,? "fnn,]) )M9LMM==#))r'%#D)D\WZ)p+11r#! $  &%B""-!=="NN$.. "NN!'!4!4"("6"6$*$:$:!<<;;+;V]]=P=PbhT`TfTfdfh %FMM& ! a 2]fK  s{M0BMAM M 1M 8B7M/ M M .M6AM<MM'BMM M'M M0 M M- ' M0rFc V^8dQhR\\,R\\\R,3,R\R\\\R,3,/#)r8names cli_secretsNrr;)rMr<rsr)r>s"r?r@r@sJ%2%2 9%2#'S4Z#8%2FJ%2 #sTz/%2rAc V'g/#\4p/p.pVF.pWa9dK Wc9d W6,WF&KVPV4K0 V'd;V'g3\RRPV4 RV^, RV^, R24hV'd>\P !R\ RRPV4 RV'dR MR R 24/VC\PV4C#) aResolve the secrets requested by a script from the caller's environment. A script only lists secret *names*: values always come from whoever runs it (`HF_TOKEN` also resolves from `hf auth login`). A requested secret that is not set locally is an error rather than an empty value: forgetting to export a secret before launching is easy, and debugging the Job that results from it is not. In `--dry-run` a missing secret is not an error but a `None` value, displayed as `` in the summary: nothing is submitted, so the point is to see the full configuration of a script - including one whose secrets are not provisioned locally (yet). zTThe script requires the following secret(s), which are not set in your environment: , z$. Export them locally (e.g. `export z0=...`) or pass them explicitly (e.g. `--secrets z=...`).zThe script's [z] table requests z+: the value(s) from your local environment zwould bezwill bez sent to the Job.) r*r\rjoinr3warningr4rsfromkeys)rrrenvironresolvedmissingrs&&$ r?rrs  #%G&(HG    ?$]HN NN4 wbcgclclmtcubvw229!*>!!( G 5   ZL(9$))H:M9NO*1JyAAR T  2h 1$--0 11rAc V^8dQhR\\,R\\,R\\\,\\,3,/#)r8 cli_specs script_specsr;)rMr<r=)r>s"r?r@r@AsA""49"DI"%PTUXPY[_`c[dPdJe"rAcVUu0uFp\W"R7^,kK ppVUu.uFp\W"R7^,V9gKVNK! ppW@,V3#uupiuupi)zMerge `-v` specs with the ones from the script. Returns `(all specs, specs from the script)`. A CLI mount overrides the script's mount at the same path. rOr)rrrcli_mount_pathskepts&& r?rrAsf DMM94|D3A669OM) d\T\$-I!-LTc-cDD\D d  T !!N dsAAArlrqrcV^8dQhR\R,R\R,R\R,R\\\R,3,R\\\R,3,R\\,R\R,R \\,R,R \\,R,R \\,/ #) r8riNrkr:rmrnrprlrqrr;)r<rsrM)r>s"r?r@r@Ks $J4ZTz  c3:o   #sTz/ " s):#Y% 9t  #YrAc T;'g\PPT;'gRT;'gRT;'gR.T;'g.OR\VP 444O\V4OVOT;'g.O#)atThe resolved launch values hashed into a Job's default name, on top of its image/script. Same inputs for `hf jobs run` and `hf jobs uv run`, so that both name Jobs after what they actually submit (`extra` carries what is specific to UV runs). Env *values* are part of the hash since they change what the Job does; secrets only contribute their names, never their values. rc34"TFwrV RV 2xK R#5i)=Nrw)rrrs& r?r#_name_hash_parts..cs A-@zsSE5' -@s)r CPU_BASICrsortedrrs $$$$$$$$$r?rrKs& --+''-- 2R  ++2  BVCIIK-@ A        R  rAz (from script)rrcxV^8dQhR\\\3,R\\,R\RR/#)r8valuesrrrr;N)rsr<rrr)r>s"r?r@r@ms6tCH~z#^bosrAc <VP4UUu.uF!wr4VRR./R39gKV\W4V43NK# ppp\RV44pR.pVFmwr4YCV9d\MR, pT\ VP R44UU u.uF%wrRV^8XdTMRP V4 RV 2NK' up p, pKo RPV4p V'd\P!V R24R#\P!V 4R#uuppiuup pi) aTEcho the launch configuration of a Job before submitting it. Printed on every run, so that what is sent to the Jobs API is always visible - in particular the values injected by a script's `[tool.hf-jobs]` table, which are marked as such. Goes to stderr for a real run, and to stdout for `--dry-run`, where it is the output of the command. NrFc3<"TFwr\V4xK R#5iN)len)rr_s& r?r%_print_job_summary..ys,tVSCtszJob configuration:  z (dry run) Job not submitted.) r_format_job_valuemax _FROM_SCRIPT enumeraterFljustrr3textlog) rrrrrrrowswidthlinesindexlinesummarys &$$ r?_print_job_summaryrms!,,. (JC r2r51 1 :K89(   ,t, ,E ! "E  !3; W`afalalmqarWs Ws b!#2259:"TF CWs   iiG G9:;< #  sDD +D c^V^8dQhR\R\R\\,R\/#)r8rrrrr;)r<rr)r>s"r?r@r@s2xx3xsxCxSxrAcHaaS;R8XdS/pVP4F:wrET;'gRpT R\V4^<8dVR,R,MT 2W4&K< M;R8Xd1VP4UUu/uFwrEYD RVeRMR 2bK pppMU;R 8Xd+VP4UUu/uF wrEWD RV 2bK pppM$R 8XdVUu/uFqwVbK ppM \V4#R PVV3R lVP444#uuppiuuppiuupi) zVFormat config entries, redacting secrets and marking values inherited from the script.rmrr:N;Nu…rnz***z rorKrc3^<"TF"wrTS RV 2S9d\MR,xK$ R#5i).rN)r)rrrrrrs& r?r$_format_job_value..s3wgvYcY]TuAdV_ -K\QSTTgvs*-)rrr<r)rrrrentriesritemrrsf&f r?rrs G#kkm zzr#'&s4y2~$s)e*;SW)X Y ,fkfqfqfstfsXbX\tvQ0@uk&RSSfsGtG @E N *$tvQtf-- GNG .34edTzeG4G u:  99wgngtgtgvw wwuN4s8D/D Dg?zThe Docker image to use.helpz.Use a custom Docker image with `uv` installed.zcFlavor for the hardware. Run 'hf jobs hardware' to list available flavors. Defaults to `cpu-basic`.)r click_type-l--labelz3Set labels. E.g. --label KEY=VALUE or --label LABEL--namezName the Job. Stored as the `name` label. Names do not have to be unique. Defaults to the image or script name plus a short hash of the resolved launch configuration.zPMax duration: int with s (seconds, default), m (minutes), h (hours) or d (days).z-dz--detachz3Run the Job in the background and print the Job ID.z --dry-runz@Print the resolved Job configuration without submitting the Job.zVThe namespace where the job will be running. Defaults to the current user's namespace.z--resource-group-idzThe ID of the resource group to create the Job in. Used to control access to resources within an organization and for cost attribution/spending-limit features.z--exposezExpose a container port through the jobs proxy. Repeat the flag for multiple ports (e.g. `--expose 8000 --expose 8001`). Each exposed port is reachable on the public jobs domain; access requires an HF token with read access to the job's namespace.z--sshzMake the job's container reachable over SSH. Connect with `hf jobs ssh `. Requires an SSH public key registered on https://huggingface.co/settings/keys.z--network-groupa Join a network group. Jobs in the same namespace and resource group sharing a group are placed together and reach each other on every port. Inside each member, `$HF_NETWORK_GROUP_HOSTNAME` resolves to every member. Lowercase alphanumerics and dashes, 46 characters max.z--network-aliaszClaim an alias in the network group. Members reach the jobs claiming it at `${HF_NETWORK_GROUP_PREFIX}`. Repeat the flag for several aliases. Lowercase alphanumerics and dashes, 34 characters max, unique within the job. Requires `--network-group`.z--withz%Run with the given packages installedz-pz--pythonz5The Python interpreter to use for the run environmentz!Suspend (pause) the scheduled Jobz8Allow multiple instances of this Job to run concurrentlyzWOne of annually, yearly, monthly, weekly, daily, hourly, or a CRON schedule expression.z$UV script to run (local file or URL)zArguments for the scriptzThe command to run.zJob ID (or 'namespace/job_id')zJob IDs (or 'namespace/job_id')z2Scheduled Job ID (or 'namespace/scheduled_job_id')z-vz--volumeaMount one or more volumes. Format: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] or LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE is one of: models, datasets, spaces, buckets. TYPE defaults to models if omitted. models, datasets and spaces are always mounted read-only. buckets are read+write by default. A local directory source is first synced to a bucket and mounted read-only by default. E.g. -v hf://datasets/org/ds:/data or -v hf://buckets/org/b:/mnt:ro or -v ./inputs:/inputszRun and manage Jobs on the Hub.c4V^8dQhR\R\RR/#)r8rLjobr;N)rr)r>s"r?r@r@ps! * *u *7 *t *rAcrVPVPVPPRR7Fp\P !V4K VP VPVPPR7pVPP\P8wdjVPP'dRVPP 2MRp\RVP RVPP RV 24h\P !RVP R 24R #) zcStream Job logs until the Job ends, then fail the command if the Job did not complete successfully.T)r9r:followr9r:z: rzJob z finished with stage 'rDz completedN) fetch_job_logsidownerrr3r wait_for_jobstatusstager COMPLETEDmessager)rLrrfinalrs&& r?_stream_logs_and_check_statusrps!!399>>RV!W  X   CFFciinn  EE ||X///161E1E1EBu||++,-2ehhZ'=ell>P>P=QQRSZR[\]]HHtEHH:Z ()rArunignore_unknown_optionsT)context_settingsexamplesc* V^8dQhR\R\R\R\R\R\ R\ R\R \R \R \R \R \R\R\R\R\ R\"R\$R\&RR/#)r8rhcommandrmrnrrr`rrrirkdetachrexposesshrl network_aliasresource_group_idr:tokenr;N)ImageArg CommandArgr#r%NameOpt LabelsOpt JobVolumesOptr"r$ FlavorOpt TimeoutOpt DetachOpt DryRunOpt ExposeOpt SshEnabledOptNetworkGroupOptNetworkAliasOptResourceGroupIdOpt NamespaceOptr))r>s"r?r@r@sj,j, j, j, j, j,  j,  j, j,j,!j, j,j, j,j, j, j, #!j,"##j,$*%j,&'j,( )j,* +j,rAc\W'4p\W84p\WTR7;'g/pTPR\TT\ T T TTTT;'g.VVR7R74\ VR7pV 'dRM \ VVVR7p\RTR \P!V4R T ;'g\PPR T R TR TRT;'g.RTRRPRT ;'g.44RTRTRRPT;'g.4RVRV/V R7V 'dR#VPVVVVVVV V V VVVVVR7p\P!RVP VP";'g/P%R4VP&R7\)WE4'gdVP";'g/P%R4p\P*!RV RVP,P. RVP R24\1VP2P4\64'dFR PR!VP2P444p\P*!R"V 24\1VP2P8\:4'd<\P*!R#VP,P. RVP R$24V'd\P*!R%V R&V R'24V 'd_VP,P. RVP 2p\P*!R(V R)V R*24\P*!R+V R,24R#\=VV4R#)-z Run a Job.rr)rirkr:rmrnrprlrqrrNrrhr rirkrmrnrKror rRc38"TFp\V4xK R#5irrrports& r?rjobs_run..B\Ts4yy\r rlrqrr:r)rhr rmrnrorKrirkr r rlrqrr: Job startedrrurlJob auto-named '('. Pass `--name` or run `hf jobs labels rC --name NAME` to rename it.rc3,"TF pRV 2xK R#5irNrwrr)s& r?rr$F/E2cU/ErSExposed ports are reachable at (requires an HF token with read access to the job): Use `hf jobs ssh &` to open an SSH session into the job.Joined network group 'K'. Jobs of this namespace and resource group started with `--network-group ` reach each other at `$HF_NETWORK_GROUP_HOSTNAME` (every member) or `${HF_NETWORK_GROUP_PREFIX}` (members claiming an alias).Use `hf jobs logs -f &` to stream logs, or `hf jobs inspect ` to check status.Use `hf jobs wait ` to block until it finishes.)r-r setdefaultrrr,rarshlexrrrrrun_jobr3r]rrogetr)_has_explicit_namerYrr isinstancer expose_urlsrMssh_urlr<r)rhr rmrnrrr`rrrirkr rr r rlr rr:rrrrrLrKr auto_nameurlsjob_refs&&&&&&&&&&&&&&&&&&&& r?jobs_runrG|s/DC*G6K"54::J$  )###\\r+ -  $ 5 !Cd#>v3Zc#dG U uzz'* f;; 5 5 ; ; w 7 { v|| j chhBV\\r\BB 3 ] sxx (;(;< !2  #& ++  #%+  C JJ}szz/?/?R.D.DV.LRURYRYZ d * *ZZ%%2**62  yk*"yy~~.ax7R T #**(($//yyFszz/E/EFF ghlgmno#**$$c** $SYY^^$4AcffX=cde $]O4 -/R R YY^^$AcffX. ( 1WX_W``rst %gY.KLM!#s+rAlogs)rc V^8dQhR\R\\\RRRR73,R\\R,\R R R R73,R \ R \ RR/#)r8r9r-fz--followzqFollow log output (stream until the job completes). Without this flag, only currently available logs are printed.rtailNz-nz--tailzvNumber of lines to show from the end of the logs. When combined with --follow, starts streaming from the last N lines.r:rr;)JobIdArgr rr1intrr))r>s"r?r@r@s&x&x &x    E   &x  d   J   &x$%&x& '&x( )&xrAc\W4wr\VR7pVPWWR7pVFp\P!V4K V'd.V'dV RV 2MTp\P !RV R24R#R#)aFetch the logs of a Job. By default, prints currently available logs and exits (non-blocking). Use --follow/-f to stream logs in real-time until the job completes. Use --tail/-n to limit the number of lines returned (server-side when supported). Note: following exits when the log stream ends, regardless of whether the Job succeeded or failed. Run `hf jobs inspect ` to check the final status. r )r9r:rrKrCz#Stream ended. Run `hf jobs inspect z6` to check the final status (e.g. COMPLETED or ERROR).N)rIr,rr3rrY) r9rrKr:rrLrHrrFs &&&&& r? jobs_logsrOsyN5VGF 5 !C   V  [D   -6YKq)F 6wi?uvwrAc(V^8dQhR\RR/#)r8nr;N)rM)r>s"r?r@r@&s''3'4'rAcJRpRp\V4Fp\WR7K R#)zz)endN)rangeprint)rQLINE_UP LINE_CLEARis& r? _clear_linerY&s"GJ 1X g&rAcV^8dQhR\R\\\\3,,R\\,R\\ \ \\\\\,,,3,,/#)r8r9metrics_stream table_headersr;)r<rrsrrMr=rrM)r>s"r?r@r@-s[ !)$sCx.!9JNs) eD#tDsO4456rAc #"VEFpVVR, R2\VR,R, ^4\^dVR,,VR,, ^4 R2\VR,4 R\VR,4 R2\VR,4 R \VR ,4 R 2.pVR ,'Ed\VR ,\4'dV.\ \ VR ,4^, 4Uu.uFpR .\ V4,NK up,p\ V\VR ,44FzwrGVR ,V,pVVR, R2\^dVR,,VR,, ^4 R2\VR,4 R\VR,4 R2., pK| M-VR.\ V4\ V4, ,, pV.pRW3xEK RV.3xR#uupi5i) cpu_usage_pct%cpu_millicoresg@@memory_used_bytesmemory_total_byteszB / Brx_bpszbps / tx_bpsbpsgpusr utilizationN/AFTN)roundrrArsrTrzipr) r9r[r\metricsrowrrgpu_idgpus &&& r?_get_jobs_stats_rowsrp-s" '( * '*+f4a 8S7#677'BV:WWYZ[\\] ^G$789:$|GThLi?j>kkl mGH-./vl78CT6U5VVY Z   6??z'&/4@@5U3wv;ORS;S5TU5TRD3s8OO5TUUD"4)@A fof-=)*!,S3':#;;cBV>WWYZ[\\]^#C(;$<=>dc@V^8dQhR\R\R\RR/#)r8job_idsr:rr;N) JobIdsArgrr))r>s"r?r@r@Js6A'A' A'A' A' A'rAc pVe,.pVF!p\WA4wrAVPV4K# Tp\VR7pVfVP4R,pVf]VP VR7Uu.uF@pVP 'dVP P MRR9gK4VPNKB pp\V4^8Xd\P!R4R#.ROp\PP\V44;_uu_4p/p VF:pV.p YR,U u.uFp RV 9gR V 9dR MR NK up , p V .W&K< \P!4p V UU u.uFqIV,FqNK K p pp \\!WR 74VUu.uFpR VRVP#WAR7RV/NK pp\%V\&VR7FwrpV'dV P)VR4MVW&\P!4pVV , \*8gKN\-^\V 4,4V UU u.uFqIV,FqNK K p pp \\!WR 74Tp K RRR4R#uupiuup iuup piuupiuup pi +'giR#;i)z7Fetch the resource usage statistics and metrics of JobsNr r)r:UNKNOWNzNo running jobs found:NNrCUSAGEz-- / --z--)headersr9r[rr\) kwargs_list)RUNNINGUPDATING) zJOB IDzCPU %zNUM CPUzMEM %z MEM USAGEzNET I/Oz GPU UTIL %z GPU MEM %z GPU MEM USAGE)rIr\r,whoami list_jobsrrrrr3rmultiprocessingpool ThreadPooltimerU _tabulatefetch_job_metricsiflatmap_unorderedrppopSTATS_UPDATE_MIN_INTERVALrY)rsr:r parsed_idsr9rLrr\rrows_per_job_idrmrlast_update_time total_rowsrzdonernows&&& r? jobs_statsrIs F F$*8C ln^op^oTZ#-7f3DI4O^op pC'*eO # 99;(7[fSYCZCZCcCZc [ i :;"  " & #"7"7v"7"[  "  #5T;O]h"i D$##FD1*.'))+C%%)BBAJ/00?cf[aKbKbCcKbc ci BC#& #j) 7 6' .q\  d9 7 6 6s[/J J %J J$)J ,J$0J J$%!JAJ$( J$J !J$J$$ J5 zlist | ls | psc8V^8dQhR\\\RRRR73,R\\\,R,\R\ \ 4R R 73,R \\\,R,\R R RR73,R\\R,\RRR73,R\\\RRR73,R\R\R\\\,R,\RRRR73,RR/ #)r8all-a--allzWShow all Jobs (default shows running and scheduling). Cannot be combined with --status.rrN--statuszfOnly show Jobs with the given status. Comma-separated or repeated, e.g. `--status running,scheduling`.rrrrrz{Only show Jobs with the given `key=value` label. Repeat to require several labels, e.g. `--label env=prod --label team=ml`.rrzFOnly show Jobs with the given name (shortcut for `--label name=NAME`).limitz--limitzCMaximum number of Jobs to display. Set to 0 to show all (no limit).r:rfilterrJ--filter2(Deprecated) Use `--status` and `--label` instead.r;) r rr1rMr<r&rrMrr))r>s"r?r@r@sYFaFa    j   Fa  S D !(+y   Fa"  S D  O   #Fa2  d  Y   3Fa@   V   AFaNOFaP QFaR  S D  E   SFab cFarAc\VR7pV'd\P!RV R24V'dV'd \R4h.p T;'g.F*p V P RV P R444K, V 'dT p M?V'dRp M4\ PP\ PP.p /p T;'g.F0p RV 9d\R V R 24hV P R4wrWV&K2 VeR V 9d \R 4hW.s"V5ETLDJJLL5Es66,NrInvalid label filter '"': must be in the form 'key=value'r6Cannot filter by both `--name` and `--label name=...`.)r:rroFT durationsr rrr9rori docker_image image/spacerR created_atNNTcreatedrrrv running_secsruntimeryid_keyzOutput truncated to z4 Jobs. Use `--limit 0` to show all (or `--limit N`).rc3,"TF pRV 2xK R#5izstatus=Nrwrss& r?rr7,QWQC=,rc36"TFwrRV RV 2xK R#5izlabel=rNrwrkvs& r?rr#:gXfPTPQVA3as;KXfzNo jobs matched filters: zHNo running jobs. Use `-a`/`--all` to include finished (and failed) jobs.)r9rrr rrr)r,r3rrrUrFrr{r SCHEDULINGr~rM itertoolsislicerr2r?rreplacer r\tablerYrr)rrrrrr:rrrL raw_statusesrserver_statusesrorr jobs_iter truncatedjobs job_itemsrjob_itemrcmd filters_msgs&&&&&&&& r?jobs_psrs^D 5 !C  x(p p  vIJJ!L2VU[[5EVV& #++1183F3F3L3LM F   d?3D69[\] ]ZZ_ s   V ST Tv RXR`R`\` aII qyI$$Y :; t9u I"G"G%/2chhsmOW||\hOiOih|4S9AA#sKot&ll84::??S-immN.KL"II\  'w.bcd  6))h7,7h:gX^XdXdXf:ghK HH0 > ? HH_ ` rAhardwarezhf jobs hardwarecV^8dQhRR/#)r8r;Nrw)r>s"r?r@r@#s]]t]rAc\4pVP4p.pVEFpRpVP'dHVPP RVPP RVPP R2pVP 'dRVP R 2MRpVP 'dRVP ^<,R 2MRpVPR VPR VPR VPR VPR VPRVRVRV/4EK \P!V4\P!R4R#)z(List available hardware options for Jobsrzx  ()$z.4ffreez.2frz pretty namecpuramstorage acceleratorzcost/minz cost/hourzLUse `hf jobs run --flavor ...` to request a specific hardware flavor.N)r,list_jobs_hardwarerquantitymodelvram unit_cost_usdr\r pretty_namerrephemeral_storager3rrY)rL hardware_listrhwaccelerator_infocost_min cost_hours r? jobs_hardwarer"s* ,C**,M E >>>"$.."9"9!:"R^^=Q=QcV^8dQhR\\\,\RR73,R\R\ RR/#)r8rsz*Job IDs to inspect (or 'namespace/job_id')rr:rr;Nr rMr<r0rr))r>s"r?r@r@?sThh  S =  hh h hrAc T.pVF!p\WA4wrAVPV4K# Tp\VR7pVUu.uFqEPWAR7NK pp\P !VUu.uF#p\ \V4VPR7NK% upRR7R#uupiuupi)z0Display detailed information on one or more Jobsr rrorrN) rIr\r, inspect_jobr3r _surface_namer2ro)rsr:rrr9rLrrs&&& r? jobs_inspectr>sJ8K&!G 5 !CNU VgFOO6O ?gD VIITXYTXS}/4SZZHTXYbfg WYs B ,)B%cancelzhf jobs cancel c@V^8dQhR\R\R\RR/#)r8r9r:rr;N)rLrr))r>s"r?r@r@Us0 + +  + +  + +rAc\W4wr\VR7pVPWR7\P!RVR7R#)z Cancel a Jobr rz Job cancelledrN)rIr, cancel_jobr3r])r9r:rrLs&&& r? jobs_cancelrTs75VGF 5 !CNN&N6JJ6*rAwaitc V^8dQhR\\\,\RR73,R\\R,\ RR73,R\ R\ R R/#) r8rsz,Job IDs to wait for (or 'namespace/job_id').rrkNzTMax time to wait: int with s (seconds, default), m (minutes), h (hours) or d (days).r:rr;)r rMr<r0r1rr))r>s"r?r@r@ist4 4  S ?  4  d g  4 4  4  4 rAc f.p\4pVF2p\Wb4wrxVPV4VPV4K4 \ V4^8d8\ RRP R\V\R744,4hVP4pVe \V4MRp \VR7p \P!R\ V4 R24p V PWIVR 7p T P!\ T 4 R 24\P"!T U u.uFFp RT P$R\T PP&4RT PP(/NKH up 4T U u.uF/qPP&\*P,8wgK-T NK1 pp T'dA\ \ T4 R\ T 4 R2RP RT44,4hR# \d#T P!R 4\ R T R 24Rhi;iuup iuup i)aWait for one or more Jobs to reach a terminal state. Blocks until every Job has finished, then exits with code 0 if all Jobs completed successfully, or a non-zero exit code if any Job was canceled, errored or deleted. All Jobs must belong to the same namespace. z0All Job IDs must be in the same namespace, got: rc38"TFp\V4xK R#5irr)rnss& r?rjobs_wait..sF*EBB*Er&)rNr z Waiting for z Job(s) to finish...)rkr:z Timed out.zTimed out after z waiting for Job(s) to finish.z Job(s) finished.rrrz of z' Job(s) did not complete successfully: c3l"TF*qP RVPP R2xK, R#5i)rrN)rrr)rrs& r?rrs*KFS66("SZZ%5%5$6a8Fs24)rtrIr\rrrrrr<rr!r,r3rr TimeoutErrorrrrrrrr)rsrkr:rr namespacesr9 parsed_idparsed_namespace timeout_secsrLrrrfaileds&&&& r? jobs_waitras>JJ&B6&U# )$'( : >iiF&*EFF G   I.5.A>'*tL 5 !C ZZ,s:&77KL MF] IV KK3t9+./0IIhlmhladcffgs3::+;+;'s"r?r@r@siEE E E E T6)2STT U E  E  E ErAcV'gVfV'g \R4hV'gVeV'd \R4h\W4wr\VR7pVe8V'g0VPWR7P;'g/p/VCRV/CpM\ W!R7;'g/pVP WVR7p \P!R V PVPR4R 7R#) zfUpdate labels on a Job. Passing --label replaces all existing labels; passing --name alone keeps them.NePlease set a name with --name or at least one label with --label. To remove all labels, pass --clear.lCannot set a name or labels and clear them at the same time. Please use --name/--label or --clear, not both.r rrr)r9ror:Labels updatedrr) rrIr,rrorupdate_job_labelsr3r]rr?) r9rrrr:rrLcurrent_labelsrors &&&&&& r? jobs_labelsr s" T\% s   !u z  5VGF 5 !C LSSYYWY1N1FD1"54::  v  RCJJCFFF1CDrAr c XV^8dQhR\R\R\R\R\RR/#)r8r9 identity_filerr:rr;N)rLr(r'rr))r>s"r?r@r@sD## #%## #  #  #rAc\W4wr\VR7pVPWR7pVPPf \ R4hVPP \9d1\ RVP RVPP R24hVPP \P8wd\P!RVP R VPP R 24pVPVPV\P.R 7pVPP \P8wdBVPR 4\ RVP R VPP R24hVPR4\VPP4p\VP RVP" 2VP$VVR7R#)aSSH into a running Job. If the Job is not yet running, waits until it reaches the RUNNING state before connecting. Requires the Job to be started with SSH enabled (`hf jobs run --ssh ...`) and your SSH public key to be registered at https://huggingface.co/settings/keys. r rNz[SSH is not enabled on this job. Start a job with SSH support using `hf jobs run --ssh ...`.zCannot SSH into job 'z%': job has already finished (stage: 'z').zWaiting for job 'z' to be running (stage: 'z')...)r9r:stagesz Job finished.z1': job finished before reaching RUNNING (stage: 'zJob is running.@)r#rr)rIr,rrrCrrrrrr{r3rrrr+usernamehostnamer#) r9rrr:rrLrrrCs &&&&& r?jobs_sshrs*5VGF 5 !C /// =C zz!tuu zz...svvh6[\_\f\f\l\l[mmpqrr zz8+++/x7PQTQ[Q[QaQaPbbghicff 8K[K[J\] ::  x// / KK ('x/`adakakaqaq`rruv   %&szz))*G    Ag../0 \\# rAzFRun UV scripts (Python with inline dependencies) on HF infrastructure.uvrc00V^8dQhR\R\R\R\R\R\ R\ R\R \R \R \R \R \R\R\R\R\ R\"R\$R\&R\(R\*R\,RR/#)r8rfrgrhrirmrnrrr`rrrkr rr r rlr rr:rwith_rjr;N) ScriptArg ScriptArgsArgImageOptrr#r%rrrr"r$rrrrrrrrrr)WithOpt PythonOpt)r>s"r?r@r@ss,s, s,s, s,  s,  s,  s, s, s, s,s,!s,s, s,s, s, !s,"##s,$#%s,&*'s,()s,* +s,, -s,. /s,0 1s,rAc \VR7p\R4/RVbRVbRVbRVbRVbRVbRVbR VbR V bR VbR V bR V bRVbRVbRVbRVbRVbRVbRV b;_uu_4p\/RVbR\P!VP 4bRRP T;'g.4bRVP ;'g\bRVP;'g\PPbRVPbR VPbR VPbR VPbRVP bRVP"bRRP RT;'g.44bRVbRVP$bRRP VP&4bRVbRVP(bVP*V R7V 'd RRR4R#TP-VP.VP TVPVP VPVPVP"VP0VPVPTTVP$VP&;'gRVVP(R 7pRRR4\2P4!R!XP6VP";'g/P9R4VP:R"7\=WgXP*4'gdVP";'g/P9R4p\2P>!R#V R$VP@PB R%VP6 R&24\EVPFPH\J4'dFR'P R(VPFPH44p\2P>!R)V 24\EVPFPL\N4'd<\2P>!R*VP@PB R%VP6 R+24VP$;p'd\2P>!R,V R-V R.24V 'd_VP@PB R%VP6 2p\2P>!R/V R0V R124\2P>!R2V R324R#\QVV4R# +'giELZ;i)58Run a UV script (local file or URL) on HF infrastructurer rLrfrgrrhrirjrmrrnrrkrrr`r:rlrqrargswithrRrKror c38"TFp\V4xK R#5irrr"s& r?rjobs_uv_run..@"F3t99r&r rrrrN)rfrgrrjrhrmrnrorKrirkr r rlrqrr:r'r(r*r+rCr,rc3,"TF pRV 2xK R#5ir.rwr/s& r?rr"gr0rr1r2r3r4r5r6r7r8r9r:r;rw))r,rrr=rrgrhrrirrrrjrkrmrnrprorlrqr:rr run_uv_jobrfrKr3r]rr?r)r@rYrrrArrBrMrCr<r)rfrgrhrirmrnrrr`rrrkr rr r rlr rr:rrrjrLrrrDrEgrouprFs&&&&&&&&&&&&&&&&&&&&&&& r? jobs_uv_runr(sL 5 !C                    "      ! "$# $&% &'  (  &  6#5#56 "- 99)9   &--FF;+@+@+F+F   &--  6>> vzz 6>> 6.. &-- #(("F2"FF s  !5!5 "388F,B,B#C  $%6! "V--# &**+ .  [  \nn==**==,, NN==NN==NN .."22::d/&&# ] BJJ}szz/?/?R.D.DV.LRURYRYZ d6+=+= > >ZZ%%2**62  yk*"yy~~.ax7R T #**(($//yyFszz/E/EFF ghlgmno#**$$c** $SYY^^$4AcffX=cde$$$u$ $UG, %w'R R YY^^$AcffX. ( 1WX_W``rst %gY.KLM!#s+q   s4AR92R9 A?R9 A!R9/R9:BR9R99 S c"]tRtRtRtRtRtRtR#)ScheduledJobStatusFilteriyzPossible values for `hf jobs scheduled ls --status`. Scheduled Jobs are not "running": they are either active (i.e. they will trigger new runs) or suspended. active suspendedrwN)rxryrzr{r|ACTIVE SUSPENDEDr~rwrAr?r*r*ys FIrAr*z,Create and manage scheduled Jobs on the Hub. scheduledzRhf jobs scheduled run "0 0 * * *" --name daily-script python:3.12 python script.pyc(V^8dQhR\R\R\R\R\R\ R\ R\R \R \R \R \R \R\R\R\R\ R\"R\$RR/#)r8schedulerhr suspend concurrencyrmrnrrr`rrrirkrr rr:rr;N) ScheduleArgrr SuspendOptConcurrencyOptr#r%rrrr"r$rrrrrrr))r>s"r?r@r@sWtWtWt WtWt Wt  Wt  WtWt Wt Wt WtWt!Wt WtWtWt !Wt"*#Wt$%Wt& 'Wt( )WtrAc\WZ4p\Wk4p\WR7;'g/pTPR\TT\ T T TTTT ;'g.R7R74\ VR7pV'dRM \ V VVR7p\RTR TR TR TR \P!V4R T ;'g\PPRT RTRTRT ;'g.RTRRPRT;'g.44RVRV/VR7V'dR#VPVVVVVVVVVV V VVVR7p\P!RVP VP"P$;'g/P'R4R7\)Wx4'gnVP"P$;'g/P'R4p\P*!RV RVP,P. RVP R24\P*!R VP,P. RVP R!24R#)"zSchedule a Job.rr)rirkr:rmrnrprr Nrr1r2r3rhr rirkrmrnrKror rRc38"TFp\V4xK R#5irrr"s& r?r scheduled_run..r%r&rr:r)rhr r1r2r3rmrnrorKrirkr rr:Scheduled Job createdr Scheduled Job auto-named '2'. Pass `--name` or run `hf jobs scheduled labels rCr,Use `hf jobs scheduled inspect ` to view its details.)r-rr<rrr,rarr=rrrrcreate_scheduled_jobr3r]rjob_specror?r@rYrr)r1rhr r2r3rmrnrrr`rrrirkrr rr:rrrrrLrK scheduled_jobrDs&&&&&&&&&&&&&&&&&&& r? scheduled_runrBs?6C*G6K"54::J$  )###\\r   5 !Cd#>v3Zc#dG  w ; U uzz'* f;; 5 5 ; ; w 7 { v|| j chhBV\\r\BB !2  #&,, +-M JJ&=+;+;=CYCYC`C`CfCfdfBkBklrBst d * *"++2288b==fE  ( 4))6)<)<)A)A(B!MDTDTCUUp r HH.}/B/B/G/G.H-JZJZI[[q rsrAcV^8dQhR\\\RRRR73,R\\\,R,\R\ \ 4R R 73,R \\\,R,\R R RR73,R\\R,\RRR73,R\R\R\\\,R,\RRRR73,RR/#)r8rrrzTShow all scheduled Jobs (default hides suspended). Cannot be combined with --status.rrNrzgOnly show scheduled Jobs with the given status. Comma-separated or repeated, e.g. `--status suspended`.rrrrzOnly show scheduled Jobs with the given `key=value` label. Repeat to require several labels, e.g. `--label env=prod --label team=ml`.rrzPOnly show scheduled Jobs with the given name (shortcut for `--label name=NAME`).r:rrrJrrr;) r rr1rMr<r&r*rr))r>s"r?r@r@s2OmOm    g   Om  S D !":;)    Om(  S D  7    )Om>  d  c   ?OmLMOmN OOmP  S D  E   QOm` aOmrAc \VR7pV'd\P!RV R24V'dV'd \R4h.pT;'g.F*p VP RV P R444K, VU u.uFq\ \49gKV NK p p V 'd0\RT R\U u.uFqPNK up R 24hV'd(\PV9p \PV9p MR p Tp /pT;'g.F2pR V9d\R V R 24hVP R ^4wpp WV&K4 VeRV9d \R4hW>R&TPYN;'gRR7p.pVFNpVP;'gRpV'd V 'gK+V'g V 'gK=VPV4KP .pVEFp\V4pVPR4;'g/pVPR4;'g/pVPR4pVPR4;'g.pVPR4;'g/PR4;'gRVR&VPR4;'gRVR&V'dRP!V4MRVR&V'd8VPR4'd!VR,R,P#RR4MRVR&VPR 4'd!VR ,R,P#RR4MRVR!&VPR"4;'gRVR"&VPV4EK \P$!V.R.OR#R$7V'gzV'g V'dLR%P!.R&V4OR'VP'44O4p\P(!R(V 24MV'g\P*!R)4V'dGV^,R#,p\P*!R*V R+24\P*!R,V R-24R#R#uup iuup i)/zList scheduled Jobs. Use `--status` to filter by status (`active` or `suspended`) and `--label` to filter by `key=value` labels. A scheduled Job must match every filter to be listed. r rrrc3"TF:qP4'gKVP4P4xK< R#5ir)rlowerrs& r?rscheduled_ps..4s0^=MTQ[Q[Q]0DJJL..00=Ms A&ArzInvalid status filter(s) z: expected one of rTrrrNrr)r:roFr@rlast_jobr rorirrrRatrrlast_runnext_job_run_atnext_runr2rrrc3,"TF pRV 2xK R#5irrwrs& r?rrGwrrc36"TFwrRV RV 2xK R#5irrwrs& r?rrGwrrz#No scheduled jobs matched filters: zENo active scheduled jobs. Use `-a`/`--all` to include suspended ones.r=z(` to view details about a scheduled job.zUse `hf jobs scheduled trigger z)` to trigger a scheduled job immediately.)rrr1rr rJrLr2)r,r3rrrUrFr=r*rr-r.list_scheduled_jobsr2r\r2r?rrrrrrY)rrrrr:rrrLrrrunknown_statuses show_activeshow_suspendedro raw_labelrscheduled_jobs filtered_jobsrAr2rsjrr@ status_dictrHrr first_item_ids&&&&&&& r? scheduled_psrYs@ 5 !C  x(p p  vIJJ!L2^U[[=M^^$0\`ab b__S!, Us !  V ST Tv,,ySW,XNM' ''005 > { ]+ (#%E!"%88J'--2hhx(..B ??:.ll9%++ X.44"99&AJJUV &ll>:CCe]+.#((3-EYDLQYQ]Q]^bQcQc8D>#.66sC@inZEP__UfEgEgK) *3 / 7 7S Amr Z((9-66Y T II g  6))h7,7h:gX^XdXdXf:ghK HH:;-H I HH\ ] a  2=/Aijk 2=/Ajkl M]cV^8dQhR\\\,\RR73,R\R\ RR/#)r8scheduled_job_idsz>Scheduled Job IDs to inspect (or 'namespace/scheduled_job_id')rr:rr;Nr)r>s"r?r@r@sTxx  S Q  xx x xrAc j.pVF!p\WA4wrAVPV4K# Tp\VR7pVUu.uFpVPWaR7NK pp\P !VUu.uF-p\ \V4VPPR7NK/ upRR7R#uupiuupi)z:Display detailed information on one or more scheduled Jobsr scheduled_job_idr:rrrN) rIr\r,inspect_scheduled_jobr3rrr2r@ro) r[r:rrr9rLr^rTrVs &&& r?scheduled_inspectr`sJ#8K&!$# 5 !C!2 1  !!3C!Y 1IIZhiZhTV}/3BKKc@V^8dQhR\R\R\RR/#r8r^r:rr;NScheduledJobIdArgrr))r>s"r?r@r@0 = =' = =  = =rAc\W4wr\VR7pVPWR7\P!RVR7R#)zDelete a scheduled Job.r r]zScheduled Job deletedrN)rIr,delete_scheduled_jobr3r]r^r:rrLs&&& r?scheduled_deleterj?#??O"[ 5 !C.>TJJ&+;c@V^8dQhR\R\R\RR/#rcrd)r>s"r?r@r@6 Q Q' Q Q  Q QrAc\W4wr\VR7pVPWR7\P!RVR7\P !RV R24R#)z Suspend (pause) a scheduled Job.r r]zScheduled Job suspendedrzUse `hf jobs scheduled resume z` to resume it.N)rIr,suspend_scheduled_jobr3r]rYris&&& r?scheduled_suspendrpsW#??O"[ 5 !C/?UJJ(-=>HH-.>-? OPrAresumezhf jobs scheduled resume c@V^8dQhR\R\R\RR/#rcrd)r>s"r?r@r@rfrAc\W4wr\VR7pVPWR7\P!RVR7R#)z!Resume (unpause) a scheduled Job.r r]zScheduled Job resumedrN)rIr,resume_scheduled_jobr3r]ris&&& r?scheduled_resumerurkrAtriggerzhf jobs scheduled trigger c@V^8dQhR\R\R\RR/#rcrd)r>s"r?r@r@rmrAc,\W4wr\VR7pVPWR7p\P!RVP VP R7\P!RVPP RVP R24R#) zJTrigger a scheduled Job to run immediately (does not change the schedule).r r]zScheduled Job triggered)rr)r7rCz` to stream logs.N) rIr,trigger_scheduled_jobr3r]rr)rYrr)r^r:rrLrs&&& r?scheduled_triggerrzst#??O"[ 5 !C # #5E # [CJJ(SVVAHH$SYY^^$4AcffX=N OPrAcV^8dQhR\R\R\R\\\ RRR73,R\ R \R R /#) r8r^rrrrz)Remove all labels from the scheduled job.rr:rr;N)rerrr rr1rr))r>s"r?r@r@siOO'O O O T6)2]^^ _ O  O  O OrAcV'gVfV'g \R4hV'gVeV'd \R4h\W4wr\VR7pVeBV'g:VPWR7PP ;'g/p/VCRV/CpM\ W!R7;'g/pVPWVR7p \P!R V PVPR4R 7R#) zpUpdate labels on a scheduled Job. Passing --label replaces all existing labels; passing --name alone keeps them.Nrrr r]rr)r^ror:rr ) rrIr,r_r@rorupdate_scheduled_job_labelsr3r]rr?) r^rrrr:rrLr rorAs &&&&&& r?scheduled_labelsr~s" T\% s   !u z  #??O"[ 5 !C   % %7G % ] f f m m s sqs 2N1FD1"54::33)I4MJJM$4$46::f;MNrAz)Schedule UV scripts on HF infrastructure.zBhf jobs scheduled uv run "0 0 * * *" --name daily-script script.pyzs"r?r@r@s h`h`h` h`h` h`  h`  h` h` h`h` h` h` h`h`!h`h` !h`" #h`$*%h`&'h`( )h`* +h`, -h`. /h`rAc \VR7p\R-/RVbRVbRVbRVbRVbRVbRVbR VbR V bR VbR V bR VbRV bRV bRV bRVbRRbRRbRVb;_uu_4pVP'gVP'd\ R\ R24h\ /RVbRVbRVbRVbR\P!VP4bRRPT;'g.4bRVP;'g\bRVP;'g\PPbRVP bR VP"bR VP$bR VP&bRVP(bRVP*bR RPR!T;'g.44bR"VbRVP,bVP.VR#7V'd RRR4R#VP1VP2VPVVVVVP VPVP$VP&VP*VP4VPVP"VVVP,R$7pRRR4\6P8!R%XP:VP<P*;'g/P?R4R&7\AWXP.4'gnVP<P*;'g/P?R4p\6PB!R'V R(VPDPF R)VP: R*24\6PB!R+VPDPF R)VP: R,24R# +'giEL';i).rr rLrfrgrrhrirjrmrrnrrkrrr`r:rlNrqrzjScheduled Jobs do not support network groups: remove 'network_group'/'network_aliases' from the script's [z] table to schedule it.r1r2r3rr rRrKror c38"TFp\V4xK R#5irrr"s& r?r#scheduled_uv_run..Kr#r&rr$)rfrgr1r2r3rrjrhrmrnrorKrirkr rr:r:r r;r<rCr,r=r>rw)$r,rrlrqrr4rr=rrgrhrrirrrrjrkrmrnrpror:rrcreate_scheduled_uv_jobrfrKr3r]rr@r?r@rYrr)r1rfrgr2r3rhrirmrnrrr`rrrkrr rr:rrrjrLrrrDs&&&&&&&&&&&&&&&&&&&&&& r?scheduled_uv_runrsB 5 !C                    "      ! $% &' ()  *     6#9#9#9(\)@B   H 7 { &    6#5#56   "-  99)9 &--FF;+@+@+F+F &-- 6>> vzz 6>> 6.. &-- #(("F2"FF  $%6! "V--# &**+ .  g  h))==**#==,, NN==NN==NN/&&#* i NJJ&3669L9L9R9RPR8W8WX^8_` d6+=+= > >\\((..B33F;  ( 4)),(8#&&A\ ^ HH.syy~~.>axG] ^_]   s9$M<s"r?r@r@tsA " "S#X "4S>D3H "TRUWZRZ^ "rAcPT;'g/PR4pVfV#RV/VC#)zPromote the `name` label to a top-level `name` field for display. The `name` is kept inside `labels` too (the dataclasses and API payloads are unchanged); this only makes it a first-class column/field in command outputs. No-op when there is no name. r)r?)rrors&$ r?rrts4 LLb  f %D | D !D !!rAcV^8dQhR\R,R\\,R,R\\,R\/#)r8rNrrrr;)r<rMrr)r>s"r?r@r@s;S4ZS D0@zZ]hlrAcVRJ;'gVRV9;'gI\;QJd&RT;'g.4F 'gK R# R#!RT;'g.44#)zlWhether the Job was named on purpose: via `--name`, a `name=` label, or the script's `[tool.hf-jobs]` table.Nz labels.namec3X"TF qPR^4^,R8HxK" R#5i)rrN)rF)rrs& r?r%_has_explicit_name..s#G;4zz#q!!$.;s(*TF)any)rrrrs&&&r?r@r@sq D H H K ' H H 3G5;;B;G33  G5;;B;G GrArcV^8dQhR\\,R,R\R,R\\\3,R,/#)r8roNrr;)rMr<rs)r>s"r?r@r@s?d3i$.ttTWY\T\~`dOdrAcV'gVfR#/pT;'g.F&pRV9dVPR^4MVR3wrEWRV&K( VeRV9d \R4hWR&V#)zParse label key-value pairs from CLI arguments. Args: labels: List of label strings in KEY=VALUE format. If KEY only, then VALUE is set to empty string. Returns: Dictionary mapping label keys to values, or None if no labels or name provided. Nrrrz4--name and --label name=... cannot both be provided.)rFr)rorr label_varrrs&$ r?rrsv dl!#J\\r\ 03y0@Y__S!,yRTo 3"  Z QR R!6 rAcV^8dQhR\\\\,,,R\\,R\/#)r8rryr;)rMr<rM)r>s"r?r@r@s2DcCi)DI#rAc L\.VOVN5!Uu.uFp\RV44NK pp\\P!4P\ V4^ ,4p\ V4\ V4,V8dVP\V44pW5;;,^,uu&\ V4\ V4,V8:gKpV\ V4, \ V4, W5,,W5&KR\ V4,P!V!p.pVPVP!V!4TPVP!VUu.uF pRV,NK up!4VF~p \W4U U u.uFEwr\ \V 44V 8d\V 4RV ^, R,M \V 4NKG p p p VPVP!V !4K RPV4#uupiuupiuup p i)zy Inspired by: - stackoverflow.com/a/8356620/593036 - stackoverflow.com/questions/9535954/printing-lists-as-tabular-data c3J"TFp\\V44xK R#5ir)rr<)rxs& r?r_tabulate..s/3ac#a&kk3s!#z{{:{}}} -Nz...r) rkrshutilget_terminal_sizecolumnsrsumrr>r\r<r) rrycol col_widthsterminal_widthcol_to_minimize row_formatrwrmr col_widthrow_format_argss && r?rrs 9$**3z?;#)# w<#j/ )^ ;*83z?*JSQX\*Y\f\w*wJ 's7|+33Z@J E LL""G,- LL""j$AjS1WWj$ABC!$C 4 4 033q6{Y/FCF?Y] #e +CPQF R 4    Z&&89  99U #P%B sH&H A H rcV^8dQhR\\,R\R\\,3,R\RR/#)r8queuefunc.kwargsr;N)r rrrrs)r>s"r?r@r@s<U1XXc8A;>N5OY]bfrAcFV!R/VBFpVPV4K R#)Nrw)put)rrrr]s&&& r?_write_generator_to_queuers.. &!rAc V^8dQhR\PPR\R\\ ,3,R\ \,R\\ ,/#)r8rr.rzr;)rrrrrrrMrs)r>s"r?r@r@sR    ) ) 3 # $d  a[ rAc #"\4pVUu.uFq@P\W1V34NK ppVPRR7xKuupi \dZ\ ;QJdRT4F 'dK RM RM !RT44'dTP 4'dMK}Ki;i \dMi;iTUu.uFqfPRR7NK MuupipR# \PdR#i;i TUu.uFqfPRR7NK Muupipi \Pdii;i;i5i)a# Takes a function that returns an iterable of items, and run it in parallel using threads to return the flattened iterable of items as they arrive. This is inspired by those three `map()` variants, and is the mix of all three: * `imap()`: like `map()` but returns an iterable instead of a list of results * `imap_unordered()`: like `imap()` but the output is sorted by time of arrival * `flatmap()`: like `map()` but given a function which returns a list, `flatmap()` returns the flattened list that is the concatenation of all the output lists Tg?)rkc3@"TFqP4xK R#5ir)ready)r async_results& r?r%iflatmap_unordered..sN ))++ sFN) r apply_asyncrr?r remptyKeyboardInterruptrr)rrrzrr async_resultsrs&&$ r?rrs0gEfqrfq\b%%&?%vAVWfqMr iii-- s  3N N333N NNNSXS^S^S`S`TaN      @M N  d  + N++    @M N  d  + N++   sE A EB8A B8 EB5'B5;B5B5,B8-D.B84B55B88 CDCD C2C)(C20E2D E D  EED7D/.D76E7E EEEErw)zFhf jobs run --name hello-world python:3.12 python -c 'print("Hello!")'z1hf jobs run --detach python:3.12 python script.pyz3hf jobs run -e FOO=foo python:3.12 python script.pyz;hf jobs run --secrets HF_TOKEN python:3.12 python script.pyz^hf jobs run -v hf://org/my-model:/data -v hf://buckets/org/b:/mnt python:3.12 python script.py)NNNNNNNNNFFNFNNNNN)zhf jobs logs zhf jobs logs -f zhf jobs logs --tail 20 z#hf jobs logs -f --tail 100 )FNNN)NNN)z hf jobs lsz hf jobs ls -az&hf jobs ls --status running,schedulingzhf jobs ls --name training-v2z+hf jobs ls --label env=prod --label team=mlz%hf jobs ls --all --label hf-sandbox=1)FNNNdNNN)NN)zhf jobs wait z"hf jobs wait z"hf jobs ls -q | xargs hf jobs wait)z*hf jobs labels --name training-v2z8hf jobs labels --label env=prod --label team=mlzhf jobs labels --clear)NNFNN)zhf jobs ssh zhf jobs ssh --dry-runz)hf jobs ssh -i ~/.ssh/id_ed25519)NFNN)z,hf jobs uv run --name my-script my_script.pyz$hf jobs uv run --detach my_script.pyz1hf jobs uv run --flavor a10g-small ml_training.pyz+hf jobs uv run --with transformers train.pyzNhf jobs uv run -v hf://org/my-model:/data -v hf://buckets/org/b:/mnt script.pyz"hf jobs uv run --dry-run script.py)NNNNNNNNNNNFFNFNNNNNNN)NNNNNNNNNNNFNNNN)zhf jobs scheduled lszhf jobs scheduled ls -az'hf jobs scheduled ls --status suspendedz(hf jobs scheduled ls --name daily-scriptz5hf jobs scheduled ls --label env=prod --label team=ml)FNNNNNN)z1hf jobs scheduled labels --name daily-scriptz>hf jobs scheduled labels --label env=prod --label team=mlz%hf jobs scheduled labels --clear)NNNNNNNNNNNNNFNNNNNN)rw)r|rrmultiprocessing.poolr=rrcollections.abcrrrr contextlibr dataclassesrrenumr pathlibr rr r typingr rr urllib.parserhuggingface_hubrrrrrrhuggingface_hub._jobs_apirrrrhuggingface_hub.errorsrhuggingface_hub.utilsr$huggingface_hub.utils._cache_managerrhuggingface_hub.utils._hf_urisrhuggingface_hub.utils._parsingr r! _cli_utilsr"r#r$r%r&r'r(r)r*r+r,r-r.r/ _frameworkr0r1_outputr2r3_uv_script_headerr4r5r6 get_loggerrxloggerrIrarcrrrrrrrrr<rrrrMrrrrrrrrrMrrrrrrr5r6r4rrrrLrtrerjobs_clirr rGrOrYrprrrrrrr ruv_app add_groupr(r* scheduled_apprBrYr`rjrprurzr~scheduled_uv_apprrr@rrrrrrwrAr?rst G EE%(**!TT ,)=7J ),II   H %.8)X aa a0ppf%2MR%2P"!%)-#> QSej6x(   '  $J =  $J rk*   I   B   $J v $J _     B     O  $J e $J o I G   p $J ]I N I  4  $J   D  4K 0 4K G f   3  I ' I "   -  I .   AI  e     ? @ *  .5 j, j,Z  &x&xR'8 '%=$>?A'@A'H  Fa FaR *(:';<]=]6 )'A&BChDh* (&?%@A +B +  4 4 n  EE:  ##L d e6% .5 s, s,lsD#QR ={3 .5b c Wt  Wtt Om Omdy,L+MNxOx0x+J*KL =M =y,L+MN QO Qx+J*KL =M =y,L+MN QO Q OOB!&QR (t4 .5LFh`h`\ "d,6 CL rA