⚒️ CVForge — paste a CV, get a stunning portfolio

CV (PDF / DOCX / Markdown / plain text) → a beautiful one-page portfolio, themed to the person's domain — 59 domains detected automatically. English and Arabic (RTL). 71 templates with a live gallery — and INFINITE DESIGNS: every 🎲 click forges a brand-new design (8 layouts × 8 backgrounds × 5 type styles × shape, card & accent systems), while each template has its own modern signature design. One engine, three ways to use it: MCP server, REST API (Vercel-hosted), and a 100% client-side offline playground.

The interface matches the banner above: deep-navy "aurora" design with animated gradient blobs, glowing cards, a laptop preview and a particle "forge" arrow — CSS-only motion (typing hero, scroll reveals, sparkle bursts, floating blobs), plus prefers-reduced-motion support.

✨ Features

Related MCP server: Resume Generator MCP Server

🧰 Tools (MCP — 4)

🚀 Quick start (local)

./setup.sh            # deps (cvforge + fastapi + pypdf + python-docx)
./run.sh              # start the MCP server (stdio)
python3 -m uvicorn playground.app:app --port 3500   # interactive web UI

MCP client config:

{ "mcpServers": { "cvforge": { "command": "python3", "args": ["-m", "cvforge"], "cwd": "/absolute/path/to/cvforge" } } }

No server needed: open cvforge-offline-playground.html in any browser — parse + render run entirely client-side. Perfect for a link-in-bio or a CV that works offline.

☁️ Hosted (Vercel)

Live demo: https://cv-forge-brown.vercel.app — see DEPLOY.md.

• index.html → landing + interactive demo (static)

• api/index.py → single self-contained serverless function:

  • GET /api/health · GET /api/cv/themes

  • POST /api/cv/parse · POST /api/cv/parse_file (PDF / DOCX upload)

  • POST /api/cv/generate (theme, language:"ar" → RTL)

💰 Monetization

See PRICING.md — freemium: free local runs → Pro hosted API → Agency white-label.

📦 License

MIT — see LICENSE.

Built by @DeadEnde · 2026 · made for people who work with AI

🎲 Infinite designs (seeds)

Every CV render is produced by a deterministic procedural design engine: the pair (theme, seed) selects a full design — layout archetype, background treatment, typography, radius/shape language, card style and section accents — while the theme still drives the palette & gradient. Any seed = any design, so combinations are effectively infinite.

• seed omitted → the template's signature design (stable: each of the 71 templates always shows its own modern look).

• POST /api/cv/generate with seed → that exact design, reproducible on any machine (Python engine in the API ≡ JS engine in the browser — parity tested).

• 🎲 New design (landing) → random seed, new design every click.

• 🔗 Copy design link → https://…/?t=ai&d=12345 opens that exact design.

• The API response includes design:{seed,layout,bg,font,accent,hero} and the page shows design — #<seed> · <layout>.