weike-zhang/architecture-canvas

어떤 프로젝트인가요?

핵심 기능

• 01업로드한 문서, 스프레드시트, PDF, 이미지를 바탕으로 채팅을 통해 아키텍처 다이어그램을 생성합니다.
• 02드래그, 텍스트 편집, 실행 취소, 가져오기를 지원하는 편집 가능한 Excalidraw 캔버스를 제공합니다.
• 03이미지가 포함된 편집 가능 파일과 SVG, PNG 형식으로 다이어그램을 내보냅니다.
• 04제안된 변경 사항을 적용 전에 검토하고 선택한 구성 요소를 고정할 수 있습니다.
• 05127.0.0.1에서 로컬로 실행되며 세션별 데이터를 작업 공간 폴더에 저장합니다.
• 06렌더러와 문서 리더를 임베드할 수 있도록 Python SDK와 MCP stdio 서버를 제공합니다.

활용 사례

• 요구사항 문서를 바탕으로 시스템 아키텍처 다이어그램 초안을 작성합니다.
• 수동으로 배치한 요소의 위치를 유지하면서 대화를 통해 기존 다이어그램을 수정합니다.
• 로컬 파일을 호스팅된 편집기로 전송하지 않고 편집 가능한 아키텍처 다이어그램을 만듭니다.
• MCP를 통해 AI 에이전트에 문서 읽기 및 다이어그램 렌더링 도구를 추가합니다.

빠른 시작

1. 1

   리포지토리를 클론합니다

   git clone https://github.com/weike-zhang/architecture-canvas.git
2. 2

   프로젝트 디렉터리로 이동합니다

   cd architecture-canvas
3. 3

   앱을 시작합니다(최초 실행 시 종속성을 설치하고 페이지를 빌드합니다)

   python3 start.py
4. 4

   브라우저에서 워크스페이스를 열고 모델 설정에서 모델을 구성합니다

사용 전 알아둘 점

• !알파 버전으로 로컬에서만 실행되며 127.0.0.1에 바인딩됩니다. 다중 사용자 계정은 지원하지 않습니다.
• !채팅, 문서 이해 및 다이어그램 생성에는 tool calling을 지원하는 API 키가 포함된 모델 서비스가 필요합니다.
• !생성은 약 22개 구성 요소로 제한되며 시퀀스, ER 또는 복잡한 분기 다이어그램은 지원하지 않습니다.

토픽

자주 묻는 질문

architecture-canvas은(는) 무엇인가요?

문서와 대화해 Excalidraw 캔버스에서 편집 가능한 아키텍처 다이어그램을 만들고 다듬는 로컬 우선 웹 작업 공간 Architecture Canvas에서는 요구사항 문서, 스프레드시트, PDF, 이미지를 업로드한 뒤 AI 어시스턴트와 대화해 아키텍처 다이어그램 초안을 만들 수 있습니다. 다이어그램은 편집 가능한 Excalidraw 캔버스에서 관리되므로 모델이 첫 초안을 생성한 후 노드를 드래그하고 텍스트를 수정하거나 SVG, PNG로 내보낼 수 있습니다.

architecture-canvas은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

architecture-canvas은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

architecture-canvas은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. architecture-canvas의 마지막 커밋은 2026년 10월 3일입니다.

architecture-canvas은(는) 어디에 사용할 수 있나요?

요구사항 문서를 바탕으로 시스템 아키텍처 다이어그램 초안을 작성합니다. 수동으로 배치한 요소의 위치를 유지하면서 대화를 통해 기존 다이어그램을 수정합니다. 로컬 파일을 호스팅된 편집기로 전송하지 않고 편집 가능한 아키텍처 다이어그램을 만듭니다. MCP를 통해 AI 에이전트에 문서 읽기 및 다이어그램 렌더링 도구를 추가합니다.

architecture-canvas는 어떻게 설치하나요?

리포지토리를 클론합니다: git clone https://github.com/weike-zhang/architecture-canvas.git 프로젝트 디렉터리로 이동합니다: cd architecture-canvas 앱을 시작합니다(최초 실행 시 종속성을 설치하고 페이지를 빌드합니다): python3 start.py 브라우저에서 워크스페이스를 열고 모델 설정에서 모델을 구성합니다

architecture-canvas은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/weike-zhang/architecture-canvas