AI_IFC

English

简体中文

English

简体中文

Appearance

AI_IFCIFC review and editing platform

Self-hosted and open-source. Review IFC models in the browser, really edit attributes, compare versions with semantic diffs, and expose the same editing API to humans and AI.

Quick Start
Upload your first IFC

3D Review

Upload an IFC and get fast XKT rendering; model tree, property inspection, section planes, measurements and 3D issue pins are built in.

Real Editing

Property overrides and a two-phase pending → commit edit flow that really modifies IFC; every commit creates an immutable version snapshot.

Semantic Version Diff

Attribute-level diffs keyed by GlobalId with added/removed/modified highlighting and old → new details, without geometric noise.

Human / AI Dual Role

Humans and AI share the same REST editing API, distinguished by provenance; the OpenAPI tool catalog can be fed directly to an LLM.

AI Authoring Skill

An agent-agnostic aiifc skill lets AI write ifcopenshell.api code directly, generating or heavily modifying IFC models from natural language.

What it does ​

AI_IFC is an IFC (Industry Foundation Classes) review and editing platform made of four components:

  • web: React + xeokit browser client for the model library, 3D review, property inspection, issues, property editing and version diffing.
  • server: Go backend for uploads, the conversion queue, the REST API and edit orchestration, with file or PostgreSQL storage.
  • converter: Node converter that turns IFC into XKT geometry and semantic metadata.
  • edit-service: Python (FastAPI + IfcOpenShell) editing service for real IFC edits, version snapshots and semantic diffs.

Typical workflow: upload an IFC → review it in 3D once conversion finishes → file issues on elements → edit attributes (override or real edit) → commit to create a version → use Diff to compare versions.

Screenshots ​

3D viewer

Model libraryProperty editingVersion diffAI chat
Model libraryProperty editingVersion diffAI chat

Getting started ​

  1. Project introduction — positioning, capability boundaries and the four-component architecture.
  2. Environment and local deployment — install dependencies and start all components in four terminals.
  3. Upload your first IFC — run through review → issues → editing → diff with the bundled sample.
  4. Viewer REST API and IFC editing API — API contracts; AI integration for agents.

Project status ​

The platform is functional end-to-end (upload → convert → review → edit → commit → diff). The active product is viewer/; SimpleCADAPI (SCAD) code from the repository history was moved on 2026-08-06 to the private archive repo 0702hjj/SimpleCADAPI-archive, see License & third-party components (Chinese) and Roadmap (Chinese).

AGPL-3.0-only

Copyright © 2026 0702hjj