Unofficial Hugging Face client with a dash of personality. Hugger brings a touch of colour and flair to your Hugging Face experience, making it easier and more enjoyable to interact with the popular transformer models, datasets, spaces. It also allows to do the same with your private repositories.
- Colourful interface
- Easy model/dataset/space interaction and management
- Fast and reliable
In order to build Hugger for the current platform you can run:
make build
If you want to build Hugger for any other platform you must specify os, for example:
make build-linux
or
make build-windows
The program in located in /cmd-cli directory.
In UNIX-like systems you must move cmd-cli/hugger to any directory in $PATH
or you can optionally include Hugger in your $PATH
environmental variable:
$ export PATH=$PATH:`pwd`/cmd-cli/hugger
In Windows you must do almost the same: just include binary in your %PATH%
.
Examples of usage:
# in cmd-cli/ directory
# show help menu (and fancy banner)
$ ./hugger -h
# download files from repo
$ ./hugger download -repo-id 'username/dataset-example' -filenames my_dataset_0001.parquet -repo-type dataset -token "hf_<your_token_here>"
# upload files from to repo
$ ./hugger upload -repo-id 'username/dataset-example' -filenames my_dataset_0001.parquet,my_dataset_0002.parquet -repo-type dataset -token "hf_<your_token_here>"
# perform actions on files in repo:
# delete file unused_file.test
$ ./hugger repo-files -repo-id '<your_repo_id>' -action delete -file unused_file.test -token "hf_<your_token_here>"
# list files in the / folder of repository
$ ./hugger repo-files -repo-id '<your_repo_id>' -action list -token "hf_<your_token_here>"
# list files in the /model folder of repository
$ ./hugger repo-files -repo-id '<your_repo_id>' -action list -file model -token "hf_<your_token_here>"
# show meta info about repository
$ ./hugger meta -repo-id '<your_repo_id>' -repo-type model -token "hf_<your_token_here>"
If you'd like to contribute to Hugger, please follow these steps:
- Fork the repository and create a new branch for your feature or bug fix
- Make your changes and commit them with a clear and descriptive commit message
- Open a pull request and describe the changes you've made
The contribution in the following areas are welcome:
- Bug fixes and stability improvements
- New features and model integrations
- UI/UX enhancements and customizations
- Documentation and testing improvements
Thanks for considering a contribution to Hugger!