README.md

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

```python
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:
```json
{
  "mcpServers": {
    "forge": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://chris4k-agent-forge.hf.space/mcp/sse"]
    }
  }
}
```

---

Built with ⚒ by [Chris4K](https://huggingface.co/Chris4K) — ki-fusion-labs.de