A lot of vibe coding....

Author: julien-c

packages/mcp-client/src/index.ts

@@ -1,3 +1,4 @@
 export * from "./McpClient";
 export * from "./Agent";
 export type { ChatCompletionInputMessageTool } from "./McpClient";
+export type { ServerConfig } from "./types";

packages/tiny-agents/README.md

@@ -12,7 +12,26 @@ yarn add @huggingface/tiny-agents
 pnpm add @huggingface/tiny-agents
 ```
 
-## Usage
+## CLI Usage
+
+```bash
+npx @huggingface/tiny-agents [command] "agent/id"
+
+```
+
+```
+Usage:
+  tiny-agents [flags]
+  tiny-agents run   "agent/id"
+  tiny-agents serve "agent/id"
+
+Available Commands:
+  run         Run the Agent in command-line
+  serve       Run the Agent as an OpenAI-compatible HTTP server
+```
+
+
+## Programmatic Usage
 
 ```typescript
 import { Agent } from '@huggingface/tiny-agents';
@@ -46,11 +65,6 @@ for await (const chunk of agent.run("What are the top 5 trending models on Huggi
 }
 ```
 
-## CLI Usage
-
-```bash
-npx @huggingface/tiny-agents
-```
 
 ## License
 

packages/tiny-agents/package.json

@@ -24,6 +24,7 @@
 		"node": ">=18"
 	},
 	"source": "index.ts",
+	"type": "module",
 	"scripts": {
 		"lint": "eslint --quiet --fix --ext .cjs,.ts .",
 		"lint:check": "eslint --ext .cjs,.ts .",
@@ -34,7 +35,7 @@
 		"prepare": "pnpm run build",
 		"test": "vitest run",
 		"check": "tsc",
-		"cli": "tsx cli.ts"
+		"cli": "tsx src/cli.ts"
 	},
 	"files": [
 		"src",
@@ -52,6 +53,7 @@
 	"license": "MIT",
 	"dependencies": {
 		"@huggingface/inference": "workspace:^",
-		"@huggingface/mcp-client": "workspace:^"
+		"@huggingface/mcp-client": "workspace:^",
+		"zod": "^3.24.4"
 	}
 }

packages/tiny-agents/pnpm-lock.yaml

@@ -0,0 +1,12 @@
+{
+	"model": "Qwen/Qwen3-32B",
+	"provider": "novita",
+	"servers": [
+		{
+			"type": "sse",
+			"config": {
+				"url": "https://evalstate-flux1-schnell.hf.space/gradio_api/mcp/sse"
+			}
+		}
+	]
+}

packages/tiny-agents/src/agents/julien-c/flux-schnell-generator/agent.json

@@ -0,0 +1,5 @@
+You are an agent - please keep going until the user’s query is completely resolved, before ending your turn and yielding back to the user. Only terminate your turn when you are sure that the problem is solved, or if you need more info from the user to solve the problem.
+
+If you are not sure about anything pertaining to the user’s request, use your tools to read files and gather the relevant information: do NOT guess or make up an answer.
+
+You MUST plan extensively before each function call, and reflect extensively on the outcomes of the previous function calls. DO NOT do this entire process by making function calls only, as this can impair your ability to solve the problem and think insightfully.

packages/tiny-agents/src/agents/julien-c/local-coder/PROMPT.md

@@ -0,0 +1,13 @@
+{
+	"model": "Qwen/Qwen2.5-72B-Instruct",
+	"provider": "nebius",
+	"servers": [
+		{
+			"type": "stdio",
+			"config": {
+				"command": "npx",
+				"args": ["@playwright/mcp@latest"]
+			}
+		}
+	]
+}

packages/tiny-agents/src/agents/julien-c/local-coder/agent.json

@@ -1,57 +1,109 @@
 #!/usr/bin/env node
 import * as readline from "node:readline/promises";
 import { stdin, stdout } from "node:process";
-import { join } from "node:path";
-import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { parseArgs } from "node:util";
+import { z } from "zod";
 import type { InferenceProviderOrPolicy } from "@huggingface/inference";
+import { PROVIDERS_OR_POLICIES } from "@huggingface/inference";
 import { version as packageVersion } from "../package.json";
+import { readFile } from "node:fs/promises";
+import type { ServerConfig } from "@huggingface/mcp-client";
 
-const SERVERS: ServerConfig[] = [
-	{
-		// Filesystem "official" mcp-server with access to your Desktop
-		command: "npx",
-		args: [
-			"-y",
-			"@modelcontextprotocol/server-filesystem",
-			process.platform === "darwin" ? join(homedir(), "Desktop") : homedir(),
-		],
-	},
-	{
-		// Playwright MCP
-		command: "npx",
-		args: ["@playwright/mcp@latest"],
-	},
-];
+const USAGE_HELP = `
+Usage:
+  tiny-agents [flags]
+  tiny-agents run   "agent/id"
+  tiny-agents serve "agent/id"
+
+Available Commands:
+  run         Run the Agent in command-line
+  serve       Run the Agent as an OpenAI-compatible HTTP server
+
+Flags:
+  -h, --help      help for tiny-agents
+  -v, --version   Show version information
+`.trim();
+
+const CLI_COMMANDS = ["run", "serve"] as const;
+function isValidCommand(command: string): command is (typeof CLI_COMMANDS)[number] {
+	return (CLI_COMMANDS as unknown as string[]).includes(command);
+}
+
+const FILENAME_CONFIG = "agent.json";
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const FILENAME_PROMPT = "PROMPT.md";
 
 async function main() {
 	const {
-		values: { url: urls },
+		values: { help, version },
+		positionals,
 	} = parseArgs({
 		options: {
-			url: {
-				type: "string",
-				multiple: true,
+			help: {
+				type: "boolean",
+				short: "h",
+			},
+			version: {
+				type: "boolean",
+				short: "v",
 			},
 		},
+		allowPositionals: true,
 	});
-	if (urls?.length) {
-		while (SERVERS.length) {
-			SERVERS.pop();
-		}
-		for (const url of urls) {
-			try {
-				SERVERS.push(urlToServerConfig(url, process.env.HF_TOKEN));
-			} catch (error) {
-				console.error(`Error adding server from URL "${url}": ${error.message}`);
-			}
-		}
-	}
-
-	if (process.argv.includes("--version")) {
+	if (version) {
 		console.log(packageVersion);
 		process.exit(0);
 	}
+	const command = positionals[0];
+	const loadFrom = positionals[1];
+	if (help) {
+		console.log(USAGE_HELP);
+		process.exit(0);
+	}
+	if (positionals.length !== 2 || !isValidCommand(command)) {
+		console.error(`You need to call run or serve, followed by an agent id (local path or Hub identifier).`);
+		console.log(USAGE_HELP);
+		process.exit(1);
+	}
+
+	if (command === "serve") {
+		console.error(`Serve is not implemented yet, coming soon!`);
+		process.exit(1);
+	} else {
+		const srcDir = dirname(fileURLToPath(import.meta.url));
+		const configPath = join(srcDir, "agents", loadFrom, FILENAME_CONFIG);
+		let configJson: string;
+		try {
+			configJson = await readFile(configPath, { encoding: "utf8" });
+		} catch {
+			console.error(`Config file not found!`);
+			process.exit(1);
+		}
+		const ConfigSchema = z.object({
+			model: z.string(),
+			provider: z.enum<InferenceProviderOrPolicy>(PROVIDERS_OR_POLICIES),
+			servers: z.array(z.custom<ServerConfig>()),
+		});
+
+		let config: z.infer<typeof ConfigSchema>;
+		try {
+			const parsedConfig = JSON.parse(configJson);
+			config = ConfigSchema.parse(parsedConfig);
+		} catch (error) {
+			console.error("Invalid configuration file:", error instanceof Error ? error.message : error);
+			process.exit(1);
+		}
+		const agent = new Agent({
+			provider: config.provider,
+			model: config.model,
+			apiKey: process.env.HF_TOKEN,
+			servers: config.servers,
+		});
+		console.log(agent);
+		// TODO: hook main loop from mcp-client/cli.ts
+	}
 }
 
 main();