hashintel/hash
🚀 The open-source, multi-tenant platform for self-building knowledge graphs and simulation
HASH란 무엇인가요?
HASH는 원시 정보를 구조화된 지식 그래프(world models라고 함)로 변환하는 오픈 소스 자가 구축형 데이터베이스입니다. 공개 웹 소스와 개인 통합 소스에서 데이터를 지속적으로 수집, 검증 및 연결하여 생성된 엔티티와 스키마를 인간과 자율 AI 에이전트 모두가 검색하고 사용할 수 있도록 합니다.
핵심 아이디어
- 그래프 기반 지식 – 데이터는 명시적 스키마(유형)와 함께 노드(엔티티) 및 엣지(관계)로 저장됩니다.
- 이중 시간성 (Bitemporality) – 모든 사실은 발생 시점과 인지 시점을 기록하여 출처를 인식하는 쿼리를 가능하게 합니다.
- 자율 에이전트 – 내장된 에이전트가 인터넷을 크롤링하거나 API에서 데이터를 가져오거나 개인 소스와 동기화하여 그래프를 자동으로 채우고 확인합니다.
- 자가 점검 – 새로운 데이터가 들어올 때마다 시스템이 스키마 준수 여부와 일관성을 검증합니다.
- 고신뢰 진실의 원천 – 그래프는 의사 결정, 자동화 또는 최적화를 위해 다운스트림 애플리케이션에서 쿼리할 수 있습니다.
저장소 레이아웃
| 폴더 | 목적 |
|---|---|
apps/ |
HASH 플랫폼을 실행하는 주요 서비스(API, 프론트엔드, 인증, 워크플로우 엔진 등). |
blocks/ |
공개 Block Protocol 블록 – 프로젝트 간에 공유할 수 있는 재사용 가능한 데이터 모델 컴포넌트. |
infra/ |
로컬 실행 또는 자체 호스팅을 위한 Docker-Compose 파일 및 배포 스크립트. |
libs/ |
공유 라이브러리 – 서비스에서 사용하는 npm 패키지 및 Rust 크레이트. |
tests/ |
엔드투엔드 및 통합 테스트 스위트. |
시작하기
퀵스타트 (권장)
- hash.ai 에서 무료 계정을 만들고 로그인하세요. 호스팅된 서비스는 5분 이내에 준비된 인스턴스를 실행합니다.
로컬 실행 (개발자용)
- Git, Docker Compose, Docker Buildx, mise(버전 관리자)를 설치하세요. Docker에 최소 8GB RAM을 할당하세요.
- 저장소를 복제하고 고정된 툴체인을 설치하세요:
git clone https://github.com/hashintel/hash.git && cd hash mise trust && mise install yarn install - 더미 API 키가 포함된
.env.local을 생성하세요(AI 기능에만 필요). - 지원 서비스를 실행하세요:
yarn compose up -d # Postgres, Redis, Kratos, Hydra, Temporal, Vault, MinIO, Grafana 등. - 플랫폼을 시작하세요:
UI는# 개발 시 가장 빠른 방법 – Rust 그래프를 한 번 컴파일한 후 API + 프론트엔드를 핫 리로드로 실행 yarn start:graph # 터미널 1 yarn dev # 터미널 2http://localhost:3000에서 사용할 수 있습니다.
Rust 그래프를 컴파일할 필요가 없다면 hgres 프로필을 사용하여 Docker에서 실행할 수 있습니다.
주요 컴포넌트
- API (
hash-api) – REST/GraphQL 진입점, 인증(Kratos 경유), 엔티티 CRUD 및 워크플로우 오케스트레이션(Temporal) 처리. - 프론트엔드 (
hash-web) – 엔티티 탐색, 유형 편집, 에이전트 관리를 위한 React 기반 UI. - 그래프 엔진 – 지식 그래프를 PostgreSQL에 저장하고 빠른 쿼리 기능을 제공하는 Rust 구현.
- Temporal 워크플로우 – 자율 에이전트, 데이터 수집 파이프라인 및 일관성 검사를 실행하는 백그라운드 워커.
- 인증 스택 – 사용자 관리 및 OAuth/OIDC를 위한 Ory Kratos + Hydra.
- 관측 가능성 – 디버깅을 위한 Grafana 대시보드, Prometheus 메트릭 및 로그.
확장성 및 통합
- AI 제공업체 – OpenAI, Anthropic(환경 변수로 키 설정)이 에이전트 추론 및 요약을 지원합니다.
- 파일 저장소 – 기본적으로 로컬 파일 시스템;
FILE_UPLOAD_PROVIDER를 통해 AWS S3 사용 가능. - 이메일 – 개발용 더미 전송기 또는 프로덕션용 실제 SMTP / AWS SES.
- Block Protocol – 공개 Þ Hub에서 재사용 가능한 스키마 블록을 가져올 수 있습니다.
라이선스
대부분의 코드는 관대한 오픈 소스 라이선스에 따라 릴리스됩니다(LICENSE.md 참조). 일부 하위 컴포넌트는 다른 조건이 적용될 수 있으며, 모두 라이선스 파일에 나열되어 있습니다.
커뮤니티 및 지원
- 토론 및 이슈 – GitHub Discussions 및 이슈 트래커.
- 소셜 – X(구 Twitter)에서 @hashai 팔로우.
- 채용 – 회사는 웹사이트에 채용 공고를 게시합니다. 기여는 주목받는 좋은 방법입니다.
요약: HASH는 인간과 AI 에이전트 모두가 쿼리할 수 있는 실시간의 출처가 풍부한 지식 그래프를 구축하고 유지하기 위한 풀스택 오픈 소스 플랫폼입니다. 이 저장소는 서비스를 로컬에서 실행하거나, 자체 호스팅하거나, 호스팅된 SaaS 버전을 사용하는 데 필요한 모든 것을 제공합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트