설치와 첫 실행 — Ontological Studio 튜토리얼

설치 파일을 받아 실행하고, 첫 화면이 뜰 때까지 무슨 일이 일어나는지 알아봅니다. 코딩 에이전트를 연결하는 방법도 다룹니다.

설치 파일 받기#

릴리스 페이지에서 운영체제에 맞는 파일을 받습니다.

운영체제	파일
macOS (Apple Silicon)	`Ontological-Studio-mac-arm64.dmg`
Windows 10/11 (x64)	`Ontological-Studio-Setup-win-x64.exe`

Intel 칩 Mac은 아직 지원하지 않습니다.

왜 경고가 나오나요?

지금 배포판은 Apple 개발자 인증서로 서명·공증되지 않았습니다. 경고 창에 「열기」 버튼이 없으면 시스템 설정 › 개인정보 보호 및 보안의 아래쪽에서 「그래도 열기」를 누르세요. 그래도 막히면 터미널에서 다음을 실행합니다.

bash xattr -dr com.apple.quarantine "/Applications/Ontological Studio.app"

Windows에서 아직 안 되는 것

MySQL·Oracle·SQL Server 원천 연결은 macOS판에만 있습니다(PostgreSQL은 둘 다 됩니다). Claude Code를 Windows에서 쓰려면 Git for Windows가 먼저 설치돼 있어야 합니다.

앱을 열면 부팅 화면이 단계별 진행 상황을 보여 줍니다.

단계	하는 일	걸리는 시간(M 시리즈 기준)
PostgreSQL	내 컴퓨터 안에서 데이터베이스 서버를 띄웁니다	1초 안쪽
첫 실행 준비	예제 업무 DB(ERP·WMS·CRM)를 만들고 데이터 패브릭에 등록합니다	처음 한 번만
Ontological	그래프 엔진(Ontological DB), Bolt 게이트웨이, 포털을 띄웁니다	1초 안쪽
Studio	구축·질의 화면, 액션 실행기, 예제 업무 시스템 3개를 띄웁니다	약 4~5초

처음 실행할 때는 예제 온톨로지 「공급망 운영 (예제)」도 함께 만들어 둡니다. 클래스 7개, 관계 6개, 액션 3개, 골든 퀘스천 3개, 골든 커맨드 4개가 들어 있어서, 설치하자마자 질의와 액션을 해 볼 수 있습니다.

모든 서버는 127.0.0.1(내 컴퓨터)에만 열립니다. 바깥에서는 접속할 수 없습니다.

온톨로지 구축, 자연어 질의, 대시보드 구성안, 코드 앱은 에이전트가 합니다. Ontological Studio는 다음 순서로 에이전트를 찾습니다.

이 컴퓨터에 설치된 Claude Code 또는 Codex CLI — CLI가 자기 로그인을 쓰므로 API 키가 필요 없습니다. 기본값입니다.
CLI가 없으면 내장 에이전트 — 이때는 studio.env 파일에 OPENAI_API_KEY를 넣어야 대화가 됩니다.

홈 화면 왼쪽 아래에 지금 쓰는 에이전트가 보입니다. 바꾸려면 메뉴 런타임 › 에이전트를 고릅니다. 「설정」 카드를 누르면 studio.env가 열립니다.

에이전트 없이도 할 수 있는 것

데이터소스 연결, 가상 노드 만들기, 포털에서 Cypher 쓰기는 에이전트 없이 동작합니다. 이 튜토리얼의 3·4부는 에이전트가 없어도 끝까지 따라 할 수 있습니다.

항목	위치 (macOS)
사용자 데이터 전체	`~/Library/Application Support/Ontological Studio/`
데이터베이스	위 폴더의 `pgdata`
비밀번호(설치마다 무작위로 생성)	위 폴더의 `secrets.json`
로그	위 폴더의 `logs/` — 홈 화면 「로그 폴더」로 바로 열 수 있습니다

처음 상태로 되돌리고 싶으면 앱을 끈 뒤 이 폴더를 지우고 다시 실행합니다. 예제 DB와 예제 온톨로지가 새로 만들어집니다.

확인

앱을 실행해 홈 화면이 뜨는지 확인하고, 왼쪽 아래에 「Ontological 연결됨」과 에이전트 이름이 나오는지 보세요.