+ QV-jLaRGt<0tRt^RIt^RIt^RIHt^RIHt^RIt^RI H t H t H t ^RI Ht^RIHt^RIHt^RIHt^R IHtHtHtHt^R IHtR tR tR ] R2tRt]!R4t ]!R4t!]!R4t"]!R4t#0RHmt$R0t%RRRR/t&]^kR.t'RRIRRJ/t(]^k]!RR7t)RRlt*RRlt+R R!lt,R"R#lt-R$R%lt.R&R/R'R(llt/R)R*lt0R+R,lt1R-R.lt2R/R0lt3R1R2lt4R3R4lt5R5R6lt6])PoR74R8R9l4t8])PoR:R;R<.R=7RKR>R?ll4t9])PoR@.RLOR=7]RARARRA3RBRCll4t:])PoRD.RMOR=7RNRERFll4t;R#)OaContains commands to manage skills for AI assistants. Usage: # install the hf-cli skill in common .agents/skills directory (either in current directory or user-level) hf skills add hf skills add --global # install the hf-cli skill for Claude (project-level, in current directory) hf skills add --claude # install globally (user-level) hf skills add --claude --global # install to a custom directory hf skills add --dest=~/my-skills # overwrite an existing skill hf skills add --claude --force N)Path) Annotated)CommandContextGroup) get_command)CLIError)disable_progress_bars)_skills)TokenOpt_has_local_formatting_option get_hf_api typer_factory)outzhf-cliaHugging Face Hub CLI (`hf`) for downloading, uploading, and managing models, datasets, spaces, buckets, repos, papers, jobs, and more on the Hugging Face Hub. Use when: handling authentication; managing local cache; managing Hugging Face Buckets; running or scheduling jobs on Hugging Face infrastructure; managing Hugging Face repos; discussions and pull requests; browsing models, datasets and spaces; reading, searching, or browsing academic papers; managing collections; querying datasets; configuring spaces; setting up webhooks; or deploying and managing HF Inference Endpoints. Make sure to use this skill whenever the user mentions 'hf', 'huggingface', 'Hugging Face', 'huggingface-cli', or 'hugging face cli', or wants to do anything related to the Hugging Face ecosystem and to AI and ML in general. Also use for cloud storage needs like training checkpoints, data pipelines, or agent traces. Use even if the user doesn't explicitly ask for a CLI command. Replaces the deprecated `huggingface-cli`.z--- name: hf-cli description: "a?" --- Install: `curl -LsSf https://hf.co/cli/install.sh | bash -s`. The Hugging Face Hub CLI tool `hf` is available. IMPORTANT: The `hf` command replaces the deprecated `huggingface-cli` command. Use `hf --help` to view available functions. Note that auth commands are now all under `hf auth` e.g. `hf auth whoami`. up ## Mounting repos as local filesystems To mount Hub repositories or buckets as local filesystems — no download, no copy, no waiting — use `hf-mount`. Files are fetched on demand. GitHub: https://github.com/huggingface/hf-mount Install: `curl -fsSL https://raw.githubusercontent.com/huggingface/hf-mount/main/install.sh | sh` Some command examples: - `hf-mount start repo openai-community/gpt2 /tmp/gpt2` — mount a repo (read-only) - `hf-mount start --hf-token $HF_TOKEN bucket myuser/my-bucket /tmp/data` — mount a bucket (read-write) - `hf-mount status` / `hf-mount stop /tmp/data` — list or unmount ## Tips - Use `hf --help` for full options, descriptions, usage, and real-world examples - Authenticate with `HF_TOKEN` env var (recommended) or with `--token` - Update the CLI with `hf update` (uses the correct command for the detected install method) z.agents/skillsz~/.agents/skillsz.claude/skillsz~/.claude/skills--token--quiet--formatzKOutput format: `--format json` (or `--json`) or `--format table` (default).zXUse a User Access Token. Prefer setting `HF_TOKEN` env var instead of passing `--token`.z&--format [auto|human|agent|json|quiet]z Manage skills for AI assistants.helpc$V^8dQhR\/#returnstr)formats"k/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/huggingface_hub/cli/skills.py __annotate__rs>>>c\VPRR4pV'd'RRPRV44,R,#\VPRR4P4;'gR #) zValue hint for an option: enum choices inline as ``[a|b|c]``, otherwise the TYPE name. e.g. `--sort [downloads|likes|trending_score]` instead of `--sort CHOICE`. choicesN[|c38"TFp\V4xK R#5iNr).0cs& r _type_hint..s6gc!ffgs]nameVALUE)getattrtypejoinupper)paramr s& r _type_hintr2s\ ejj)T2GSXX6g666<< 5::vr * 0 0 2 = =g=rc0V^8dQhR\R\/#rcmdr)rr)rs"rrrsCrc .pVPFpVP'dVPR8XdK(VP'd$VPP R4'dK]\ R\ VR.44R4pVe$\V4pVPV RV 24KVP'gKVPVP4K RPV4#)zMFormat required params: positional as UPPER_CASE, options as ``--name TYPE``.--help_c3V"TFqPR4'gKVxK! R#5i)--N) startswith)r%os& rr'!_format_params..sR%;||D?Q!!%;s) )optsN ) paramsrequiredhuman_readable_namer*r;nextr-r2appendr/)r5partsp long_name type_names& r_format_paramsrIs E ZZzzzQ22h>  666aff'',, RWQ%;RTXY  "1 I LLI;a {3 4 VVV LL.. / 88E?rc V^8dQhR\R\R\\,R\\\\,\ 3,,/#)rgroupctx path_partsr)rrlistrtupler)rs"rrrsE  % g 49 QUV[\`ad\egn\nVoQp rcJ.p\WVR,R7pVPV4FwpVPWE4pVeVP'dK,.VOVNp\ V\ 4'dVP \WdV44KeVPWv34Ky V#)zXRecursively walk a Click Group, returning (full_path_parts, cmd) for every leaf command.)parent info_name) r list_commandsrhidden isinstancerextend_collect_leaf_commandsrD)rKrLrMleavessub_ctxr*r5 child_paths&&& rrXrXs.0Fe:b>BG##G,. ;#*** (z(4( c5 ! ! MM0zJ K MM:+ ,- Mrc$V^8dQhR\/#)rr5)r)rs"rrrs++w+rc#"VPFpVP'gVPR8XdK(VP'd$VPP R4'dK]RpRp\ VR.4FCpVP R4'dT;'gTpK(VP R4'gKATpKE V'gKWV3xK R#5i)zKYield (param, long_name, short_name) for each optional, non-internal param.r7r8Nr>r:-)r@rArBr*r;r-)r5rFrG short_nameopts& r_iter_optional_paramsras ZZ :::..(:  666aff'',,   1fb)C~~d##%,, $$ * 9 * *s$AC C*5C C> C Cc0V^8dQhR\R\/#r4)rbool)rs"rrrs11g1$1rchVPPR4'dR#\V4'*#)zVReturn True if the leaf command accepts the global '--format' / '--json' / '-q' flags.ignore_unknown_optionsF)context_settingsgetr )r5s&r_accepts_global_format_flagsrhs+  899+C0 00rexcludecvV^8dQhR\R\\,R,R\\,/#)rr5riNr)rsetrrN)rs"rrrs-c#hocrcFa.p\V4F^wr4pS'd VS9dK\VRR4'dVPV4K=\V4pVPV RV 24K` \ V4'd VP V3Rl\ 44V#)aReturn long-form flag names (--foo) for optional, non-internal params. Boolean flags are bare ('--dry-run'). Value-taking options include a type hint ('--include TEXT', '--max-workers INTEGER'). Synthetic global formatting flags are appended for commands that accept them. is_flagFr?c3t<"TF-pS'dVP4^,S9dK)VxK/ R#5i)N)split)r%flagris& rr'"_get_flag_names..s/r&Ad'VZV`V`VbcdVeipVpTT&As 88 8)rar-rDr2rhrW_GLOBAL_FORMAT_INLINE_FLAGS)r5riflagsrFrG_shortrHs&d r_get_flag_namesrvs E 5c :f yG+  1i ' ' LL #"1 I LLI;a {3 4!;$C(( r&Arr LrcV^8dQhR\\\\,\3,,R\\\\\3,3,/#)r leaf_commandsr)rNrOrrdict)rs"rrrsAd3i012 #uS#X rc"/pVFwr#\V4FwrEpV\9dKWQ9g!V'gK#RW,^,9gK9V'dV RV 2MTp\VRR4;'gRPR4^,P 4pWx3W&K K \ ;QJdRV4F 'gK RM RM !RV44'd/\ P4FwrYVPWY4K V#) z0Collect display info for flags in the allowlist.z / rNr+ c3<"TFwr\V4xK R#5ir$)rh)r%_pathr5s& rr'(_compute_common_flags..s M} ' , ,}sTF) ra_COMMON_FLAG_ALLOWLISTr-rpstripany_GLOBAL_COMMON_FLAGSitems setdefault) rx flag_infor}r5rFrGr_display help_textentrys & r_compute_common_flagsrs-/I# (=c(B $A* 66)jjU)J^_`Ja=a;EZLI;79$Q5;;BB4HKQQS (/'; $)C$ s M} Msss M} MMM 4 : : < I   2!= rcRV^8dQhR\\,R\R\/#)rrMr5r)rNrr)rs"rrrs%  T#Y W  rcVVP;'gRPR4^,P4p\V4pR.VOV'dV.M.,pRRP V4 RV 2p\ V\ R7pV'dVRRP V4 R 2, pV#) z6Render a single leaf command as a markdown list entry.r+r{hf- `r?` — )riz `[z]`)rrprrIr/rv_INLINE_FLAG_EXCLUDE)rMr5rr@rErrts&& r _render_leafrsR&&t,Q/557I C F  J vF82 >E#((5/"& 4E C)= >E  3sxx'r** Lrc$V^8dQhR\/#rr)rs"rrrs>>>rcl^RIHp^RIHp\ V4p\ VRR7p.p.p\ VPV44FjpVP W64pVeVP'dK,\V\4'dVPWg34KVVPV.V34Kl .p\V4p VF5wrj\WV.4p VPWk34V PV 4K7 \V 4p \\ P#44p V PR4V PRV R24V PR4V PR4V PR4VFwrV P\%W44K! \'V4pVFwrkW,pVP(;'gRP+R 4^,P-4pV PR4V PR V R V 24V PR4V FwrV P\%W44K! K V 'dV PR4V PR 4V PR4\ V P/44FUwpwpp\0P3VV4pV'dV PR V R V 24K@V PR V R24KW V P\4P#44R P7V 4#)ro) __version__)appr)rRr+z!Generated with `huggingface_hub vz-`. Run `hf skills add --force` to regenerate.z ## Commandsr{z### `hf rz## Common optionsr`)huggingface_hubrhuggingface_hub.cli.hfrrrsortedrTrUrVrrDrNrXrWr_SKILL_YAML_PREFIX splitlinesrryrrprr_COMMON_FLAG_HELP_OVERRIDESrg _SKILL_TIPSr/)rr click_apprL top_levelgroupsr*r5 group_leavesall_leaf_commandsrKrY common_flagslinesrM groups_dict group_cmdrrGrs rbuild_skill_mdrs+*C I )t ,C13I&(Fy..s34##C. ;#***  c5 ! ! MM4+ &   tfc] +5GIL9=i 'TF;TN+  ( )):;L.99; s7)1-. 0L LL'')* 99U rc4V^8dQhR\R\RR/#)rpathforcerN)rrc)rs"rrrHs!  4   rc8VP4'gVP4'gR#V'g\RV R24hVP4'd/VP4'g\P !V4R#VP 4R#)zRRemove existing file/directory/symlink if force is True, otherwise raise an error.NzSkill already exists at z#. Re-run with --force to overwrite.)exists is_symlinkris_dirshutilrmtreeunlink)rrs&&r_remove_existingrHsa KKMMT__.. 1$7[\]] {{}}T__.. d rcHV^8dQhR\R\R\R\/#)r skills_dir skill_namerrrrrc)rs"rrrTs.MMDMcM$M4Mrcx\P!WVR7# \dp\T R24ThRp?ii;i)zPInstall a marketplace skill into a skills directory. Returns the installed path.)rz" Re-run with --force to overwrite.N)r add_skillFileExistsErrorr)rrrexcs&&& r _install_torTsBM  uEE M#ABCLMs 949c TV^8dQhR\R\R\R\R\/#)ragent_skills_dirrcentral_skill_pathrrr)rs"rrr\s2  d  QU ^b gk rcVP4P4pVPRRR7W, p\WC4VP \ P PW 44V#)zMCreate a relative symlink from agent directory to the central skill location.T)parentsexist_ok) expanduserresolvemkdirr symlink_toosrrelpath)rrrr link_paths&&&& r_create_symlinkr\s_'224<<>4$7 -IY& );NO rc lV^8dQhR\R\R\R,R\\,/#)rclaudeglobal_destNr)rcrrN)rs"rrrhs:;; ;; + ;  $Z ;rcbVe;V'g V'd \R4hVP4P4.#V'd\M\.pV'd$TP V'd\ M\4VUu.uF qDP4P4NK" up#uupi)N4--dest cannot be combined with --claude or --global.)rrrCENTRAL_GLOBAL CENTRAL_LOCALrD CLAUDE_GLOBAL CLAUDE_LOCAL)rrrrootsroots$$$ r_resolve_update_rootsrhsy   WQR R!))+,,+2 FE  g]<@49 :EDOO  % % 'E :: :s&B,previewcV^8dQhRR/#)rrN)rs"rrrzsrc,\\44R#)z0Print the generated `hf-cli` SKILL.md to stdout.N)printrrrrskills_previewrys . rz list | lszhf skills listzhf skills list --format json)examplesc(V^8dQhR\RR/#)rtokenrN)r )rs"rrrs!! ! !rc"R\3R\3R\3R\3.p/pVFdwr4\P !V.4FDpVP VPP4\44PV4KF Kf \VR7p\4;_uu_4\P!V4pRRR4XUUU u.uFvpRVPRVP;'gR /VUU u/uF@wr9Y3VPVPP4\449dR MR bKB up pCNKx p ppp \ P"!V RRR RR RR RR /R 7R# +'giL;iuup piuup ppi) z8List available skills from the Hugging Face marketplace.projectzproject (claude)globalzglobal (claude))rNr* descriptionr+yesright)id_key alignments)rrrrr _iter_unique_skill_dirsrr*lowerrkaddr r _load_marketplace_skillsrrgrtable) rinstall_locations installedlabelr skill_dirapiskillsskillr8resultss & r skills_listrsw M" \* >" M* 1 &(I(  88$@I  !5!5!7 ? C CE JA) 5 !C  11#6 ! E EJJ 5,,22 !2 1HEuzz7G7G7I35)Q QuWYY 1  IIw';MwXikrs !  s+)E1$F 3F ;AF F 1 F F rFcV^8dQhR\\\P!RRR73,R\\\P !RRR73,R \\\P !R R R R73,R \\ R,\P !RR73,R\\\P !RRR73,RR/#)rr*zMarketplace skill name.Fr show_defaultr--claudezInstall for Claude.rr--global-gzJInstall globally (user-level) instead of in the current project directory.rNz=Install into a custom destination (path to skills directory).rz--forcez-Overwrite existing skills in the destination.rrrtyperArgumentrcOptionr)rs"rrrs0/0/   5EJ L 0/ dELL:OPP Q 0/    ]   0/  t  P   0/(   @   )0/6 70/rcTVe;V'g V'd \R4h\W0V4p\RV RV 24R#V'd\M\p\W`V4p\RV RV 24V'd1V'd\ M\ p\WWt4p \RV 24R#R#)aDownload a Hugging Face skill and install it for an AI assistant. Default location is in the current directory (.agents/skills) or user-level (~/.agents/skills). If `--claude` is specified, the skill is also symlinked into Claude's legacy skills directory. Nrz Installed 'z' to z' to central location: zCreated symlink: )rrrrrrrr) r*rrrr skill_dest central_pathr agent_targetrs &&&&& r skills_addrsV  WQR R U3  D6zl34&->-L$\? Kv45G4H IJ (/}\ #L8JR  !)-.rupdatec V^8dQhR\\R,\P!RRR73,R\\\P !RRR 73,R \\\P !R R R R 73,R\\ R,\P !RR 73,RR/#)rr*Nz(Optional installed skill name to update.Frrrz#Update skills installed for Claude.rrrrz=Use global skills directories instead of the current project.rz+Update skills in a custom skills directory.rr)rs"rrrs99  d  FUZ[ ] 9 dELL:_`` a 9    P   9  t  >   9( )9rc\WVR7p\P!W@R7pV'g\R4R#VFMpVP'dRVP R2MRp\VP RVP V 24KO R#) z1Update installed Hugging Face marketplace skills.)rrr)selectorzNo installed skills found.Nz ()r+z: )rr update_skillsrdetailr*status)r*rrrrrresultr s&&&& r skills_updater st> "t LE##E9G  *+*0---2fmm_A&R  R vh78rcV^8dQh/^\9d\\\3,;R&^\9d,\\\\\3,3,;R&#)rrr)__conditional_annotations__ryrrO)rs"rrrsVRT#s(^Sfd3c3h/0gr>--typerrr --revision)rzOutput format.)z -q / --quietzQuiet output (one ID per line).r$)z hf skills addz3hf skills add huggingface-gradio --dest=~/my-skillszhf skills add --globalzhf skills add --claudez2hf skills add huggingface-gradio --claude --global)zhf skills updatezhf skills update hf-cliz6hf skills update huggingface-gradio --dest=~/my-skillszhf skills update --claude)NFFN)=r__doc__rrpathlibrtypingrrclickrrr typer.mainrhuggingface_hub.errorsrutilsr r+r _cli_utilsr r r r_outputrDEFAULT_SKILL_ID_SKILL_DESCRIPTIONrrrrrrrrrrsr skills_clir2rIrXrarhrvrrrrrrrcommandrrrr r)rs@rrs(  ))"+)YY20""#  &%& ()$% '( T!{] i/ HH. B4  B C >"  +$1(2 >B M ;" I  &!!H    TY   50/ 0/f  99r