nehalecky

Darts Forecasting Model Style Guide

Reference guide extracted from CONTRIBUTING.md and existing model implementations Created: 2025-11-05

Core Principles (from CONTRIBUTING.md)

1. Focus on simplicity and clarity for end users
2. Design the best possible API, simple by default
3. Make it hard for users to make mistakes

nehalecky

Foundation Models Integration Design for Darts

Issue: #2933: Foundation Models Integration Last Updated: November 5, 2025

Problem Statement

Time series foundation models (TSFMs) like TimesFM, Chronos 2, Moirai, and TimeGPT each provide different APIs. Users wanting to compare models or switch between them must reimplement evaluation pipelines for each model. This creates friction and limits experimentation.

As @hrzn noted: "Darts could be a great neutral ground for multiple TSFMs under a unified API."

nehalecky

#!/bin/bash
set -e

if [[ ! -v CONDA_INSTALL_PATH ]]; then
    echo "CONDA_INSTALL_PATH not set, setting ..."
    CONDA_INSTALL_PATH="/usr/local/bin/miniconda"
    echo "Set CONDA_INSTALL_PATH to $CONDA_INSTALL_PATH"
fi
# 0. Specify Miniconda version
## 0.1 A few parameters

nehalecky

#!/bin/bash
apt-get -y install python3
echo "export PYSPARK_PYTHON=python3" | tee -a  /etc/profile.d/spark_config.sh  /etc/*bashrc
echo "export PYTHONHASHSEED=123" | tee -a  /etc/profile.d/spark_config.sh  /etc/*bashrc /usr/lib/spark/conf/spark-env.sh
source ~/.bashrc

nehalecky

# Can be copied to ~/.ipython/profile_default/startup/
import pandas as pd
import numpy as np

# Add plotly
import plotly
import plotly.plotly as py
from plotly.graph_objs import *
from plotly.offline import download_plotlyjs, init_notebook_mode, iplot
print("Plotly version: " + plotly.__version__)           # version 1.9.x required

nehalecky

Keybase proof

I hereby claim:

• I am nehalecky on github.
• I am nehalecky (https://keybase.io/nehalecky) on keybase.
• I have a public key whose fingerprint is 6A39 BED6 5A62 A515 5346 AC64 BD37 C15A 8575 88C0

To claim this, I am signing this object: