timesfm
TimesFM (Time Series Foundation Model)은 시계열 예측을 위해 Google Research에서 개발한 사전 학습된 시계열 파운데이션 모델입니다.
파일 탐색기
- main.yml
- manual_publish.yml
- __init__.py
- dense.py
- normalization.py
- transformer.py
- util.py
- timesfm_2p5_base.py
- timesfm_2p5_flax.py
- timesfm_2p5_torch.py
- __init__.py
- dense.py
- normalization.py
- transformer.py
- util.py
- xreg_lib.py
- __init__.py
- configs.py
- __init__.py
- test_base_utils.py
- test_configs.py
- test_force_flip_invariance.py
- test_model_loading.py
- test_torch_layers.py
- test_torch_utils.py
- anomaly_detection.json
- anomaly_detection.png
- detect_anomalies.py
- covariates_data.png
- covariates_metadata.json
- sales_with_covariates.csv
- demo_covariates.py
- finetune_lora.py
- README.md
- animation_data.json
- forecast_animation.gif
- forecast_output.csv
- forecast_output.json
- forecast_visualization.png
- interactive_forecast.html
- generate_animation_data.py
- generate_gif.py
- generate_html.py
- README.md
- run_example.sh
- run_forecast.py
- temperature_anomaly.csv
- visualize_forecast.py
- api_reference.md
- data_preparation.md
- system_requirements.md
- check_system.py
- forecast_csv.py
- SKILL.md
- contributing.md
- __init__.py
- timegpt_pipeline.py
- README.md
- run_timegpt.py
- run_timesfm.py
- tfm_extended_new.png
- tfm_results.png
- utils.py
- README.md
- run_eval.py
- tfm_long_horizon.png
- covariates.ipynb
- finetuning.ipynb
- finetuning_torch.ipynb
- finetune.py
- finetune.sh
- README.md
- usage.ipynb
- __init__.py
- dora_layers.py
- lora_layers.py
- utils.py
- __init__.py
- finetuning_example.py
- finetuning_torch.py
- __init__.py
- data_loader.py
- patched_decoder.py
- pytorch_patched_decoder.py
- time_features.py
- timesfm_base.py
- timesfm_jax.py
- timesfm_torch.py
- xreg_lib.py
- test_data_loader.py
- test_timesfm.py
- LICENSE
- poetry.lock
- pyproject.toml
- README.md
- TROUBLESHOOTING.md
- .gitattributes
- .gitignore
- AGENTS.md
- LICENSE
- pyproject.toml
- README.md
- requirements.txt
# 설치 가이드
python- Python >=3.10
- uv
- PyTorch / JAX
설치 및 실행 절차
git clone https://github.com/google-research/timesfm.git
프로젝트 저장소를 로컬에 복제합니다.
uv venv
uv를 사용하여 가상 환경을 생성합니다.
source .venv/bin/activate
가상 환경을 활성화합니다.
uv pip install -e .[torch]
패키지를 torch 백엔드와 함께 편집 가능한 모드로 설치합니다.
핵심 명령어
pip install timesfm[torch]
PyPI를 통해 torch 백엔드와 함께 패키지를 설치합니다.
uv pip install -e .[torch]
로컬 개발 환경에서 torch 백엔드와 함께 패키지를 설치합니다.
# CDN으로 사용하기
jsDelivrjsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.
명령어 용어집
이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.
git clone
설명 보기 ▼
git clone
Clone an existing repository.
git clone {{remote_repository_location}} {{path/to/directory}}
Clone an existing repository into a new directory (the default directory is the repository name):
git clone --recursive {{remote_repository_location}}
Clone an existing repository and its submodules:
git clone {{[-n|--no-checkout]}} {{remote_repository_location}}
Clone only the `.git` directory of an existing repository:
pip install
설명 보기 ▼
pip install
Install Python packages.
pip install {{package1 package2 ...}}
Install one or more packages:
pip install {{package1 package2 ...}} {{[-U|--upgrade]}}
Upgrade all specified packages to the latest version, installing any that are not already present:
pip install {{package}}=={{version}}
Install a specific version of a package:
uv pip
설명 보기 ▼
uv pip
Provides pip-like commands for installing, uninstalling, and managing packages.
uv pip install {{package}}
Install a package:
uv pip install {{[-r|--requirements]}} {{requirements.txt}}
Install packages from a requirements file:
uv pip install {{package==1.2.3}}
Install a package with a specific version:
uv venv
설명 보기 ▼
uv venv
Create an isolated Python environment for installing packages.
uv venv
Create a virtual environment in the default location (`.venv`):
uv venv {{path/to/venv}}
Create a virtual environment at a specific path:
uv venv {{[-p|--python]}} {{3.12}}
Create using a specific Python version: