The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the 3D New Era AI listing page.
English · Português (Brasil) · Website · Try it in the browser
An open-source home design, floor plan and interior design editor written in Rust, built so that your AI can design with you. It ships with a Model Context Protocol server: Claude, ChatGPT, Codex, Gemini, Cursor or any other MCP client draws the walls, furnishes the rooms, builds the joinery, checks lighting and ergonomics against real standards and renders the photos, while every change shows up live on screen and is one Ctrl+Z away.
A Sweet Home 3D alternative for Windows, macOS, Linux and the browser, in English, Portuguese, Spanish and French.

| What you get | Account | |
|---|---|---|
| Desktop app | The full editor on your machine, with a local MCP server at 127.0.0.1:7878. Nothing leaves your computer. | none |
| Browser editor | The same editor in a tab (WebGPU or WebGL). Switch on its MCP and your AI edits the tab's project. | none |
| Hosted connector | Add https://mcp.3dneweraai.com/mcp to Claude or ChatGPT and design from the chat, with projects kept in your account. | email sign-in |
The desktop app and the browser editor are free, open source and need no account. The hosted connector is free within a quota; see pricing.
Windows — in PowerShell:
macOS (Apple Silicon and Intel) — in Terminal:
or with Homebrew: brew install --cask leandrodaf/tap/3d-new-era-ai.
The installers work for your user only, with no administrator password: the app appears
in the Start menu or Launchpad, newera goes on your PATH, the MCP server is registered
in Claude Code and Codex if you have them, and running the same command again updates it.
Uninstall with install-macos.sh --uninstall, or from Settings → Apps on Windows.
Prefer a plain download?
| Windows (x64) | macOS Apple Silicon | macOS Intel | Linux (x64) |
|---|
The builds are not signed with a paid Apple or Microsoft certificate, so the system asks once:
newera-gui.exe; if SmartScreen appears, click
More info → Run anyway.xattr -dr com.apple.quarantine "/Applications/3D New Era AI.app".tar xzf newera-linux-x64.tar.gz && ./newera/newera. Run
./newera/install-desktop.sh to add the menu entry, the icon and the .newera file
type (--uninstall undoes it).The one-line installers skip these prompts.
Hosted, nothing to install. In Claude or ChatGPT, add a custom connector with the
address https://mcp.3dneweraai.com/mcp and sign in with your email. Step by step:
https://3dneweraai.com/connector/.
With the desktop app. The editor serves MCP at http://127.0.0.1:7878/mcp while it is
open (or run newera serve for no window). The AI menu, or the MCP chip in the status
bar, shows the snippet for your client, can register it for you, and lists the tools the
agent calls as it calls them.
From a browser tab. Open https://3dneweraai.com/app/ and switch the MCP on in the AI panel (Ctrl+Shift+M). The tab gets an address your AI can reach through a small relay, because a tab cannot listen on a port. The relay passes messages and stores nothing; the project stays in the tab, and the address stops answering when you switch it off or close the tab. Treat that address like a password. Video rendering is not offered there, since it would hold the tab for minutes.
Then just ask, for example: "Draw a 4 × 5 m bedroom with a door and a window, furnish it and render a photo."
One click, with the app installed:
Claude Desktop: download newera-mcp.mcpb from the
latest release and open it.
Plugins with skills:
| Client | Command |
|---|---|
| Claude Code | /plugin marketplace add leandrodaf/3d-new-era-ai, then /plugin install 3d-new-era-ai-desktop@3d-new-era-ai (the app on your screen) or /plugin install 3d-new-era-ai@3d-new-era-ai (hosted) |
| Codex | codex plugin marketplace add leandrodaf/3d-new-era-ai |
| Gemini CLI | gemini extensions install https://github.com/leandrodaf/3d-new-era-ai |
Claude Code (already set up inside a clone of this repository by .mcp.json)
Codex CLI
Gemini CLI
VS Code (Copilot agent mode)
Cursor — ~/.cursor/mcp.json
Windsurf — ~/.codeium/windsurf/mcp_config.json
Claude Desktop without the bundle — Settings → Developer → Edit Config (needs
Node.js for the mcp-remote bridge)
DeepSeek, Qwen, Llama and other models — the model does not matter, the app you chat
in does. Use one that speaks MCP: Cline or
Roo Code in VS Code, Cherry Studio,
LM Studio or opencode (opencode.json):
Any other client — Streamable HTTP at http://127.0.0.1:7878/mcp, or stdio for
clients that start a process:
Over stdio, with the editor open the agent edits the plan in that window; with no window
(or newera mcp --standalone) it works on a project of its own.
A real 105 m² apartment, traced from an openly licensed floor plan and furnished, lit
and photographed by an AI agent through MCP alone: walls from the scan, doors that swing
the right way, a slatted TV wall, an L kitchen and wardrobes from cabinet_run,
downlights sized by photometry against NBR ISO/CIE 8995-1, and path-traced photos. Every
image below came out of the editor. See how it was built →
| Floor plan with real finishes | Aerial cutaway |
|---|---|
![]() | ![]() |
| Daylight | At dusk, lamps on |
|---|---|
![]() | ![]() |
![]() | ![]() |
![]() | ![]() |
| Joinery and rooms | |
|---|---|
![]() | ![]() |
![]() | ![]() |
background find the walls. Opens Sweet Home 3D (.sh3d)
projects as they are.cabinet_run fills a wall with even modules around doors, windows and corners;
cut_list exports the boards as CSV or DXF/SVG sheets.w12), [x, y] points in centimeters, compact reads and one-line write replies
keep token use low.Reads and changes are separate tools: a read never changes the plan, so an AI client can run it without asking, and asks before each change.
| Tool | What it does |
|---|---|
home | Compact state (detail=summary for counts, bounds and room areas) |
create | Walls (polylines, arcs, sloping), rooms (polygon or detected from walls), dimensions, labels, roofs with skylights and solids, in one atomic call |
update / move / delete | Edit any element by id |
arrange | Copies in a row, rotate, mirror, group/ungroup, drawing order |
edit_walls | Split a wall in two, or join walls on one line |
edit_home | Project name, compass (north), the city whose building code applies and who lives there |
background / edit_background | Scanned plan at real scale (calibration, X/Y scale, rotation); find the walls in it, and create them |
catalog / place | Search the parametric catalog; place furniture, doors and windows (snapped into walls), beams, finishes and glass |
joinery | Parametric cabinets, slatted panels, countertops with cutouts, plaster coves, shadow gaps and modular sofas |
cabinet_run | Fill a wall with cabinets sized for it: even modules around corners, doors, windows, fridge and stove |
embed | Set a sink or cooktop into a countertop (exact cutout) or an oven into a cabinet niche |
fit_roof | Walls, glass and panels take the shape of the roof above and keep following it |
cut_list | Boards, edge banding and hardware of the joinery, as CSV or DXF/SVG sheets |
layout | Overlaps, pieces in walls, blocked doors, pieces outside rooms, areas against references |
ergonomics | Review for the people living there: circulation, occupancy, kitchen, doors, ceiling heights, windows, wheelchair use |
lighting / edit_lighting | Lux per room by photometry against NBR ISO/CIE 8995-1; place the fixtures a room needs |
electrical / plumbing | Electrical and plumbing projects over the plan, changed through edit_electrical / edit_plumbing |
measure | Free floor around a piece, the gap between two, what a straight probe runs into, how far a piece can grow |
accept | Mark findings of any review as seen, with the reason |
rules | What a review checks against: the standards' tables, what each layout problem means, how ergonomics scores |
materials / disciplines / annotations | Finishes, visible projects and layers, dimension chains and schedules; stale finds notes that no longer match the drawing |
levels / cameras / variants / video | Storeys, points of view, plan versions and camera-path videos, each changed through its edit_* tool |
render_plan / show_plan | PNG of the plan as the user sees it; the plan inside the chat as an interactive viewer (MCP Apps) |
render_3d / render_photo | Software 3D views (aerial, visitor, cameras, elevations, sections); path-traced photos with sun and lamps |
export | PDF, SVG or PNG plan; GLB or OBJ model; the cut list as CSV or DXF/SVG sheets |
file | New, open and save: projects (.newera) and Sweet Home 3D import (.sh3d) |
edit_history / history | Undo and redo, shared with the user, and named checkpoints to come back to |
plugins / run_plugin / sessions | External plugins and the people working on the project |
feedback | A note to the developers about what a tool could do better (desktop only) |
The hosted connector adds projects, to list and switch between the projects in your
account, and leaves out feedback and the plugin tools, which only make sense on your
own machine.
Options: --addr 127.0.0.1:7878 (or NEWERA_ADDR); --token (or NEWERA_TOKEN),
required to listen beyond loopback; NEWERA_LOG for the log filter;
NEWERA_RENDER_THREADS for photo renders (half the cores by default). The server binds to
loopback by default and validates the Host header. On Windows, newera-gui.exe opens
the editor without a console window.
You need Rust 1.95 or newer (rustup). On Linux, also
libxkbcommon-dev libwayland-dev libx11-dev libxcursor-dev libxrandr-dev libxi-dev.
Run make to list every command. To host the browser editor yourself, serve web/ as
static files, with .wasm sent as application/wasm and compressed (about 15 MB raw,
a quarter of that gzipped). No backend or special headers are needed. The public site is
built by scripts/site-build.sh and deployed on every push to main.
Browsers: Chrome, Edge and Safari 26 use WebGPU. Where it is missing (Firefox today) the editor falls back to WebGL 2 and still draws everything; a browser with neither gets a message pointing at the download.
The app sends crash reports through Sentry, along with the notes agents leave with the MCP
feedback tool. It is on by default and off with one click in
Help → Send error reports, or newera telemetry off; NEWERA_TELEMETRY=0 turns it off
for a single run. Nothing of the project is sent, nor the IP address or the machine's name,
and the MCP token is removed from every report. Notes are always kept locally in the config
folder (notes.jsonl).
Under the same switch, opening the app counts one app_open — a random installation id, the
version, the operating system, the architecture and the mode — and the installers count one
install and one uninstall, saying which system and whether the app came from a release or was
compiled on the machine. Both go to 3dneweraai.com/ping, an endpoint of the site that holds
the Google Analytics secret and forwards the count without passing the IP address on: the
country Cloudflare already knows goes instead. A build made without the project's keys reports
through the same endpoint, so installing from source counts like any other install;
cargo build on a clone and CI count nothing. The hosted service keeps only what it needs:
your email, your projects and usage, never the conversation. See the
privacy policy.
Everything above is free and stays free. If it saves you time, the Supporter plan (US$ 5/month or US$ 48/year) raises the cloud quotas for your account and pays for the server.
Contributions are welcome. See CONTRIBUTING.md; make check runs the
same checks as CI.
Licensed under either of Apache License 2.0 or MIT license, at your option.