Skip to content
Back to search

3d-new-era-ai

Open-source home design and floor plan editor in Rust (a Sweet Home 3D alternative) with a built-in MCP server: your AI agent draws walls, furnishes rooms, checks lighting and ergonomics, and renders photos — live, on your own machine.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/leandrodaf/3d-new-era-ai with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/leandrodaf/3d-new-era-ai'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/leandrodaf--3d-new-era-ai/badge.svg)](/listings/leandrodaf--3d-new-era-ai)

HTML

<a href="/listings/leandrodaf--3d-new-era-ai"><img src="/api/listings/leandrodaf--3d-new-era-ai/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

**Windows** — in PowerShell:

irm https://raw.githubusercontent.com/leandrodaf/3d-new-era-ai/main/scripts/install-windows.ps1 | iex

**macOS** (Apple Silicon and Intel) — in Terminal:

curl -fsSL https://raw.githubusercontent.com/leandrodaf/3d-new-era-ai/main/scripts/install-macos.sh | bash

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)](https://github.com/leandrodaf/3d-new-era-ai/releases/latest/download/newera-windows-x64.zip) | [macOS Apple Silicon](https://github.com/leandrodaf/3d-new-era-ai/releases/latest/download/newera-macos-apple-silicon.zip) | [macOS Intel](https://github.com/leandrodaf/3d-new-era-ai/releases/latest/download/newera-macos-intel.zip) | [Linux (x64)](https://github.com/leandrodaf/3d-new-era-ai/releases/latest/download/newera-linux-x64.tar.gz) | |:---:|:---:|:---:|:---:|

<details> <summary>First launch of a plain download</summary>

The builds are not signed with a paid Apple or Microsoft certificate, so the system asks once:

- **Windows:** unzip and open `newera-gui.exe`; if SmartScreen appears, click *More info* → *Run anyway*. - **macOS:** unzip and move *3D New Era AI* to Applications, then right-click it → *Open* → *Open*. On macOS 15 and later, open it once, then go to *System Settings* → *Privacy & Security* → *Open Anyway*, or run `xattr -dr com.apple.quarantine "/Applications/3D New Era AI.app"`. - **Linux:** `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. </details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 24 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "3d-new-era-ai",
  3. "owner": {
  4. "name": "Leandro Ferreira",
  5. "url": "https://3dneweraai.com"
  6. },
  7. "metadata": {
  8. "description": "The 3D New Era AI plugin: skills and the MCP server for designing homes with your AI."
  9. },
  10. "plugins": [
  11. {
  12. "name": "3d-new-era-ai",
  13. "source": "./plugin",
  14. "description": "Design your home by talking to your AI, with nothing to install: floor plans, furniture, kitchens and wardrobes, and photos of the result.",
  15. "category": "design"
  16. },
  17. {
  18. "name": "3d-new-era-ai-desktop",
  19. "source": "./plugin-desktop",
  20. "description": "Design your home with your AI in the 3D New Era AI app on your computer: every change shows up on your screen as it happens.",
  21. "category": "design"
  22. }
  23. ]
  24. }
README.md · README · 395 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # 3D New Era AI
  2. **English** · [Português (Brasil)](README.pt-BR.md) · **[Website](https://3dneweraai.com/?lang=en)** · **[Try it in the browser](https://3dneweraai.com/app/)**
  3. [![CI](https://github.com/leandrodaf/3d-new-era-ai/actions/workflows/ci.yml/badge.svg)](https://github.com/leandrodaf/3d-new-era-ai/actions/workflows/ci.yml)
  4. [![Latest release](https://img.shields.io/github/v/release/leandrodaf/3d-new-era-ai)](https://github.com/leandrodaf/3d-new-era-ai/releases/latest)
  5. [![License: MIT OR Apache-2.0](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue.svg)](#license)
  6. An open-source **home design, floor plan and interior design editor** written in Rust,
  7. built so that **your AI can design with you**. It ships with a
  8. [Model Context Protocol](https://modelcontextprotocol.io) server: Claude, ChatGPT, Codex,
  9. Gemini, Cursor or any other MCP client draws the walls, furnishes the rooms, builds the
  10. joinery, checks lighting and ergonomics against real standards and renders the photos,
  11. while every change shows up live on screen and is one Ctrl+Z away.
  12. A Sweet Home 3D alternative for Windows, macOS, Linux and the browser, in English,
  13. Portuguese, Spanish and French.
  14. ![Editor with a furnished 105 m² apartment: catalog, rendered floor plan and live 3D view](docs/images/editor.png)
  15. ## Three ways to use it
  16. | | What you get | Account |
  17. |---|---|---|
  18. | **[Desktop app](#install)** | The full editor on your machine, with a local MCP server at `127.0.0.1:7878`. Nothing leaves your computer. | none |
  19. | **[Browser editor](https://3dneweraai.com/app/)** | The same editor in a tab (WebGPU or WebGL). Switch on its MCP and your AI edits the tab's project. | none |
  20. | **[Hosted connector](https://3dneweraai.com/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 |
  21. The desktop app and the browser editor are free, open source and need no account. The
  22. hosted connector is free too, with no limits.
  23. ## Install
  24. **Windows** — in PowerShell:
  25. ```powershell
  26. irm https://raw.githubusercontent.com/leandrodaf/3d-new-era-ai/main/scripts/install-windows.ps1 | iex
  27. ```
  28. **macOS** (Apple Silicon and Intel) — in Terminal:
  29. ```sh
  30. curl -fsSL https://raw.githubusercontent.com/leandrodaf/3d-new-era-ai/main/scripts/install-macos.sh | bash
  31. ```
  32. or with Homebrew: `brew install --cask leandrodaf/tap/3d-new-era-ai`.
  33. The installers work for your user only, with no administrator password: the app appears
  34. in the Start menu or Launchpad, `newera` goes on your `PATH`, the MCP server is registered
  35. in Claude Code and Codex if you have them, and running the same command again updates it.
  36. Uninstall with `install-macos.sh --uninstall`, or from *Settings → Apps* on Windows.
  37. On Windows, it is also in the Microsoft Store:
  38. [![Get it from Microsoft](https://3dneweraai.com/microsoft-store.svg)](https://apps.microsoft.com/detail/9MT55M4M7B76)
  39. Prefer a plain download?
  40. | [Windows (x64)](https://github.com/leandrodaf/3d-new-era-ai/releases/latest/download/newera-windows-x64.zip) | [macOS Apple Silicon](https://github.com/leandrodaf/3d-new-era-ai/releases/latest/download/newera-macos-apple-silicon.zip) | [macOS Intel](https://github.com/leandrodaf/3d-new-era-ai/releases/latest/download/newera-macos-intel.zip) | [Linux (x64)](https://github.com/leandrodaf/3d-new-era-ai/releases/latest/download/newera-linux-x64.tar.gz) |
  41. |:---:|:---:|:---:|:---:|
  42. <details>
  43. <summary>First launch of a plain download</summary>
  44. The builds are not signed with a paid Apple or Microsoft certificate, so the system asks
  45. once:
  46. - **Windows:** unzip and open `newera-gui.exe`; if SmartScreen appears, click
  47. *More info* → *Run anyway*.
  48. - **macOS:** unzip and move *3D New Era AI* to Applications, then right-click it →
  49. *Open* → *Open*. On macOS 15 and later, open it once, then go to *System Settings* →
  50. *Privacy & Security* → *Open Anyway*, or run
  51. `xattr -dr com.apple.quarantine "/Applications/3D New Era AI.app"`.
  52. - **Linux:** `tar xzf newera-linux-x64.tar.gz && ./newera/newera`. Run
  53. `./newera/install-desktop.sh` to add the menu entry, the icon and the `.newera` file
  54. type (`--uninstall` undoes it). It needs glibc 2.35 or newer: Ubuntu 22.04, Debian 12,
  55. Fedora 36 or any later release.
  56. The one-line installers skip these prompts.
  57. </details>
  58. ## Connect your AI
  59. **Hosted, nothing to install.** In Claude or ChatGPT, add a custom connector with the
  60. address `https://mcp.3dneweraai.com/mcp` and sign in with your email. Step by step:
  61. <https://3dneweraai.com/connector/>.
  62. **With the desktop app.** The editor serves MCP at `http://127.0.0.1:7878/mcp` while it is
  63. open (or run `newera serve` for no window). The **AI** menu, or the MCP chip in the status
  64. bar, shows the snippet for your client, can register it for you, and lists the tools the
  65. agent calls as it calls them.
  66. **From a browser tab.** Open <https://3dneweraai.com/app/> and switch the MCP on in the
  67. **AI** panel (Ctrl+Shift+M). The tab gets an address your AI can reach through a small
  68. relay, because a tab cannot listen on a port. The relay passes messages and stores
  69. nothing; the project stays in the tab, and the address stops answering when you switch it
  70. off or close the tab. Treat that address like a password. Video rendering is not offered
  71. there, since it would hold the tab for minutes.
  72. Then just ask, for example: *"Draw a 4 × 5 m bedroom with a door and a window, furnish it
  73. and render a photo."*
  74. ### Client setup
  75. One click, with the app installed:
  76. [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=newera&config=eyJjb21tYW5kIjoibmV3ZXJhIiwiYXJncyI6WyJtY3AiXX0%3D)
  77. [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_newera-0098FF?logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=newera&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22newera%22%2C%22args%22%3A%5B%22mcp%22%5D%7D)
  78. [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_newera-24bfa5?logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=newera&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22newera%22%2C%22args%22%3A%5B%22mcp%22%5D%7D&quality=insiders)
  79. **Claude Desktop:** download `newera-mcp.mcpb` from the
  80. [latest release](https://github.com/leandrodaf/3d-new-era-ai/releases/latest) and open it.
  81. **Plugins with skills:**
  82. | Client | Command |
  83. |---|---|
  84. | 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) |
  85. | Codex | `codex plugin marketplace add leandrodaf/3d-new-era-ai` |
  86. | Gemini CLI | `gemini extensions install https://github.com/leandrodaf/3d-new-era-ai` |
  87. <details>
  88. <summary>Manual setup for each client</summary>
  89. **Claude Code** (already set up inside a clone of this repository by `.mcp.json`)
  90. ```sh
  91. claude mcp add --transport http newera http://127.0.0.1:7878/mcp
  92. ```
  93. **Codex CLI**
  94. ```sh
  95. codex mcp add newera --url http://127.0.0.1:7878/mcp
  96. ```
  97. **Gemini CLI**
  98. ```sh
  99. gemini mcp add --transport http newera http://127.0.0.1:7878/mcp
  100. ```
  101. **VS Code (Copilot agent mode)**
  102. ```sh
  103. code --add-mcp '{"name":"newera","type":"http","url":"http://127.0.0.1:7878/mcp"}'
  104. ```
  105. **Cursor** — `~/.cursor/mcp.json`
  106. ```json
  107. { "mcpServers": { "newera": { "url": "http://127.0.0.1:7878/mcp" } } }
  108. ```
  109. **Windsurf** — `~/.codeium/windsurf/mcp_config.json`
  110. ```json
  111. { "mcpServers": { "newera": { "serverUrl": "http://127.0.0.1:7878/mcp" } } }
  112. ```
  113. **Claude Desktop without the bundle** — *Settings → Developer → Edit Config* (needs
  114. [Node.js](https://nodejs.org) for the `mcp-remote` bridge)
  115. ```json
  116. { "mcpServers": { "newera": { "command": "npx", "args": ["-y", "mcp-remote", "http://127.0.0.1:7878/mcp"] } } }
  117. ```
  118. **DeepSeek, Qwen, Llama and other models** — the model does not matter, the app you chat
  119. in does. Use one that speaks MCP: [Cline](https://cline.bot) or
  120. [Roo Code](https://roocode.com) in VS Code, [Cherry Studio](https://cherry-ai.com),
  121. [LM Studio](https://lmstudio.ai) or [opencode](https://opencode.ai) (`opencode.json`):
  122. ```json
  123. { "mcp": { "newera": { "type": "remote", "url": "http://127.0.0.1:7878/mcp" } } }
  124. ```
  125. **Any other client** — Streamable HTTP at `http://127.0.0.1:7878/mcp`, or stdio for
  126. clients that start a process:
  127. ```json
  128. { "mcpServers": { "newera": { "command": "newera", "args": ["mcp"] } } }
  129. ```
  130. Over stdio, with the editor open the agent edits the plan in that window; with no window
  131. (or `newera mcp --standalone`) it works on a project of its own.
  132. </details>
  133. ## Showcase
  134. A real 105 m² apartment, traced from an openly licensed floor plan and furnished, lit
  135. and photographed by an AI agent through MCP alone: walls from the scan, doors that swing
  136. the right way, a slatted TV wall, an L kitchen and wardrobes from `cabinet_run`,
  137. downlights sized by photometry against NBR ISO/CIE 8995-1, and path-traced photos. Every
  138. image below came out of the editor. **[See how it was built →](docs/SHOWCASE.md)**
  139. | Floor plan with real finishes | Aerial cutaway |
  140. |---|---|
  141. | ![Rendered floor plan with real finishes](docs/images/showcase/13-rendered-plan.jpg) | ![Aerial cutaway of the apartment](docs/images/showcase/12-aerial.jpg) |
  142. | Daylight | At dusk, lamps on |
  143. |---|---|
  144. | ![Living room with slatted TV wall](docs/images/showcase/01-living-window.jpg) | ![Dining table under the pendant at dusk](docs/images/showcase/09-dining-night.jpg) |
  145. | ![Dining and living toward the window](docs/images/showcase/02-dining-living.jpg) | ![L-shaped kitchen at night](docs/images/showcase/10-kitchen-night.jpg) |
  146. | ![L-shaped kitchen with terrazzo floor](docs/images/showcase/04-kitchen.jpg) | ![Master bedroom at night](docs/images/showcase/11-master-bedroom-night.jpg) |
  147. | Joinery and rooms | |
  148. |---|---|
  149. | ![Slatted TV wall with the TV embedded](docs/images/showcase/03-tv-wall.jpg) | ![Home office with desk and bookcase](docs/images/showcase/05-office.jpg) |
  150. | ![Master bedroom with tall wardrobe run](docs/images/showcase/07-master-bedroom.jpg) | ![Bathroom with Nero marble wall](docs/images/showcase/08-bathroom.jpg) |
  151. ## Features
  152. - **Plans from anything.** Draw walls, arcs and sloping walls, or drop in a scanned plan
  153. at real scale and let `background` find the walls. Opens Sweet Home 3D (`.sh3d`)
  154. projects as they are.
  155. - **Joinery a workshop can build.** Parametric cabinets, wardrobes, slatted panels,
  156. countertops with exact sink and cooktop cutouts, plaster coves with LED and modular
  157. sofas. `cabinet_run` fills a wall with even modules around doors, windows and corners;
  158. `cut_list` exports the boards as CSV or DXF/SVG sheets.
  159. - **Checked against the people who live there.** An ergonomics review (circulation, beds
  160. and bathrooms per person, the kitchen triangle, wheelchair turning space) and lux per
  161. room by photometry, each finding tied to its [source](docs/STANDARDS.md) and with the
  162. fix ready to apply.
  163. - **Electrical and plumbing plans** over the same floor plan: circuits and panel, Wi-Fi
  164. coverage, runs and checks against NBR 5410, NBR 5626 and NBR 8160.
  165. - **Pictures that sell the project.** Rendered floor plans with real finishes, elevations
  166. and sections, aerial cutaways, path-traced photos with the sun from the compass and the
  167. lamps you placed, and videos along a camera path. They render on the CPU, so a headless
  168. server can take them too.
  169. - **Roofs and structure.** Pitched roofs with skylights, walls and glass that follow the
  170. roof above, beams, storeys, pools and decks.
  171. - **Furniture always true to size.** The catalog is generated by code, so a
  172. 158 × 208 cm bed is exactly that in the plan, in 3D and in collision checks.
  173. - **Try alternatives safely.** Duplicate the plan into a new tab, change it and compare
  174. versions side by side; name checkpoints and come back to them.
  175. - **Built for agents.** People and agents go through the same undoable commands. Short
  176. ids (`w12`), `[x, y]` points in centimeters, compact reads and one-line write replies
  177. keep token use low.
  178. - **Open and extensible.** Plugins in any language over the HTTP API, several people on
  179. the same project with named cursors, and exports to PDF, SVG, PNG, GLB and OBJ.
  180. ## MCP tools
  181. Reads and changes are separate tools: a read never changes the plan, so an AI client can
  182. run it without asking, and asks before each change.
  183. | Tool | What it does |
  184. |------|--------------|
  185. | `home` | Compact state (`detail=summary` for counts, bounds and room areas) |
  186. | `create` | Walls (polylines, arcs, sloping), rooms (polygon or detected from walls), dimensions, labels, roofs with skylights and solids, in one atomic call |
  187. | `update` / `move` / `delete` | Edit any element by id |
  188. | `arrange` | Copies in a row, rotate, mirror, group/ungroup, drawing order |
  189. | `edit_walls` | Split a wall in two, or join walls on one line |
  190. | `edit_home` | Project name, compass (north), the city whose building code applies and who lives there |
  191. | `background` / `edit_background` | Scanned plan at real scale (calibration, X/Y scale, rotation); find the walls in it, and create them |
  192. | `catalog` / `place` | Search the parametric catalog; place furniture, doors and windows (snapped into walls), beams, finishes and glass |
  193. | `joinery` | Parametric cabinets, slatted panels, countertops with cutouts, plaster coves, shadow gaps and modular sofas |
  194. | `cabinet_run` | Fill a wall with cabinets sized for it: even modules around corners, doors, windows, fridge and stove |
  195. | `embed` | Set a sink or cooktop into a countertop (exact cutout) or an oven into a cabinet niche |
  196. | `fit_roof` | Walls, glass and panels take the shape of the roof above and keep following it |
  197. | `cut_list` | Boards, edge banding and hardware of the joinery, as CSV or DXF/SVG sheets |
  198. | `layout` | Overlaps, pieces in walls, blocked doors, pieces outside rooms, areas against references |
  199. | `ergonomics` | Review for the people living there: circulation, occupancy, kitchen, doors, ceiling heights, windows, wheelchair use |
  200. | `lighting` / `edit_lighting` | Lux per room by photometry against NBR ISO/CIE 8995-1; place the fixtures a room needs |
  201. | `electrical` / `plumbing` | Electrical and plumbing projects over the plan, changed through `edit_electrical` / `edit_plumbing` |
  202. | `measure` | Free floor around a piece, the gap between two, what a straight probe runs into, how far a piece can grow |
  203. | `model` | What an imported OBJ/glTF/GLB became: unit taken, size, triangles, materials, named parts, and what is not drawn; `check=clashes` finds parts passing through one another |
  204. | `edit_model` | Swap the file of placed pieces in one undo step (keeping ids, size, finishes and links), change a material or a part by name, or give a lighter file for distant views |
  205. | `library` / `edit_library` | A library of approved model versions, with their photos, measurements and source, placed in any project as `library:<name>@<v>` and listed in the desktop catalog to place by hand |
  206. | `accept` | Mark findings of any review as seen, with the reason |
  207. | `rules` | What a review checks against: the standards' tables, what each layout problem means, how ergonomics scores |
  208. | `materials` / `disciplines` / `annotations` | Finishes, visible projects and layers, dimension chains and schedules; `stale` finds notes that no longer match the drawing |
  209. | `levels` / `cameras` / `variants` / `video` | Storeys, points of view, plan versions and camera-path videos, each changed through its `edit_*` tool |
  210. | `render_plan` / `show_plan` | PNG of the plan as the user sees it; the plan inside the chat as an interactive viewer (MCP Apps) |
  211. | `render_3d` / `render_photo` | Software 3D views (aerial, visitor, cameras, elevations, sections); path-traced photos with sun and lamps |
  212. | `export` | PDF, SVG or PNG plan; GLB or OBJ model; the cut list as CSV or DXF/SVG sheets |
  213. | `file` | New, open and save: projects (`.newera`) and Sweet Home 3D import (`.sh3d`) |
  214. | `edit_history` / `history` | Undo and redo, shared with the user, and named checkpoints to come back to |
  215. | `plugins` / `run_plugin` / `sessions` | External plugins and the people working on the project |
  216. | `feedback` | A note to the developers about what a tool could do better (desktop only) |
  217. The hosted connector adds `projects`, to list and switch between the projects in your
  218. account, and leaves out `feedback`, the plugin tools and `library` / `edit_library` (the
  219. library is a folder on your machine), which only make sense on your own machine; the
  220. browser tab leaves out the library tools too.
  221. ## Command line
  222. ```sh
  223. newera [FILE] # desktop editor with the embedded HTTP + MCP server
  224. newera --demo # start with a sample house
  225. newera gui --no-server # editor only
  226. newera serve [FILE] # headless HTTP + MCP server
  227. newera mcp # MCP over stdio (attaches to the open window, if any)
  228. ```
  229. Options: `--addr 127.0.0.1:7878` (or `NEWERA_ADDR`); `--token` (or `NEWERA_TOKEN`),
  230. required to listen beyond loopback; `NEWERA_LOG` for the log filter;
  231. `NEWERA_RENDER_THREADS` for photo renders (half the cores by default). The server binds to
  232. loopback by default and validates the `Host` header. On Windows, `newera-gui.exe` opens
  233. the editor without a console window.
  234. ## Build from source
  235. You need Rust 1.95 or newer ([rustup](https://rustup.rs)). On Linux, also
  236. `libxkbcommon-dev libwayland-dev libx11-dev libxcursor-dev libxrandr-dev libxi-dev`.
  237. ```sh
  238. git clone https://github.com/leandrodaf/3d-new-era-ai
  239. cd 3d-new-era-ai
  240. make run # editor + HTTP + MCP, with a sample house
  241. make release # optimized binary in target/release/newera
  242. make web-serve # browser editor and viewer at http://127.0.0.1:8790
  243. ```
  244. Run `make` to list every command. To host the browser editor yourself, serve `web/` as
  245. static files, with `.wasm` sent as `application/wasm` and compressed (about 15 MB raw,
  246. a quarter of that gzipped). No backend or special headers are needed. The public site is
  247. built by `scripts/site-build.sh` and deployed on every push to `main`.
  248. **Browsers:** Chrome, Edge and Safari 26 use WebGPU. Where it is missing (Firefox today)
  249. the editor falls back to WebGL 2 and still draws everything; a browser with neither gets a
  250. message pointing at the download.
  251. ### Project layout
  252. ```text
  253. crates/
  254. newera-core domain model, commands, undo/redo, geometry, standards — no UI, no I/O
  255. newera-catalog parametric furniture and fixtures at exact sizes; OBJ/glTF import
  256. newera-joinery parametric joinery and interiors, workshop rules, cut lists
  257. newera-ergonomics habitability review: clearances, occupancy, kitchens, accessibility
  258. newera-draw plan scene shared by the editor, PNG renders and SVG/PDF export
  259. newera-render 3D meshes, software renderer, path-traced photos, videos
  260. newera-sh3d Sweet Home 3D (.sh3d) import
  261. newera-mcp the MCP tools, over stdio and Streamable HTTP
  262. newera-server REST API + MCP endpoint, sessions (axum)
  263. newera-plugins external programs that edit the home over the HTTP API
  264. newera-app desktop editor (egui + wgpu)
  265. newera-editor-web the editor in the browser (WebGPU or WebGL)
  266. newera-web lightweight WebAssembly viewer
  267. newera-relay lets an AI reach the editor in a browser tab
  268. newera-cloud the hosted service: accounts, OAuth, cloud projects
  269. newera-telemetry crash reports and usage notes
  270. newera the binary that wires everything together
  271. ```
  272. ## Documentation
  273. - [Architecture](docs/ARCHITECTURE.md): crates, the command model, MCP design and security
  274. - [Standards and sources](docs/STANDARDS.md): where every rule in the reviews comes from
  275. - [Showcase](docs/SHOWCASE.md): a full apartment built by an agent
  276. - [Distribution](docs/DISTRIBUTION.md): channels, releases and the hosted service
  277. - [Roadmap](docs/ROADMAP.md) and [changelog](CHANGELOG.md)
  278. ## Privacy and telemetry
  279. The app sends crash reports through Sentry, along with the notes agents leave with the MCP
  280. `feedback` tool. It is **on by default** and off with one click in
  281. **Help → Send error reports**, or `newera telemetry off`; `NEWERA_TELEMETRY=0` turns it off
  282. for a single run. Nothing of the project is sent, nor the IP address or the machine's name,
  283. and the MCP token is removed from every report. Notes are always kept locally in the config
  284. folder (`notes.jsonl`).
  285. Under the same switch, opening the app counts one `app_open` — a random installation id, the
  286. version, the operating system, the architecture and the mode — the request for support counts a
  287. `support_prompt` when it shows and which button closed it, and the installers count one
  288. install and one uninstall, saying which system and whether the app came from a release or was
  289. compiled on the machine. Both go to `3dneweraai.com/ping`, an endpoint of the site that holds
  290. the Google Analytics secret and forwards the count without passing the IP address on: the
  291. country Cloudflare already knows goes instead. A build made without the project's keys reports
  292. through the same endpoint, so installing from source counts like any other install;
  293. `cargo build` on a clone and CI count nothing. The hosted service keeps only what it needs:
  294. your email, your projects and usage, never the conversation. See the
  295. [privacy policy](https://3dneweraai.com/privacy/).
  296. Apart from that switch, the desktop app asks GitHub's public API for the latest release when it
  297. opens, sending nothing about the installation, and says in its status bar when a newer one is
  298. out.
  299. ## Support the project
  300. Everything above is free, with no limits, and stays free. There is no paid plan. If it saves
  301. you time, a [donation on Buy Me a Coffee](https://buymeacoffee.com/leandrodaf) helps pay for
  302. the server; it unlocks nothing extra. See [support](https://3dneweraai.com/pricing/).
  303. ## Contributing
  304. Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md); `make check` runs the
  305. same checks as CI.
  306. ## License
  307. Licensed under either of [Apache License 2.0](LICENSE-APACHE) or
  308. [MIT license](LICENSE-MIT), at your option.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.