whatisgithub

What is heritage-architecture-studio?

thursdaycapital/heritage-architecture-studio — explained in plain English

Analysis updated 2026-07-25

5PythonAudience · designerComplexity · 3/5Setup · easy

In one sentence

An AI agent skill that takes a historic building name and generates a complete workflow: analysis, JSON specs, multi-view image boards, and an interactive 3D web exhibit.

Mindmap

mindmap
  root((repo))
    What it does
      Analyzes buildings
      Generates JSON specs
      Builds 3D exhibits
    How it works
      Fixed ten views
      Validates JSON
      Graceful fallbacks
    Use cases
      Architectural visuals
      Historical education
      Concept prototyping
    Tech stack
      Python
      Three.js
      JSON Schema
    Audience
      Designers
      Archival researchers
      Builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a multi-view visual reference board for a historic building to guide 3D modeling.

USE CASE 2

Create an interactive web exhibit of a landmark for educational presentations.

USE CASE 3

Produce a structured JSON specification describing a building's architecture and materials.

USE CASE 4

Generate a detailed architectural prompt for visualizing ancient ruins.

What is it built with?

PythonThree.jsJSON Schema

How does it compare?

thursdaycapital/heritage-architecture-studio1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity3/53/52/5
Audiencedesignerops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires installing via the Hermes AI agent skills system or downloading a packaged file from GitHub releases.

So what is it?

Heritage Architecture Studio is a skill for the Hermes AI agent that converts the name of a historic building into a complete architectural generation workflow. You give it something like the Yingxian Wooden Pagoda, and it runs through a multi-step pipeline: analyzing the building's type, style, era, culture, and materials, producing a structured reference prompt, generating a self-contained JSON specification, assembling a multi-view reference board, and finally building an interactive Three.js webpage exhibit that runs in desktop and mobile browsers. The skill identifies architectural features and distinguishes between confirmed facts, inferences, simplifications, and uncertain information. It avoids presenting guesses as precise survey data. It enforces a fixed set of ten standard views, including hero perspective, front, back, left, right, top, bottom, roof detail, and ornament detail, plus at least two additional perspective views. The reference board requires at least eleven separate panels. It adapts its output for standing buildings, roofless ruins, and buildings with restrained decoration. Users can run the full pipeline or limit the scope. You can request only the prompt, only the JSON, the prompt plus JSON, the reference board without the webpage, or the Three.js webpage alone. Supplying reference images adds them as evidence without overriding the requested scope. The skill includes a JSON Schema for validation, a prompt and JSON consistency checker, and fallback behavior that preserves the prompt and JSON when image services fail, continuing to Three.js when feasible. Installation is done through the Hermes skills system with a single command, or by downloading a packaged skill file from the GitHub releases page. The repository contains the skill definition, reference documents, validation scripts, and templates for the JSON schema and the multi-view board prompt. Local validation scripts check repository structure and compile the Python files. The design boundaries are clearly stated. The generated reference boards help lock in silhouette, materials, and readability but do not replace conservation surveying. Structural dimensions prefer authoritative sources, and uncertainty is recorded rather than fabricated. The Three.js output is an interpretable procedural reconstruction, not a museum-grade CAD restoration.

Copy-paste prompts

Prompt 1
I want to create a 3D exhibit for the Yingxian Wooden Pagoda. Run the Heritage Architecture Studio skill to generate the interactive Three.js webpage.
Prompt 2
Give me only the structured JSON specification and reference prompt for the Pantheon, without generating the image board or webpage.
Prompt 3
I have reference images of the Colosseum. Add them as evidence and generate the full reference board without the Three.js webpage.
Prompt 4
Check the consistency between my generated architectural prompt and its JSON specification for the Hagia Sophia.
Prompt 5
Generate a multi-view reference board with at least eleven panels for Machu Picchu, adapting the output for roofless ruins.

Frequently asked questions

What is heritage-architecture-studio?

An AI agent skill that takes a historic building name and generates a complete workflow: analysis, JSON specs, multi-view image boards, and an interactive 3D web exhibit.

What language is heritage-architecture-studio written in?

Mainly Python. The stack also includes Python, Three.js, JSON Schema.

How hard is heritage-architecture-studio to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is heritage-architecture-studio for?

Mainly designer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.