Huggingface.js documentation
@huggingface/tiny-agents
@huggingface/tiny-agents
Hugging FaceのInference ClientとMCPスタックを基盤として構築された、軽量で組み合わせ可能なAIアプリケーションのグループです。
インストール
npm install @huggingface/tiny-agents
# or
pnpm add @huggingface/tiny-agentsCLIの使用方法
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エージェントは、Hugging Face Hubのtiny-agentsデータセットから直接読み込むことも、ローカルのエージェント設定へのパスを指定することもできます。
独自のエージェントを定義する
独自のエージェントを作成する最も簡単な方法は、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"]
}
]
}または、ローカルまたはリモートのエンドポイントURLを使用します:
{
"model": "Qwen/Qwen3-32B",
"endpointUrl": "http://localhost:1234/v1",
"servers": [
{
"type": "stdio",
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
]
}
servers は、MCP サーバーのリストです（Stdio、SSE、HTTP サーバーをサポートしています）。
必要に応じて、AGENTS.md（またはPROMPT.md）ファイルを追加して、Agentのデフォルトプロンプトを上書きできます。
次に、tiny-agentsをローカルフォルダーに向けます:
npx @huggingface/tiny-agents run ./my-agent
できました！🔥
Tiny Agentsコレクション
https://huggingface.co/datasets/tiny-agents/tiny-agents にある、厳選した Tiny Agents のコレクションをご覧ください。各エージェントは上記の構造に従って、それぞれ専用のサブディレクトリに保存されています。Hub からエージェントを実行するには、その agent_id を使用するだけです。例えば、julien-c/flux-schnell-generator エージェントを実行するには:
npx @huggingface/tiny-agents run "julien-c/flux-schnell-generator"コミュニティに独自のエージェントを共有したい場合は、Hub上のTiny AgentsリポジトリにPRを送信してください。提出には
agent.jsonファイルの同梱が必須です。また、PROMPT.mdまたはAGENTS.mdファイルの追加は任意です。他のユーザーがエージェントの機能を理解しやすくなるよう、サンプルプロンプトやユースケースを含むEXAMPLES.mdファイルの同梱を検討してください。
高度なトピック: プログラムによる使用
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);
}
}
}ライセンス
MIT
Update on GitHub