-:jNddlmZddlmZddlmZddlmZddlmZddl m Z ddl m Z Gdd e eZGd d e eZej ej"ej$ej&fZeGd d ZeGddZeGddZeGddZeGddZeGddZeGddZeGddZeGddZeGddZeGd d!Zd"d"d"d#d$d%e d&e e d'e!e efd"zd(e!e efd"zd)ee zd"zd*e"e#ze zd"zd+e!e e fd"zd,e e d"zd-e e"d"zd.e$d/e!e effd0Z%y")1) dataclass)datetime)Enum)Any) constants)Volume)parse_datetimecxeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZy) JobHardwarea  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____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[/var/www/html/tokenscope/api/venv/lib/python3.12/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%Nr6r c(eZdZdZdZdZdZdZdZdZ y) JobStageav 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 SCHEDULINGRUNNINGN) rrrrr:r;r<r=r>r?r5r6r7r9r9Cs' IH EGJGr6r9cNeZdZUeed<edzed<eedzed<edzed<y) JobStatusstageNmessage expose_urlsssh_url)rrrr9__annotations__strlistr5r6r7rArA\s* O 4ZcT!! 4Zr6rAc,eZdZUeed<eed<eed<y)JobOwneridnametypeN)rrrrGrFr5r6r7rJrJds G I Ir6rJcJeZdZUdZedzed<edzed<edzed<ddZy) JobDurationsau 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 |jd|jd|_|jd|jd|_|jd|jd|_y)NschedulingSecsrP runningSecsrQ totalSecsrR)getrPrQrRselfkwargss r7__init__zJobDurations.__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' ``` rKN created_at started_at finished_at docker_imagespace_idcommand arguments environmentsecretsflavorlabelsvolumesstatus durationsowner initiatorendpointurlc |d|_|jdxs|jd}|r t|nd|_|jdxs|jd}|r t|nd|_|jdxs|jd}|r t|nd|_|jdxs|jd |_|jd xs|jd |_|jd i}t|d|d |d|_ |jd|_ |jd|_ |jd|_ |jd|_ |jd|_|jd|_|jd}|r|Dcgc] }t!d#i|c}nd|_|jdi}t%|d|jd|jd|jd|_|jd} | r t)d#i| nd|_|jd} | r#t-| d| d| jd nd|_|jd t0j2|_|j4d!|jj6d"|j|_ycc}w)$NrK createdAtrc startedAtrd finishedAtre dockerImagerfspaceIdrgrqrLrMrKrLrMrhrirjrkrlrmrnrorBrC exposeUrlssshUrl)rBrCrDrErprr)rMrKrLrsz/jobs//r5)rKrWr rcrdrerfrgrJrqrhrirjrkrlrmrrnrArorOrpr`rrrENDPOINTrsrLrt) rYrZrcrdrerqrnvrorprrs r7r[zJobInfo.__init__sq,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@W5  5d Hb)/JJy) <0JJx(   JJ{+ 6?2 2TJJ{+ dmLi/IdO)--X^J_ `sw   :y/A/AB mm_F4::??*;1TWWIF#6sK?r\)rrrrrGrFrrHdictrr rrArOrJr`r[r5r6r7rbrbsDL G44D *Dj #Y Cy4c3h$&& #s(^d "" $  cNT !! &\D  d"" Od""M H$Gr6rbc eZdZUedzed<edzed<eedzed<eedzed<eeefdzed<eeefdzed<edzed<e dzed <eedzed <edzed <eeefdzed <ee dzed <ddZ y)JobSpecNrfrgrhrirjrkrltimeouttagsarchrmrnc |jdxs|jd|_|jdxs|jd|_|jd|_|jd|_|jd|_|jd|_|jd |_|jd |_|jd |_ |jd |_ |jd |_ |jd}|r|Dcgc] }tdi|c}|_ yd|_ ycc}w)Nryrfrzrgrhrirjrkrlrrrrmrnr5)rWrfrgrhrirjrkrlrrrrmrrn)rYrZrnrs r7r[zJobSpec.__init__*s"JJ}5SN9S 9-GJ1G zz), K0!::m4zz), jj* zz), JJv& JJv& jj* **Y'9@W5  5 d 5s0Er\) rrrrGrFrHrrr r^rr[r5r6r7rrs*Dj #Y Cy4c3h$&& #s(^d "" $  4Z s)d  * cNT !! &\D   Kr6rc*eZdZUeed<eed<ddZy) LastJobInforKatNc >|d|_t|d|_y)NrKr)rKr rrXs r7r[zLastJobInfo.__init__?s, .r6r\)rrrrGrFrr[r5r6r7rr:s GL/r6rc6eZdZUedzed<edzed<ddZy)ScheduledJobStatusNlast_jobnext_job_run_atc |jdxs|jd}|r tdi|nd|_|jdxs|jd}|rtt ||_yd|_y)NlastJobr nextJobRunAtrr5)rWrrr rGr)rYrZrrs r7r[zScheduledJobStatus.__init__Isj::i(BFJJz,B3; /h/  **^4U CT8UGV~c/.BC\`r6r\)rrrrrFrr[r5r6r7rrDsD  _$ar6rceZdZUdZeed<edzed<eed<edzed<edzed<edzed<e ed <e ed <d d Z y) ScheduledJobInfoa 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) ``` rKNrcjob_specschedulesuspend concurrencyrorqc |d|_|jdxs|jd}|r t|nd|_t di|jdxs|jdi|_|jd|_|jd|_|jd|_|jd i}t|jd xs|jd |jd xs|jd |_ |jdi}t|d|d|d|_ y)NrKrvrcrjobSpecrrrrorrrr)rrrqrLrMr{r5) rKrWr rcrrrrrrrorJrq)rYrZrcrorqs r7r[zScheduledJobInfo.__init__s,ZZ ,H <0H 8B.4X6::j#9#VVZZ SU=VX  :. zz), !::m4Hb)(ZZ +Dvzz)/D"JJ'89WVZZ=W   7B't5=uV}U r6r\) rrrrrGrFrrboolrrJr[r5r6r7rrPsN&P G4Dj D[  OVr6rcLeZdZUdZeed<eed<eed<eed<eed<d dZy) JobAcceleratora 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"`. rMmodelquantityvram manufacturerNc h|d|_|d|_|d|_|d|_|d|_y)NrMrrrr)rMrrrrrXs r7r[zJobAccelerator.__init__s<6N G_ z* 6N ">2r6r\)rrrrrGrFr[r5r6r7rrs( I JM I3r6rczeZdZUdZeed<eed<eed<eed<eed<edzed<eed <eed <eed <d d Z y)JobHardwareInfoa$ 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' ``` rL pretty_namecpuramephemeral_storageN acceleratorunit_cost_micro_usd unit_cost_usd unit_labelc |d|_|d|_|d|_|d|_|j dd|_|j d}|r t d i|nd|_|d|_|d |_ |d |_ y) NrL prettyNamerrephemeralStoragezN/ArunitCostMicroUSD unitCostUSD unitLabelr5) rLrrrrWrrrrrr)rYrZrs r7r[zJobHardwareInfo.__init__s6N !,/%=%=!',>!Fjj/ 8K8T#)*<#= #M2 -r6r\) rrrrrGrFrr^floatr[r5r6r7rrsF!F I H H$&&O .r6rNF)rmrnexposesshimagerhenvrkrlrrmrnrrr]c |g|xsi|xstjd} |r|| d<|rPddddd} t|tr+|d| vr$t t |dd| |dz| d <nt || d <|r|| d <|r!|D cgc]} | j c} | d <|rd |i| d <| rddi| d<dD]'} |j| s|t| d| d<| S|| d<| Scc} w)N)rhrirjrlrk<iiQ)smhdtimeoutSecondsrmrnportsrenabledTr)zhttps://huggingface.co/spaces/zhttps://hf.co/spaces/zhuggingface.co/spaces/z hf.co/spaces/rzry) r r isinstancerGr^rto_dict startswithlen)rrhrrkrlrrmrnrrrtime_units_factorsvolprefixs r7_create_job_specrs>yb1K11  H%#$2DyI gs # 7I(I),U73B<-@CUV]^`VaCb-b)cH% &),WH% & #8?@s{{}@ %v. $d+ (   F #"'F "6HY   O (#( O'AsC&)& dataclassesrrenumrtypingrhuggingface_hubrhuggingface_hub._space_apirhuggingface_hub.utils._datetimer rGr r9r:r;r<r=TERMINAL_JOB_STAGESrArJrOr`rbrrrrrrrHrr^rrrr5r6r7rsg"%-:(&#t(&VsD, ))8+<+ 8.8. 8.F%)#'#6 6#Y6 c3h$  6 #s(^d " 6 #  $ 65[3  %6 cNT !6&\D 6 I 6 6 #s(^6r6