some LLM scaffolding + some human edit 🙄

Author: julien-c

README.md

@@ -241,8 +241,8 @@ const agent = new Agent({
   ],
 });
 
-
 await agent.loadTools();
+
 for await (const chunk of agent.run("What are the top 5 trending models on Hugging Face?")) {
     if ("choices" in chunk) {
         const delta = chunk.choices[0]?.delta;

packages/tiny-agents/README.md

@@ -0,0 +1,57 @@
+# @huggingface/tiny-agents
+
+A lightweight, composable agent framework for AI applications built on Hugging Face's JS stack.
+
+## Installation
+
+```bash
+npm install @huggingface/tiny-agents
+# or
+yarn add @huggingface/tiny-agents
+# or
+pnpm add @huggingface/tiny-agents
+```
+
+## Usage
+
+```typescript
+import { Agent } from '@huggingface/tiny-agents';
+
+const HF_TOKEN = "hf_...";
+
+// Create an Agent
+const agent = new Agent({
+  provider: "auto",
+  model: "Qwen/Qwen2.5-72B-Instruct",
+  apiKey: HF_TOKEN,
+  servers: [
+    {
+      // Playwright MCP
+      command: "npx",
+      args: ["@playwright/mcp@latest"],
+    },
+  ],
+});
+
+await agent.loadTools();
+
+// Use the Agent
+for await (const chunk of agent.run("What are the top 5 trending models on Hugging Face?")) {
+    if ("choices" in chunk) {
+        const delta = chunk.choices[0]?.delta;
+        if (delta.content) {
+            console.log(delta.content);
+        }
+    }
+}
+```
+
+## CLI Usage
+
+```bash
+npx @huggingface/tiny-agents
+```
+
+## License
+
+MIT

packages/tiny-agents/package.json

@@ -0,0 +1,57 @@
+{
+	"name": "@huggingface/tiny-agents",
+	"packageManager": "[email protected]",
+	"version": "0.1.0",
+	"description": "Lightweight, composable agents for AI applications",
+	"repository": "https://github.com/huggingface/huggingface.js.git",
+	"publishConfig": {
+		"access": "public"
+	},
+	"main": "./dist/index.js",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.ts",
+	"bin": {
+		"tiny-agents": "./dist/cli.js"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"require": "./dist/index.js",
+			"import": "./dist/index.mjs"
+		}
+	},
+	"engines": {
+		"node": ">=18"
+	},
+	"source": "index.ts",
+	"scripts": {
+		"lint": "eslint --quiet --fix --ext .cjs,.ts .",
+		"lint:check": "eslint --ext .cjs,.ts .",
+		"format": "prettier --write .",
+		"format:check": "prettier --check .",
+		"prepublishOnly": "pnpm run build",
+		"build": "tsup src/index.ts --format cjs,esm --clean && tsc --emitDeclarationOnly --declaration",
+		"prepare": "pnpm run build",
+		"test": "vitest run",
+		"check": "tsc",
+		"cli": "tsx cli.ts"
+	},
+	"files": [
+		"src",
+		"dist",
+		"tsconfig.json"
+	],
+	"keywords": [
+		"huggingface",
+		"agent",
+		"ai",
+		"llm",
+		"tiny-agent"
+	],
+	"author": "Hugging Face",
+	"license": "MIT",
+	"dependencies": {
+		"@huggingface/inference": "workspace:^",
+		"@huggingface/mcp-client": "workspace:^"
+	}
+}

packages/tiny-agents/src/cli.ts

@@ -0,0 +1,57 @@
+#!/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 { parseArgs } from "node:util";
+import type { InferenceProviderOrPolicy } from "@huggingface/inference";
+import { version as packageVersion } from "../package.json";
+
+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"],
+	},
+];
+
+async function main() {
+	const {
+		values: { url: urls },
+	} = parseArgs({
+		options: {
+			url: {
+				type: "string",
+				multiple: 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")) {
+		console.log(packageVersion);
+		process.exit(0);
+	}
+}
+
+main();

packages/tiny-agents/src/index.ts

@@ -0,0 +1 @@
+

packages/tiny-agents/tsconfig.json

@@ -0,0 +1,21 @@
+{
+	"compilerOptions": {
+		"allowSyntheticDefaultImports": true,
+		"lib": ["ES2022", "DOM"],
+		"module": "CommonJS",
+		"moduleResolution": "node",
+		"target": "ES2022",
+		"forceConsistentCasingInFileNames": true,
+		"strict": true,
+		"noImplicitAny": true,
+		"strictNullChecks": true,
+		"skipLibCheck": true,
+		"noImplicitOverride": true,
+		"outDir": "./dist",
+		"declaration": true,
+		"declarationMap": true,
+		"resolveJsonModule": true
+	},
+	"include": ["src", "test"],
+	"exclude": ["dist"]
+}