Huggingface.js

Join the Hugging Face community

and get access to the augmented documentation experience

Collaborate on models, datasets and Spaces

Faster examples with accelerated inference

Switch between documentation themes

to get started

@huggingface/tiny-agents

meme

Hugging Face'in Inference Client ve MCP yığını üzerine inşa edilmiş, hafif ve birleştirilebilir yapay zeka uygulamalarından oluşan bir ekip.

Kurulum

npm install @huggingface/tiny-agents
# or
pnpm add @huggingface/tiny-agents

CLI Kullanımı

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

Ajanları doğrudan Hugging Face Hub tiny-agents veri setinden yükleyebilir veya kendi yerel ajan yapılandırmanızın yolunu belirtebilirsiniz.

Kendi ajanınızı tanımlayın

Kendi ajanınızı oluşturmanın en basit yolu, agent.json dosyası içeren bir klasör oluşturmaktır:

mkdir my-agent
touch my-agent/agent.json

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

Veya yerel veya uzak bir uç nokta URL'si kullanın:

{
	"model": "Qwen/Qwen3-32B",
	"endpointUrl": "http://localhost:1234/v1",
	"servers": [
		{
			"type": "stdio",
			"command": "npx",
			"args": ["@playwright/mcp@latest"]
		}
	]
}

Burada servers, MCP sunucularının bir listesidir (Stdio, SSE ve HTTP sunucularını destekliyoruz).

İsteğe bağlı olarak, varsayılan Agent istemcisini geçersiz kılmak için bir AGENTS.md (veya PROMPT.md) dosyası ekleyebilirsiniz.

Sonra tiny-agents'ı yerel klasörünüze yönlendirin:

npx @huggingface/tiny-agents run ./my-agent

İşte! 🔥

Tiny Agents koleksiyonu

Tiny Agents koleksiyonumuzun derlenmiş halini https://huggingface.co/datasets/tiny-agents/tiny-agents adresinde inceleyebilirsiniz. Her ajan, yukarıda belirtildiği gibi kendi alt dizininde saklanır. Hub'dan bir ajanı çalıştırmak, agent_id'sini kullanmak kadar basittir. Örneğin, julien-c/flux-schnell-generator ajanını çalıştırmak için:

npx @huggingface/tiny-agents run "julien-c/flux-schnell-generator"

Kendi ajanınızı toplulukla paylaşmak istiyor musunuz? Hub'daki Tiny Agents deposuna bir PR gönderin. Gönderiminizde bir agent.json dosyası bulunmalıdır ve isteğe bağlı olarak bir PROMPT.md veya AGENTS.md dosyası ekleyebilirsiniz. Başkalarının ajanınızın yeteneklerini anlamasına yardımcı olmak için örnek istemler ve kullanım durumları içeren bir EXAMPLES.md dosyası dahil etmeyi düşünün.

Gelişmiş: Programatik Kullanım

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);
        }
    }
}

Lisans

MIT

Update on GitHub

←Inference Client üzerine inşa edilmiş basit bir MCP İstemcisi Uygulamanızda Space mini_header kullanın→