Structure OS

건축을 설계하는 AI가 아니라, 건축을 운영하는 AI.

Live: https://structure-os-ai.web.app

자연어 프롬프트를 공간 데이터로 해석하고, 선택적으로 첨부한 도면 이미지/PDF를 함께 참고해 브라우저에서 편집 가능한 2D·3D 개념 모델로 바꾸는 오픈소스 Phase 1 MVP입니다.

현재 작동하는 기능

• 텍스트 프롬프트만으로 공간 구성 생성
• PNG/JPG/WEBP/PDF를 프롬프트 컨텍스트로 첨부
• openai/codex 기반 공간·치수 구조화
• Codex를 실행할 수 없는 서버를 위한 OpenAI Responses API fallback
• API 키가 없어도 작동하는 샘플 프로젝트
• 2D 인식 결과와 회전 가능한 WebGL 3D 모델
• 한국어 치수 명령: 거실을 1m 넓혀줘, 층고를 3.2m로, 계단을 오른쪽으로
• 기둥·보·벽체 에셋 팔레트와 2D 드래그 배치
• 선택 에셋의 X / Z / Width / Depth / Height 숫자 인스펙터
• Codex 기반 에셋 생성·수정: 거실 중앙에 0.5×0.5×3.2m 기둥 생성, 선택한 기둥을 오른쪽으로 1m 이동
• 수동/AI 에셋 편집 결과를 2D·3D·GLB에 동시 반영
• Монгол / 한국어 / English 전체 UI 및 Codex 출력 전환(기본값: Монгол)
• 모델 치수·재료·중량·리비전 기반 Technical Drawing 및 Drawing Register
• GLB 다운로드

실행

npm install
cp .env.example .env
npm run dev

브라우저에서 http://localhost:4173을 엽니다. 기본 엔진은 오픈소스 Codex SDK이며 로컬 Codex 로그인 정보를 사용합니다. 먼저 한 번 codex login을 완료하세요. API 키는 브라우저로 전달되지 않습니다.

AI_ENGINE=codex npm run dev

Codex를 설치·로그인할 수 없는 서버에서는 Responses API를 사용할 수 있습니다.

AI_ENGINE=openai OPENAI_API_KEY=... npm run dev

프로덕션 빌드:

npm run build
npm start

아키텍처

프롬프트 + 선택적 도면 → /api/generate → openai/codex SDK (read-only sandbox)
                                            ↓ structured output
                                       FloorPlan JSON
                                            ↓
대화 명령 → Constraint parser → 2D SVG + Three.js 3D → GLB
에셋 프롬프트 → /api/asset → Codex structured command → geometry constraint → SceneAsset

Codex는 read-only, approvalPolicy: never, 네트워크 비활성화 상태로 매 요청마다 임시 스레드에서 실행됩니다. 첨부 도면 외 파일을 수정하지 않으며, JSON Schema를 통과한 결과만 기하 엔진에 전달됩니다.

정확성 경계

이 저장소는 개념 설계 MVP입니다. 생성 결과는 인허가, 구조 계산, 내진 검토, 시공 또는 전문 설계자의 판단을 대체하지 않습니다. IFC/DWG 내보내기, 실제 CAD 벡터 파싱, 구조·법규 검토는 아직 구현하지 않았습니다.

다음 우선순위

1. DXF/IFC 파서와 벽·문·창호 토폴로지
2. 제약조건 기반 인접 공간 편집과 undo/redo
3. IFC export 및 Revit/SketchUp 검증
4. 구조 엔진 연동 전 전문가 검증 데이터셋

라이선스

MIT