README.md

metadata

title: FORGE v2 — Universal Capability Registry
emoji: ⚒
colorFrom: blue
colorTo: red
sdk: docker
pinned: true
license: mit
short_description: Universal Capability Registry for AI Agents

⚒ FORGE v2

Universal Capability Registry for AI Agents

More than a skill registry. The single source of truth for everything an AI agent needs at runtime.

---

What is FORGE?

FORGE is a universal capability registry — a typed, versioned, searchable store for every artifact an AI agent ecosystem needs:

Type	What it stores
skill	Executable Python code (def execute(...)) — hot-loadable at runtime
prompt	System prompts, personas, Jinja2/f-string templates
workflow	Multi-step ReAct plans, orchestration graphs
knowledge	Curated text/JSON for RAG injection or agent context
config	Agent behavior policies, guardrails, tool whitelists
mcp_ref	Pointer to external MCP servers with auth hints
model_ref	HF model pointer + usage notes + prompting guide
bundle	Named collection of capabilities (complete agent loadout)

---

Quick Start (Agent Side)

import requests, types

def bootstrap_forge(url="https://chris4k-agent-forge.hf.space"):
    r = requests.get(f"{url}/api/capabilities/forge_client/payload")
    m = types.ModuleType("forge_client")
    exec(r.json()["payload"]["code"], m.__dict__)
    return m.ForgeClient(url)

forge = bootstrap_forge()

# Load a skill at runtime
calc = forge.load_skill("calculator")
print(calc.execute(expression="sqrt(144) + 2**8"))

# Get a prompt template
persona = forge.get_prompt("researcher_persona",
    variables={"agent_name": "MyResearcher", "max_steps": "8"})

# Load a complete agent bundle
loadout = forge.get_bundle("researcher_loadout")

---

REST API

GET  /api/capabilities           List/search (params: q, type, tag, limit)
GET  /api/capabilities/{id}      Get capability (latest version)
GET  /api/capabilities/{id}/{v}  Get specific version
GET  /api/capabilities/{id}/payload  Payload only (for hot-loading)
GET  /api/capabilities/{id}/resolve  Resolve bundle
POST /api/capabilities           Publish new capability
GET  /api/stats                  Counts by type
GET  /api/tags                   All tags

MCP Server

GET  /mcp/sse  SSE transport
POST /mcp      JSON-RPC 2.0

Tools: forge_search, forge_get, forge_publish, forge_list_types, forge_resolve_bundle

Claude Desktop config:

{
  "mcpServers": {
    "forge": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://chris4k-agent-forge.hf.space/mcp/sse"]
    }
  }
}

---

Built with ⚒ by Chris4K — ki-fusion-labs.de