Add cli for @huggingface/hub

package.json

@@ -26,7 +26,7 @@
 		"tshy": "^3.0.2",
 		"tsup": "^6.7.0",
 		"tsx": "^4.7.0",
-		"typescript": "^5.4.2",
+		"typescript": "^5.8.3",
 		"vite": "^5.0.2",
 		"vitest": "^0.34.6",
 		"webdriverio": "^8.6.7"

packages/hub/README.md

@@ -93,6 +93,35 @@ for await (const fileInfo of hub.listFiles({repo})) {
 await hub.deleteRepo({ repo, accessToken: "hf_..." });
 ```
 
+## CLI usage
+
+You can use `@huggingface/hub` in CLI mode to upload files and folders to your repo. 
+
+```console
+npx @huggingface/hub upload coyotte508/test-model .
+npx @huggingface/hub upload datasets/coyotte508/test-dataset .
+# Same thing
+npx @huggingface/hub upload --repo-type dataset coyotte508/test-dataset .
+# Upload new data with 0 history in a separate branch
+npx @huggingface/hub create-branch coyotte508/test-model release --empty
+npx @huggingface/hub upload coyotte508/test-model . --revision release
+
+npx @huggingface/hub --help
+npx @huggingface/hub upload --help
+```
+
+You can also instal globally with `npm install -g @huggingface/hub`. Then you can do:
+
+```console
+hfjs upload coyotte508/test-model .
+
+hfjs create-branch --repo-type dataset coyotte508/test-dataset release --empty
+hfjs upload --repo-type dataset coyotte508/test-dataset . --revision release
+
+hfjs --help
+hfjs  upload --help
+```
+
 ## OAuth Login
 
 It's possible to login using OAuth (["Sign in with HF"](https://huggingface.co/docs/hub/oauth)).