Crealink/spaces-as-agent-tools

🤖 Spaces as Agent Tools

Every Gradio Space on Hugging Face exposes a plain-text `agents.md` that coding agents (Claude Code, Codex, OpenCode, Pi, etc.) can call directly — no client library, no hardcoded integration.

This Space is both a live demo you can use in the browser and a reference guide you can copy into your agent.

🖥️ Browser Walkthrough

What you need

• —A free Hugging Face account
• —A Hugging Face token (only for the Chain demo) — create one here

Step-by-step

1. Open the Space

Go to [▶ Open the demo](https://huggingface.co/spaces/Crealink/spaces-as-agent-tools) in your browser.

You'll see three tabs at the top: 🔍 Explore a Space, ⛓️ Chain: Text → Image → 3D, and 📋 curl Reference.

2. 🔍 Explore a Space (works immediately — no token needed)

This tab lets you inspect any Gradio Space's agent interface.

1. 1.The Space ID field is pre-filled with black-forest-labs/flux-klein-9b-kv
2. 2.Click 🔍 Explore
3. 3.You'll see three things:
4. 4.agents.md — the exact 4-line text a coding agent reads to know how to call this Space
5. 5.curl command — copy-paste this into Claude Code, Codex, or any terminal
6. 6.API Endpoints — every function the Space exposes, with parameter names, types, and defaults

Try it: Click one of the example buttons below the input (e.g. microsoft/TRELLIS.2 or Qwen/Qwen3-ASR) to explore other Spaces.

Tip: You can type any Gradio Space ID here — not just the examples. Try one of your own Spaces!

3. ⛓️ Chain: Text → Image → 3D (requires one-time token setup)

This tab demonstrates chaining two Spaces — the same thing a coding agent does behind the scenes, but visible step by step.

One-time setup (2 minutes):

Since this demo calls GPU-powered Spaces on your behalf, it needs your Hugging Face token.

1. 1.Create a token (if you don't have one):
2. 2.Go to huggingface.co/settings/tokens
3. 3.Click Create new token
4. 4.Name it anything (e.g. "spaces-demo")
5. 5.Type: Read is enough
6. 6.Click Create token and copy it

1. 1.Add the token to this Space:
2. 2.Go to ⚙️ Space Settings
3. 3.Scroll down to Variables and secrets
4. 4.Click New secret
5. 5.Name: HF_TOKEN
6. 6.Value: paste your token
7. 7.Click Save
8. 8.The Space will restart automatically (takes ~30 seconds)

Using the chain demo:

1. 1.Switch to the ⛓️ Chain: Text → Image → 3D tab
2. 2.Type a prompt (or keep the default: "a glowing crystal dragon perched on a rocky mountain peak")
3. 3.Click 🚀 Generate
4. 4.Watch the pipeline log at the bottom as it:
5. 5.Calls FLUX Klein 9B to generate an image from your text
6. 6.Sends that image to TRELLIS.2 for background removal
7. 7.Generates a 3D model from the image
8. 8.Extracts a downloadable .GLB mesh
9. 9.The generated image appears on the left, the 3D preview on the right, and the GLB download below

⏱️ The full pipeline takes about 1–3 minutes depending on queue times.

💡 This is the exact same REST protocol (POST → poll SSE) that a coding agent uses. The log shows you every step.

4. 📋 curl Reference (no token needed)

This tab is a full copy-paste cheatsheet. It covers:

• —How to read any Space's agents.md
• —How to inspect the API schema
• —How to submit a job and poll for results
• —How to chain FLUX → TRELLIS.2 end to end
• —A Python gradio_client alternative
• —Authentication tiers and quotas

For coding agent users: Copy the curl commands from this tab directly into your agent's context.

🔑 How agents.md works

Every Gradio Space automatically exposes a URL:

https://huggingface.co/spaces/{owner}/{name}/agents.md

The response is always 4 lines of plain text:

To use this application (owner/name: description):
API schema: GET https://owner-name.hf.space/gradio_api/info
Call endpoint: POST https://owner-name.hf.space/gradio_api/call/{endpoint} {"data": [...]}
Poll result: GET https://owner-name.hf.space/gradio_api/call/{endpoint}/{event_id}
Auth: Bearer $HF_TOKEN

A coding agent reads this, fetches the schema to learn the parameters, and then makes standard HTTP calls. That's it.

🔗 From any Space's UI

You don't need this demo to use agent tools. On any compatible Space page:

1. 1.Look for the Agents button in the Space header
2. 2.Click it → the curl command is copied to your clipboard
3. 3.Paste it into your coding agent (Claude Code, Codex, OpenCode, etc.)

⛓️ Chaining — why this is powerful

An agent can compose Spaces like building blocks:

The image URL from step 1 is passed directly as input to step 2. No file download, no SDK, no glue code — just HTTP.

Other possible chains:

• —Text → Image → Video (FLUX → video generation Space)
• —Audio → Text → Translation (ASR Space → translation Space)
• —Image → Caption → Image (captioning Space → image gen Space)

📋 Popular Spaces to try

Find more on huggingface.co/spaces — any Gradio Space has an agents.md.

🔐 Authentication tiers

Get your token at: huggingface.co/settings/tokens