Merge branch 'main' into add-video-to-video

Author: merveenoyan

.github/workflows/documentation.yml

@@ -11,7 +11,7 @@ on:
       - "README.md"
       - "packages/hub/README.md"
       - "packages/inference/README.md"
-      - "packages/agents/README.md"
+      - "packages/tiny-agents/README.md"
       - ".github/workflows/documentation.yml"
 
 jobs:

.github/workflows/pr-documentation.yml

@@ -8,7 +8,7 @@ on:
       - "packages/hub/README.md"
       - "packages/doc-internal/**"
       - "packages/inference/README.md"
-      - "packages/agents/README.md"
+      - "packages/tiny-agents/README.md"
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}

README.md

@@ -97,8 +97,8 @@ You can run our packages with vanilla JS, without any bundler, by using a CDN or
 
 ```html
 <script type="module">
-    import { InferenceClient } from 'https://cdn.jsdelivr.net/npm/@huggingface/inference@3.13.2/+esm';
-    import { createRepo, commit, deleteRepo, listFiles } from "https://cdn.jsdelivr.net/npm/@huggingface/hub@2.1.0/+esm";
+    import { InferenceClient } from 'https://cdn.jsdelivr.net/npm/@huggingface/inference@4.0.6/+esm';
+    import { createRepo, commit, deleteRepo, listFiles } from "https://cdn.jsdelivr.net/npm/@huggingface/hub@2.2.0/+esm";
 </script>
 ```
 

docs/_toctree.yml

@@ -18,14 +18,12 @@
   isExpanded: true
   sections:
     - local: mcp-client/README
-      title: Simple MCP Client and smol Agent built on top of Inference Client
-- title: "@huggingface/agent"
+      title: Simple MCP Client built on top of Inference Client
+- title: "@huggingface/tiny-agents"
   isExpanded: true
   sections:
-    - local: agents/README
-      title: Use Agents to run multi-modal workflows from a natural language API
-    - local: agents/modules
-      title: API Reference
+    - local: tiny-agents/README
+      title: A lightweight MCP-powered Agent built on top of Inference Client
 - title: "@huggingface/space-header"
   isExpanded: true
   sections:

packages/doc-internal/package.json

@@ -5,16 +5,16 @@
 	"description": "Package to generate doc for other @huggingface packages",
 	"private": true,
 	"scripts": {
-		"start": "pnpm run fix-cdn-versions && pnpm run doc-hub && pnpm run doc-inference && pnpm run doc-agents && pnpm run doc-space-header && pnpm run doc-gguf && pnpm run doc-mcp-client && cp ../../README.md ../../docs/index.md && pnpm run update-toc && pnpm run fix-md-links && pnpm run fix-md-headinghashlinks",
+		"start": "pnpm run fix-cdn-versions && pnpm run doc-hub && pnpm run doc-inference && pnpm run doc-space-header && pnpm run doc-gguf && pnpm run doc-mcp-client && pnpm run doc-tiny-agents && cp ../../README.md ../../docs/index.md && pnpm run update-toc && pnpm run fix-md-links && pnpm run fix-md-headinghashlinks",
 		"lint": "eslint --quiet --fix --ext .cjs,.ts .",
 		"lint:check": "eslint --ext .cjs,.ts .",
 		"format": "prettier --write .",
 		"format:check": "prettier --check .",
 		"doc-hub": "typedoc --tsconfig ../hub/tsconfig.json --githubPages false --plugin typedoc-plugin-markdown --out ../../docs/hub --hideBreadcrumbs --hideInPageTOC --sourceLinkTemplate https://github.com/huggingface/huggingface.js/blob/main/{path}#L{line} ../hub/index.ts",
 		"doc-inference": "typedoc --tsconfig ../inference/tsconfig.json --githubPages false --plugin typedoc-plugin-markdown --out ../../docs/inference --hideBreadcrumbs --hideInPageTOC --sourceLinkTemplate https://github.com/huggingface/huggingface.js/blob/main/{path}#L{line} ../inference/src/index.ts",
-		"doc-agents": "typedoc --tsconfig ../agents/tsconfig.json --githubPages false --plugin typedoc-plugin-markdown --out ../../docs/agents --hideBreadcrumbs --hideInPageTOC --sourceLinkTemplate https://github.com/huggingface/huggingface.js/blob/main/{path}#L{line} ../agents/src/index.ts",
 		"doc-gguf": "mkdir -p ../../docs/gguf && cp ../../packages/gguf/README.md ../../docs/gguf/README.md",
 		"doc-mcp-client": "mkdir -p ../../docs/mcp-client && cp ../../packages/mcp-client/README.md ../../docs/mcp-client/README.md",
+		"doc-tiny-agents": "mkdir -p ../../docs/tiny-agents && cp ../../packages/tiny-agents/README.md ../../docs/tiny-agents/README.md",
 		"doc-space-header": "mkdir -p ../../docs/space-header && cp ../../packages/space-header/README.md ../../docs/space-header/README.md",
 		"update-toc": "tsx update-toc.ts",
 		"fix-cdn-versions": "tsx fix-cdn-versions.ts",

packages/hub/cli.ts

@@ -2,7 +2,7 @@
 
 import { parseArgs } from "node:util";
 import { typedEntries } from "./src/utils/typedEntries";
-import { createBranch, createRepo, deleteBranch, repoExists, uploadFilesWithProgress } from "./src";
+import { createBranch, createRepo, deleteBranch, deleteRepo, repoExists, uploadFilesWithProgress } from "./src";
 import { pathToFileURL } from "node:url";
 import { stat } from "node:fs/promises";
 import { basename, join } from "node:path";
@@ -78,7 +78,6 @@ const commands = {
 			{
 				name: "repo-type" as const,
 				enum: ["dataset", "model", "space"],
-				default: "model",
 				description:
 					"The type of repo to upload to. Defaults to model. You can also prefix the repo name with the type, e.g. datasets/username/repo-name",
 			},
@@ -126,9 +125,8 @@ const commands = {
 					{
 						name: "repo-type" as const,
 						enum: ["dataset", "model", "space"],
-						default: "model",
 						description:
-							"The type of repo to create. Defaults to model. You can also prefix the repo name with the type, e.g. datasets/username/repo-name",
+							"The type of the repo to create the branch into. Defaults to model. You can also prefix the repo name with the type, e.g. datasets/username/repo-name",
 					},
 					{
 						name: "revision" as const,
@@ -173,7 +171,6 @@ const commands = {
 					{
 						name: "repo-type" as const,
 						enum: ["dataset", "model", "space"],
-						default: "model",
 						description:
 							"The type of repo to delete the branch from. Defaults to model. You can also prefix the repo name with the type, e.g. datasets/username/repo-name",
 					},
@@ -187,6 +184,35 @@ const commands = {
 			},
 		},
 	} satisfies CommandGroup,
+	repo: {
+		description: "Manage repositories on the Hub",
+		subcommands: {
+			delete: {
+				description: "Delete a repository from the Hub",
+				args: [
+					{
+						name: "repo-name" as const,
+						description:
+							"The name of the repo to delete. You can also prefix the repo name with the type, e.g. datasets/username/repo-name",
+						positional: true,
+						required: true,
+					},
+					{
+						name: "repo-type" as const,
+						enum: ["dataset", "model", "space"],
+						description:
+							"The type of the repo to delete. Defaults to model. You can also prefix the repo name with the type, e.g. datasets/username/repo-name",
+					},
+					{
+						name: "token" as const,
+						description:
+							"The access token to use for authentication. If not provided, the HF_TOKEN environment variable will be used.",
+						default: process.env.HF_TOKEN,
+					},
+				] as const,
+			},
+		},
+	} satisfies CommandGroup,
 	version: {
 		description: "Print the version of the CLI",
 		args: [] as const,
@@ -389,6 +415,54 @@ async function run() {
 			}
 			break;
 		}
+		case "repo": {
+			const repoCommandGroup = commands.repo;
+			const currentSubCommandName = subCommandName as keyof typeof repoCommandGroup.subcommands | undefined;
+
+			if (cliArgs[0] === "--help" || cliArgs[0] === "-h") {
+				if (currentSubCommandName && repoCommandGroup.subcommands[currentSubCommandName]) {
+					console.log(detailedUsageForSubcommand("repo", currentSubCommandName));
+				} else {
+					console.log(listSubcommands("repo", repoCommandGroup));
+				}
+				break;
+			}
+
+			if (!currentSubCommandName || !repoCommandGroup.subcommands[currentSubCommandName]) {
+				console.error(`Error: Missing or invalid subcommand for 'repo'.`);
+				console.log(listSubcommands("repo", repoCommandGroup));
+				process.exitCode = 1;
+				break;
+			}
+
+			const subCmdDef = repoCommandGroup.subcommands[currentSubCommandName];
+
+			switch (currentSubCommandName) {
+				case "delete": {
+					const parsedArgs = advParseArgs(cliArgs, subCmdDef.args, `repo ${currentSubCommandName}`);
+					const { repoName, repoType, token } = parsedArgs;
+
+					const repoDesignation: Parameters<typeof deleteRepo>[0]["repo"] = repoType
+						? { type: repoType as "model" | "dataset" | "space", name: repoName }
+						: repoName;
+
+					await deleteRepo({
+						repo: repoDesignation,
+						accessToken: token,
+						hubUrl: process.env.HF_ENDPOINT ?? HUB_URL,
+					});
+					console.log(`Repository '${repoName}' deleted successfully.`);
+					break;
+				}
+				default:
+					// This case should ideally be caught by the check above
+					console.error(`Error: Unknown subcommand '${currentSubCommandName}' for 'repo'.`);
+					console.log(listSubcommands("repo", repoCommandGroup));
+					process.exitCode = 1;
+					break;
+			}
+			break;
+		}
 		case "version": {
 			if (cliArgs[0] === "--help" || cliArgs[0] === "-h") {
 				console.log(detailedUsageForCommand("version"));

packages/hub/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@huggingface/hub",
 	"packageManager": "[email protected]",
-	"version": "2.1.0",
+	"version": "2.2.0",
 	"description": "Utilities to interact with the Hugging Face hub",
 	"repository": "https://github.com/huggingface/huggingface.js.git",
 	"publishConfig": {

packages/hub/src/lib/file-download-info.spec.ts

@@ -5,7 +5,7 @@ describe("fileDownloadInfo", () => {
 	it("should fetch LFS file info", async () => {
 		const info = await fileDownloadInfo({
 			repo: {
-				name: "bert-base-uncased",
+				name: "google-bert/bert-base-uncased",
 				type: "model",
 			},
 			path: "tf_model.h5",
@@ -19,7 +19,7 @@ describe("fileDownloadInfo", () => {
 	it("should fetch raw LFS pointer info", async () => {
 		const info = await fileDownloadInfo({
 			repo: {
-				name: "bert-base-uncased",
+				name: "google-bert/bert-base-uncased",
 				type: "model",
 			},
 			path: "tf_model.h5",
@@ -34,7 +34,7 @@ describe("fileDownloadInfo", () => {
 	it("should fetch non-LFS file info", async () => {
 		const info = await fileDownloadInfo({
 			repo: {
-				name: "bert-base-uncased",
+				name: "google-bert/bert-base-uncased",
 				type: "model",
 			},
 			path: "tokenizer_config.json",

packages/hub/src/lib/file-exists.spec.ts

@@ -5,7 +5,7 @@ describe("fileExists", () => {
 	it("should return true for file that exists", async () => {
 		const info = await fileExists({
 			repo: {
-				name: "bert-base-uncased",
+				name: "google-bert/bert-base-uncased",
 				type: "model",
 			},
 			path: "tf_model.h5",
@@ -18,7 +18,7 @@ describe("fileExists", () => {
 	it("should return false for file that does not exist", async () => {
 		const info = await fileExists({
 			repo: {
-				name: "bert-base-uncased",
+				name: "google-bert/bert-base-uncased",
 				type: "model",
 			},
 			path: "tf_model.h5dadazdzazd",

packages/hub/src/lib/list-files.spec.ts

@@ -6,7 +6,7 @@ describe("listFiles", () => {
 	it("should fetch the list of files from the repo", async () => {
 		const cursor = listFiles({
 			repo: {
-				name: "bert-base-uncased",
+				name: "google-bert/bert-base-uncased",
 				type: "model",
 			},
 			revision: "dd4bc8b21efa05ec961e3efc4ee5e3832a3679c7",
@@ -67,7 +67,7 @@ describe("listFiles", () => {
 	it("should fetch the list of files from the repo, including last commit", async () => {
 		const cursor = listFiles({
 			repo: {
-				name: "bert-base-uncased",
+				name: "google-bert/bert-base-uncased",
 				type: "model",
 			},
 			revision: "dd4bc8b21efa05ec961e3efc4ee5e3832a3679c7",