한국의 운세 시장 규모는 약 1조 4천억 원으로 추산된다. 새해가 되면 사주팔자를 보고, 연인과의 궁합을 확인하고, 올해의 재물운이나 직장운을 점치는 사람이 넘쳐난다. 그런데 막상 사주팔자나 자미두수, 서양 점성술의 계산 원리를 알고 싶어서 찾아보면, 제대로 공개된 소스코드를 구하기가 쉽지 않다. 대부분의 만세력 사이트와 사주 앱은 소스를 비공개로 운영하고, 유료 API 형태로만 제공하는 경우가 많다.
Orrery(혼천의, 渾天儀)는 이 상황을 완전히 뒤집는 프로젝트다. 서버 없이 브라우저에서 사주팔자, 자미두수, 서양 점성술 출생차트를 동시에 계산하며, 전체 소스코드가 GitHub에 AGPL-3.0 라이선스로 공개되어 있다. 개발자 황장호(Jang-Ho Hwang)가 2018년부터 개인적으로 Java, Python으로 포팅해 사용하던 만세력 코드를 2026년 2월 Claude Code를 활용해 TypeScript로 재작성하면서 탄생했다.
명리학이나 점성술에 관심이 있는 개발자, 사주팔자 계산 로직을 직접 공부하고 싶은 사람, 혹은 자신만의 운세 서비스를 만들어보고 싶은 사람에게 이 프로젝트는 현존하는 가장 체계적인 오픈소스 학습 자료다. 이 글에서는 Orrery의 기능 구조, 기술 스택, 핵심 계산 엔진, AGPL 라이선스의 실질적 의미, 그리고 실제 활용 방법까지 상세하게 다룬다.
1. Orrery 프로젝트 개요와 탄생 배경
Orrery라는 이름은 태양계 행성의 운동을 재현하는 기계 장치인 혼천의(渾天儀)에서 따왔다. 동양 천문학의 상징적 도구를 이름으로 삼은 만큼, 이 프로젝트는 동양 명리학(사주팔자, 자미두수)과 서양 점성술(Natal Chart)을 하나의 도구에서 동시에 다루는 것이 핵심 목표다.
- 깃헙 - 사주팔자 소스코드 100% 공개 : https://github.com/rath/orrery
- 100% 무료 사주팔자 계산 운영 중인 사이트 : Orrery — 혼천의(渾天儀) https://sky.told.me/

1.1 프로젝트의 역사와 크레딧
-
사주 만세력의 원본은 고영창이 Perl로 작성한 '진짜만세력'이다. 이를 김정균이 PHP로 포팅했고, 황장호가 2018년 11월에 Java와 Python으로 다시 포팅하여 개인적으로 사용해왔다. 2026년 2월에 Claude Code(Opus 4.6)를 활용해 TypeScript로 최종 포팅했다.
-
자미두수 명반 계산은 lunar-javascript 라이브러리를 기반으로 Claude(Opus 4.5)가 중국어 문헌을 리서치하면서 구현했다. 자미두수는 중국 명리학 체계라 관련 문헌 대부분이 중국어로 되어 있는데, AI가 문헌 해석과 코드 구현을 동시에 수행한 독특한 사례다.
-
서양 점성술 출생차트는 Swiss Ephemeris의 Moshier 이론을 순수 TypeScript로 포팅한 것이다. 외부 WASM이나 데이터 파일 의존성 없이 모든 천체 위치 계산이 TypeScript 코드만으로 이루어진다.

1.2 라이브 서비스 주소
실제 운영 중인 서비스는 https://sky.told.me/ 에서 접속할 수 있으며, GitHub Pages를 통한 데모도 https://github.com/rath/orrery 에서 제공된다. 두 사이트 모두 동일한 코드 기반이며, 모든 계산이 브라우저에서 이루어지므로 개인정보가 외부 서버로 전송되지 않는다.
2. 세 가지 핵심 기능 상세 분석
Orrery는 단순히 하나의 운세를 보는 도구가 아니다. 사주팔자(四柱八字), 자미두수(紫微斗數), 서양 점성술 출생차트(Natal Chart)라는 세 가지 전혀 다른 체계를 하나의 입력(생년월일시, 성별, 출생지)으로 동시에 계산한다.
2.1 사주팔자(四柱八字) 기능

-
60갑자 기반 사주 4주 계산: 년주, 월주, 일주, 시주를 천간(天干)과 지지(地支)의 60갑자 체계로 계산한다. 예를 들어 1981년 7월 19일 12시에 태어난 남성의 사주는 년주 辛酉, 월주 乙未, 일주 戊戌, 시주 戊午로 산출된다.
-
십신(十神)과 12운성: 각 주의 천간과 지지에 대해 일간을 기준으로 비견, 겁재, 식신, 상관, 편재, 정재, 편관, 정관, 편인, 정인의 십신 관계를 계산한다. 12운성(장생, 목욕, 관대, 건록, 제왕, 쇠, 병, 사, 묘, 절, 태, 양)도 함께 표시된다.
-
간지 관계 분석: 합(合), 충(沖), 형(刑), 파(破), 해(害)의 다섯 가지 관계를 자동으로 탐지한다. 예시 데이터에서 午戌 반합화, 午未 합화, 戌未 파, 戌未 형(무례지형), 戌酉 해, 乙辛 충 등이 자동 검출되는 것을 확인할 수 있다.
-
대운(大運)과 세운(歲運): 10년 단위의 대운과 매년의 세운을 순행/역행으로 계산한다. 대운 시작 나이, 각 대운의 간지, 십신, 12운성, 신살까지 포함된다.
-
일운(日運) 분석: 향후 1개월간의 일별 운세 변동을 감지하여, 특정 날짜의 일운이 본인 사주와 어떤 합·충·형 관계를 형성하는지 보여준다.
-
좌법(坐法)과 인종법(引從法): 각 주 지장간이 일지에서 어떤 운성에 좌하는지 분석하는 좌법, 그리고 사주에 누락된 십성의 양간을 인종하는 인종법까지 포함된다. 이 수준의 분석을 제공하는 오픈소스 프로젝트는 매우 드물다.
2.2 자미두수(紫微斗數) 기능

-
명반(命盤) 자동 생성: 양력 생년월일을 입력하면 자동으로 음력 변환 후 12궁(명궁, 형제, 부처, 자녀, 재백, 질액, 천이, 교우, 관록, 전택, 복덕, 부모)에 14개 주성(자미계열 + 천부계열)을 배치한다.
-
보성과 흉성 배치: 좌보, 우필, 문창, 문곡, 천괴, 천월 등 보조성과 경양, 타라, 화성, 영성, 지공, 지겁 등 흉성도 함께 배치된다.
-
사화(四化) 계산: 화록, 화권, 화과, 화기의 사화가 어느 궁에 걸리는지 자동 계산한다. 예시에서 화록은 거문이 형제궁에, 화권은 태양이 전택궁에, 화과는 문곡이 자녀궁에, 화기는 문창이 전택궁에 걸리는 것을 확인할 수 있다.
-
성요 밝기(廟·旺·得·利·平·不得·陷): 각 주성이 해당 궁에서 어떤 밝기를 갖는지 7단계로 표시한다. 천상이 묘(廟)에 있는지 자미가 묘(廟)에 있는지에 따라 해석이 크게 달라지므로, 이 밝기 정보는 자미두수 해석의 핵심이다.
-
대한(大限)과 유년(流年): 오행국에 따른 대한 시작 나이와 12개 대한 주기를 계산한다. 유년 분석에서는 특정 연도(예: 2026 병오년)의 유년 명궁, 유년 사화, 유월 운세까지 12개월 단위로 제공된다.
-
전통 44궁 레이아웃: 자미두수 명반을 전통적인 사각형 12궁 형태로 시각화한다. 각 궁의 천간지지, 배치된 성요, 사화 표시, 밝기가 한눈에 보이도록 구성되어 있다.
2.3 서양 점성술 출생차트(Natal Chart) 기능

-
Swiss Ephemeris Moshier 이론 기반 행성 위치 계산: 태양, 달, 수성, 금성, 화성, 목성, 토성, 천왕성, 해왕성, 명왕성의 10개 행성과 키론, 북교점, 남교점, 행운점(Part of Fortuna)의 위치를 별자리(sign), 도수(degree), 역행(retrograde) 여부와 함께 계산한다.
-
하우스 시스템 선택: 기본값인 Placidus 외에도 Koch, Equal, Whole Sign 등 10가지 하우스 시스템을 지원한다. 하우스 시스템에 따라 행성이 속하는 하우스가 달라지므로, 여러 시스템을 비교해볼 수 있다는 점이 학습 목적에서 큰 장점이다.
-
ASC(어센던트), MC(미드헤븐), DESC(디센던트), IC(이뭄 코엘리): 4대 앵글을 정확하게 계산한다. 예시에서 ASC는 천칭자리 15°29', MC는 게자리 17°29'로 산출되었다.
-
5대 메이저 애스펙트: 합(conjunction, 0°), 세미섹스타일이 아닌 섹스타일(sextile, 60°), 스퀘어(square, 90°), 트라인(trine, 120°), 오포지션(opposition, 180°)의 5가지 주요 애스펙트를 오브(orb) 허용 범위와 함께 계산한다.
-
출생 위치 입력: 위도와 경도를 직접 입력하거나 도시명으로 검색할 수 있다. 한글 초성 검색도 지원하여, 'ㅂㅅ'을 입력하면 '부산'이 매칭된다. 시간대는 출생 위치에 따라 자동 추론된다.
핵심 포인트: Orrery는 동양 명리학(사주팔자, 자미두수)과 서양 점성술(Natal Chart)을 하나의 입력으로 동시에 계산하는, 현재 공개된 오픈소스 중 가장 포괄적인 통합 점술 계산기다.
3. 기술 스택과 아키텍처
Orrery의 기술적 구조는 프론트엔드 개발자가 참고할 만한 현대적 스택으로 구성되어 있다.
3.1 프레임워크와 언어
-
React 19 + TypeScript 5: 최신 React와 TypeScript를 사용한다. 타입 안전성이 보장되므로, 천간지지 매핑이나 행성 위치 계산에서 발생할 수 있는 타입 오류를 컴파일 시점에 잡을 수 있다.
-
Vite 7: 빌드 도구로 Vite 7을 사용한다. 개발 서버 시작 속도와 HMR(Hot Module Replacement) 성능이 빨라서, 코드를 수정하면서 실시간으로 결과를 확인하기에 적합하다.
-
Tailwind CSS 4: 스타일링에 Tailwind CSS 4를 사용한다. 자미두수 명반의 복잡한 12궁 레이아웃이나 출생차트의 시각적 표현에 유틸리티 클래스 기반 스타일링이 활용된다.
-
Vitest: 테스트 프레임워크로 Vitest를 사용한다. 사주팔자 계산이나 행성 위치 계산의 정확도를 검증하는 테스트가 포함되어 있다.
3.2 핵심 의존성 구조
| 패키지 | 유형 | 용도 |
|---|---|---|
| lunar-javascript | dependency | 양력→음력 변환 (자미두수에 필수) |
| Swiss Ephemeris Moshier | 직접 포팅 | 행성 위치 계산 (순수 TypeScript) |
주목할 점은 외부 WASM이나 바이너리 데이터 파일 의존성이 전혀 없다는 것이다. Swiss Ephemeris는 보통 C 언어로 작성된 네이티브 라이브러리를 WASM으로 컴파일하거나, 대용량 천문 데이터 파일(.se1)을 로드하는 방식으로 사용한다. Orrery는 Moshier 이론(해석적 근사법)을 TypeScript로 직접 구현함으로써, 브라우저에서 추가 파일 다운로드 없이 행성 위치를 계산한다.
3.3 @orrery/core npm 패키지
계산 엔진은 @orrery/core라는 독립 npm 패키지로도 배포되어 있다. 현재 버전은 0.4.2이며, 브라우저와 Node.js 환경 모두에서 동작한다. 설치는 npm install @orrery/core 한 줄이면 된다.
Subpath Export 구조가 잘 정리되어 있어, 필요한 모듈만 선택적으로 가져올 수 있다.
| 경로 | 설명 |
|---|---|
| @orrery/core | 전체 barrel export |
| @orrery/core/saju | calculateSaju() 함수 |
| @orrery/core/ziwei | createChart(), calculateLiunian(), getDaxianList() |
| @orrery/core/natal | calculateNatal(), 별자리/행성 심볼, 포맷 함수 |
| @orrery/core/pillars | getFourPillars(), getDaewoon() 등 저수준 API |
| @orrery/core/types | 모든 TypeScript 타입/인터페이스 |
| @orrery/core/constants | 천간/지지, 십신, 궁위명 등 상수 테이블 |
| @orrery/core/cities | 도시 데이터, 한글 초성 검색 함수 |
자신만의 사주 서비스나 점성술 앱을 만들고 싶다면, 웹 UI 전체를 포크하지 않아도 이 코어 패키지만으로 계산 로직을 활용할 수 있다.
4. AGPL-3.0 라이선스의 실질적 의미
Orrery는 AGPL-3.0(GNU Affero General Public License v3) 라이선스를 채택했다. 이 라이선스는 오픈소스 라이선스 중에서도 가장 강력한 카피레프트 조항을 가지고 있으며, 일반적인 GPL보다 한 단계 더 엄격하다.
4.1 AGPL-3.0과 GPL-3.0의 핵심 차이
| 항목 | GPL-3.0 | AGPL-3.0 |
|---|---|---|
| 소스코드 공개 의무 | 바이너리 배포 시 | 바이너리 배포 시 + 웹 서비스 제공 시 |
| 네트워크 조항 | 없음 | 있음 (Section 13) |
| SaaS 루프홀 | 존재 (서버에서만 실행하면 공개 의무 없음) | 차단됨 |
GPL-3.0은 소프트웨어를 바이너리로 배포할 때만 소스코드 공개 의무가 발생한다. 그래서 웹 서비스로만 운영하면(이른바 SaaS 루프홀) 소스를 공개하지 않아도 된다. AGPL-3.0은 이 루프홀을 명시적으로 차단한다. 네트워크를 통해 사용자와 상호작용하는 서비스를 운영하는 것만으로도 소스코드 공개 의무가 발생한다.
4.2 개인 사용자에게 미치는 영향
-
개인적으로 실행하고 수정하는 것은 완전히 자유다. 자기 컴퓨터에서 돌리고, 코드를 뜯어보고, 기능을 추가하는 데 아무런 제약이 없다.
-
소스코드를 읽고 공부하는 것은 언제든 환영된다. 사주팔자 계산 알고리즘, 자미두수 성요 배치 로직, Swiss Ephemeris Moshier 이론의 TypeScript 구현을 학습 목적으로 분석하는 데 이상적이다.
-
수정 후 재배포도 가능하되, 반드시 같은 AGPL-3.0 라이선스를 유지해야 하고, 변경 사항을 명시해야 하며, 원본 저작권 표시를 유지해야 한다.
4.3 상업적 활용의 제약
-
이 코드를 수정하여 웹 서비스를 운영하면서 소스를 비공개로 유지하는 것은 라이선스 위반이다.
-
AGPL 코드를 MIT, Apache 등 더 허용적인 라이선스로 변경하여 배포할 수 없다.
-
AGPL 코드가 조금이라도 섞이면, 경우에 따라 해당 서비스의 전체 소스코드를 공개해야 할 수 있다. 이 때문에 상용 서비스에 직접 통합하기는 어렵다.
핵심 포인트: AGPL-3.0은 '마음껏 쓰되, 수정하거나 서비스로 제공할 경우 소스코드를 공개하라'는 원칙이다. 개인 학습이나 비공개 사용에는 아무 제약이 없으므로, 사주팔자 프로그래밍을 공부하는 데 최적의 교재다.
5. AI 해석 연동 기능과 실제 활용 흐름
Orrery의 가장 실용적인 기능 중 하나는 AI 해석용 복사 기능이다. 사주팔자, 자미두수 명반, 출생차트 데이터를 텍스트 형태로 한 번에 복사해서 Claude, ChatGPT, Gemini 등 AI 채팅에 붙여넣을 수 있다.
5.1 활용 시나리오
-
성격 분석: 사주팔자의 십신 구조, 자미두수 명궁의 주성과 밝기, 출생차트의 태양·달·ASC 위치를 종합하여 AI에게 성격 분석을 요청할 수 있다. 세 가지 체계를 동시에 제공하면, 단일 체계만으로는 놓칠 수 있는 교차 분석이 가능해진다.
-
궁합 분석: 두 사람의 데이터를 각각 복사하여 AI에게 제공하면, 사주팔자의 합충 관계, 자미두수의 부처궁 배치, 출생차트의 행성 간 애스펙트를 기반으로 궁합 분석을 받을 수 있다.
-
운세 상담: 대운, 세운, 유년 데이터를 포함하여 복사하면, 특정 시기에 주의해야 할 점이나 기회가 될 수 있는 시기를 AI가 분석해줄 수 있다.
5.2 복사 데이터 구조
복사되는 텍스트는 AI가 구조를 파악하기 쉽도록 정리되어 있다. 출생차트의 경우 행성명, 별자리, 도수, 역행 여부, 하우스 번호가 테이블 형태로 정리되며, 하우스 커스프와 메이저 애스펙트도 포함된다. 자미두수 명반은 12궁별 배치 성요와 사화, 대한, 유년 정보가 포함된다. 사주팔자는 4주의 천간지지, 십신, 운성, 신살, 장간, 간지 관계, 대운, 세운이 빠짐없이 들어간다.
6. 다른 오픈소스 사주 프로젝트와의 비교
현재 GitHub에는 사주팔자를 계산하는 오픈소스 프로젝트가 여러 개 존재한다. Orrery의 위치를 파악하기 위해 주요 프로젝트들과 비교해본다.
| 항목 | Orrery (@orrery/core) | ssaju (golbin) | manseryeok-js | sajupy (Python) |
|---|---|---|---|---|
| 사주팔자 | O (십신, 대운, 좌법, 인종법) | O (십신, 대운) | O (기본 4주) | O (기본 4주) |
| 자미두수 | O (명반, 사화, 대한, 유년) | X | X | X |
| 서양 점성술 | O (Moshier 기반 순수 TS) | X | X | X |
| AI 복사 기능 | O | X | X | X |
| 웹 UI | O (React) | X (라이브러리) | X (라이브러리) | X (라이브러리) |
| npm 패키지 | O (@orrery/core) | O | O | N/A (PyPI) |
| 라이선스 | AGPL-3.0 | MIT | MIT | MIT |
Orrery는 세 가지 체계를 모두 포함하는 유일한 오픈소스 프로젝트라는 점에서 독보적이다. 다른 프로젝트들은 사주팔자 단일 기능에 집중하는 반면, Orrery는 자미두수와 서양 점성술까지 아우른다. 다만 라이선스 측면에서 ssaju나 manseryeok-js는 MIT 라이선스여서 상업적 활용이 자유로운 반면, Orrery의 AGPL-3.0은 상업적 서비스에 직접 통합하기 어렵다는 차이가 있다.
7. 소스코드 공부를 위한 추천 학습 경로
이 프로젝트를 학습 목적으로 활용하려는 개발자를 위한 단계별 접근 방법을 정리한다.
7.1 환경 설정부터 실행까지
-
저장소 클론 후
bun install로 의존성을 설치한다. Bun이 없다면 Node.js와 npm으로도 동작하지만, Bun을 사용하면 설치와 실행 속도가 더 빠르다. -
bun dev로 개발 서버를 실행하면 로컬에서 즉시 사용해볼 수 있다.bun run build로 프로덕션 빌드도 가능하다. -
bun test로 테스트를 실행하여 계산 결과의 정확도를 검증하는 테스트 케이스를 확인할 수 있다.
7.2 핵심 디렉토리 구조 파악
-
packages/core/디렉토리가 계산 엔진의 핵심이다. 사주팔자 계산은saju/하위에, 자미두수는ziwei/하위에, 출생차트는natal/하위에 있다. -
pillars/디렉토리에는 사주 4주 계산의 저수준 API가 있다.getFourPillars(),getDaewoon(),getRelation()등의 함수로 만세력 계산 원리를 직접 추적할 수 있다. -
constants/디렉토리에는 천간·지지 테이블, 십신 관계 테이블, 12운성 테이블, 궁위명 등 명리학에서 사용하는 상수 데이터가 정리되어 있다. 명리학 이론서에 나오는 표를 코드로 어떻게 옮기는지 학습하기에 좋다. -
examples/디렉토리에 사주, 자미두수, 출생차트 각각의 사용 예시 스크립트가 준비되어 있다.bun packages/core/examples/saju.ts처럼 바로 실행해볼 수 있다.
7.3 MCP 서버 확장
@orrery/core를 기반으로 한 MCP(Model Context Protocol) 서버 프로젝트(orrery-mcp)도 별도로 존재한다. AI 에이전트가 직접 사주팔자, 자미두수, 출생차트를 계산할 수 있도록 하는 확장 프로젝트로, AI와 명리학의 결합에 관심이 있다면 참고할 만하다.
8. 혼천의(Orrery) 사주팔자 — 로컬 설치 및 실행 완전 가이드
혼천의는 사주팔자, 자미두수, 서양 점성술(Natal Chart)을 한 번에 볼 수 있는 오픈소스(AGPL-3.0) 프로젝트입니다. 프로그래밍을 전혀 모르는 분도 아래 가이드를 1번부터 순서대로 따라하시면 내 컴퓨터에서 실행할 수 있습니다.
8.1 혼천의란?
혼천의(Orrery)는 동양 명리학과 서양 점성술을 하나의 웹 화면에서 모두 볼 수 있도록 만든 무료 오픈소스 프로젝트입니다. 원래 Perl, PHP, Java, Python 등 다양한 언어로 작성되었던 역학 계산 로직을 2026년 2월 Claude Code(Opus 4.6)를 활용하여 TypeScript로 새롭게 구현한 것이 특징입니다.
사주팔자 기능: 60간지 기반 4주(년주, 월주, 일주, 시주) 산출, 대운과 세운, 12운성, 합과 충과 형(삼합, 방합, 육합 등), 신살(도화살, 역마살, 화개살 등), 공망 판단, 10신 관계(비견/겁재 등), 격국 판단(식신격/상관격/편재격 등) 등을 지원합니다.
자미두수 기능: 자미두수 명반 생성, 14주성(자미성 + 천부성 계열) 배치, 사화 배치(화록/화권/화과/화기), 보성과 잡성 배치(문창/문곡/좌보/우필/천괴/천월 등), 4대 공망 판단, 12궁 분석, 삼방사정(명궁, 재백궁, 12궁) 등을 지원합니다.
서양 점성술(Natal Chart) 기능: Swiss Ephemeris의 Moshier 알고리즘을 TypeScript로 직접 구현하여 외부 서버 없이 계산합니다. 10대 행성 + 상승점 + 중천/하강점 좌표 산출, 하우스 시스템(Placidus 방식, 10도 이내 커스프 보정), ASC/MC/DESC/IC 표시, 5대 주요 상(합/충/삼합/사각/육합), 역행과 순행 표시 등을 지원합니다.
AI 통합 해석: 사주 + 자미두수 + 서양 점성술 3가지를 AI가 종합하여 해석해주는 기능도 포함되어 있습니다(3종 통합 해석).
8.2 프로젝트 다운로드
혼천의 소스코드는 GitHub에 공개되어 있습니다. 아래 주소로 이동합니다.
https://github.com/rath/orrery
방법 A — ZIP 파일로 다운로드 (가장 쉬움, 추천)
- 웹 브라우저(Chrome, Edge, Firefox 등)를 열고 위 주소에 접속합니다.
- 페이지가 열리면 화면 오른쪽 위에 있는 초록색
<> Code버튼을 클릭합니다. - 드롭다운 메뉴가 펼쳐지면 맨 아래에 있는
Download ZIP을 클릭합니다. orrery-main.zip파일이 다운로드됩니다. 보통C:\Users\내이름\Downloads폴더에 저장됩니다.- 다운로드된 ZIP 파일을 마우스 오른쪽 버튼으로 클릭한 뒤 "압축 풀기" 또는 "여기에 풀기" 를 선택합니다.
- 압축이 풀리면
orrery-main이라는 폴더가 생깁니다. - 이 폴더를 원하는 위치로 옮겨도 됩니다. 예시 경로:
C:\Users\내이름\Documents\orrery-main
방법 B — Git으로 클론 (Git이 이미 설치되어 있는 분만)
Git을 이미 사용하고 계신 분은 터미널에서 아래 명령어를 입력하면 됩니다.
git clone https://github.com/rath/orrery.git
이 경우 orrery라는 폴더가 현재 경로에 생성됩니다.
8.3 Node.js 설치 (윈도우 개발환경 설정)
Node.js는 JavaScript 코드를 내 컴퓨터에서 실행할 수 있게 해주는 런타임 환경입니다. 혼천의는 JavaScript(TypeScript) 기반 프로젝트이므로 Node.js가 반드시 필요합니다. Node.js를 설치하면 패키지 관리 도구인 npm도 함께 자동으로 설치됩니다.
다운로드
- 웹 브라우저에서 Node.js 공식 사이트에 접속합니다.
https://nodejs.org
- 메인 페이지에 큰 다운로드 버튼이 두 개 보입니다. 왼쪽의 LTS (Long Term Support) 버전을 클릭합니다. LTS는 장기 지원 안정 버전이라는 뜻으로, 일반 사용자에게 권장됩니다.
.msi확장자의 설치 파일이 다운로드됩니다.
설치 과정
- 다운로드된
.msi파일을 더블클릭하여 실행합니다. - Welcome 화면 → Next 클릭
- License Agreement (라이선스 동의) → 체크박스에 체크 → Next 클릭
- Destination Folder (설치 경로) → 기본값 그대로 두고 → Next 클릭
- Custom Setup (구성 요소 선택) → 기본값 그대로 두고 → Next 클릭
- Tools for Native Modules 화면이 나올 수 있습니다. 체크하지 않아도 됩니다 → Next 클릭
- Install 클릭 → 설치가 진행됩니다 (관리자 권한 팝업이 나오면 예 클릭)
- 설치 완료 → Finish 클릭
설치 확인 (매우 중요)
설치가 끝나면 반드시 정상적으로 설치되었는지 확인해야 합니다.
- Windows 키를 누르고
cmd를 입력합니다. - 검색 결과에서 명령 프롬프트 를 클릭하여 엽니다.
- 아래 명령어를 입력하고 Enter를 누릅니다.
node --version
화면에 v22.13.0 처럼 버전 번호가 표시되면 Node.js 설치가 성공한 것입니다.
- 이어서 npm도 확인합니다.
npm --version
10.9.2 같은 숫자가 표시되면 npm도 정상 설치된 것입니다.
버전이 표시되지 않는 경우: 명령 프롬프트를 닫고 컴퓨터를 재시작한 후 다시 시도해 보세요. Node.js 설치 시 환경변수(PATH)가 등록되는데, 이것이 재시작 후에야 적용되는 경우가 있습니다. 재시작 후에도 안 되면 Node.js를 삭제하고 처음부터 다시 설치해 보세요.
8.4 터미널(명령 프롬프트)에서 프로젝트 폴더로 이동
npm install이나 npm run dev 같은 명령어는 반드시 혼천의 프로젝트 폴더 안에서 실행해야 합니다. 그래서 터미널에서 해당 폴더로 이동하는 과정이 필요합니다.
터미널 여는 방법
방법 1: Windows 키 + R 을 동시에 누르면 "실행" 창이 열립니다. 거기에 cmd를 입력하고 Enter를 누릅니다.
방법 2: Windows 키를 누르고 "명령 프롬프트" 또는 "cmd"를 검색하여 클릭합니다.
방법 3: Windows 키를 누르고 "터미널"을 검색하여 Windows 터미널을 열 수도 있습니다.
알아야 할 핵심 명령어
| 명령어 | 의미 | 사용 예시 |
|---|---|---|
cd 폴더이름 |
해당 폴더 안으로 들어가기 (change directory) | cd Documents |
cd .. |
한 단계 상위(부모) 폴더로 나가기 | cd .. |
cd \ |
현재 드라이브의 최상위(루트)로 이동 | cd \ |
D: |
다른 드라이브로 이동 (D드라이브 예시) | D: 입력 후 Enter |
dir |
현재 폴더에 있는 파일과 폴더 목록 보기 | dir |
실제 이동 예시
ZIP 파일을 C:\Users\홍길동\Documents\orrery-main에 압축 해제했다고 가정합니다.
한 번에 이동하는 방법:
cd C:\Users\홍길동\Documents\orrery-main
한 번에 이동이 어려우면 단계별로 이동합니다:
cd C:\Users
cd 홍길동
cd Documents
cd orrery-main
만약 D드라이브에 압축을 풀었다면 먼저 드라이브를 변경해야 합니다:
D:
cd orrery-main
올바른 폴더에 도착했는지 확인
dir
이 명령어를 입력했을 때 파일 목록 중에 package.json이 보이면 올바른 위치에 있는 것입니다. package.json이 보이지 않는다면 아직 정확한 폴더에 도착하지 못한 것이므로 cd 명령어로 더 안쪽 폴더로 들어가 보세요.
꿀팁 — 파일 탐색기에서 바로 터미널 열기
위의 cd 과정이 번거롭다면 훨씬 쉬운 방법이 있습니다. 파일 탐색기(윈도우 탐색기)에서 orrery-main 폴더를 엽니다. 상단의 주소창(경로가 표시되는 부분)을 마우스로 클릭하면 텍스트 입력 상태가 됩니다. 거기에 cmd를 입력하고 Enter를 누르면, 해당 폴더 경로에서 바로 명령 프롬프트가 열립니다. 이 방법을 쓰면 cd 명령어를 전혀 사용할 필요가 없습니다.
8.5 npm install (패키지 설치)
혼천의 프로젝트는 React, Vite, Tailwind CSS, lunar-javascript 등 여러 외부 라이브러리에 의존합니다. npm install 명령어는 package.json 파일에 기록된 이 모든 라이브러리를 인터넷에서 자동으로 다운로드하여 node_modules 폴더에 저장합니다.
실행
터미널에서 프로젝트 폴더(package.json이 있는 위치)에 있는 상태에서 아래 명령어를 입력하고 Enter를 누릅니다.
npm install
진행 과정에서 보이는 화면
npm warn deprecated inflight@1.0.6: This module is not supported...
npm warn deprecated glob@7.2.3: Glob versions prior to v9 are...
added 285 packages in 32s
이런 식으로 여러 줄의 텍스트가 빠르게 지나갑니다. warn(경고)은 정상입니다. 무시해도 됩니다. error라는 단어가 빨간색으로 나타나지 않으면 문제없습니다. 인터넷 속도에 따라 30초에서 2분 정도 소요됩니다.
설치 완료 확인
dir 명령어를 다시 입력했을 때 node_modules라는 폴더가 새로 생겨 있으면 설치가 성공한 것입니다.
ERROR가 발생하는 경우 대처법
첫째, dir로 현재 위치에 package.json이 있는지 확인하세요. 없다면 3단계로 돌아가 올바른 폴더로 이동하세요. 둘째, Node.js 버전이 너무 낮으면 호환성 문제가 생길 수 있습니다. node --version으로 확인하고, 버전이 18 미만이라면 최신 LTS를 다시 설치하세요. 셋째, 회사나 학교 네트워크에서 프록시나 방화벽이 npm 다운로드를 차단하는 경우가 있습니다. 이 경우 개인 네트워크(모바일 핫스팟 등)로 시도해 보세요.
8.6 npm run dev (개발 서버 실행)
이제 혼천의를 내 컴퓨터에서 실행합니다. 이 명령어는 Vite 개발 서버를 시작하여 내 컴퓨터를 임시 웹 서버로 만들어 줍니다.
실행
터미널에서 아래 명령어를 입력하고 Enter를 누릅니다.
npm run dev
실행 성공 화면
아래와 비슷한 메시지가 나타나면 성공입니다:
VITE v7.x.x ready in 500ms
➜ Local: http://localhost:5173/
➜ Network: http://192.168.x.x:5173/
➜ press h + enter to show help
Local: http://localhost:5173/ 이 줄이 핵심입니다. 이 주소로 브라우저에서 접속하면 혼천의를 사용할 수 있다는 뜻입니다.
주의사항: 이 터미널 창은 절대 닫지 마세요. 이 터미널이 곧 서버입니다. 닫으면 서버가 종료되어 브라우저에서 접속할 수 없게 됩니다. 터미널은 그대로 두고 브라우저를 별도로 열어서 사용합니다.
8.7 브라우저에서 접속하여 사용
접속 방법
- 웹 브라우저(Chrome, Edge, Firefox 등)를 새로 엽니다. (터미널은 그대로 두세요)
- 주소창에 아래 주소를 직접 입력하고 Enter를 누릅니다.
http://localhost:5173/
주의할 점은 https가 아니라 http 라는 것입니다. s가 붙으면 접속되지 않습니다.
- 혼천의 메인 화면이 나타나면 성공입니다.
사용 방법
화면에서 생년월일, 출생시간, 성별을 입력하면 사주팔자(4주, 대운, 세운, 신살 등), 자미두수(명반, 14주성, 사화 등), 서양 점성술 차트(행성 위치, 하우스, 상 등)를 한 화면에서 모두 확인할 수 있습니다. 정확한 출생 시간을 입력할수록 더 정밀한 결과를 얻을 수 있습니다.
8.8 종료 방법
사용을 모두 마쳤으면 서버를 종료합니다.
npm run dev가 실행 중인 터미널 창으로 돌아갑니다.- 키보드에서
Ctrl + C를 동시에 누릅니다. 일괄 작업을 끝내시겠습니까 (Y/N)?라는 메시지가 나타나면Y를 입력하고 Enter를 누릅니다.- 서버가 종료됩니다. 이후 브라우저에서
localhost:5173에 접속해도 더 이상 화면이 나오지 않습니다.
다시 실행하고 싶을 때
npm install(4단계)은 처음 한 번만 하면 됩니다. 다시 실행할 때는 터미널을 열고 프로젝트 폴더로 이동(3단계)한 뒤 npm run dev(5단계)만 실행하면 됩니다. 그리고 브라우저에서 http://localhost:5173/에 접속(6단계)하면 바로 사용할 수 있습니다.
8.9 AI 바이브 코딩 도구 활용 팁
Cursor, Windsurf, Claude Code 같은 AI 코딩 도구를 사용하고 있다면 위의 모든 과정을 AI에게 물어보면서 진행할 수 있습니다. 예를 들어 "이 프로젝트를 로컬에서 실행하려면 어떻게 해야 하나요?"라고 질문하면 AI가 현재 환경에 맞는 명령어를 안내해 줍니다. 특히 에러가 발생했을 때 에러 메시지를 그대로 복사해서 AI에게 붙여넣으면 해결 방법을 빠르게 찾을 수 있습니다.
8.10 문제 해결 (트러블슈팅)
"npm을(를) 찾을 수 없습니다" 또는 "'npm'은(는) 내부 또는 외부 명령... 이 아닙니다" 오류
Node.js가 제대로 설치되지 않았거나 환경변수가 등록되지 않은 것입니다. 2단계로 돌아가 Node.js를 재설치하고 컴퓨터를 재부팅한 뒤 다시 시도하세요.
"port 5173 is already in use" 오류
이미 다른 프로그램이나 이전에 실행한 혼천의 서버가 5173 포트를 사용 중입니다. 이전에 열어둔 터미널 창이 있는지 확인하고 모두 닫은 뒤 다시 npm run dev를 실행하세요.
브라우저에서 "사이트에 연결할 수 없음" 또는 "이 페이지를 표시할 수 없습니다"
터미널에서 npm run dev가 정상적으로 실행 중인지 확인하세요. VITE ready 메시지가 보여야 합니다. 주소가 정확히 http://localhost:5173/인지 다시 확인하세요. https가 아닌 http여야 하고, 포트 번호 5173도 정확해야 합니다.
npm install 중 "ERESOLVE unable to resolve dependency tree" 오류
패키지 간 버전 충돌이 발생한 것입니다. 아래 명령어로 강제 설치를 시도해 보세요:
npm install --legacy-peer-deps
npm install 중 "EACCES permission denied" 오류
권한 문제입니다. 명령 프롬프트를 관리자 권한으로 실행하세요. Windows 키를 누르고 cmd를 검색한 뒤 마우스 오른쪽 버튼으로 클릭하여 "관리자 권한으로 실행"을 선택합니다.
8.11 전체 과정 한눈에 요약
1. https://github.com/rath/orrery 에서 ZIP 다운로드 → 압축 해제
2. https://nodejs.org 에서 Node.js LTS 설치
3. 터미널(cmd) 열기 → cd 명령으로 프로젝트 폴더로 이동
4. npm install ← 최초 1회만 실행
5. npm run dev ← 사용할 때마다 실행
6. 브라우저에서 http://localhost:5173/ 접속
7. 종료할 때: 터미널에서 Ctrl + C → Y → Enter
9. 혼천의 사주팔자 및 결과 예시 - 이걸 AI에 던져주고 사주 및 운세 풀이

9.1 AI 운세 풀이에 사용된 AI 모델명 = 클러드 오푸스 4.6 ( 젠스파크 내 AI 채팅 기능 활용 )
- 사이트 개발 및 운세 풀이에 사용된 AI 서비스 - 젠스파크 AI 구경 : https://min-inter.co.kr/link/genspark-unlimited

9.2 사주 및 기초 데이터 계산 결과
四柱八字 (男)
─────
時柱 日柱 月柱 年柱
─────
십신 比肩 本元 偏印 劫財
천간 戊 戊 丙 己
지지 午 午 子 卯
십신 正印 正印 正財 正官
─────
운성 帝旺 帝旺 胎 沐浴
공망 空
장간 丙己丁 丙己丁 壬 癸 甲 乙
공망: 子丑
八字關係 ───── 時-日: 午午刑(自刑) 時-月: 午子沖 時-年: 午卯破 日-月: 午子沖 日-年: 午卯破 月-年: 子卯刑(相刑)
神殺 ───── 양인살(時柱,日柱) · 도화살(年柱)
坐法 (장간 → 운성) ───── 時柱: 丙(偏印·帝旺坐) 己(劫財·乾祿坐) 丁(正印·乾祿坐) 日柱: 丙(偏印·帝旺坐) 己(劫財·乾祿坐) 丁(正印·乾祿坐) 月柱: 壬(偏財·胎坐) 癸(正財·絶坐) 年柱: 甲(偏官·死坐) 乙(正官·長生坐)
引從法 (누락 십성의 양간 인종) ───── 庚 食傷 → 沐浴從 · 壬 財星 → 胎從 · 甲 官星 → 死從
大運 ───── 1運 ( 8세) 正官 乙亥 偏財 (2008年) 2運 (18세) 偏官 甲戌 比肩 (2018年) 3運 (28세) 正財 癸酉 傷官 (2028年) 4運 (38세) 偏財 壬申 食神 (2038年) 5運 (48세) 傷官 辛未 劫財 (2048年) 6運 (58세) 食神 庚午 正印 (2058年) 7運 (68세) 劫財 己巳 偏印 (2068年) 8運 (78세) 比肩 戊辰 比肩 (2078年) 9運 (88세) 正印 丁卯 正官 (2088年) 10運 (98세) 偏印 丙寅 偏官 (2098年)
紫微斗數 命盤 (男) ═════
年柱: 己卯 命宮: 庚午 身宮: 命宮 (午) 五行局: 土五局 大限起始: 5歲
十二宮 ───── 命宮·身 庚午 紫微 旺 吉: 祿存 兄弟 己巳 天機 陷 吉: 天馬 | 煞: 地空 地劫 陀羅 夫妻 戊辰 七殺 得 吉: 文昌 | 煞: 鈴星 子女 丁卯 太陽 廟, 天梁 旺 化科 煞: 火星 財帛 丙寅 武曲 利 化祿, 天相 旺 吉: 左輔 疾厄 丁丑 天同 陷, 巨門 陷 遷移 丙子 貪狼 旺 化權 吉: 右弼 天魁 交友 乙亥 太陰 廟 官祿 甲戌 廉貞 平, 天府 旺 吉: 文曲 田宅 癸酉 (空宮) 福德 壬申 破軍 陷 吉: 天鉞 父母 辛未 (空宮) 煞: 擎羊
四化 ───── 化祿: 武曲 在 財帛 化權: 貪狼 在 遷移 化科: 天梁 在 子女 化忌: 文曲 在 官祿
大限 ───── 5- 14歲 命宮 庚午 紫微 15- 24歲 兄弟 己巳 天機 25- 34歲 夫妻 戊辰 七殺 35- 44歲 子女 丁卯 太陽 天梁 45- 54歲 財帛 丙寅 武曲 天相 55- 64歲 疾厄 丁丑 天同 巨門 65- 74歲 遷移 丙子 貪狼 75- 84歲 交友 乙亥 太陰 85- 94歲 官祿 甲戌 廉貞 天府 95-104歲 田宅 癸酉 (空宮) 105-114歲 福德 壬申 破軍 115-124歲 父母 辛未 (空宮)
Natal Chart ═════
Angles ───── ASC ♈ Aries 3°22' MC ♑ Capricorn 1°53'
Planets ───── ☉ Sun ♑ Capricorn 9°59' XI ☽ Moon ♏ Scorpio 8°47' VIII ☿ Mercury ♑ Capricorn 1°19' IX ♀ Venus ♐ Sagittarius 1°07' VIII ♂ Mars ♒ Aquarius 27°40' XII ♃ Jupiter ♈ Aries 25°14' I ♄ Saturn ♉ Taurus 10°24' R II ♅ Uranus ♒ Aquarius 14°47' XII ♆ Neptune ♒ Aquarius 3°11' XI ♇ Pluto ♐ Sagittarius 11°26' VIII ⚷ Chiron ♐ Sagittarius 11°34' VIII ☊ North Node ♌ Leo 5°03' R VI ☋ South Node ♒ Aquarius 5°03' XII ⊕ Fortuna ♒ Aquarius 2°10' XI
Houses (Placidus) ───── I ♈ Aries 3°22' II ♉ Taurus 8°11' III ♊ Gemini 15°47' IV ♋ Cancer 1°53' V ♋ Cancer 5°44' VI ♌ Leo 3°39' VII ♎ Libra 3°22' VIII ♏ Scorpio 8°11' IX ♐ Sagittarius 15°47' X ♑ Capricorn 1°53' XI ♑ Capricorn 5°44' XII ♒ Aquarius 3°39'
Major Aspects ───── ♇ Pluto ☌ ⚷ Chiron orb 0.1° ☉ Sun △ ♄ Saturn orb 0.4° ☉ Sun ⚹ ☽ Moon orb 1.2° ☽ Moon ☍ ♄ Saturn orb 1.6° ♆ Neptune ☍ ☊ North Node orb 1.9° ♀ Venus ⚹ ♆ Neptune orb 2.1° ♂ Mars ⚹ ♃ Jupiter orb 2.4° ♅ Uranus ⚹ ⚷ Chiron orb 3.2° ♅ Uranus ⚹ ♇ Pluto orb 3.3° ♀ Venus □ ♂ Mars orb 3.4° ☿ Mercury ⚹ ♂ Mars orb 3.6° ☽ Moon □ ☊ North Node orb 3.7° ♀ Venus △ ☊ North Node orb 3.9° ♄ Saturn □ ♅ Uranus orb 4.4° ♄ Saturn □ ☊ North Node orb 5.3°
9.3 AI에 운세 풀이 요청 프롬프트
- 프롬프트 : 야 운세좀 봐주라 AI에게 이렇게 물어보세요
성격 분석 다음은 내 사주팔자, 자미두수 명반, 출생차트야. 성격적 강점과 약점을 분석해줘. [복사한 데이터 붙여넣기]
고민 상담 아래 명반 데이터를 기반으로, 내가 살면서 힘들 수 있는 부분 Top 3를 뽑고 조언해줘. [복사한 데이터 붙여넣기]
9.4 위 사주를 AI 에 제공하면 받는 답변
- 종합 운세 분석 세 가지 체계(사주팔자, 자미두수, 서양점성술)를 겹쳐 읽어볼게. 상당히 강렬한 명식이다.
- 핵심 성격 — "불 위의 흙, 타오르는 고집"
세 체계가 공통으로 가리키는 게 있어.
사주를 보면, 일간 戊土가 午月도 아닌데 시주·일주 모두 午火 위에 앉아 있고, 비겁(戊·己)과 인성(丙·丁)이 사주 전반을 장악하고 있다. 火生土 구조가 과잉이야. 쉽게 말하면 자기 에너지가 넘치는 사람이다. 戊土 자체가 산, 바위, 대지의 기운인데 帝旺에 두 번 앉았으니 "나는 산이다, 안 움직인다"는 식의 묵직한 자존심과 뚝심이 핵심이야. 여기에 양인살이 시주·일주 양쪽에 걸려 있으니 성격에 날이 서 있고, 결단력은 있지만 한번 꽂히면 물러서질 못해.
자미두수에서 命宮이 紫微 旺 + 祿存. 紫微는 황제성이야. 거기에 녹존까지 붙었으니 자존심, 리더십, "내가 중심이어야 한다"는 기질이 사주의 戊土 帝旺과 정확히 겹친다.
서양 차트에서는 ASC 양자리 3도. 양자리 상승은 직진형, 선두주자, 개척자 기질이고, 태양이 염소자리로 MC(천정) 바로 옆 11하우스에 있어. 사회적 성취와 구조 안에서의 인정에 대한 욕구가 크다. 목성이 1하우스 양자리에 있으니 자기 확장 욕구, 자신감이 더해지고.
한 줄 요약: 자존심 세고, 뚝심 있고, 리더 기질이며, "내 방식대로" 밀어붙이는 사람. 타인에게 쉽게 고개를 숙이지 않는다.
- 가장 날카로운 문제 — 관계의 충돌과 외로움
사주에서 충(沖)·형(刑)·파(破)가 여섯 개나 걸려 있다. 이건 상당히 드문 구조야.
午午 자형, 午子 충이 두 번, 子卯 형, 午卯 파가 두 번. 특히 午子 충은 일주-월주, 시주-월주에서 일어나는데, 月柱는 사회관계·부모·청년기를 대표하고 日柱는 자기 자신과 배우자를 대표해. 가까운 사람과의 갈등 구조가 명식에 박혀 있다는 뜻이다. 거기다 공망이 子丑인데 月支 子가 공망에 걸려. 월주 정재(正財)가 공망이면 안정적 수입원이나 아버지·배우자와의 인연이 허한 측면이 있어.
자미두수에서도 夫妻宮에 七殺이 앉아 있고 鈴星이 동반한다. 칠살이 부부궁에 있으면 연애·결혼에서 극적인 파도가 치는 구조야. 매력적인 만남은 오지만 평탄하지가 않아.
서양 차트에서 금성(사랑)이 사수자리 8하우스에 있으면서 화성과 스퀘어(□ 3.4°). 연애에서 강렬한 끌림과 마찰이 동시에 오고, 8하우스 금성 자체가 관계의 깊이와 집착, 변환을 암시해. 달(감정)이 전갈자리 8하우스에 있으니 감정 자체가 깊고 무거우며, 쉽게 열지 못하는 성격이야.
한 줄 요약: 겉으로는 강하고 자신감 넘쳐 보이는데, 내면의 감정은 전갈자리 달처럼 깊고 복잡하며, 가까운 관계에서 충돌이 반복될 수 있다. 특히 배우자·파트너 관계에서 진검승부가 벌어진다.
- 돈과 커리어 — 만들 능력은 있는데 흐름이 불안정
사주에서 재성(財星)을 보면: 월간 丙 아래 子水에 壬(편재)·癸(정재)가 있지만 胎·絶 상태이고 공망까지 걸려 있어. 인종법으로도 壬 재성이 胎從이야. 돈을 못 버는 게 아니라, 벌어도 고이지 않는 구조다. 비겁이 강하니 쓰는 것도 크고, 남 좋은 일 하느라 새기도 하고.
반면 자미두수 財帛宮은 상당히 좋아. 武曲 化祿 + 天相 旺 + 左輔. 무곡 화록이 재백궁에 떨어지면 정면승부로 돈을 벌 수 있는 능력이 확실히 있다는 뜻이야. 武曲은 군인·금융·기술·결단의 별이고, 화록이 붙었으니 실질적 수익으로 연결된다.
서양 차트에서는 태양(염소) 트라인 토성(황소) — 오브 0.4도로 거의 정확해. 이건 사회적 구조 안에서 꾸준히 쌓아 올리는 능력, 실질적 성취에 매우 유리한 배치야. 2하우스(재산) 토성이 태양과 트라인이면 늦되 단단한 재정 기반을 만들 수 있어.
한 줄 요약: 역량은 출중하다. 다만 초중반에는 돈이 손에서 빠져나가는 느낌이 강할 수 있고, 30대 중후반~40대 이후에 재정이 본격적으로 안정된다.
- 현재 시점 운세 (2026년, 대략 26세 전후)
사주 대운을 보면 지금은 2운 甲戌 (18~27세, 편관 대운) 끝자락이야. 편관은 압박, 시험, 외부의 도전이 오는 시기인데, 내년(2028년)부터 3운 癸酉 (정재·상관 대운)로 넘어간다.
자미두수 대한으로는 25~34세 夫妻宮 七殺 대한에 진입한 상태. 이 대한은 인생에서 큰 변화와 결단이 요구되는 시기야. 칠살 대한은 안주하면 깨지고, 능동적으로 돌파하면 크게 도약하는 구조다.
서양 차트에서 트랜짓을 정밀하게 보긴 어렵지만, 네이탈 토성이 황소자리 10도에 있으니 2025~2026년 즈음 트랜짓 천왕성이 네이탈 토성 위를 지나가고 있을 가능성이 높아(천왕성 황소자리 후반 통과 시기). 이건 기존에 쌓아온 구조가 갑자기 흔들리거나 예상 못한 변화가 터지는 시그널이야.
지금 시기 요약: 2026년은 전환기의 한가운데다. 편관 대운의 압박이 마무리되면서 동시에 칠살 대한의 강한 바람이 불고 있어. 지금 힘들거나 불안한 게 있다면 그게 정상이야. 이 시기를 억지로 안정시키려 하지 말고 "뭘 바꿀 건 바꾸고 갈 건 가자"는 마인드가 맞다.
- 살면서 힘들 수 있는 부분 Top 3 + 조언
- 하나. 인간관계에서의 고집과 충돌
세 체계 모두 "강한 자아 vs 타인과의 마찰" 구조를 보여줘. 午午 자형은 자기 안에서의 갈등이고, 午子 충은 외부와의 정면충돌이야. 양인살에 ASC 양자리, 紫微 命宮까지 겹치면 "내가 맞는데 왜 저 사람은 모르지?"라는 생각에 자주 빠질 수 있어.
조언: 네가 틀려서가 아니라, 맞아도 표현 방식에서 상대가 벽을 느끼는 거야. 전달 방식을 10% 만 부드럽게 바꾸면 결과가 완전히 달라진다. 특히 가까운 사이일수록.
- 둘. 감정을 혼자 삼키는 습관
겉으로는 강하고 주도적인데, 달이 전갈자리 8하우스고 사주에서 인성(丙·丁)이 과하게 강해. 인성 과다는 "생각이 너무 많고 속으로만 삭이는" 경향이야. 감정을 밖으로 꺼내는 걸 약하다고 느끼거나 불필요하다고 치부할 수 있는데, 그게 쌓이면 어느 날 갑자기 터져.
조언: 신뢰할 수 있는 한두 사람에게는 "나 요즘 좀 힘들어"라고 말하는 연습을 하자. 네 명식에서 가장 부족한 건 식상(食傷) — 자기 감정과 생각을 밖으로 표현하는 통로야. 글을 쓰든, 운동을 하든, 창작을 하든 배출구를 의식적으로 만들어야 한다.
- 셋. "내가 다 해야 한다"는 압박
비겁이 강하고 재성이 약한 구조에서 흔히 나타나는 패턴이 있어 — 남한테 맡기는 걸 못하고 다 자기가 짊어지려 하는 거야. 紫微 祿存 命宮도 마찬가지로 혼자 다 컨트롤하려는 성향을 보여주고. 이게 커리어에서는 강점이 되지만, 장기적으로 번아웃의 원인이 돼.
조언: 위임하는 능력을 기르자. 네 명식에서 관성(官星)은 甲木으로 年支 卯에 뿌리가 있고 자미두수에서도 遷移宮 貪狼 化權이 있어 — 밖에서 만나는 사람, 외부 환경을 활용하는 힘이 있다는 뜻이야. 혼자 산을 옮기려 하지 말고 사람을 쓰는 법을 배우면, 30대 중반 이후 재성 대운과 맞물려서 확 트인다.
마무리
솔직히 쉬운 명식은 아니야. 충·형·파가 이렇게 겹치면 인생 초반에 꽤 굴곡이 있었을 거고, 남들이 모르는 속앓이도 많았을 거야. 근데 이 명식의 진짜 힘은 맷집이야. 帝旺 두 개, 紫微 祿存, 태양-토성 트라인 — 이건 부러지지 않는 구조다. 지금 20대 후반의 전환기를 잘 넘기면 30대 중반부터 본격적으로 꽃이 피는 만시발복(晩時發福) 타입이야.
지금은 좀 힘들어도 괜찮아. 네 명식은 원래 젊을 때 단련받고 나중에 크는 구조니까.
10. 마무리
위에서 살펴본 Orrery(혼천의) 오픈소스 프로젝트의 핵심 내용을 정리하면 다음과 같습니다.
핵심 요약:
- Orrery는 서버 없이 브라우저에서 사주팔자, 자미두수, 서양 점성술 출생차트를 동시에 계산하는 통합 점술 도구다
- 전체 소스코드가 AGPL-3.0 라이선스로 GitHub에 공개되어 있어, 개인 학습 목적으로 자유롭게 활용 가능하다
- 계산 엔진은 @orrery/core npm 패키지로 독립 배포되어, 자신만의 서비스 구축 시 핵심 로직만 가져다 쓸 수 있다
- Swiss Ephemeris Moshier 이론을 순수 TypeScript로 포팅하여, 외부 WASM이나 데이터 파일 의존성 없이 동작한다
- AGPL-3.0 라이선스는 개인 사용에는 제약이 없지만, 상업적 웹 서비스로 운영 시 전체 소스코드 공개 의무가 발생한다
- AI 해석용 복사 기능으로 세 가지 체계의 분석 결과를 Claude, ChatGPT 등에 바로 붙여넣어 해석을 받을 수 있다
사주팔자 계산 원리를 직접 코드로 공부하고 싶거나, 자미두수와 서양 점성술까지 아우르는 통합 계산 엔진이 필요하다면, Orrery는 현재 가장 체계적으로 정리된 오픈소스 선택지다. 라이브 서비스는 sky.told.me에서, 소스코드는 github.com/rath/orrery에서 확인할 수 있다.
