Huggingface.js documentation
@huggingface/tiny-agents
@huggingface/tiny-agents
Um esquadrão de aplicações de IA leves e componíveis construídas sobre o Inference Client e a pilha MCP da Hugging Face.
Instalação
npm install @huggingface/tiny-agents
# or
pnpm add @huggingface/tiny-agentsUso da CLI
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 serverVocê pode carregar agentes diretamente do Dataset tiny-agents do Hugging Face Hub ou especificar um caminho para a configuração local do seu próprio agente.
Defina seu próprio agente
A maneira mais simples de criar o seu próprio agente é criar uma pasta contendo um arquivo agent.json:
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"]
}
]
}Ou usando uma URL de endpoint local ou remoto:
{
"model": "Qwen/Qwen3-32B",
"endpointUrl": "http://localhost:1234/v1",
"servers": [
{
"type": "stdio",
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
]
}
Onde servers é uma lista de servidores MCP (suportamos servidores Stdio, SSE e HTTP).
Opcionalmente, você pode adicionar um arquivo AGENTS.md (ou PROMPT.md) para substituir o prompt padrão do Agent.
Depois, basta apontar o tiny-agents para a sua pasta local:
npx @huggingface/tiny-agents run ./my-agent
E voilà! 🔥
Coleção Tiny Agents
Navegue pela nossa coleção curada de Tiny Agents em https://huggingface.co/datasets/tiny-agents/tiny-agents. Cada agente é armazenado em seu próprio subdiretório, seguindo a estrutura descrita acima. Executar um agente do Hub é tão simples quanto usar seu agent_id. Por exemplo, para executar o agente julien-c/flux-schnell-generator:
npx @huggingface/tiny-agents run "julien-c/flux-schnell-generator"Quer compartilhar seu próprio agente com a comunidade? Envie um PR para o repositório Tiny Agents no Hub. Sua submissão deve incluir um arquivo
agent.json, e você pode adicionar opcionalmente um arquivoPROMPT.mdouAGENTS.md. Para ajudar os outros a entender as capacidades do seu agente, considere incluir um arquivoEXAMPLES.mdcom prompts de exemplo e casos de uso.
Avançado: Uso Programático
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);
}
}
}Licença
MIT
Update on GitHub