rPjD< dZddlZddlZddlZddlZddlZddlZddlmZm Z m Z m Z ddl m Z ddlmZmZddlmZddlmZddlmZmZdd lmZmZmZdd lmZddlZdd lm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&dd l'm(Z(m)Z)m*Z*m+Z+dd l,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5m6Z6ddl7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZIddlJmKZKmLZLddlMmNZNmOZOmPZPddlQmRZRmSZSmTZTe/jeVZWdeXdeXdzdeYeXeXdzffdZZde[eXdzde deXdzde[e%dzfdZ\eGddZ]e de d eXd!e[eXdzd"e[eXdzd#eXdzd$eXdzd%eXdzd&e[eXdzd'eXdzd(e[eXdzd)eXdzd*eXdzd+e^dzd,eXdzd-e[eXdzd.e[eXdzdeXdzd/eXdzd0e[eXdzd1e_de e]ddff*d2Z`d3d4d(e[eXdzd)eXdzd1e_deaeXeXdzffd5Zbd3d4d6e[eXd7eaeXeXdzfd1e_deaeXeXdzffd8Zcd9e[eXd:e[eXdeYe[eXe[eXffd;Zddddd<d$eXdzd*eXdzdeXdzd&eaeXeXdzfd(eaeXeXdzfd=e[eXd/eXdzd0e[eXdzd>e[eXdzde[eXfd?Zed@ZfdAd3dBdCeaeXefdDe eXd1e_ddfdEZgdFeXdGedDe eXdeXfdHZhdIZieeXeKdJKfZjeeXdzeLdLKfZkeeXdzeLdMe?e!NfZlee[eXdzeLdOdPdQKfZmeeXdzeLdRdSKfZneeXdzeLdTKfZoee^dzeLdUddVWfZpee_eLdXdYdZKfZqee_eLd[d\KfZreeXdzeLd]KfZseeXdzeLd^d_KfZtee[e^dzeLd`daKfZuee[e^dzeLdbdcKfZvee_eLdddeKfZweeXdzeLdfdgKfZxee[eXdzeLdhdiKfZyee[eXdzeLdjdkKfZzeeXdzeLdldmdnKfZ{ee_dzeLdoKfZ|ee_dzeLdpKfZ}eeXeKdqKfZ~eeXeKdrKfZee[eXdzeKdsKfZee[eXeKdtKfZeeXeKduKfZee[eXdzeKdvKfZeeXeKdwKfZee[eXdzeLdxdydzKfZeId{KZde d|e"ddfd}Zde d|e"ddfd~Zde d|e"de_ddfdZejdddigd dd#ejded&e9d(e>d,end-emd.ed'e8d)e=d$eld*eod+epdeqd1erdeudevdewd/exdeydetdesdeBde:de;ded,end-emd.ed'e8d)e=d*eod+epdeqd1erdeudevdewd/exdeydetdesdeBdezd%e{de:de;ded,end-emd.ed'e8d)e=d$eld*eod+epd1erdeudevdetdesdeBde:de;ded,end-emd.ed'e8d)e=d*eod+epd1erdeudevdetdesdeBdezd%e{de:de;de| j@xsdg|xsg| t | gng | jd<| dddycc}}wcc}}w#1swYyxYww)awMerge 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. key cli_valueNrAcP||St|x}j||Sy)z2Keep the CLI value, and fall back to the script's.N)getattradd)rr script_valuerqheaders rIpickz$_resolve_uv_job_config..picks6$  ' 44 A$##rKrgrhrirjr@rkrpc3&K|] }d| yw)zenv.Nr{.0rs rI z)_resolve_uv_job_config..s>CT#<>rc3&K|] }d| yw)zsecrets.Nr{rs rIrz)_resolve_uv_job_config..sFXcU+Frrrc3&K|] }d| yw)zlabels.Nr{rs rIrz)_resolve_uv_job_config..sDsWSE?Drc3&K|] }d| yw)zvolumes.Nr{)rspecs rIrz)_resolve_uv_job_config..sMXdV,MrrMr@)rdrfrgrhrirjr@rkrlrmrnrorLrprq rhrjr@rlrmrorkrpextra config_parts)!r>rr=rzrvrprr3rlitemsupdate_parse_secrets_map_resolve_script_secretsrm_parse_labels_maprnr_merge_volume_specsrLrcrdrarrf_name_hash_partsrhrjr@rorkrgrri)#rMrdrfr|rgrhrirlr}rmr~rjrrrr`r@rkrprrZrenv_maprvalue script_env secrets_mapscript_secrets labels_map script_labelsroscript_volume_specsconfigrqrs# @@rI_resolve_uv_job_configrsYD  U62."2 #  c cDj S4Z We$h'h'y'*i0 _m< 6#9#9 OO- .$44OX.39::3C3C3E\ZS%T[I[c5j\ \>:>>+Z+7+(,P 0V]^F~FF77;7 &u48>B g6==gfkkF]ffkk-Bceg 6C6I6I6Ke UsZdOdee eDmDD4 44 ,? "fnn,]) )M9LMM==#)r'%#D)D\WZfo)p+1r#! $  &%B""-!=="NN$.. "NN!'!4!4"("6"6$*$:$: 8(8 +',".6-A3x=/r %FMM& !( kUU2]fKUUsI L7C L+ L)L.B3L+! L%.L%3E#L+ L7 L++L40L7Frct||}|xsgDcgc]}d|vs|jx}|vs| }}|r&|s$tddj|d|ddi|tj |Scc}w)a7Parse `--secrets`/`--secrets-file`, failing if a bare `--secrets NAME` is not set locally. Same behavior as for the secrets requested by a script (see `_resolve_script_secrets`): a missing secret is an error rather than silently dropped, except in `--dry-run` where it is displayed as ``. =z9The following secret(s) are not set in your environment: , $. Export them locally (e.g. `export r)=...`) or use `--secrets-file` otherwise.)r3striprjoinryfromkeys)rmr~rrrrmissings rIrr%s 6K!(Br#U2BPUP[P[P]H]fqGqtrGrwG RYHZG[\229!*=f h   5k 4T]]73 44 ss A;A;A;names cli_secretsc l|siSt}i}g}|D]%}||vr||vr ||||<|j|'|r&|s$tddj|d|dd|r6t j dt ddj|d|rd nd d i|tj|S) 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: rrrrzThe script's [z] table requests z+: the value(s) from your local environment zwould bezwill bez sent to the Job.) r0r\rrr;warningr<ryr)rrrenvironresolvedrrs rIrr7s  #%G&(HG! ;   7?$T]HTN NN4 !wbcgclclmtcubvw229!*=f h   ZL(9$))H:M9NO*1JyAAR T  2h 1$--0 11rK cli_specs script_specsc|Dchc]}t||d}}|Dcgc]}t||d|vs|}}||z|fScc}wcc}w)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$r )rrrcli_mount_pathskepts rIrr^se DMM4|Dd3A6MOM) dT\$D-I!-LTc-cD dD d ) T !!N dsAA A )rkrprrorc |xstjj|xsd|xsd|xsdg|xsgdt|j Dt|||xsgS)aThe 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. rc30K|]\}}|d|yw)rNr{)rrrs rIrz#_name_hash_parts..s AzsESE5'  As)r CPU_BASICrsortedrrs rIrrhs& -+''-- 2R  +2  BVCIIK-@ A       R  rKz (from script)r{rqrvaluesrqc |jDcgc]\}}|ddgidfvr|t|||f}}}td|D}dg}|D]`\}}|||vrtndz }|t |j dD cgc]#\}} d|dk(r|ndj |d| %c} }z }bdj|} |rtj| d ytj| ycc}}wcc} }w) adEcho 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. NrFc38K|]\}}t|ywN)len)rr_s rIrz%_print_job_summary..s,VS!C,szJob configuration:  rz (dry run) Job not submitted.) r_format_job_valuemax _FROM_SCRIPT enumeraterFljustrr;textlog) rrqrrrrowswidthlinesindexlinesummarys rI_print_job_summaryrs!,,.  C r2r51 1 UK89 D  ,t, ,E ! "E U  !3; W`afalalmqarWs HStb!#2259:"TF C   iiG G9:;< #  s "C5(C; rrcxdk(rBi}|jD]+\}}|xsd}|dt|dkDr|dddzn|||<-nxdk(r.|jDcic]\}}||d|d nd }}}nPxd k(r*|jDcic] \}}||d|}}}n!d k(r|Dcic]}||}}n t|Sd jfd|jDScc}}wcc}}wcc}w)zVFormat config entries, redacting secrets and marking values inherited from the script.rlrr<N;u…rmz***z rnrLrc3LK|]\}}|d|vrtndzyw).rN)r)rrrrqrs rIrz$_format_job_value..s1wYcY]_cTuAdV_ -K\QSTws!$)rrrvr)rrrqentriesritemrrs` ` rIrrs! G#kkm Z dzr#'&s4y2~$s)e*;SW)X Y  ZfkfqfqfstXbX\^btvQ0@uk&RSStGt @E N*$tvQtf--NGN .34dtTz4G4 u:  99wgngtgtgvw wwuN4s$C7C=5 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_typez-lz--labelz3Set labels. E.g. --label KEY=VALUE or --label LABELz--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 --attemptsz9Maximum attempts, including the first run. Defaults to 1.)minrz-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--expose-publiczExpose a container port through the jobs proxy without authentication. Repeat the flag for multiple ports. No need to also pass the port with `--expose`.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 concurrentlyz]One 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.jobc tj}tj} |jjt j k(rtdD]m}|j|jjxsddtttj|z dtjdo|j|j|jj }|jjt j k(r|jdy#t"j$$rY'wxYw#|jdwxYw) z[Wait while the Job is scheduling, showing why (e.g. waiting for hardware) and for how long. Scheduling ()r$r?r@rN)r;statustime monotonicstager SCHEDULINGrangermessager"intsleep inspect_jobidownerrhttpx2 HTTPError)rMrrstartrs rI_wait_while_schedulingrs ZZ\F NN E jj("5"551X  zz))9\:"_SQUQ_Q_QadiQiMj=k>/JC jj("5"55  b        bs$C:D77E  E E  EE#c  t|||j|j|jjdD]}t j ||j|j|jj}|jjtjk7rc|jjrd |jjnd }td|jd |jjd |t j d|jd y#t$rF|jjd|j}t jd|d|d|dwxYw)zcStream Job logs until the Job ends, then fail the command if the Job did not complete successfully.Tr?r@followrrCzJob z( was not canceled. Use `hf jobs logs -f z)` to follow it again, or `hf jobs cancel z` to cancel it.z: rz finished with stage 'rDz completedN)rfetch_job_logsrrrr;r wait_for_jobKeyboardInterruptrYrrr COMPLETEDrr)rMrrfinaljob_refrs rI_stream_logs_and_check_statusrsU sC(%%SVVsyy~~VZ%[ C HHSM   #)).. I ||X///161E1EBu||++,-2ehhZ'=ell>P>P=QQRSZR[\]]HHtEHH:Z () YY^^$AcffX. 7)CG9M##*)? <   s B D99AFdetachc|jjd|j}t|jj t rDdjd|jj D}tjd|t|jjtrtjd|dt|jtr2|jj}tjd|d|d |r6tjd |d |d tjd |dyt||y)zZPrint hints about how to reach a started Job, then stream its logs unless `detach` is set.rCrc3&K|] }d| yw)rNr{)rurls rIrz._hint_or_follow_started_job..sF2cUFrz Exposed ports are reachable at: zUse `hf jobs ssh z&` to open an SSH session into the job.zJoined network group 'zK'. Jobs of this namespace and resource group started with `--network-group z` reach each other at `$HF_NETWORK_GROUP_HOSTNAME` (every member) or `${HF_NETWORK_GROUP_PREFIX}` (members claiming an alias).Use `hf jobs logs -f z&` to stream logs, or `hf jobs inspect z` to check status.zUse `hf jobs wait z` to block until it finishes.N)rrr isinstancer expose_urlsrxrr;rYssh_urlrvnetworkrgroupr)rMrrrurlsrs rI_hint_or_follow_started_jobrs #&&*G#**(($/yyFszz/E/EFF 4TF;<#**$$c* $WI-STU#++z* !! $UG, %w'R R  ( 1WX_W``rst %gY.KLM!#s+rKrunignore_unknown_optionsT)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)context_settingsexamplescommandexpose expose_publicssh network_aliasresource_group_idtokenformat json_outputquietcjt|||t||}t||| }t||xsi}|j dt ||t | | | t| gnd||||xsg|| t|}| rdn t|||}tid |d tj|d | xstjjd | d | d|d|d|xsgd|ddjd|xsgDddjd|xsgDd|d|ddj|xsgd|d|| | ry|j!||||||| | | |||||||}t#j$d|j&|j(xsij+d|j,t/||s\|j(xsij+d}t#j0d|d |j2j4d!|j&d"t7||| #y)$z Run a Job.rrrN) rhrjrr@rlrmrorkrprrrrgrrhrjrrlrmrLrnrrRc32K|]}t|ywrrvrports rIrzjobs_run..#BTs4yBrc32K|]}t|ywrr%r&s rIrzjobs_run..$%PDc$i%Pr)rrkrprr@)rgrrlrmrnrLrhrjrrrrrkrprr@ Job startedrrr Job auto-named '('. Pass `--name` or run `hf jobs labels rC --name NAME` to rename it.r)r5r3rr setdefaultrrrvr2rarshlexrrrrrun_jobr;r]rrngetr _has_explicit_namerYrrr) rgrrlrmrrr`r}r~rhrjrrrrrrrkrrr@rrr r!rrrrMrLr auto_names rIjobs_runr8sNfk51C*G$WlGLK"5t4:J$  ))1)=s8}o4###\r+ -  & 5 !Cd#>v3Zc#dG U uzz'*  f; 5 5 ; ;  w    7   {  v|  j  chhBV\rBB  SXX%PMzhf jobs logs -f zhf jobs logs --tail 20 z#hf jobs logs -f --tail 100 )rrz-fz--followzqFollow log output (stream until the job completes). Without this flag, only currently available logs are printed.tailz-nz--tailzvNumber of lines to show from the end of the logs. When combined with --follow, starts streaming from the last N lines.ct||\}}t|}|j||||}|D]}tj||r|d|n|}|rtj d|dytj d|dy) 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#)r?r@rr:rC#Stream ended. Run `hf jobs inspect 6` to check the final status (e.g. COMPLETED or ERROR).z2If the job is still running, use `hf jobs logs -f z(` to stream new logs until it completes.N)rJr2rr;rrY) r?rr:r@rrMr9rrs rI jobs_logsr>KsN5VYGFI 5 !C   VyVZ  [D  )2 1VH%G  6wi?uvw @ Iq r rKncFd}d}t|D]}t||y)Nzz)end)rprint)r?LINE_UP LINE_CLEARis rI _clear_linerFs)GJ 1X' g:&'rKmetrics table_headersc ||ddt|ddz dtd|dz|dz d dt|dd t|dd t|d d t|ddg}|drt|dtr|gt t |ddz Dcgc]}dgt |zc}z}t |t|dD]R\}}|d|}||ddtd|dz|dz d dt|dd t|dd gz }T|S|dgt |t |z zz }|gScc}w)N cpu_usage_pct%cpu_millicoresg@@r$dmemory_used_bytesmemory_total_bytesrzB / Brx_bpszbps / tx_bpsbpsgpusr utilizationN/A)roundrr ryrrzipr)r?rGrHrowrrgpu_idgpus rI_format_job_stats_rowsr\s ? # $A& g&'&0!4 w233g>R6SSUV W XXYZ  34 5 6d<PdHe;f:gghi ) * +6,wx?P2Q1RRUV Cv:gfot<'*ecRYZ`RaNbefNfHg.h1tc#h.h&htVGFO%<= KC&/&)C }%&a(s#677#>R:SSUVWXXYZ$7 89:$|CPdLe?f>gghi C  E7c-(3s83 44C 5L/is*Emetrics_streamc#LK|D]}d|t|||fd|gfyw)NFT)r\)r?r]rHrGs rI_get_jobs_stats_rowsr_s="TV3FG]SSST  "$stats)z hf jobs statszhf jobs stats zhf jobs stats -f job_idsziFollow stats output (live view until the Jobs complete). Without this flag, a single snapshot is printed.c |rHtjtjk7r't dtjj d|+g}|D]"}t |\}|j|$|}t|jd|OjDcgc]4}|jr|jjnddvr |j6}}t|d k(r+tjgtj d ygd }|sbd t"d t$t"t&fdzffd }t(j*j-t|5} | j/||} dddg} t1| D]6\}} | tj2d|d"| jd |i| 8tjtjk(r|| rz| D cgc]} t5| d | |D]}|}} }tj6t9||dj;fd| D}tj d|dytj| d yt(j*j-t|5} i}|D]+}|g}||ddDcgc]}d|vsd|vrdndc}z }|g||<-t=j<}|Dcgc]}||D]}|}}}t?t9|||Dcgc]}|jA|d|d}}tC| tD|D]\}}}|r|jG|dn|||<t=j<}||z tHk\sBtKd t|z|Dcgc]}||D]}|}}}t?t9|||} ddddj;fd!|D}tj d"|d#ycc}w#1swYxYwcc}} wcc}wcc}}wcc}wcc}}w#1swYkxYw)$zFetch the resource usage statistics and metrics of Jobs. By default, prints a snapshot of the current stats and exits (non-blocking). Use --follow/-f to display live stats until the Jobs complete. zD`--follow` displays a live terminal view and is not supported with 'z3' output. Run without `--follow` to get a snapshot.Nr#r)r@UNKNOWN)RUNNINGUPDATINGrzHNo running jobs. Use `hf jobs ps -a` to list finished (and failed) jobs.) zJOB IDzCPU %zNUM CPUzMEM %z MEM USAGEzNET I/Oz GPU UTIL %z GPU MEM %z GPU MEM USAGEr?rAcPttj|dS)Nr)nextiterfetch_job_metrics)r?rMr@s rIfetch_latest_metricsz(jobs_stats..fetch_latest_metricss&S22&I2VWY]^ ^rKzNo stats available for Job z. Is it running?)headersrRc32K|]}d|dyw)rCr?Nr{)rrr@s rIrzjobs_stats..s!RD9+QtH~.> ?RszUse `hf jobs stats -f z` to follow live stats.id_keyr$rCUSAGEz-- / --z--Tr)r?r]rH) kwargs_listrc3,K|] }d| yw)rCNr{)rr?r@s rIrzjobs_stats..sFF9+Qvh/Fsr<r=)&r;moder9humanrrrJr\r2whoami list_jobsrrrrtablerYrvryrmultiprocessingpool ThreadPoolmaprXrr\r _tabulaterrrBrjiflatmap_unorderedr_popSTATS_UPDATE_MIN_INTERVALrF)rbrr@r parsed_idsr?rrHrkrylatest_metricsrrGrrYrjob_refsrows_per_job_idrlast_update_time total_rowsrqdonenowrMs ` @rI jobs_statsrs4#((l000RSVS[S[SaSaRbc9 9    &F  ,F$*8C ^klmln^opTZ#-7f3DI4Op pC'*eOF # , 99;(7[f?SYCZ[Cc[c[ [ i M:;"   !"%"7"7vQZcg"7"h!.   #5T;O]h"i ' D&$##FD1*.'))+C%%)BBAJ/00?cf?[aKbcCcccc ci MBC#&  ')'>xxFgFFHHH28*.^sVTDJJLVs--,NrInvalid label filter '"': must be in the form 'key=value'r6Cannot filter by both `--name` and `--label name=...`.)r@rrnFrr$T durationsrrrr?rnrV docker_image image/spacerR created_atTcreatedrrrd running_secsruntime)r?rrrrrrrlrozOutput truncated to z4 Jobs. Use `--limit 0` to show all (or `--limit N`).rc3&K|] }d| ywzstatus=Nr{rss rIrzjobs_ps..7QWQC=7rc32K|]\}}d|d|ywzlabel=rNr{rkvs rIrzjobs_ps..$:gPTPQSTVA3as;K:gr)zNo jobs matched filters: zHNo running jobs. Use `-a`/`--all` to include finished (and failed) jobs.)r2rrUrFrrerrrvrx itertoolsislicerr:r5rreplacer"r\r;rwrYrr)rrrrrr@rrM raw_statusesrserver_statusesrnrr jobs_iter truncatedjobs job_itemsrjob_itemrcmd filters_msgs rIjobs_psrs6t 5 !C vIJJ!L2WVU[[5EVVW& #++1183F3F3L3LM F  d?3D69[\] ]ZZ_ Us   V ST Tv /RXR`\` aII qyI$$Y :; t9u I"G%/2chhsmOW||\hOih|4Sb9AA#sKot&ll84:??S-immN.KL" #II\  'w.bcd  6))h7,7h:gX^XdXdXf:ghK HH0 > ? HH_ ` rKhardwarezhf jobs hardwarec ^t}|j}g}|D]}d}|jrG|jjd|jjd|jj d}|j rd|j dnd}|j rd|j dzd nd}|j|j|j|j|j|j|||d tj|tjd y ) z(List available hardware options for Jobsrzx rr$z.4ffreerz.2f)rz pretty namecpuramstorage acceleratorzcost/minz cost/hourzLUse `hf jobs run --flavor ...` to request a specific hardware flavor.N)r2list_jobs_hardwarerquantitymodelvram unit_cost_usdr\r pretty_namerrephemeral_storager;rwrY)rM hardware_listrhwaccelerator_infocost_min cost_hours rI jobs_hardwarers ,C**,M E  >>"$.."9"9!:"R^^=Q=Qz*Job IDs to inspect (or 'namespace/job_id')c Lg}|D]"}t||\}}|j|$|}t|}|Dcgc]}|j||}}t j |Dcgc]"}t t||j$c}dycc}wcc}w)z0Display detailed information on one or more Jobsr#rrnrrnN) rJr\r2rr;rw _surface_namer:rn)rbr@rrr?rMrrs rI jobs_inspectrsJ"8K &!"G 5 !CNU VFCOO6YO ? VD VIITXYS}/4SZZHYbfg WYs B+'B!rerunzhf jobs rerun zhf jobs rerun --detach ct||\}}t|}|j||}tjd|j |j xsijd|jt|||y)z*Run a new Job with an existing Job's spec.r#rr,rr-r1N) rJr2 rerun_jobr;r]rrnr5r r)r?rr@rrMrs rI jobs_rerunrsn5VYGFI 5 !C --v- ;CJJ}szz/?R.D.DV.LRURYRYZS8rK)zhf jobs expose 8000z*hf jobs expose 8000 --public 9000zhf jobs expose --clearportszlPorts to expose through the jobs proxy. Access requires an HF token with read access to the job's namespace.publicz--publiczExpose a port without authentication. Repeat the flag for multiple ports. No need to also pass the port as a positional argument.clearz--clearzClose all exposed ports.c&|r|s|r td|s|s |s tdt||\}}t|}|j||||}t j d|j |jxsg|jxsgy)z'Replace exposed ports on a running Job.z6`--clear` cannot be combined with ports or `--public`.zKPass at least one port or `--public` port, or `--clear` to close all ports.r#)r?rrr@zExposed ports updated)rr public_portsN) rrJr2update_job_exposer;r]rrr)r?rrrr@rrMrs rI jobs_exposers8 %6OPP vdee4VYGFI 5 !C  ve6]f  gCJJ&3669IrX[XiXiXomoprKcancelzhf jobs cancel ct||\}}t|}|j||tjd|y)z Cancel a Jobr#rz Job cancelledrN)rJr2 cancel_jobr;r])r?r@rrMs rI jobs_cancelr s=5VYGFI 5 !CNN&IN6JJ6*rKwait)zhf jobs wait z"hf jobs wait z"hf jobs ls -q | xargs hf jobs waitz,Job IDs to wait for (or 'namespace/job_id').zTMax time to wait: int with s (seconds, default), m (minutes), h (hours) or d (days).c *g}t}|D]3}t||\}}|j||j|5t |dkDr3t ddj dt|tDz|j}| t|nd} t|} tjdt |d } | j|| | } | j!t | dtj"| D cgc]C} | j$t| jj&| jj(dEc} | D cgc],} | jj&t*j,k7s+| .}} |r.>sFBBFr))rNr#z Waiting for z Job(s) to finish...)rjr@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: c3hK|]*}|jd|jjd,yw)rrN)rrr)rrs rIrzjobs_wait..Qs,KS366("SZZ%5%5$6a8Ks02)rzrJr\rrrrrrvr~r#r2r;rr TimeoutErrorrrwrrrrr)rbrjr@rr namespacesr? parsed_idparsed_namespace timeout_secsrMrrrfaileds rI jobs_waitrs>JJ)&B69&U# #)$'() : >iiF&*EFF G   I.5.A>'*tL 5 !C ZZ,s:&77KL MF] LIV KK3t9+./0IIhlmadcffs3::+;+;'<I[I[\mn! LcSZZ%5%59K9K%Kc LF L 6{m4D {*Q RiiKFKK L   ] L!)'2PQRX\\] n LsGAH +,HH+Hrn)z*hf jobs labels --name training-v2z8hf jobs labels --label env=prod --label team=mlzhf jobs labels --clearzRemove all labels from the job.c|s| |s td|s| |r tdt||\}}t|}|,|s*|j||jxsi}i|d|i}nt ||xsi}|j |||} tjd | j|jd y) 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)r?rnr@Labels updatedrr) rrJr2rrnrupdate_job_labelsr;r]rr5) r?rrrr@rrMcurrent_labelsrnrs rI jobs_labelsrUs" T\% s   !u z  5VYGFI 5 !C )LSSYWY1N1FD1"5t4:  vf  RCJJCFFF1CDrK)zhf jobs ssh zhf jobs ssh --dry-runz)hf jobs ssh -i ~/.ssh/id_ed25519 identity_filect||\}}t|}|j||}|jj t d|jj tvr0t d|jd|jj d|jj tjk7rtjd|jd |jj d }|j|j|tjg }|jj tjk7rA|jd t d|jd |jj d|jdt|jj}t|j d|j"|j$||y)a SSH 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')...)r?r@stagesz Job finished.z1': job finished before reaching RUNNING (stage: 'zJob is running.@)r'rr)rJr2rrrrrrrrrer;rrrr1usernamehostnamer') r?rrr@rrMrrrs rIjobs_sshrzs*5VYGFI 5 !C //9/ =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 \\# rKzFRun UV scripts (Python with inline dependencies) on HF infrastructure.uvr)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.pywith_ct|||t|}td+id|d|d|d|d|d|d|d |d | d |d | d | d| d|d|d|d|d|d|d|5}tid|dt j |j ddj |xsgd|jxstd|jxstjjd|jd |jd| d |jd |j d|j"d|j$ddj d|xsgDddj d|xsgDd|d|j&ddj |j(||j*d |j,|!|r d"d"d"y"|j/|j0|j ||j|j|j|j |j$|j2|j|j| ||||j&|j(xsd"||j*#}d"d"d"t5j6d$j8|j$xsij;d|j<%t?||j,s\|j$xsij;d}t5j@d&|d'|jBjDd(|j8d)tG||| *y"#1swYxYw),8Run a UV script (local file or URL) on HF infrastructurer#rMrdrfr|rgrhrirlr}rmr~rjrrrr`r@rkrprargswithrRrLrnrc32K|]}t|ywrr%r&s rIrzjobs_uv_run.."F3t9"Fr)rc32K|]}t|ywrr%r&s rIrzjobs_uv_run..)T#d))Tr)rrr@rN)rdrfr|rirgrlrmrnrLrhrjrrrrrkrprr@r,r-r.r/rCr0r1r{)$r5r2rrr3rrfrgrrhrrrrirjrlrmrornrkrpr@rq run_uv_jobrdrLr;r]rr5r r6rYrrr) rdrfrgrhrlrmrrr`r}r~rjrrrrrrrkrrr@rrrirr r!rMrrr7s rI jobs_uv_runrsVfk51 5 !C                    "      ! "# $$% &&' () E *  &  6#5#56 "- 9)9   &--F;+@+@+F+F   &--  6>> H vzz 6>> 6.. &-- #(("F2"FF  )T @SQS)T!T s   !5!5! ""388F,B,B#C# $&7#--' ***/ 2  aE E bnn==**==,, NN==NN==NN' .."22:d/&&' cE LJJ}szz/?R.D.DV.LRURYRYZ dE6+=+= >ZZ%2**62  yk*"yy~~.ax7R T  S8[E E sEL?B*L??MceZdZdZdZdZy)ScheduledJobStatusFilterzPossible 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 suspendedN)rrrsrtruACTIVE SUSPENDEDr{rKrIr r )s FIrKr z,Create and manage scheduled Jobs on the Hub. scheduledzRhf jobs scheduled run "0 0 * * *" --name daily-script python:3.12 python script.pyschedulesuspend concurrencyct|||t|| }t|| |}t||xsi}|j dt ||t | | | t|gnd|||| xsgt|}|rdn t| ||}tid |d |d |d |d tj|d| xstjjd| d|d|d|d| xsgd|ddjd|xsgDddjd|xsgDd|d|||ry|j!|||||||||| | |||||}t#j$d|j&|j(j*xsij-dt/||sf|j(j*xsij-d}t#j0d|d |j2j4d!|j&d"t#j0d#|j2j4d!|j&d$y)%zSchedule a Job.rrrN)rhrjrr@rlrmrorr#rrrrrgrrhrjrrlrmrLrnrrRc32K|]}t|ywrr%r&s rIrz scheduled_run..|r(r)rc32K|]}t|ywrr%r&s rIrz scheduled_run..}r+r)rr@)rgrrrrrlrmrnrLrhrjrrrrr@Scheduled Job createdrScheduled Job auto-named '2'. Pass `--name` or run `hf jobs scheduled labels rCr0Use `hf jobs scheduled inspect ` to view its details.)r5r3rrr2rrrvr2rarr3rrrrcreate_scheduled_jobr;r]rjob_specrnr5r6rYrr)rrgrrrrlrmrrr`r}r~rhrjrrrrrr@rrr r!rrrrMrL scheduled_jobr7s rI scheduled_runr7s@fk51C*G$WlGLK"5t4:J$  ))1)=s8}o4###\r " 5 !Cd#>v3Zc#dG  w  ;  U  uzz'*  f; 5 5 ; ;   w    7  {  v|  j  chhBV\rBB  SXX%PM.s+^TQUQ[Q[Q]DJJL..0^s;#;rzInvalid status filter(s) z: expected one of rTrrrr$Nrr)r@rnFrrlast_jobrrnrVrrrRatrrlast_runnext_job_run_atnext_runr)rrrrrr#r%rrrrc3&K|] }d| ywrr{rs rIrzscheduled_ps..$rrc32K|]\}}d|d|ywrr{rs rIrzscheduled_ps..$rr)z#No scheduled jobs matched filters: zENo active scheduled jobs. Use `-a`/`--all` to include suspended ones.rrz(` to view details about a scheduled job.zUse `hf jobs scheduled trigger z)` to trigger a scheduled job immediately.)r2rrUrFtupler rr r list_scheduled_jobsrr\r:r5rrr;rwrrrY)rrrrr@rrMrrrunknown_statuses show_activeshow_suspendedrn raw_labelrscheduled_jobs filtered_jobsrrrsjrr status_dictr!rr first_item_ids rI scheduled_psr3sp 5 !C vIJJ!L2_^U[[=M^^_$0\a1EBZ<[3[\\'(8'9:":;Q;`ab b__S!, Us   V ST Tv,,ySW,XNM', ''05 > { ]+ ,#%E!"%88J'-2hhx(.B ??:.ll9%+ X.4"99&AJUV &ll>:Ce]+.#((3-EYDLQYQ]Q]^bQc8D>#2.66sC@inZEP__UfEgK) *3B / 7 7S Amr Z((9-6Y T II g  6))h7,7h:gX^XdXdXf:ghK HH:;-H I HH\ ] a  2=/Aijk 2=/Ajkl M]scheduled_job_idsz>Scheduled Job IDs to inspect (or 'namespace/scheduled_job_id')c `g}|D]"}t||\}}|j|$|}t|}|Dcgc]}|j||}}t j |Dcgc],}t t||jj.c}dycc}wcc}w)z:Display detailed information on one or more scheduled Jobsr#scheduled_job_idr@rrrnN) rJr\r2inspect_scheduled_jobr;rwrr:rrn) r4r@rrr?rMr7r.r0s rIscheduled_inspectr9/sJ#"8K &!"# 5 !C!2  !!3Cy!YNIIZhiTV}/3BKKr7ct||\}}t|}|j||tjd|y)zDelete a scheduled Job.r#r6zScheduled Job deletedrN)rJr2delete_scheduled_jobr;r]r7r@rrMs rIscheduled_deleter>HF#??OQZ"[i 5 !C.>)TJJ&+;ct||\}}t|}|j||tjd|tj d|dy)z Suspend (pause) a scheduled Job.r#r6zScheduled Job suspendedrzUse `hf jobs scheduled resume z` to resume it.N)rJr2suspend_scheduled_jobr;r]rYr=s rIscheduled_suspendrBUs^#??OQZ"[i 5 !C/?9UJJ(-=>HH-.>-? OPrKresumezhf jobs scheduled resume ct||\}}t|}|j||tjd|y)z!Resume (unpause) a scheduled Job.r#r6zScheduled Job resumedrN)rJr2resume_scheduled_jobr;r]r=s rIscheduled_resumerFcr?rK reschedulez-hf jobs scheduled reschedule "0 9 * * 1"c.t||\}}t|}|j|||}tjd|j |j tjd|jjd|j dy) z!Change when a scheduled Job runs.r#)r7rr@zScheduled Job rescheduled)rrrrCz` to see its next run.N) rJr2update_scheduled_job_scheduler;r]rrrYrr)r7rr@rrMrs rIscheduled_reschedulerJps#??OQZ"[i 5 !C + +=MX`lu + vCJJ*svv MHH.syy~~.>axG] ^_rKtriggerzhf jobs scheduled trigger c,t||\}}t|}|j||}tjd|j |j tjd|jjd|j dy) zJTrigger a scheduled Job to run immediately (does not change the schedule).r#r6zScheduled Job triggered)rr r rCz` to stream logs.N) rJr2trigger_scheduled_jobr;r]rr rYrr)r7r@rrMrs rIscheduled_triggerrNs|#??OQZ"[i 5 !C # #5EQZ # [CJJ(SVVAHH$SYY^^$4AcffX=N OPrK)z1hf jobs scheduled labels --name daily-scriptz>hf jobs scheduled labels --label env=prod --label team=mlz%hf jobs scheduled labels --clearz)Remove all labels from the scheduled job.c|s| |s td|s| |r tdt||\}}t|}|6|s4|j||jj xsi}i|d|i}nt ||xsi}|j|||} tjd | j|jd y) zpUpdate labels on a scheduled Job. Passing --label replaces all existing labels; passing --name alone keeps them.Nrrr#r6rr)r7rnr@rr) rrJr2r8rrnrupdate_scheduled_job_labelsr;r]rr5) r7rrrr@rrMrrnrs rIscheduled_labelsrQs" T\% s   !u z  #??OQZ"[i 5 !C   % %7GS\ % ] f f m m sqs 2N1FD1"5t4:33)&I4MJJM$4$46::f;MNrKz)Schedule UV scripts on HF infrastructure.zBhf jobs scheduled uv run "0 0 * * *" --name daily-script script.pyzj,xsijAd)tC| | j0sf|j>j,xsijAd}t9jDd*|d+|jFjHd,|j<d-t9jDd.|jFjHd,|j<d/y#1swY xYw)1rr#rMrdrfr|rgrhrirlr}rmr~rjrrrr`r@rkNrprzjScheduled Jobs do not support network groups: remove 'network_group'/'network_aliases' from the script's [z] table to schedule it.rrrrrrRrLrnrc32K|]}t|ywrr%r&s rIrz#scheduled_uv_run..rr)rc32K|]}t|ywrr%r&s rIrz#scheduled_uv_run..rr)rr)rdrfrrrr|rirgrlrmrnrLrhrjrrrrr@rrrrrCr0rrr{)%r5r2rrkrprr<rr3rrfrgrrhrrrrirjrlrmrornr@rqcreate_scheduled_uv_jobrdrLr;r]rrr5r6rYrr)rrdrfrrrgrhrlrmrrr`r}r~rjrrrrrr@rrrirr r!rMrrr7s rIscheduled_uv_runrVs Lfk51 5 !C                    "      ! "# &' () *+ K ,    6#9#9(\)@B   H 7 { &    6#5#56   "-  9)9 &--F;+@+@+F+F &-- 6>> H vzz 6>> 6.. &--  #(("F2"FF! " )T @SQS)T!T# $&7#--' ***/ 2  mK K n))==**#==,, NN==NN==NN'/&&'* oK XJJ&3669L9L9RPR8W8WX^8_` dE6+=+= >\\((.B33F;  ( 4)),(8#&&A\ ^ HH.syy~~.>axG] ^_gK K sE!M$ BM$$M.rc@|xsijd}||Sd|i|S)aPromote 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)r5)rrnrs rIrr;s2 Lb  f %D | D !D !!rKcF|duxsd|vxstd|xsgDS)zlWhether the Job was named on purpose: via `--name`, a `name=` label, or the script's `[tool.hf-jobs]` table.Nz labels.namec3LK|]}|jddddk(yw)rr$rrN)rF)rrs rIrz%_has_explicit_name..Ls%G4tzz#q!!$.Gr`)any)rrrqs rIr6r6Gs7 D H K ' H G5;BG GrKc|s|yi}|xsgD]$}d|vr|jddn|df\}}|||<&|d|vr td||d<|S)aParse 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. Nrr$rrz4--name and --label name=... cannot both be provided.)rFr)rnrr label_varrrs rIrrPs} dl!#J\r 03y0@Y__S!,yRTo U 3   Z QR R! 6 rKrrlc tg||Dcgc]}td|D}}ttjjt |dz}t |t |z|kDr|jt|}||xxdzcc<t |t |z|kr#|t |z t |z ||z||<t |t |z|kDrdt |zj|}g}|j|j||j|j|Dcgc]}d|z c}|D]r} t| |D cgc];\} } t t| | kDrt| d| dz dzn t| =} } } |j|j| td j|Scc}wcc}wcc} } w) z Inspired by: - stackoverflow.com/a/8356620/593036 - stackoverflow.com/questions/9535954/printing-lists-as-tabular-data c3DK|]}tt|ywr)rrv)rxs rIrz_tabulate..ms/ac#a&k/s  rz{{:{}}} -Nz...r) rXrshutilget_terminal_sizecolumnsrsumrrr\rvr) rrlcol col_widthsterminal_widthcol_to_minimize row_formatrwrYr_ col_widthrow_format_argss rIr|r|fs 9$**3z?;?#)# w<#j/ )^ ;*83z?*JSQX\*Y\fgv\w*wJ ' g,Z (> 9 4*s7|+33Z@J E LL"""G,- LL"""j$AS1W$ABC:!$C 4 9033q6{Y/FCF?Y] #e +CPQF R    &Z&&89 : 99U #P%B sG* G/ 6AG4rqueuefunc.kwargsc@|di|D]}|j|y)Nr{)put)rorprqr]s rI_write_generator_to_queuerts#.. &rKryrqc #6Kt}|Dcgc]}|jt|||f}} |jdcc}w#t$r't d|Dr|j rYnY5wxYwn#t$rYnwxYw |Dcgc]}|jdncc}wc}y#tj$rYywxYw# |Dcgc]}|jdncc}wc}w#tj$rYwwxYwxYww)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 g?)rjc3<K|]}|jywr)ready)r async_results rIrz%iflatmap_unordered..sN |))+NsN) r apply_asyncrtr5r remptyrrxr)ryrprqrorq async_resultsrxs rIr}r}sgEfqr\bT%%&?%vAVWrMr iii--s  N NNSXS^S^S`      @M N \  d  + N N++    @M N \  d  + N N++   sD A DBA B D+B;B?BBC B CBCB;B21 B;:D;CDCDDC=C43 C=<D=DDDDD)NNNNNNNNNNFFNNFNNNNNNFF)FNNN)NFNN)FNNNrMNN)rAN)NN)FNN)NNFNN)NNN)NNNNNNNNNNNNFFNNFNNNNNNNNFF)NNNNNNNNNNNNFNNNNNNFF)FNNNNN)NNNNNNNNNNNNNNFNNNNNNNNFF)r{)rurrxmultiprocessing.poolr3rcrcollections.abcrrrr contextlibr dataclassesrr enumr pathlibr ror r typingrrr urllib.parserrhuggingface_hubrrrrrrrhuggingface_hub._jobs_apirrrrhuggingface_hub.errorsrhuggingface_hub.utilsr$huggingface_hub.utils._cache_managerrhuggingface_hub.utils._hf_urisr!huggingface_hub.utils._parsingr"r# _cli_utilsr%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6 _frameworkr7r8_outputr9r:r;_uv_script_headerr<r=r> get_loggerrrloggerrvr(rJrxrarcrboolrryrrrrrrrrImageArgImageOpt FlavorOpt LabelsOptNameOpt TimeoutOpt AttemptsOpt DetachOpt DryRunOpt NamespaceOptResourceGroupIdOpt ExposeOptExposePublicOpt SshEnabledOptNetworkGroupOptNetworkAliasOptWithOpt PythonOpt SuspendOptConcurrencyOpt ScheduleArg ScriptArg ScriptArgsArg CommandArgJobIdArg JobIdsArgScheduledJobIdArg JobVolumesOptjobs_clirrrrr8r>rFr\r_rrrrrrrrrruv_app add_grouprr  scheduled_apprr3r9r>rBrFrJrNrQscheduled_uv_apprVrr6rr|rrtryrzr}r{rKrIrs)G EE%(**! ``` ,)=7J()::II   H %..t.cSVY]S]oH^.8) #Y )',)9 RTejtCH~z#^bos6x3xsxCxSx(   '  $J =  $J rk*   I   B   $J v $J _ $J  d  c   ?AmLMAmN OAmP QAm AmHy,L+MN#x  S Q  xx x xOx0x+J*KL# =' = =  = =M =y,L+MN# Q' Q Q  Q QO Qx+J*KL# =' = =  = =M =|/^._`# `' ` ` `  `  `a `y,L+MN# Q' Q Q  Q QO Q bg" O'O O O T6)2]^^ _ O  O  O OOB!&QR (t4 .5LF"&"& #' %),0" 7s`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`2 3s`45s`6 7s`8 9s`s`r "S#X "4S>D3H "TRUWZRZ^ "S4ZS D0@zZ]hlGKd3i$.ttTWY\T\~`dOd,DcCi)DI#6 CLU1XXc8A;>N5OY]bf     ) ) 3 # $d  a[ rK