MeltFlex AI

MeltFlex AI Skills

AI agent skills for photorealistic interior and exterior design 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. Also produces cinematic video walkthroughs and 3D models from 2D floorplans. Works with Claude Code, Hermes, Cursor, Codex, 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.

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.

Authenticate

You need an active subscription (any paid plan) — without one the key won't work. After subscribing at https://www.meltflexai.com/settings, 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"

Use with Hermes

Hermes (Nous Research) speaks MCP, so it runs MeltFlex through the meltflex-mcp 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 generate_interior, generate_video, floorplan_to_3d and check_credits tools. Full guide: https://www.meltflexai.com/mcp.

Skills

Skill	Invoke	Description
meltflex-design	/meltflex:design	Restyle a room, facade or garden; swap floors, walls, stairs, doors or windows; redesign a kitchen or bathroom; boost a layout; turn a 3D draft into a photo. 15 prompt-driven modes, plus video walkthroughs and floorplan→3D via the API.
meltflex-furniture	/meltflex:furniture	Place specific real furniture/decor products into a room photo, matching their exact colors, materials, and proportions (up to 10 reference items).

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

Modes

meltflex-design — 15 modes, each the same endpoint with a mode-tuned prompt:

Mode	What it's for
restyle	Change a room's style or theme
virtual_staging	Furnish an empty room
layout_boost	Rearrange existing furniture into a better layout
declutter	Clean up / depersonalize a space
exterior	Building facade / house exterior
garden	Landscaping and outdoor design
wall_texture	Change wall material or finish
floor_restyle	Change the flooring
stairs	Restyle a staircase in place
doors	Swap interior doors
windows	Swap window frames / glazing
kitchen	Whole kitchen redesign
bathroom	Whole bathroom redesign
photo_to_render	Turn a 3D draft / SketchUp shot into a photo
seasonal	Time-of-day / seasonal / lighting variation

Two more capabilities go beyond stills, using the same API key: a cinematic video walkthrough (POST /api/v1/video) and a 2D floorplan → 3D model (POST /api/v1/floorplan-to-3d). See the design skill and the API docs.

Quick Reference

What you want	Skill	Note
Restyle a room from a photo	meltflex-design	Pick a mode, write a specific prompt
Furnish an empty room	meltflex-design	virtual_staging mode
Place a specific sofa/bed/table	meltflex-furniture	Pass product images as references
Redesign a house exterior or garden	meltflex-design	exterior / garden mode
Swap flooring or wall finish	meltflex-design	floor_restyle / wall_texture (attach the material as a reference)
Restyle stairs, doors or windows	meltflex-design	stairs / doors / windows mode
Redesign a kitchen or bathroom	meltflex-design	kitchen / bathroom mode
Turn a 3D draft into a photo	meltflex-design	photo_to_render mode
Cinematic video walkthrough	meltflex-design	POST /api/v1/video (100–150 credits)
2D floorplan → 3D model	meltflex-design	POST /api/v1/floorplan-to-3d (10 credits)
Check credit balance	—	meltflex credits (CLI) or the MCP check_credits tool

Going further

• API docs: https://www.meltflexai.com/api
• CLI: https://www.meltflexai.com/cli — meltflex generate from your terminal
• MCP server: https://www.meltflexai.com/mcp — npx -y meltflex-mcp
• Cookbook: COOKBOOK.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.