QЦi6SSKJr SSKJr SSKJr SSKJrJrJr SSK J r SSK J r SSK Jr "SS \\5r\"S S 55r\"S S 55r\"SS55r\"SS55r\"SS55r\"SS55r\"SS55r\"SS55r\"SS55rSS.S\S\\S \\\\4S!\\\\4S"\\ S#\\\\\4S$\\\\4S%\\\44S&jjrg)') dataclass)datetime)Enum)AnyOptionalUnion) constants) SpaceHardware)parse_datetimec,\rSrSrSrSrSrSrSrSr Sr g ) JobStageaH 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`, `RUNNING`. Taken from https://github.com/huggingface/moon-landing/blob/main/server/job_types/JobInfo.ts#L61 (private url). COMPLETEDCANCELEDERRORDELETEDRUNNINGN) __name__ __module__ __qualname____firstlineno____doc__rrrrr__static_attributes__rX/var/www/html/ai-image-ml/venv/lib/python3.13/site-packages/huggingface_hub/_jobs_api.pyr r s" IH EGGrr c0\rSrSr%\\S'\\\S'Srg) JobStatus-stagemessagerN) rrrrr __annotations__rstrrrrrrr-s O c]rrc4\rSrSr%\\S'\\S'\\S'Srg)JobOwner3idnametyperN)rrrrr#r"rrrrr%r%3s G I Irr%c\rSrSr%Sr\\S'\\\S'\\\S'\\\S'\\ \\S'\\ \\S'\\ \\ 4\S '\\ \\ 4\S '\\ \S '\\ \\4\S '\ \S '\\S'\\S'\\S'SSjrSrg)JobInfo:a Contains information about a Job. Args: id (`str`): Job ID. created_at (`datetime` or `None`): When the Job was created. docker_image (`str` or `None`): The Docker image from Docker Hub used for the Job. Can be None if space_id is present instead. space_id (`str` or `None`): The Docker image from Hugging Face Spaces used for the Job. Can be None if docker_image is present instead. command (`list[str]` or `None`): Command of the Job, e.g. `["python", "-c", "print('hello world')"]` arguments (`list[str]` or `None`): Arguments passed to the command environment (`dict[str]` or `None`): Environment variables of the Job as a dictionary. secrets (`dict[str]` or `None`): Secret environment variables of the Job (encrypted). flavor (`str` or `None`): Flavor for the hardware, as in Hugging Face Spaces. See [`SpaceHardware`] for possible values. E.g. `"cpu-basic"`. labels (`dict[str, str]` or `None`): Labels to attach to the job (key-value pairs). status: (`JobStatus` or `None`): Status of the Job, e.g. `JobStatus(stage="RUNNING", message=None)` See [`JobStage`] for possible stage values. owner: (`JobOwner` or `None`): Owner of the Job, e.g. `JobOwner(id="5e9ecfc04957053f60648a3e", name="lhoestq", type="user")` Example: ```python >>> 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), 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), owner=JobOwner(id='5e9ecfc04957053f60648a3e', name='lhoestq', type='user'), 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' ``` r' created_at docker_imagespace_idcommand arguments environmentsecretsflavorlabelsstatusownerendpointurlNc USUlURS5=(d URS5nU(a [U5OSUlURS5=(d URS5UlURS5=(d URS5UlURS05n[ USUS US S 9UlURS 5UlURS 5Ul URS5Ul URS5Ul URS5Ul URS5Ul URS05n[USURS5S9UlURS[ R"5UlUR$SURR&SUR3Ulg)Nr' createdAtr- dockerImager.spaceIdr/r7r(r)r'r(r)r0r1r2r3r4r5r6r r!)r r!r8z/jobs//)r'getr r-r.r/r%r7r0r1r2r3r4r5rr6r ENDPOINTr8r(r9)selfkwargsr-r7r6s r__init__JobInfo.__init__sq,ZZ ,H <0H 8B.4"JJ}5SN9S 9-GJ1G  7B't5=uV}U zz), K0!::m4zz), jj* jj* Hb)fWovzz)?TU  :y/A/AB mm_F4::??*;1TWWIFr)r1r0r-r.r8r2r4r'r5r7r3r/r6r9returnN)rrrrrr#r"rrlistdictrr rr%rDrrrrr+r+:s2h G""3-sm d3i  S ""$sCx.)) d38n %% ] ## T#s(^ $$  OM HGrr+c\rSrSr%\\\S'\\\S'\\\\S'\\\\S'\\\\ 4\S'\\\\ 4\S'\\ \S'\\ \S '\\\\S '\\\S '\\\\4\S 'SSjr Sr g )JobSpecr.r/r0r1r2r3r4timeouttagsarchr5Nc HURS5=(d URS5UlURS5=(d URS5UlURS5UlURS5UlURS5UlURS5UlURS 5UlURS 5UlURS 5Ul URS 5Ul URS 5Ul g)Nr<r.r=r/r0r1r2r3r4rMrNrOr5) r@r.r/r0r1r2r3r4rMrNrOr5rBrCs rrDJobSpec.__init__s"JJ}5SN9S 9-GJ1G zz), K0!::m4zz), jj* zz), JJv& JJv& jj* r) rOr1r0r.r2r4r5r3r/rNrMrF)rrrrrr#r"rHrIrr intrDrrrrrKrKs3-sm d3i  S ""$sCx.)) d38n %% ] ## c] 49  3- T#s(^ $$ +rrKc4\rSrSr%\\S'\\S'SSjrSrg) LastJobInfor'atNc >USUl[US5Ulg)Nr'rW)r'r rWrQs rrDLastJobInfo.__init__s, .r)rWr'rF) rrrrr#r"rrDrrrrrUrUs GL/rrUc@\rSrSr%\\\S'\\\S'SSjrSr g)ScheduledJobStatuslast_jobnext_job_run_atNc *URS5=(d URS5nU(a [S0UD6OSUlURS5=(d URS5nU(a[[ U55UlgSUlg)NlastJobr] nextJobRunAtr^r)r@rUr]r r#r^)rBrCr]r^s rrDScheduledJobStatus.__init__sj::i(BFJJz,B3; /h/  **^4U CT8UGV~c/.BC\`rr]r^rF) rrrrrrUr"rrDrrrrr[r[s{##h''arr[c\rSrSr%Sr\\S'\\\S'\ \S'\\\S'\\ \S'\\ \S'\ \S '\ \S 'SS jr S rg )ScheduledJobInfoa9 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) ``` r'r-job_specschedulesuspend concurrencyr6r7Nc USUlURS5=(d URS5nU(a [U5OSUl[ S0URS5=(d URS05D6UlURS5UlURS5UlURS5UlURS 05n[URS 5=(d URS 5URS 5=(d URS 5S9Ul URS05n[USUSUSS9Ul g)Nr'r;r-rgjobSpecrhrirjr6r]r`r^rarcr7r(r)r>r) r'r@r r-rKrgrhrirjr[r6r%r7)rBrCr-r6r7s rrDScheduledJobInfo.__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)rjr-r'rgr7rhr6rirF)rrrrrr#r"rrrKboolr[r%rDrrrrreresO&P G""sm d^$  OVrrecV\rSrSr%Sr\\S'\\S'\\S'\\S'\\S'S S jrS rg) JobAcceleratori a 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"`. r)modelquantityvram manufacturerNc hUSUlUSUlUSUlUSUlUSUlg)Nr)rqrrrsrt)r)rqrrrsrtrQs rrDJobAccelerator.__init__%s<6N G_ z* 6N ">2r)rtrqrrr)rsrF) rrrrrr#r"rDrrrrrprp s( I JM I3rrpcz\rSrSr%Sr\\S'\\S'\\S'\\S'\\\S'\ \S'\ \S '\\S 'SS jr S r g ) JobHardwarei-a) 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"`. 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] JobHardware(name='cpu-basic', pretty_name='CPU Basic', cpu='2 vCPU', ram='16 GB', accelerator=None, unit_cost_micro_usd=167, unit_cost_usd=0.000167, unit_label='minute') >>> hardware_list[0].name 'cpu-basic' ``` r( pretty_namecpuram acceleratorunit_cost_micro_usd unit_cost_usd unit_labelNc USUlUSUlUSUlUSUlUR S5nU(a [ S 0UD6OSUlUSUlUSUlUSUl g) Nr( prettyNamerzr{r|unitCostMicroUSD unitCostUSD unitLabelr) r(ryrzr{r@rpr|r}r~r)rBrCr|s rrDJobHardware.__init__Ysy6N !,/%=%=jj/ 8K8T#)*<#= #M2 -r)r|rzr(ryr{r}r~rrF) rrrrrr#r"rrprSfloatrDrrrrrxrx-s@B I H H.))O .rrxN)r5imager0envr3r4rMr5rGcU/U=(d 0U=(d [RS.nU(aX7S'U(aVSSSSS.n[U[5(a,USU;a#[ [ USS5XS-5US 'O[ U5US 'U(aXgS 'S H-n UR U 5(dMU[U 5SUS ' U$ XS 'U$)N)r0r1r2r4r3<iiQ)smhdtimeoutSecondsr5)zhttps://huggingface.co/spaces/zhttps://hf.co/spaces/zhuggingface.co/spaces/z hf.co/spaces/r=r<)r CPU_BASIC isinstancer#rSr startswithlen) rr0rr3r4rMr5rgtime_units_factorsprefixs r_create_job_specresyb3M33  H%#$2DyI gs # # 7I(I),U73B<-@CU^`VaCb-b)cH% &),WH% & #   F # #"'F "6HY   O#( Or) dataclassesrrenumrtypingrrrhuggingface_hubr huggingface_hub._space_apir huggingface_hub.utils._datetimer r#r rr%r+rKrUr[rerprxrHrIrSrrrrrrs"''%4:sD(       YGYG YGx ++ +6 // / aa a @V@V @VF 33 3> 4.4. 4.~(,* *#Y* $sCx. ! * d38n % * ] # *eCO, -* T#s(^ $* #s(^*r