BIM Reviera

Install a package

Riviera is pre-release software at a very early stage. Most of its specification, research and implementation was carried out autonomously by AI coding agents. Expect features that are incomplete or incorrect at this stage, check results before relying on them, and keep copies of models you care about.

Installing

Linux:

flatpak install --user BIM-Riviera-0.1.0-pre.11-x86_64.flatpak

Windows: run the installer, or unzip the portable build and start riviera.exe.

macOS (Apple silicon): open the .dmg and drag BIM Riviera to Applications. The app isn't notarized by Apple yet, so the first time macOS will refuse to open it. Open System Settings › Privacy & Security and click Open Anyway, or run:

xattr -dr com.apple.quarantine "/Applications/BIM Riviera.app"

How the Windows packages are built. The Windows installer and portable ZIP are cross-compiled on Fedora Linux, so they are never built or packaged on a Windows machine. A Windows virus has no practical way to get into them during the build.

Check the installer's hash before you run it. Each package's SHA-256 hash is listed in the table above and in SHA256SUMS. Compute the hash of the file you downloaded and compare it with the published one. If they differ, the file is damaged or has been altered, so delete it and don't run it.

On Windows, in PowerShell:

Get-FileHash .\BIM-Riviera-0.1.0-pre.11-windows-x64-setup.exe -Algorithm SHA256

On macOS or Linux, in the folder you downloaded to:

shasum -a 256 BIM-Riviera-0.1.0-pre.11-macos-arm64.dmg  # macOS
sha256sum BIM-Riviera-0.1.0-pre.11-x86_64.flatpak        # Linux

Every package includes the sample models and the sample Component Library.

Your first model

1. Open Help › Riviera Help (F1). The Samples section opens each sample model as a fresh copy, grouped by part of the application: Architecture, Structure, Systems, Sustainability, View and Modify. The sustainability samples open with their own weather files.
2. Try the Manor for architecture, or the Steel-framed office for structure. Each sample has a walkthrough showing how to build it by hand.
3. Or start from File › New, set your units and building code in Manage › Settings › Model Properties, and draw some walls.

Build from source

Fedora is the development platform today.

sudo dnf install rustup cmake ninja-build gcc-c++ opencascade-devel boost-devel eigen3-devel \
    libxml2-devel json-devel perl-FindBin perl-IPC-Cmd perl-Time-Piece webkit2gtk4.1-devel
rustup-init

git clone https://github.com/Rational-Boxes/BIM_Riviera.git
cd BIM_Riviera
tools/build-ifcopenshell.sh      # IfcOpenShell into third_party/ (about 15 minutes)

cargo build
cargo run -- gui model.ifc

Script it

Run a Lua script against the open model from Scripts › Run Script…, or from the shell:

local l1 = riviera.level.list()[1].id
local w = riviera.wall.create{
  curve = { line = { start = { 0, 0 }, ["end"] = { 10, 0 } } },
  base_level = l1, top_constraint = { unconnected = 3.0 },
}
riviera.door.place{ host_wall_id = w, point_along = 7.5 }
riviera.window.place{ host_wall_id = w, point_along = 2.5 }

The scripts behind every sample model are in test-data/samples/.

Connect an AI agent

The quickest way is the agent terminal. Open View › User Interface › Terminal (Ctrl+Shift+T) and start a Claude Code, Antigravity CLI, Qwen Code or Codex CLI tab. The agent starts already connected to the open model, and destructive changes wait for your approval in Riviera. Riviera doesn't install the agents, so install and sign in to the ones you use first.

To connect an agent from outside Riviera, use its MCP server. For example, with Claude Code:

claude mcp add riviera -- /path/to/riviera --mcp-stdio --permission model_edit /path/to/model.ifc

The permission levels are read_only (the default), model_edit and full_scripting.

Get involved

The source, the specification and the issue tracker are on GitHub. Riviera is licensed under the GNU GPL v3.0 or later. Its open data formats, protocols and client libraries are MIT-licensed.