Repolode
Nixtla

Nixtla/nixtla

Nixtla의 시계열 예측 및 이상 탐지용 호스팅 사전 학습 foundation model인 TimeGPT의 Python SDK 클라이언트

스타
4,026
포크
341
열린 이슈
63
마지막 커밋
4일 전

어떤 프로젝트인가요?

이 저장소에는 시계열을 위한 생성형 사전 학습 트랜스포머인 TimeGPT의 클라이언트, Nixtla Python SDK가 들어 있습니다. 몇 줄의 코드만으로 개발자 자신의 데이터로 모델을 먼저 학습하지 않고도 시계열 데이터의 미래 값을 예측하고 이상을 탐지할 수 있습니다.

TimeGPT 자체는 비공개 소스이며 Nixtla 서버에서 실행되므로, 예측이나 이상 탐지 호출을 할 때마다 API key가 필요합니다. SDK는 Apache 2.0 라이선스의 오픈소스입니다. 자체 인프라에 배포한 TimeGPT와 함께 사용할 수도 있으며, Snowflake 내부에 TimeGPT를 배포하는 스크립트도 포함되어 있습니다.

SDK는 zero-shot 예측, fine-tuning, 외생 변수, 예측 구간, 교차 검증, 다중 시계열 예측을 지원합니다. 현재 버전의 이상 탐지 API는 배치 기반이며, README에는 nixtla 1.0에서 다른 온라인 방식의 변형을 제공할 계획이라고 나와 있습니다.

핵심 기능

  • 01모델 학습 없이 zero-shot 예측 및 이상 탐지
  • 02사용자 데이터셋에 사용자 정의 loss function을 적용한 fine-tuning
  • 03휴일, 이벤트, 가격 등의 외생 변수 지원
  • 04예측 구간 및 내장 교차 검증
  • 05다중 시계열 예측 및 불규칙한 타임스탬프 지원
  • 06데이터 웨어하우스 내부에서 실행하기 위한 Snowflake 배포 스크립트

활용 사례

  • 사용자 정의 모델을 만들지 않고 소매 수요나 전력 부하 예측
  • IoT 센서 또는 메트릭 스트림의 이상 모니터링
  • API 호출을 통해 애플리케이션에 시계열 예측 기능 추가
  • 데이터를 외부로 옮기지 않고 Snowflake 내부에서 예측 실행

빠른 시작

  1. 1

    nixtla SDK를 설치합니다

    pip install nixtla>=0.8.0
  2. 2

    무료 체험 페이지에서 API 키를 발급받습니다

  3. 3

    API 키로 NixtlaClient를 만들고 데이터에 forecast()를 호출합니다

사용 전 알아둘 점

  • 예측은 호스팅된 TimeGPT 모델에서 실행되므로 API 키가 필요합니다.
  • TimeGPT 자체는 비공개 소스이며, Apache 2.0 라이선스가 적용되는 것은 SDK 클라이언트뿐입니다.
  • detect_anomalies()는 nixtla 1.0에서 제거되었으며 바로 대체할 수 있는 함수가 없습니다. 따라서 업그레이드하면 배치 이상 탐지 코드가 작동하지 않습니다.

토픽

자주 묻는 질문

nixtla은(는) 무엇인가요?
Nixtla의 시계열 예측 및 이상 탐지용 호스팅 사전 학습 foundation model인 TimeGPT의 Python SDK 클라이언트 이 저장소에는 시계열을 위한 생성형 사전 학습 트랜스포머인 TimeGPT의 클라이언트, Nixtla Python SDK가 들어 있습니다. 몇 줄의 코드만으로 개발자 자신의 데이터로 모델을 먼저 학습하지 않고도 시계열 데이터의 미래 값을 예측하고 이상을 탐지할 수 있습니다.
nixtla은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
nixtla은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
nixtla은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. nixtla의 마지막 커밋은 2026년 10월 15일입니다.
nixtla은(는) 어디에 사용할 수 있나요?
사용자 정의 모델을 만들지 않고 소매 수요나 전력 부하 예측 IoT 센서 또는 메트릭 스트림의 이상 모니터링 API 호출을 통해 애플리케이션에 시계열 예측 기능 추가 데이터를 외부로 옮기지 않고 Snowflake 내부에서 예측 실행
nixtla는 어떻게 설치하나요?
nixtla SDK를 설치합니다: pip install nixtla>=0.8.0 무료 체험 페이지에서 API 키를 발급받습니다 API 키로 NixtlaClient를 만들고 데이터에 forecast()를 호출합니다
nixtla은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Nixtla/nixtla

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트