whatisgithub

What is pinestack?

heyphat/pinestack — explained in plain English

Analysis updated 2026-05-18

13TypeScriptAudience · developerComplexity · 3/5LicenseSetup · easy

In one sentence

A command line toolkit that runs TradingView style Pine Script strategies across many symbols, with backtesting and parameter sweeps.

Mindmap

mindmap
  root((pinestack))
    What it does
      Runs Pine Script outside TradingView
      Scans many symbols
      Backtests strategies
    Tech stack
      TypeScript
      Bun runtime
      Piner engine
    Use cases
      Multi symbol scans
      Strategy backtesting
      Parameter sweeps
    Audience
      Developers
      Traders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Scan a trading indicator or strategy across hundreds of symbols at once.

USE CASE 2

Backtest a Pine Script strategy and get a full performance report.

USE CASE 3

Sweep parameter combinations to see how a strategy performs under different settings.

What is it built with?

TypeScriptBunPine Script

How does it compare?

heyphat/pinestackabhi-arya1/riffandersondanieln/hexllama
Stars131313
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardeasy
Complexity3/54/52/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

The pinerun CLI is a single downloadable binary with no extra dependencies needed to start.

So what is it?

Pinestack is a toolkit built around a separate project called piner, which is an engine that runs Pine Script, the scripting language TradingView uses for indicators and trading strategies. Normally Pine Script only runs inside TradingView's own charts, tied to one symbol and one timeframe at a time. Pinestack takes the piner engine and wraps it so you can run it outside of TradingView, across many symbols and settings at once, from the command line or your own scripts. With pinestack you can scan a single indicator or strategy across hundreds of trading symbols at the same time, backtest a strategy and get a full report on its performance, and sweep through many parameter combinations to see how a strategy behaves under each one. The main way to use it is a command line tool called pinerun, which is distributed as a single downloadable program with everything already built in, so there is nothing extra like Node or a package manager to install first. It supports Linux, macOS, and Windows. The project is organized as two packages. One, called pinery, is the data layer that fetches historical price data from sources like Binance, OKX, Kraken, and Alpaca, and also supports loading your own CSV files. The other, pinerun, is the orchestration layer that manages running jobs, fans work out across many symbols or parameter combinations, and includes the CLI itself. Both packages depend on the piner engine, which stays a separate, lightweight library. To get started, you scaffold a starter trading strategy file with one command, then run a backtest on that strategy against real market data, for example five hundred hours of Bitcoin price history, with another command. The tool then prints a detailed report showing returns, risk metrics like maximum drawdown and volatility, and charts of price, account equity, and drawdown, all directly in the terminal. Running the project from source requires the Bun JavaScript runtime, version 1.2 or newer. The project is licensed under the AGPL version 3 license, a copyleft license that requires anyone who modifies and distributes the code, including running it as a network service, to also share their source code.

Copy-paste prompts

Prompt 1
Help me install pinerun and run my first backtest on Bitcoin price data.
Prompt 2
Explain how pinery and pinerun work together to run Pine Script strategies outside TradingView.
Prompt 3
Walk me through writing a parameter sweep for a moving average crossover strategy in pinestack.
Prompt 4
What does the AGPL v3 license mean for using pinestack in my own project?

Frequently asked questions

What is pinestack?

A command line toolkit that runs TradingView style Pine Script strategies across many symbols, with backtesting and parameter sweeps.

What language is pinestack written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, Pine Script.

How hard is pinestack to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is pinestack for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.