Ë
    ÂÓ^j¤'  ã            (       ó*  — d Z ddlZddlmZmZ ddlZddlmZmZm	Z	 ddl
mZmZ ddlmZ ddlmZ dd	lmZmZmZmZmZmZmZmZmZmZmZ dd
lmZ ddlm Z m!Z! ddl"m#Z#m$Z$  e% ee«      «      Z& ee«      Z' ejP                  de'D � ci c]  } | | “Œ c} e)¬«      Z* ejP                  d e% ee«      «      D �ci c]  }||“Œ c}e)¬«      Z+ee)dz   e!ddjY                  e&«      › d� ee&«      ¬«      f   Z- ed¬«      Z.e.j_                  dg d¢¬«      dddddddddddeddddddfdee)dz   e d¬«      f   dedededee)dz   e!d d!¬«      f   d"ee0dz   e!d#d$¬«      f   d%ee1e)   dz   e!d&d'¬«      f   d(ee)dz   e!d)¬«      f   d*ee1e)   dz   e!d+ ee+«      d,¬-«      f   d.ee0 e!d/d0¬«      f   d1ee*dz   e!d2¬«      f   d3ed4e-d5ee0 e!d6d7d8¬«      f   d9ee0 e!d:d;¬«      f   d<ee0 e!d=d>d?¬«      f   d@edAedBdf&dC„«       Z2e.j_                  dDdEdFg¬«      	 	 	 dSdGee) e dH¬«      f   d@ed4e-dAedBdf
dI„«       Z3e.j_                  dJg dK¢¬«      	 	 	 dTdGee) e dH¬«      f   dLee0 e!dMdN¬«      f   dOee0 e!dPdQ¬«      f   dAedBdf
dR„«       Z4yc c} w c c}w )UzBContains commands to interact with models on the Hugging Face Hub.é    N)Ú	AnnotatedÚget_args)ÚCLIErrorÚRepositoryNotFoundErrorÚRevisionNotFoundError)ÚExpandModelProperty_TÚModelSort_T)Ú
PROVIDER_T)Ú	ModelCardé   )ÚREPO_LIST_DEFAULT_LIMITÚ	AuthorOptÚ	FilterOptÚLimitOptÚRevisionOptÚ	SearchOptÚ
SoftChoiceÚTokenOptÚ
get_hf_apiÚmake_expand_properties_parserÚtyper_factory)Úlist_repo_files_cmd)ÚArgumentÚOption)Ú_dataclass_to_dictÚoutÚModelSortEnum)ÚtypeÚInferenceProviderEnumz”Comma-separated properties to return. When used, only the listed properties (and id) are returned. Example: '--expand=downloads,likes,tags'. Valid: z, ú.)ÚhelpÚcallbackz Interact with models on the Hub.)r!   z	list | ls)z(hf models ls --sort downloads --limit 10z1hf models ls --search "llama" --author meta-llamaz2hf models ls --pipeline-tag text-generation --warmz:hf models ls --num-parameters min:6B,max:128B --sort likesz'hf models ls --no-gated --author googlez)hf models ls --apps llama.cpp --apps vllmz?hf models ls --inference-provider fireworks-ai --sort downloadsz"hf models ls --warm --search llamaz-hf models ls meta-llama/Llama-3.2-1B-Instructz0hf models ls meta-llama/Llama-3.2-1B-Instruct -Rz7hf models ls meta-llama/Llama-3.2-1B-Instruct --tree -h)ÚexamplesFÚrepo_idzRModel ID (e.g. `username/repo-name`) to list files from. If omitted, lists models.ÚsearchÚauthorÚfilterÚpipeline_tagz--pipeline-tagz>Filter by pipeline tag (canonical task), e.g. 'summarization'.Úgatedz--gated/--no-gatedzRFilter by gated status. '--gated' for gated only, '--no-gated' for non-gated only.Úappsz--appszAFilter by app(s) that can run the model, e.g. 'ollama' or 'vllm'.Únum_parametersz2Filter by parameter count, e.g. 'min:6B,max:128B'.Úinference_providerz--inference-providerzGFilter by inference provider(s) serving the model, e.g. 'fireworks-ai'.)Ú
click_typer!   Úwarmz--warmzEOnly list models currently served by at least one inference provider.ÚsortzSort results.ÚlimitÚexpandÚhuman_readablez--human-readablez-hz=Show sizes in human readable format (only for listing files).Úas_treez--treez3List files in tree format (only for listing files).Ú	recursivez--recursivez-Rz0List files recursively (only for listing files).ÚrevisionÚtokenÚreturnc                 ób  — | ��-|�t        j                  d«      ‚|�t        j                  d«      ‚|�t        j                  d«      ‚|�t        j                  d«      ‚|�t        j                  d«      ‚|�t        j                  d«      ‚|�t        j                  d«      ‚|�t        j                  d	«      ‚|	rt        j                  d
«      ‚|
�t        j                  d«      ‚|t        k7  rt        j                  d«      ‚|�t        j                  d«      ‚t        | d|||||¬«      S |rt        j                  d«      ‚|rt        j                  d«      ‚|rt        j                  d«      ‚|�t        j                  d«      ‚|	r|�t        j                  d«      ‚t	        |¬«      }|
r|
j
                  nd}|j                  ||||||||	rdnd||||¬«      D �cg c]  }t        |«      ‘Œ }}t        j                  |«       |€|	r|st        j                  d«       yyyc c}w )z³List models on the Hub, or files in a model repo.

    When called with no argument, lists models on the Hub.
    When called with a model ID, lists files in that model repo.
    Nz'Cannot use --search when listing files.z'Cannot use --author when listing files.z'Cannot use --filter when listing files.z-Cannot use --pipeline-tag when listing files.z1Cannot use --gated/--no-gated when listing files.z%Cannot use --apps when listing files.z/Cannot use --num-parameters when listing files.z3Cannot use --inference-provider when listing files.z%Cannot use --warm when listing files.z%Cannot use --sort when listing files.z&Cannot use --limit when listing files.z'Cannot use --expand when listing files.Úmodel)r$   Ú	repo_typer2   r3   r4   r5   r6   z&Cannot use --tree when listing models.z+Cannot use --recursive when listing models.z0Cannot use --human-readable when listing models.z*Cannot use --revision when listing models.z5Cannot use --warm together with --inference-provider.©r6   r.   )r'   r&   r%   r(   r)   r*   r+   Ú	inferencer,   r/   r0   r1   zsUse `--expand inferenceProviderMapping` to see which provider serves each model and the provider-specific model id.)ÚclickÚBadParameterr   r   r   ÚvalueÚlist_modelsr   r   ÚtableÚhint)r$   r%   r&   r'   r(   r)   r*   r+   r,   r.   r/   r0   r1   r2   r3   r4   r5   r6   ÚapiÚsort_keyÚ
model_infoÚresultss                         úe/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/huggingface_hub/cli/models.pyÚ	models_lsrH   @   sh  € ðb ÑØÐÜ×$Ñ$Ð%NÓOÐOØÐÜ×$Ñ$Ð%NÓOÐOØÐÜ×$Ñ$Ð%NÓOÐOØÐ#Ü×$Ñ$Ð%TÓUÐUØÐÜ×$Ñ$Ð%XÓYÐYØÐÜ×$Ñ$Ð%LÓMÐMØÐ%Ü×$Ñ$Ð%VÓWÐWØÐ)Ü×$Ñ$Ð%ZÓ[Ð[ÙÜ×$Ñ$Ð%LÓMÐMØÐÜ×$Ñ$Ð%LÓMÐMØÔ+Ò+Ü×$Ñ$Ð%MÓNÐNØÐÜ×$Ñ$Ð%NÓOÐOÜ"ØØØ)ØØØØô
ð 	
ñ Ü× Ñ Ð!IÓJÐJÙÜ× Ñ Ð!NÓOÐOÙÜ× Ñ Ð!SÓTÐTØÐÜ× Ñ Ð!MÓNÐNÙÐ"Ð.Ü× Ñ Ð!XÓYÐYÜ
˜5Ô
!€CÙ!ˆt�zŠz t€Hð Ÿ/™/ØØØØ%ØØØ)Ù $‘f¨$Ø1ØØØð *ó 
öàô 	˜:Õ&ð€Gð ô" ‡I�IˆgÔØÐ&©$¹Ü�‰ð Bõ	
ð 9?¨$ùò%s   Ç%H,Úinfoz/hf models info meta-llama/Llama-3.2-1B-Instructz<hf models info Qwen/Qwen3.5-9B --expand downloads,likes,tagsÚmodel_idz)The model ID (e.g. `username/repo-name`).c                 óð   — t        |¬«      }	 |j                  | ||¬«      }t        j                  |«       y# t        $ r}t        d| › d�«      |‚d}~wt        $ r}t        d|› d| › d�«      |‚d}~ww xY w)	z"Get info about a model on the Hub.r;   )r$   r5   r1   zModel 'z' not found.Nz
Revision 'z' not found on 'z'.)r   rE   r   r   r   r   Údict)rJ   r5   r1   r6   rC   rI   Úes          rG   Úmodels_inforN   Ø   s‡   € ô ˜5Ô
!€CðSØ�~‰~ h¸È&ˆ~ÓQˆô
 ‡H�HˆT…Nøô	 #ò @Ü˜  
¨,Ð7Ó8¸aÐ?ûÜ ò SÜ˜ H :Ð-=¸h¸ZÀrÐJÓKÐQRÐRûðSús!   Ž8 ¸	A5ÁAÁA5ÁA0Á0A5Úcard)z$hf models card google/gemma-4-31B-itz/hf models card google/gemma-4-31B-it --metadataz=hf models card google/gemma-4-31B-it --metadata --format jsonz+hf models card google/gemma-4-31B-it --textÚmetadataz
--metadataz'Output only the metadata from the card.Útextz--textz(Output only the text body (no metadata).c                 ód  — |r|rt        d«      ‚t        j                  | |¬«      }|r.t        j                  |j
                  j                  «       «       y|r t        j                  |j                  «       yt        j                  |j                  «       t        j                  d| › d�«       y)z3Get the model card (README) for a model on the Hub.z---metadata and --text are mutually exclusive.r;   zUse `hf models card z/ --metadata` to extract only the card metadata.N)
r   r   Úloadr   rL   ÚdataÚto_dictrQ   ÚcontentrB   )rJ   rP   rQ   r6   rO   s        rG   Úmodels_cardrW   ð   s{   € ñ  ‘DÜÐFÓGÐGÜ�>‰>˜(¨%Ô0€DÙÜ�‰�—‘×"Ñ"Ó$Õ%Ù	Ü�‰�—‘Õä�‰�—‘ÔÜ�‰Ð'¨ zÐ1`ÐaÕbó    )NNN)FFN)5Ú__doc__ÚenumÚtypingr   r   r=   Úhuggingface_hub.errorsr   r   r   Úhuggingface_hub.hf_apir   r	   Ú$huggingface_hub.inference._providersr
   Úhuggingface_hub.repocardr   Ú
_cli_utilsr   r   r   r   r   r   r   r   r   r   r   Ú_file_listingr   Ú
_frameworkr   r   Ú_outputr   r   ÚsortedÚ_EXPAND_PROPERTIESÚ_SORT_OPTIONSÚEnumÚstrr   r   ÚjoinÚ	ExpandOptÚ
models_cliÚcommandÚboolÚlistrH   rN   rW   )ÚsÚps   00rG   ú<module>rq      sò  ðñ Iã ß &ã ç [Ñ [ß EÝ ;Ý .÷÷ ÷ ñ õ /ß (ß ,ñ ™HÐ%:Ó;Ó<Ð Ù˜Ó%€Ø�—	‘	˜/¸-Ö+H°Q¨A¨q©DÒ+HÈsÔS€Ø!˜Ÿ	™	Ø©F±8¸JÓ3GÓ,HÖI q˜a ™dÒIÐPSôÐ ð
 Øˆ$�JÙ
ð dð  ei÷  enñ  enð  oAó  eBð  dCð  CDð  EÙ.Ð/AÓBôðñ€	ñ Ð BÔC€
ð ×ÑØòð ó ð( 	ØØØð 	ð 	ð 	ð 	ð 	ð 	ð 	Ø-Øð 	ð 	ð 	Ø ØñuE
ØØˆd‰
ÙÐjÔkð	mñðE
ð
 ðE
ð ðE
ð ðE
ð Øˆd‰
ÙÐÐ&fÔgð	iñðE
ð Øˆt‰ÙØ Øeô	
ð	ñðE
ð& ØˆS‰	�DÑÙˆxÐaÔbð	dñð'E
ð. Øˆd‰
ÙÐHÔIð	Kñð/E
ð6 "ØˆS‰	�DÑÙØ"Ù!Ð"7Ó8ØZô	
ð	ñð7E
ðF ØÙˆxÐeÔfð	hñðGE
ðN Ø˜ÑÙ�OÔ$ð	&ñðOE
ðV ðWE
ðX ðYE
ðZ ØÙÐ! 4Ð.mÔnð	pñð[E
ðb ØÙˆxÐSÔTð	VñðcE
ðj ØÙˆ}˜dÐ)[Ô\ð	^ñðkE
ðr ðsE
ðt ðuE
ðv 
òwE
ó!ð E
ðP ×ÑØ
à9ØFðð ó ð !ØØñ	Ø˜™XÐ+VÔWÐWÑXðàðð ðð ð	ð
 
òóðð" ×ÑØ
òð ó ð glØ_dØñ	cØ˜™XÐ+VÔWÐWÑXðcà˜™f \Ð8aÔbÐbÑcðcð �D™& Ð0ZÔ[Ð[Ñ
\ðcð ð	cð
 
òcóñcùòW ,IùâIs   Â
J
Â8
J
