MeltFlex AI Skills

AI agent skills for photorealistic interior and exterior design and 3D via MeltFlex AI — restyle rooms, place real furniture, swap floors, walls, stairs, doors and windows, redesign kitchens, bathrooms, facades and gardens, and turn 3D drafts into photos, all from a single photo. Then go further: cinematic video walkthroughs, 2D floorplan → 3D model or rendered 3D picture, furniture photo → GLB 3D model, and photo → explorable 3D world. Works with Claude Code, Hermes, Cursor, Codex, Cline, and other AI agents that load Markdown-based skills or speak MCP.

Each user authenticates with their own MeltFlex API key; every generation is billed to their account credits. The skills call the public MeltFlex API directly, so there's nothing extra to install.

Interior redesign · floor restyle from a material · garden design — a few of the 16 image modes, all from one photo.

Furniture photo → 3D model · room render → explorable 3D world · 2D floorplan → 3D model. Real outputs of /api/v1/furniture-3d, /api/v1/world and /api/v1/floorplan-to-3d.

Install

Pick one. Each method sets up the skills for your agent.

`npx skills` — recommended, cross-agent

npx skills add MeltFlexDevs/skills

GitHub CLI (v2.90+)

gh skill install MeltFlexDevs/skills

Claude Code marketplace

Inside Claude Code:

/plugin marketplace add MeltFlexDevs/skills
/plugin install meltflex@meltflex

Setup script

Universal fallback:

git clone --depth 1 https://github.com/MeltFlexDevs/skills.git
cd skills
./setup

More options in INSTALL.md. Agent-driven install (paste into your agent): INSTALL_FOR_AGENTS.md. Cline and other MCP-settings agents: llms-install.md.

Authenticate

You need an active subscription (any paid plan) — without one the key won't work. After subscribing at , open account settings → API Key under Profile, then Generate API Key (shown once — copy it):

Then expose it:

export MELTFLEX_API_KEY="mf_sk_xxxxxxxxxxxx"

If you use the MCP server / CLI, you can skip the copy-paste and sign in from the browser instead: `npx -y meltflex-mcp auth login` opens , mints a key from your signed-in session and stores it in `~/.meltflex/config.json` (chmod 600).

Skills

Image skills are self-contained: a room photo in, a photorealistic redesign out, 10 credits per image (auto-refunded on failure).

Image modes

`meltflex-design` — 16 modes, each the same `POST /api/v1/generate` endpoint with a mode-tuned prompt:

Optional fields on every image call: `resolution` (`512` / `1K` / `2K`), `designLevel` (`lite` −2 cr · `quick` · `pro` +5 cr), `variations` (1–3 per call, charged per image), up to 10 `referenceImageUrls`.

Video & 3D

Same key, five more outputs. The three 3D builds can take minutes; they answer HTTP 202 + a poll URL when they outlive the request, and `/meltflex:3d` shows how to poll.

Full reference with response bodies and three.js / Spark loader snippets: .

Quick Reference

Use with the MCP server

Agents that prefer tool calls over scripted API calls can run the `meltflex-mcp` server (npm, stdio). It exposes six tools — `generate_interior`, `generate_video`, `floorplan_to_3d`, `furniture_to_3d`, `generate_world`, `check_credits` — and handles polling and saving files to disk.

npx -y meltflex-mcp auth login              # or: npx -y meltflex-mcp auth mf_sk_xxxxxxxx
claude mcp add meltflex -- npx -y meltflex-mcp

Any MCP client works with the same shape (`command: npx`, `args: ["-y", "meltflex-mcp"]`, optional `env.MELTFLEX_API_KEY`). The same package is a terminal CLI: `meltflex generate | video | floorplan | furniture | world | credits`. A Claude Desktop extension bundle lives in `mcpb/`.

Hermes

Hermes (Nous Research) speaks MCP, so it runs MeltFlex through the same server.

From the catalog (once merged into the Hermes catalog):

hermes mcp install meltflex

Manually — sign in once, then add the server to `~/.hermes/config.yaml`:

npx -y meltflex-mcp auth login

mcp_servers:
  meltflex:
    command: npx
    args: ["-y", "meltflex-mcp"]

Start `hermes chat` (or run `/reload-mcp` in a session) to load the six MeltFlex tools. Full guide: .

Going further

• API docs:
• CLI: — `meltflex generate` from your terminal
• MCP server: — `npx -y meltflex-mcp`
• Cookbook: COOKBOOK.md · Changelog: CHANGELOG.md

Security

The skills never contain a key. Each user supplies their own `mf_sk_` key via `MELTFLEX_API_KEY`; generations spend that user's own credits. Credits, auth, and rate limits are all enforced server-side. Never commit your key — revoke it anytime in settings.

License

MIT — see LICENSE. Contributions welcome — see CONTRIBUTING.md.