5pj\SSKrSSKrSSKrSSKJr SSKJr SSKJr SSKJ r SSK J r SSK J r SSKJr SS KJr "S S \\5r"S S \\5r\R*\R,\R.\R04rSr\"SS55r\"SS55r\"SS55r\"SS55r\"SS55r\"SS55r \"SS55r!\"SS55r"\"SS 55r#\"S!S"55r$\"S#S$55r%S%\\ -S&\4S'jr&S(\S&\4S)jr'S*\(\S&\4S+jr)S,\S-\(\S&\4S.jr*S/\S0\(\S&\4S1jr+SSSSS2SS3.S,\S-\(\S4\,\\ 4S-S5\,\\ 4S-S6\\-S-S7\-\.-\-S-S(\S-S8\,\\4S-S9\(\S-S:\(\-S-S;\/S<\S-S&\,\\ 44S=jjr0g)>N) dataclass)datetime)Enum)Path)Any) constants)Volume)parse_datetimec\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrg) JobHardwarez Enumeration of hardware flavors available to run Jobs on the Hub. Value can be compared to a string: ```py assert JobHardware.CPU_BASIC == "cpu-basic" ``` Both enums are kept in sync with the Hub API by `utils/check_hardware_flavors.py`. z cpu-basicz cpu-upgradezcpu-performancezcpu-xlzt4-smallz t4-mediuml4x1l4x4l40sx1l40sx4l40sx8z a10g-smallz a10g-largez a10g-largex2z a10g-largex4z a100-largea100x4a100x8h200h200x2h200x4h200x8z rtx-pro-6000zrtx-pro-6000x2zrtx-pro-6000x4zrtx-pro-6000x8N) __name__ __module__ __qualname____firstlineno____doc__ CPU_BASIC CPU_UPGRADECPU_PERFORMANCECPU_XLT4_SMALL T4_MEDIUML4X1L4X4L40SX1L40SX4L40SX8 A10G_SMALL A10G_LARGE A10G_LARGEX2 A10G_LARGEX4 A100_LARGEA100X4A100X8H200H200X2H200X4H200X8 RTX_PRO_6000RTX_PRO_6000X2RTX_PRO_6000X4RTX_PRO_6000X8__static_attributes__rU/var/www/html/pdf-tiff/venv/lib/python3.13/site-packages/huggingface_hub/_jobs_api.pyr r s IK'O FHI D D F F FJJ!L!LJ F F D F F F!L%N%N%Nr:r c0\rSrSrSrSrSrSrSrSr Sr S r g ) JobStageGaV Enumeration of possible stage of a Job on the Hub. Value can be compared to a string: ```py assert JobStage.COMPLETED == "COMPLETED" ``` Possible values are: `COMPLETED`, `CANCELED`, `ERROR`, `DELETED`, `SCHEDULING`, `RUNNING`. Taken from https://github.com/huggingface/moon-landing/blob/main/server/job_types/JobInfo.ts#L61 (private url). COMPLETEDCANCELEDERRORDELETED SCHEDULINGRUNNINGrN) rrrrrr?r@rArBrCrDr9rr:r;r=r=Gs' IH EGJGr:r=)zhttps://huggingface.co/spaces/zhttps://hf.co/spaces/zhuggingface.co/spaces/z hf.co/spaces/cV\rSrSr%\\S'\S-\S'\\S-\S'\S-\S'Srg) JobStatushstageNmessage expose_urlsssh_urlr) rrrrr=__annotations__strlistr9rr:r;rFrFhs* O 4ZcT!! 4Zr:rFc4\rSrSr%\\S'\\S'\\S'Srg)JobOwnerpidnametyperN)rrrrrMrLr9rr:r;rPrPps G I Ir:rPcT\rSrSr%Sr\S-\S'\S-\S'\S-\S'S SjrSrg) JobDurationswaE Timing breakdown for a Job, computed server-side. Args: scheduling_secs (`int` or `None`): Seconds the job spent in the scheduling stage before starting to run. `None` if the job never reached the running stage. running_secs (`int` or `None`): Seconds the job has been or was running. Recomputed on each request while the job is in progress. `None` if the job never started running. total_secs (`int` or `None`): Total seconds elapsed since the job was created. Recomputed on each request while the job is in progress. Nscheduling_secs running_secs total_secsc URSURS55UlURSURS55UlURSURS55Ulg)NschedulingSecsrX runningSecsrY totalSecsrZ)getrXrYrZselfkwargss r;__init__JobDurations.__init__sW%zz*:FJJGX>> from huggingface_hub import run_job >>> job = run_job( ... image="python:3.12", ... command=["python", "-c", "print('Hello from the cloud!')"] ... ) >>> job JobInfo(id='687fb701029421ae5549d998', created_at=datetime.datetime(2025, 7, 22, 16, 6, 25, 79000, tzinfo=datetime.timezone.utc), started_at=datetime.datetime(2025, 7, 22, 16, 6, 31, 79000, tzinfo=datetime.timezone.utc), finished_at=None, docker_image='python:3.12', space_id=None, command=['python', '-c', "print('Hello from the cloud!')"], arguments=[], environment={}, secrets={}, flavor='cpu-basic', labels=None, status=JobStatus(stage='RUNNING', message=None), durations=JobDurations(scheduling_secs=6, running_secs=2, total_secs=8), owner=JobOwner(id='5e9ecfc04957053f60648a3e', name='lhoestq', type='user'), initiator=JobInitiator(type='user', id='5e9ecfc04957053f60648a3e', name='lhoestq'), endpoint='https://huggingface.co', url='https://huggingface.co/jobs/lhoestq/687fb701029421ae5549d998') >>> job.id '687fb701029421ae5549d998' >>> job.url 'https://huggingface.co/jobs/lhoestq/687fb701029421ae5549d998' >>> job.status.stage 'RUNNING' ``` rRN created_at started_at finished_at docker_imagespace_idcommand arguments environmentsecretsflavorlabelsvolumesstatus durationsowner initiatorendpointurlc jUSUlURS5=(d URS5nU(a [U5OSUlURS5=(d URS5nU(a [U5OSUlURS5=(d URS5nU(a [U5OSUlURS5=(d URS 5UlURS 5=(d URS 5UlURS 05n[USUS USS9Ul URS5Ul URS5Ul URS5Ul URS5Ul URS5UlURS5UlURS5nU(aUVs/sHn[!S#0UD6PM snOSUlURS05n[%USURS5URS5URS5S9UlURS5n U (a [)S#0U D6OSUlURS5n U (a [-U SU SU RS 5S9OSUlURS [0R25UlUR4S!URR6S"UR3Ulgs snf)$NrR createdAtrn startedAtro finishedAtrp dockerImagerqspaceIdrrr|rSrTrRrSrTrsrtrurvrwrxryrzrHrI exposeUrlssshUrl)rHrIrJrKr{r})rTrRrSr~z/jobs//r)rRr_r rnrorprqrrrPr|rsrtrurvrwrxr ryrFrzrVr{rir}rENDPOINTr~rSr) rarbrnrorpr|ryvrzr{r}s r;rcJobInfo.__init__su,ZZ ,H <0H 8B.4ZZ ,H <0H 8B.4jj.K&**]2K :E>+64"JJ}5SN9S 9-GJ1G  7B't5=uV}U zz), K0!::m4zz), jj* jj* **Y'9@W5W  W5d Hb)/JJy) <0JJx(   JJ{+ 6?2 2TJJ{+ dmLi/IdO)--X^J_ `sw   :y/A/AB mm_F4::??*;1TWWIF#6s8L0)rtrsrnrqr{r~rurprwrRr}rxr|rvrrrorzrryre)rrrrrrMrLrrNdictrr r rFrVrPrircr9rr:r;rlrlsDL G44D *Dj #Y Cy4c3h$&& #s(^d "" $  cNT !! &\D  d"" Od""M H$Gr:rlc\rSrSr%\S-\S'\S-\S'\\S-\S'\\S-\S'\\\4S-\S'\\\4S-\S'\ S-\S '\ S-\S '\\S-\S '\S-\S '\\\4S-\S '\\ S-\S'SSjr Sr g)JobSpeci'Nrqrrrsrtrurvrwtimeouttagsarchrxryc URS5=(d URS5UlURS5=(d URS5UlURS5UlURS5UlURS5UlURS5UlURS 5UlURS 5UlURS 5Ul URS 5Ul URS 5Ul URS5nU(a"UVs/sHn[S0UD6PM snUl gSUl gs snf)Nrrqrrrrsrtrurvrwrrrrxryr)r_rqrrrsrtrurvrwrrrrxr ry)rarbryrs r;rcJobSpec.__init__6s"JJ}5SN9S 9-GJ1G zz), K0!::m4zz), jj* zz), JJv& JJv& jj* **Y'9@W5W  W5 d 5s?E%) rrtrsrqrurwrxrvrrrrryre)rrrrrMrLrNrrr rgr rcr9rr:r;rr's*Dj #Y Cy4c3h$&& #s(^d "" $  4Z s)d  * cNT !! &\D   Kr:rc4\rSrSr%\\S'\\S'SSjrSrg) LastJobInfoiFrRatNc >USUl[US5Ulg)NrRr)rRr rr`s r;rcLastJobInfo.__init__Ks, .r:)rrRre) rrrrrMrLrrcr9rr:r;rrFs GL/r:rc@\rSrSr%\S-\S'\S-\S'SSjrSrg)ScheduledJobStatusiPNlast_jobnext_job_run_atc *URS5=(d URS5nU(a [S0UD6OSUlURS5=(d URS5nU(a[[ U55UlgSUlg)NlastJobr nextJobRunAtrr)r_rrr rMr)rarbrrs r;rcScheduledJobStatus.__init__Usj::i(BFJJz,B3; /h/  **^4U CT8UGV~c/.BC\`r:rrre) rrrrrrLrrcr9rr:r;rrPsD  _$ar:rc\rSrSr%Sr\\S'\S-\S'\\S'\S-\S'\ S-\S'\ S-\S '\ \S '\ \S 'SS jr S r g)ScheduledJobInfoi\a9 Contains information about a Job. Args: id (`str`): Scheduled Job ID. created_at (`datetime` or `None`): When the scheduled Job was created. tags (`list[str]` or `None`): The tags of the scheduled Job. schedule (`str` or `None`): One of "@annually", "@yearly", "@monthly", "@weekly", "@daily", "@hourly", or a CRON schedule expression (e.g., '0 9 * * 1' for 9 AM every Monday). suspend (`bool` or `None`): Whether the scheduled job is suspended (paused). concurrency (`bool` or `None`): Whether multiple instances of this Job can run concurrently. status (`ScheduledJobStatus` or `None`): Status of the scheduled Job. owner: (`JobOwner` or `None`): Owner of the scheduled Job, e.g. `JobOwner(id="5e9ecfc04957053f60648a3e", name="lhoestq", type="user")` job_spec: (`JobSpec` or `None`): Specifications of the Job. Example: ```python >>> from huggingface_hub import run_job >>> scheduled_job = create_scheduled_job( ... image="python:3.12", ... command=["python", "-c", "print('Hello from the cloud!')"], ... schedule="@hourly", ... ) >>> scheduled_job.id '687fb701029421ae5549d999' >>> scheduled_job.status.next_job_run_at datetime.datetime(2025, 7, 22, 17, 6, 25, 79000, tzinfo=datetime.timezone.utc) ``` rRNrnjob_specschedulesuspend concurrencyrzr|c USUlURS5=(d URS5nU(a [U5OSUl[ S0URS5=(d URS05D6UlURS5UlURS5UlURS5UlURS 05n[URS 5=(d URS 5URS 5=(d URS 5S9Ul URS05n[USUSUSS9Ul g)NrRrrnrjobSpecrrrrzrrrrrr|rSrTrr) rRr_r rnrrrrrrrzrPr|)rarbrnrzr|s r;rcScheduledJobInfo.__init__s,ZZ ,H <0H 8B.4X6::j#9#VVZZ SU=VX  :. zz), !::m4Hb)(ZZ +Dvzz)/D"JJ'89WVZZ=W   7B't5=uV}U r:)rrnrRrr|rrzrre)rrrrrrMrLrrboolrrPrcr9rr:r;rr\sN&P G4Dj D[  OVr:rcV\rSrSr%Sr\\S'\\S'\\S'\\S'\\S'S S jrS rg) JobAcceleratoria Contains information about a Job accelerator (GPU). Args: type (`str`): Type of accelerator, e.g. `"gpu"`. model (`str`): Model of accelerator, e.g. `"T4"`, `"A10G"`, `"A100"`, `"L4"`, `"L40S"`. quantity (`str`): Number of accelerators, e.g. `"1"`, `"2"`, `"4"`, `"8"`. vram (`str`): Total VRAM, e.g. `"16 GB"`, `"24 GB"`. manufacturer (`str`): Manufacturer of the accelerator, e.g. `"Nvidia"`. rTmodelquantityvram manufacturerNc hUSUlUSUlUSUlUSUlUSUlg)NrTrrrr)rTrrrrr`s r;rcJobAccelerator.__init__s<6N G_ z* 6N ">2r:)rrrrTrre) rrrrrrMrLrcr9rr:r;rrs( I JM I3r:rc\rSrSr%Sr\\S'\\S'\\S'\\S'\\S'\S-\S '\\S '\ \S '\\S 'SS jr Sr g)JobHardwareInfoia Contains information about available Job hardware. Args: name (`str`): Machine identifier, e.g. `"cpu-basic"`, `"a10g-large"`. pretty_name (`str`): Human-readable name, e.g. `"CPU Basic"`, `"Nvidia A10G - large"`. cpu (`str`): CPU specification, e.g. `"2 vCPU"`, `"12 vCPU"`. ram (`str`): RAM specification, e.g. `"16 GB"`, `"46 GB"`. ephemeral_storage (`str`): Ephemeral storage specification, e.g. `"20 GB"`, `"100 GB"`. accelerator (`JobAccelerator` or `None`): GPU/accelerator details if available. unit_cost_micro_usd (`int`): Cost in micro-dollars per unit, e.g. `167` (= $0.000167). unit_cost_usd (`float`): Cost in USD per unit, e.g. `0.000167`. unit_label (`str`): Cost unit period, e.g. `"minute"`. Example: ```python >>> from huggingface_hub import list_jobs_hardware >>> hardware_list = list_jobs_hardware() >>> hardware_list[0] JobHardwareInfo(name='cpu-basic', pretty_name='CPU Basic', cpu='2 vCPU', ram='16 GB', ephemeral_storage='20 GB', accelerator=None, unit_cost_micro_usd=167, unit_cost_usd=0.000167, unit_label='minute') >>> hardware_list[0].name 'cpu-basic' ``` rS pretty_namecpuramephemeral_storageN acceleratorunit_cost_micro_usd unit_cost_usd unit_labelc USUlUSUlUSUlUSUlUR SS5UlUR S5nU(a [ S 0UD6OSUlUSUlUS Ul US Ul g) NrS prettyNamerrephemeralStoragezN/ArunitCostMicroUSD unitCostUSD unitLabelr) rSrrrr_rrrrrr)rarbrs r;rcJobHardwareInfo.__init__s6N !,/%=%=!',>!Fjj/ 8K8T#)*<#= #M2 -r:) rrrrSrrrrrre) rrrrrrMrLrrgfloatrcr9rr:r;rrsF!F I H H$&&O .r:rsourcerfcB[U5R5R5n[R"[ R "5SU3R55R5SSnURRSS5=(d SnUSU3$)aDerive a stable remote folder name for a local directory synced as a Job volume. The name is `{dirname}-{hash}` where the hash fingerprints the absolute path and the machine's hostname: re-syncing the same directory from the same machine reuses the same remote folder (so only changed files are re-uploaded), while same-named directories from different paths or machines don't collide. :N _root-) r expanduserresolvehashlibsha256platformnodeencode hexdigestrSreplace)rresolveddigestdirnames r;_derive_job_volume_namersF|&&(002H ^^x}}/q ;BBD E O O QRTST UFmm##C-7GYax  r:rSc2[R"SSU5$)zSanitize a string so it is a valid Job `name` label. Job names must match `^[a-zA-Z0-9._-]*$` and are also stored as tags, which only allow alphanumerics, `-` and `_`. Every other character (including `/`, `:` and `.`) is replaced with `-`. z[^a-zA-Z0-9_-]r)resub)rSs r;_sanitize_job_namer s 66#S$ //r:partsc[R"SRU5R55R 5SS$)zShort, stable hash of a Job invocation (image/script + command line). Appended to auto-generated names so reruns of the same command share a name while different ones don't. Nr)rrjoinrr)rs r;_short_invocation_hashrs5 >>&++e,335 6 @ @ B2A FFr:imagersc[H;nURU5(dM[U[U5S=(d U5n O7 [UR S5R S5S=(d U5nUS[ U/UQ53$)aDerive a default Job name from a Docker image or Space reference and its command. A short hash of the full command line is appended to group reruns of the same command. e.g. python:3.12 + [foo, --truc] -> python-3-12-1a2b3c4d hf.co/spaces/lhoestq/duckdb -> lhoestq-duckdb- pytorch/pytorch:2.6.0-cuda12.4-... -> pytorch-2-6-0-cuda12-4-...- Nrr)_SPACE_IMAGE_PREFIXES startswithrlenrstripsplitr)rrsprefixbases r;_default_job_name_from_imagers(   F # #%eCKM&:&CeDD ( "%,,s"3"9"9#">r"B"KeLV1+U,=W,=>? @@r:script script_argsc,URSS5SRSS5SRS5RS5SnURS5(aUS[S5*n[ U=(d U5nUS [ U/UQ53$) aMDerive a default Job name from a UV script path, URL, or command and its arguments. A short hash of the full command line is appended to group reruns of the same command. e.g. my_script.py + [--epochs, 3] -> my_script-1a2b3c4d https://.../sft.py?raw=1 -> sft- lighteval -> lighteval- ?r#rrz.pyNr)rrendswithrrr)rrrSrs r;_default_job_name_from_scriptr,s <<Q  " ( (a 0 3 : :3 ? E Ec J2 ND }}UMs5zk" dnf -DV1+V,Bk,BCD EEr:F)rSrxryexposesshresource_group_idenvrvrwrrxryrrrc Ub%UbSU;a [S5e0U=(d 0ESU0EnU/U=(d 0U=(d [RS.n U(aX`name` and the `name` key in `labels` cannot both be provided.)rsrtrurwrvr<iiQ)smhdrtimeoutSecondsrxryportsrenabledTrresourceGroupIdrr) ValueErrorr r isinstancerMrgrto_dictrrr)rrsrrvrwrrSrxryrrrrtime_units_factorsvolrs r;_create_job_specr ;sv   &F"2]^ ^1V\r1FD1yb1K11  H%#$2DyI gs # # 7I(I),U73B<-@CU^`VaCb-b)cH% &),WH% & #8?@{{}@ %v. $d+&7"#'   F # #"'F "6HY   O ( #( O#AsE)1rrr dataclassesrrenumrpathlibrtypingrhuggingface_hubrhuggingface_hub._space_apir huggingface_hub.utils._datetimer rMr r=r?r@rArBTERMINAL_JOB_STAGESrrFrPrVrirlrrrrrrrrrNrrrrrgrrr rr:r;rs% !%-:(&#t(&VsD, ))8+<+ 8.8. 8.v !C$J !3 !0S0S0G$s)GGAAd3iACA" F# FDI F# F.$(#'#$(; ;#Y; c3h$  ; #s(^d " ; #  $ ;5[3  %; *; cNT !;&\D ; I ; ;Tz; #s(^;r: