finnts
Microsoft Finance Time Series Forecasting Framework (FinnTS) is a forecasting package that utilizes cutting-edge time series forecasting and parallelization on the cloud to produce accurate forecasts for financial data.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/microsoft/finnts with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/microsoft/finnts'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/microsoft--finnts)HTML
<a href="/listings/microsoft--finnts"><img src="/api/listings/microsoft--finnts/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
CRAN version
install.packages("finnts")Development version
To get a bug fix or to use a feature from the development version, you can install the development version of finnts from GitHub.
# install.packages("devtools")
devtools::install_github("microsoft/finnts")What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 98 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Microsoft Finance Time Series Forecasting Framework
- <img src="man/figures/logo.png" align="right" height="200" style="float:right; height:200px;"/>
- <!-- badges: start -->
- [](https://cran.r-project.org/package=finnts)
- <!-- badges: end -->
- The Microsoft Finance Time Series Forecasting Framework, aka finnts or Finn, is an automated forecasting framework for producing financial forecasts. While it was built for corporate finance activities, it can easily expand to any time series forecasting problem!
- - Built in AI agent that can act as your own virtual data scientist, always optimizing for the most accurate forecast.
- - Automated feature engineering, feature selection, back testing, and model selection.
- - Access to 25+ models. Both univariate and multivariate models.
- - Azure integration to run thousands of time series in parallel within the cloud.
- - Supports daily, weekly, monthly, quarterly, and yearly forecasts.
- - Handles external regressors, either purely historical or historical+future values.
- ## Use Finn with a coding agent
- Don't want to write R code? The [Finn skill](https://github.com/microsoft/finnts/tree/main/skills/finn) lets a coding agent such as GitHub Copilot or Codex install R and finnts, run forecasts, and explain the results for you. Paste this into your agent:
- ```
- Install the Finn skill from https://github.com/microsoft/finnts/tree/main/skills/finn and help me forecast my data.
- ```
- ## Installation
- ### CRAN version
- ``` r
- install.packages("finnts")
- ```
- ### Development version
- To get a bug fix or to use a feature from the development version, you can install the development version of finnts from GitHub.
- ``` r
- # install.packages("devtools")
- devtools::install_github("microsoft/finnts")
- ```
- ## Usage
- ``` r
- library(finnts)
- # prepare historical data
- hist_data <- timetk::m4_monthly %>%
- dplyr::rename(Date = date) %>%
- dplyr::mutate(id = as.character(id))
- # connect LLM
- llm <- ellmer::chat_azure_openai(model = "gpt-4o-mini")
- # set up new forecast project and agent run
- project <- set_project_info(project_name = "Demo_Project",
- combo_variables = c("id"),
- target_variable = "value",
- date_type = "month")
- agent <- set_agent_info(project_info = project,
- llm = llm,
- input_data = hist_data,
- forecast_horizon = 6)
- # iterate forecast via agent
- iterate_forecast(agent_info = agent,
- max_iter = 3,
- weighted_mape_goal = 0.03)
- # load final forecast output
- forecast_output <- get_agent_forecast(agent_info = agent)
- # ask agent to explain the forecast results
- eda_answer <- ask_agent(agent_info = agent,
- question = "Summarize the exploratory data analysis, what stands out?")
- accuracy_answer <- ask_agent(agent_info = agent,
- question = "What's the best model accuracy?")
- model_answer <- ask_agent(agent_info = agent,
- question = "Explain why the best model was selected. How does that model work?")
- ```
- ## Contributing
- This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit <https://cla.opensource.microsoft.com>.
- When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
- This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode\@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
- ## Trademarks
- This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.
skills/finn/install_skill.ps1 · Bundled script · 129 lines · 1 finding marked
- # One-line installer for the Finn skill (Windows PowerShell 5.1 or PowerShell 7).
- #
- # irm https://raw.githubusercontent.com/microsoft/finnts/main/skills/finn/install_skill.ps1 | iex
- Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
- Line 3 on GitHub
- #
- # Downloads only the skills/finn folder from GitHub and copies it into your agent's
- # personal skills folder. It does not install R or finnts; the skill does that later,
- # after asking you. It never deletes or overwrites anything: if the skill is already
- # installed it stops and tells you how to update.
- #
- # Optional environment variables (set them before running the line above):
- # FINN_SKILL_AGENT copilot (default), claude, or agents
- # FINN_SKILL_DEST exact folder to install into (overrides FINN_SKILL_AGENT)
- # FINN_SKILL_REPO GitHub owner/repo (default microsoft/finnts)
- # FINN_SKILL_REF branch, tag, or commit (default main)
- & {
- $ErrorActionPreference = "Stop"
- $ProgressPreference = "SilentlyContinue"
- try {
- [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
- } catch {
- }
- $repo = if ($env:FINN_SKILL_REPO) { $env:FINN_SKILL_REPO } else { "microsoft/finnts" }
- $ref = if ($env:FINN_SKILL_REF) { $env:FINN_SKILL_REF } else { "main" }
- $agent = if ($env:FINN_SKILL_AGENT) { $env:FINN_SKILL_AGENT.ToLower() } else { "copilot" }
- $folders = @{ copilot = ".copilot"; claude = ".claude"; agents = ".agents" }
- if ($env:FINN_SKILL_DEST) {
- $dest = $env:FINN_SKILL_DEST
- } elseif ($folders.ContainsKey($agent)) {
- $dest = Join-Path (Join-Path (Join-Path $HOME $folders[$agent]) "skills") "finn"
- } else {
- Write-Host "Unknown FINN_SKILL_AGENT '$agent'. Use copilot, claude, or agents." -ForegroundColor Red
- return
- }
- if (Test-Path -LiteralPath $dest) {
- Write-Host "The Finn skill is already installed at $dest." -ForegroundColor Yellow
- Write-Host "To update it, ask your agent: 'Update the Finn skill.'"
- Write-Host "(It runs scripts/update_skill.R --action=update, which keeps a backup you can roll back to.)"
- return
- }
- $headers = @{ "User-Agent" = "finn-skill"; "Accept" = "application/vnd.github+json" }
- Write-Host "Resolving $repo ($ref) to an immutable commit..."
- try {
- $commit = Invoke-RestMethod -UseBasicParsing -Headers $headers -Uri "https://api.github.com/repos/$repo/commits/$([uri]::EscapeDataString($ref))"
- } catch {
- Write-Host "Could not resolve the GitHub ref: $($_.Exception.Message)" -ForegroundColor Red
- Write-Host "Check your internet connection or proxy, or install manually (see skills/finn/README.md)."
- return
- }
- $sha = [string]$commit.sha
- $treeSha = [string]$commit.commit.tree.sha
- if ($sha -notmatch "^[0-9a-fA-F]{40}$" -or $treeSha -notmatch "^[0-9a-fA-F]{40}$") {
- Write-Host "GitHub did not return valid commit and tree identities. Nothing was installed." -ForegroundColor Red
- return
- }
- Write-Host "Finding the Finn skill files at commit $sha..."
- try {
- $tree = Invoke-RestMethod -UseBasicParsing -Headers $headers -Uri "https://api.github.com/repos/$repo/git/trees/${treeSha}?recursive=1"
- } catch {
- Write-Host "Could not read the resolved commit tree: $($_.Exception.Message)" -ForegroundColor Red
- Write-Host "Nothing was installed. Try again later."
- return
- }
- if ($tree.truncated) {
- Write-Host "GitHub returned a partial file list. Install manually (see skills/finn/README.md)." -ForegroundColor Red
- return
- }
- $prefix = "skills/finn/"
- $files = @($tree.tree | Where-Object { $_.type -eq "blob" -and $_.path.StartsWith($prefix) } | ForEach-Object { $_.path.Substring($prefix.Length) })
- if ($files.Count -eq 0 -or -not ($files -contains "SKILL.md")) {
- Write-Host "No Finn skill found in $repo at $ref." -ForegroundColor Red
- return
- }
- $stage = Join-Path ([IO.Path]::GetTempPath()) ("finn-skill-" + [guid]::NewGuid().ToString("N"))
- $i = 0
- foreach ($f in $files) {
- $i++
- Write-Host (" [{0}/{1}] {2}" -f $i, $files.Count, $f)
- $target = Join-Path $stage ($f -replace "/", [IO.Path]::DirectorySeparatorChar)
- New-Item -ItemType Directory -Force -Path (Split-Path $target -Parent) | Out-Null
- $url = "https://raw.githubusercontent.com/$repo/$sha/$prefix$f"
- try {
- Invoke-WebRequest -UseBasicParsing -Headers @{ "User-Agent" = "finn-skill" } -Uri $url -OutFile $target
- } catch {
- Write-Host "Download failed for $f : $($_.Exception.Message)" -ForegroundColor Red
- Write-Host "Nothing was installed. Try again later."
- return
- }
- }
- $requiredFiles = @("SKILL.md", "version.json", "scripts/finn_common.R", "scripts/update_skill.R", "scripts/install_finnts.R", "scripts/run_forecast.R")
- foreach ($required in $requiredFiles) {
- if (-not (Test-Path -LiteralPath (Join-Path $stage $required))) {
- Write-Host "The download is incomplete ($required is missing). Nothing was installed." -ForegroundColor Red
- return
- }
- }
- try {
- New-Item -ItemType Directory -Force -Path (Split-Path $dest -Parent) | Out-Null
- Copy-Item -Recurse -LiteralPath $stage -Destination $dest
- } catch {
- Write-Host "Copying into $dest failed: $($_.Exception.Message)" -ForegroundColor Red
- return
- }
- foreach ($required in $requiredFiles) {
- $stagedFile = Join-Path $stage $required
- $installedFile = Join-Path $dest $required
- if (-not (Test-Path -LiteralPath $installedFile) -or
- (Get-FileHash -Algorithm SHA256 -LiteralPath $stagedFile).Hash -ne
- (Get-FileHash -Algorithm SHA256 -LiteralPath $installedFile).Hash) {
- Write-Host "The installation at $dest is incomplete or differs from commit $sha ($required)." -ForegroundColor Red
- return
- }
- }
- Write-Host ""
- Write-Host "Installed the Finn skill from commit $sha at $dest" -ForegroundColor Green
- Write-Host "Next steps:"
- Write-Host " 1. Start a new chat (or reload your agent) so it finds the skill."
- Write-Host " 2. Say: 'Use the Finn skill to give me the Finn tutorial.'"
- Write-Host " or: 'Use the Finn skill to forecast <your file>.'"
- Write-Host "The agent checks your setup and asks before installing R or finnts."
- }
skills/finn/install_skill.sh · Bundled script · 252 lines · 1 finding marked
- #!/bin/sh
- # One-line installer for the Finn skill (macOS and Linux).
- #
- # curl -fsSL https://raw.githubusercontent.com/microsoft/finnts/main/skills/finn/install_skill.sh | sh
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 4 on GitHub
- #
- # Downloads only the skills/finn folder from GitHub and copies it into your agent's
- # personal skills folder. It does not install R or finnts; the skill does that later,
- # after asking you. It never deletes or overwrites anything: if the skill is already
- # installed it stops and tells you how to update.
- #
- # Optional environment variables:
- # FINN_SKILL_AGENT copilot (default), claude, or agents
- # FINN_SKILL_DEST exact folder to install into (overrides FINN_SKILL_AGENT)
- # FINN_SKILL_REPO GitHub owner/repo (default microsoft/finnts)
- # FINN_SKILL_REF branch, tag, or commit (default main)
- set -u
- repo="${FINN_SKILL_REPO:-microsoft/finnts}"
- ref="${FINN_SKILL_REF:-main}"
- agent="${FINN_SKILL_AGENT:-copilot}"
- if [ -n "${FINN_SKILL_DEST:-}" ]; then
- dest="$FINN_SKILL_DEST"
- else
- case "$agent" in
- copilot) dest="$HOME/.copilot/skills/finn" ;;
- claude) dest="$HOME/.claude/skills/finn" ;;
- agents) dest="$HOME/.agents/skills/finn" ;;
- *)
- echo "Unknown FINN_SKILL_AGENT '$agent'. Use copilot, claude, or agents." >&2
- exit 1
- ;;
- esac
- fi
- if [ -e "$dest" ]; then
- echo "The Finn skill is already installed at $dest."
- echo "To update it, ask your agent: 'Update the Finn skill.'"
- echo "(It runs scripts/update_skill.R --action=update, which keeps a backup you can roll back to.)"
- exit 0
- fi
- if command -v curl >/dev/null 2>&1; then
- fetch() { curl -fsSL -H "User-Agent: finn-skill" "$1" -o "$2"; }
- elif command -v wget >/dev/null 2>&1; then
- fetch() { wget -q --header="User-Agent: finn-skill" "$1" -O "$2"; }
- else
- echo "Neither curl nor wget is available. Install one, or install manually (see skills/finn/README.md)." >&2
- exit 1
- fi
- stage="$(mktemp -d 2>/dev/null || mktemp -d -t finn-skill)"
- commit_file="$stage.commit.json"
- tree_file="$stage.tree.json"
- echo "Resolving $repo ($ref) to an immutable commit..."
- # Percent-encode the ref so branch names such as users/me/fix stay one path segment.
- encoded_ref="$(printf '%s' "$ref" | LC_ALL=C awk '
- BEGIN { for (i = 1; i < 256; i++) ord[sprintf("%c", i)] = i }
- { text = (NR > 1 ? text "\n" : "") $0 }
- END {
- out = ""
- for (i = 1; i <= length(text); i++) {
- c = substr(text, i, 1)
- if (c ~ /[A-Za-z0-9._~-]/) out = out c
- else out = out sprintf("%%%02X", ord[c])
- }
- printf "%s", out
- }
- ')"
- if ! fetch "https://api.github.com/repos/$repo/commits/$encoded_ref" "$commit_file"; then
- echo "Could not resolve the GitHub ref. Check your internet connection or proxy, or install manually (see skills/finn/README.md)." >&2
- exit 1
- fi
- identity="$(awk '
- { json = json $0 "\n" }
- function next_token( c, value, escaped) {
- while (pos <= length(json) && substr(json, pos, 1) ~ /[[:space:]]/) pos++
- c = substr(json, pos, 1)
- if (c == "") {
- token_type = ""
- token_value = ""
- return
- }
- if (c == "\"") {
- pos++
- value = ""
- escaped = 0
- while (pos <= length(json)) {
- c = substr(json, pos++, 1)
- if (escaped) {
- value = value c
- escaped = 0
- } else if (c == "\\") {
- escaped = 1
- } else if (c == "\"") {
- token_type = "string"
- token_value = value
- return
- } else {
- value = value c
- }
- }
- token_type = "invalid"
- return
- }
- if (c == "{" || c == "}" || c == "[" || c == "]" || c == ":" || c == ",") {
- pos++
- token_type = c
- token_value = c
- return
- }
- value = ""
- while (pos <= length(json)) {
- c = substr(json, pos, 1)
- if (c ~ /[[:space:]]/ || c == "{" || c == "}" || c == "[" || c == "]" || c == ":" || c == ",") break
- value = value c
- pos++
- }
- token_type = "primitive"
- token_value = value
- }
- function parse_value(path, key, child_path) {
- if (token_type == "{") {
- next_token()
- if (token_type == "}") return 1
- while (1) {
- if (token_type != "string") return 0
- key = token_value
- next_token()
- if (token_type != ":") return 0
- if (path == "" && key == "commit") commit_objects++
- if (path == "commit" && key == "tree") tree_objects++
- if (path == "" && key == "sha") commit_shas++
- if (path == "commit.tree" && key == "sha") tree_shas++
- child_path = path == "" ? key : path "." key
- next_token()
- if (!parse_value(child_path)) return 0
- next_token()
- if (token_type == "}") return 1
- if (token_type != ",") return 0
- next_token()
- }
- }
- if (token_type == "[") {
- next_token()
- if (token_type == "]") return 1
- while (1) {
- if (!parse_value(path)) return 0
- next_token()
- if (token_type == "]") return 1
- if (token_type != ",") return 0
- next_token()
- }
- }
- if (token_type == "string") {
- if (path == "sha") commit_sha = token_value
- if (path == "commit.tree.sha") tree_sha = token_value
- return 1
- }
- return token_type == "primitive"
- }
- END {
- pos = 1
- next_token()
- if (!parse_value("")) exit 1
- next_token()
- if (token_type != "" || commit_objects != 1 || tree_objects != 1 ||
- commit_shas != 1 || tree_shas != 1 ||
- length(commit_sha) != 40 || commit_sha !~ /^[[:xdigit:]]+$/ ||
- length(tree_sha) != 40 || tree_sha !~ /^[[:xdigit:]]+$/) {
- exit 1
- }
- printf "%s %s\n", commit_sha, tree_sha
- }
- ' "$commit_file")" || {
- echo "GitHub did not return an unambiguous commit and tree identity. Nothing was installed." >&2
- exit 1
- }
- set -- $identity
- if [ "$#" -ne 2 ]; then
- echo "GitHub did not return valid commit and tree identities. Nothing was installed." >&2
- exit 1
- fi
- sha=$1
- tree_sha=$2
- echo "Finding the Finn skill files at commit $sha..."
- if ! fetch "https://api.github.com/repos/$repo/git/trees/$tree_sha?recursive=1" "$tree_file"; then
- echo "Could not read the resolved commit tree. Nothing was installed." >&2
- exit 1
- fi
- if grep -q '"truncated": *true' "$tree_file"; then
- echo "GitHub returned a partial file list. Install manually (see skills/finn/README.md)." >&2
- exit 1
- fi
- # Put each tree entry on its own line (works for pretty or compact JSON), keep
- # blobs, and strip the skills/finn/ prefix. Skill file names contain no spaces.
- files="$(tr -d '\n\r' < "$tree_file" | tr '{' '\n' | grep '"type": *"blob"' |
- sed -n 's/.*"path": *"skills\/finn\/\([^"]*\)".*/\1/p')"
- case "$files" in
- *SKILL.md*) ;;
- *)
- echo "No Finn skill found in $repo at $ref." >&2
- exit 1
- ;;
- esac
- total="$(printf '%s\n' "$files" | wc -l | tr -d ' ')"
- i=0
- skill="$stage/finn"
- for f in $files; do
- i=$((i + 1))
- echo " [$i/$total] $f"
- mkdir -p "$skill/$(dirname "$f")"
- if ! fetch "https://raw.githubusercontent.com/$repo/$sha/skills/finn/$f" "$skill/$f"; then
- echo "Download failed for $f. Nothing was installed. Try again later." >&2
- exit 1
- fi
- done
- required_files="SKILL.md version.json scripts/finn_common.R scripts/update_skill.R scripts/install_finnts.R scripts/run_forecast.R"
- for required in $required_files; do
- if [ ! -f "$skill/$required" ]; then
- echo "The download is incomplete ($required is missing). Nothing was installed." >&2
- exit 1
- fi
- done
- mkdir -p "$(dirname "$dest")"
- if ! cp -R "$skill" "$dest" || [ ! -f "$dest/SKILL.md" ]; then
- echo "Copying into $dest failed. Nothing was installed." >&2
- exit 1
- fi
- for required in $required_files; do
- if [ ! -f "$dest/$required" ] || ! cmp -s "$skill/$required" "$dest/$required"; then
- echo "The installation at $dest is incomplete or differs from commit $sha ($required)." >&2
- exit 1
- fi
- done
- echo ""
- echo "Installed the Finn skill from commit $sha at $dest"
- echo "Next steps:"
- echo " 1. Start a new chat (or reload your agent) so it finds the skill."
- echo " 2. Say: 'Use the Finn skill to give me the Finn tutorial.'"
- echo " or: 'Use the Finn skill to forecast <your file>.'"
- echo "The agent checks your setup and asks before installing R or finnts."
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.