엔비디아가 **오토 온톨로지(Auto Ontology)**를 무료(Apache-2.0)로 공개했어요. AI가 회사 DB에 SQL을 짜기 전에 ‘매출’이 어느 표의 어느 칸인지 같은 정의를 먼저 정리하고, 사람이 확인한 정의대로 답하게 해 주는 도구예요(깃허브 별 5,180개, 2026-11-05 기준). 이 페이지에 한눈에 보기, README 공식 설치 순서, 클로드 코드 연결법, 회사 데이터에 바로 던지는 질문 프롬프트 30개를 정리했어요.
📺 더 많은 클로드 활용법: 유튜브 빌더조쉬 구독 · 조쉬의 뉴스레터 구독
NVIDIA/auto-ontology 저장소
| 항목 | 내용 |
|---|---|
| 무엇 | 회사 DB 위에 ‘업무 정의 층(온톨로지)’을 자동으로 만들어 주는 오픈소스 |
| 만든 곳 | 엔비디아 (github.com/NVIDIA/auto-ontology) |
| 비용 | 무료 오픈소스(Apache-2.0). 모델은 build.nvidia.com API 키 또는 OpenAI 호환 엔드포인트 |
| 하는 일 | ① DB 메타데이터로 정의 초안 생성 → ② 사람이 확인(certify) → ③ 에이전트가 그 정의로 SQL 작성·답변 |
| 답에 같이 나오는 것 | 답 + 실제로 쓴 SQL + 이은 표(조인 경로)·단계 |
| 없는 데이터를 물으면 | 지어내지 않고 “이 데이터엔 없다”고 알려 주고 되물어요(check_answerable) |
| 연결 가능한 DB | PostgreSQL, MySQL, Databricks, Snowflake, ClickHouse, Trino, Apache Kyuubi, HeavyDB, DuckDB, SQLite (10종) |
| 에이전트 연결 | MCP · CLI · REST API (클로드 데스크톱·커서·클로드 코드) |
준비물: Docker(Compose v2), uv, 엔비디아 API 키(nvapi-..., build.nvidia.com 에서 발급)
1) 저장소 받고 .env 만들기
git clone https://github.com/NVIDIA/auto-ontology.git && cd auto-ontology
cp .env.example .env
.env에 아래 값을 넣어요. 기본 비밀번호는 꼭 새로 바꾸세요(Postgres·pgAdmin·웹이 내 컴퓨터에 열려요).
DEFAULT_MODELS_API_KEY=nvapi-...
AUTH_SECRET=<openssl rand -base64 32 로 만든 긴 문자열>
APP_URL=http://localhost:3000
POSTGRES_PASSWORD=<새 비밀번호>
CONNECTION_STRINGS=postgresql://postgres:<같은 비밀번호>@postgres:5432/wideworldimporters
AUTO_ONTOLOGY_ADMIN_PASSWORD=<새 비밀번호>
PGADMIN_PASSWORD=<새 비밀번호>
2) Postgres 켜고 예시 DB(마이크로소프트 Wide World Importers) 넣기
docker compose up -d --wait postgres
git clone https://github.com/NVIDIA/auto-ontology-eval.git ../auto-ontology-eval
(cd ../auto-ontology-eval && uv sync && cp .env.example .env && \
POSTGRES_PASSWORD='<같은 비밀번호>' \
uv run python scripts/seed/seed_wwi.py --database-name wideworldimporters --drop)
3) 나머지 띄우기
docker compose up -d --build
4) http://localhost:3000 에 .env의 관리자 계정으로 로그인 → Settings → Semantic Compilation 켜기 → “Semantic compilation is ready”가 뜨면 준비 끝.