A bundler for multi-file PineScript development. Write modular PineScript code across multiple files and bundle them into a single TradingView-compatible script.

Docs located here.

• Multi-file support - Split your PineScript code into multiple files
• Import/Export system - Use // @import and // @export directives
• Automatic namespacing - Prevents variable/function collisions between modules
• External import deduplication - TradingView library imports are deduplicated automatically
• Watch mode - Rebuild automatically when files change
• Clipboard support - Copy bundled output directly to clipboard

Clone the repository and install in development mode:

git clone https://github.com/claudianadalin/pinecone.git
cd pinecone
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e .

my-indicator/
├── pine.config.json
└── src/
    ├── main.pine
    └── utils.pine

Create pine.config.json in your project root:

{
  "entry": "src/main.pine",
  "output": "dist/bundle.pine"
}

src/utils.pine - Export functions you want to share:

//@version=5
// @export double, triple

double(x) =>
    x * 2

triple(x) =>
    x * 3

src/main.pine - Import and use them:

//@version=5
// @import { double, triple } from "./utils.pine"

indicator("My Indicator", overlay=true)

result = double(close)
plot(result)

pinecone build

This creates dist/bundle.pine with all modules combined and properly namespaced.

# Basic build
pinecone build

# Build with custom config path
pinecone build --config path/to/pine.config.json

# Watch mode - rebuild on file changes
pinecone build --watch

# Copy output to clipboard after build
pinecone build --copy

1. Parses your entry file and discovers all imports
2. Resolves the dependency graph (with circular dependency detection)
3. Renames all top-level identifiers in dependency modules to prevent collisions
4. Merges all modules in topological order
5. Outputs a single TradingView-compatible PineScript file

If utils.pine defines myFunc, it becomes __utils__myFunc in the bundle. Your imports are automatically updated to reference the renamed version.

• Python 3.10+

Full documentation is available at claudianadalin.github.io/pinecone

source .venv/bin/activate
mkdocs serve

Then open http://localhost:8000

mkdocs gh-deploy

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run tests with coverage
pytest --cov

If you find Pinecone useful, consider buying me a coffee!

MIT