https://github.com/pynesys/pynecore
PyneCore - Pine Script Like Python Framework
https://github.com/pynesys/pynecore
backtesting-engine compiler financial-data framework library open-source pine-script pinescript python technical-analysis trading-indicators trading-strategies tradingvew
Last synced: 9 months ago
JSON representation
PyneCore - Pine Script Like Python Framework
- Host: GitHub
- URL: https://github.com/pynesys/pynecore
- Owner: PyneSys
- License: apache-2.0
- Created: 2025-01-02T23:42:43.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-26T12:16:52.000Z (10 months ago)
- Last Synced: 2025-04-26T13:26:41.719Z (10 months ago)
- Topics: backtesting-engine, compiler, financial-data, framework, library, open-source, pine-script, pinescript, python, technical-analysis, trading-indicators, trading-strategies, tradingvew
- Language: Python
- Homepage: https://pynecore.org
- Size: 1.46 MB
- Stars: 4
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
PyneCore™
Pine Script in Python - Without Limitations
## What is PyneCore?
PyneCore brings TradingView's Pine Script capabilities to Python through a revolutionary approach - it transforms regular Python code to behave like Pine Script through AST transformations, while maintaining the full power of the Python ecosystem.
Instead of creating another object-oriented wrapper or a new language, PyneCore modifies your Python code at import time, giving you the intuitive bar-by-bar execution model of Pine Script without leaving Python's rich environment.
## Key Features
- **Native Pine Script Semantics in Python**: Write familiar Python code that runs with Pine Script's bar-by-bar execution model
- **AST Transformation Magic**: Your code is transformed at import time to implement Pine Script behavior
- **High Performance**: Zero mandatory external dependencies with highly optimized implementation
- **Series & Persistent Variables**: Full support for Pine Script's time series and state persistence
- **Function Isolation**: Each function call gets its own isolated persistent state
- **NA Handling**: Graceful handling of missing data with Pine Script's NA system
- **Technical Analysis Library**: Comprehensive set of Pine Script-compatible indicators and functions
- **Strategy Backtesting**: Pine Script compatible framework for developing and testing trading strategies
## Quick Example
```python
"""
@pyne
"""
from pynecore import Series
from pynecore.lib import script, close, ta, plot, color, input
@script.indicator(title="Bollinger Bands")
def main(
length=input.int("Length", 20, minval=1),
mult=input.float("Multiplier", 2.0, minval=0.1, step=0.1),
src=input.source("Source", close)
):
# Calculate Bollinger Bands
basis = ta.sma(src, length)
dev = mult * ta.stdev(src, length)
upper = basis + dev
lower = basis - dev
# Output to chart
plot(basis, "Basis", color=color.orange)
plot(upper, "Upper", color=color.blue)
plot(lower, "Lower", color=color.blue)
```
## Innovative Concepts
PyneCore introduces several revolutionary concepts:
### 1. Magic Comment & Import Hook
Identify your scripts with a simple magic comment:
```python
"""
@pyne
"""
```
This activates PyneCore's import hook system which intercepts Python imports and applies AST transformations to recognized scripts.
### 2. Series Variables
Track historical data across bars, just like in Pine Script:
```python
from pynecore import Series
price: Series[float] = close
previous_price = price[1] # Access previous bar's price
```
### 3. Persistent Variables
Maintain state between bars with simple type annotations:
```python
from pynecore import Persistent
counter: Persistent[int] = 0
counter += 1 # Increments with each bar
```
### 4. Function Isolation
Each call to a function maintains its own isolated state:
```python
def my_indicator(src, length):
# Each call gets its own instance of sum
sum: Persistent[float] = 0
sum += src
return sum / length
```
## Installation
```bash
# Basic installation
pip install pynesys-pynecore
# With CLI tools (recommended)
pip install pynesys-pynecore[cli]
# With all features including data providers
pip install pynesys-pynecore[all]
```
## Getting Started
### Create a Simple Script
1. Create a file with the `@pyne` annotation:
```python
"""
@pyne
"""
from pynecore.lib import script, close, plot
@script.indicator("My First Indicator")
def main():
# Calculate a simple moving average
sma_value = (close + close[1] + close[2]) / 3
# Plot the result
plot(sma_value, "Simple Moving Average")
```
2. Run your script with the PyneCore CLI:
```bash
# First, download some price data
pyne data download ccxt --symbol "BYBIT:BTC/USDT:USDT"
# Then run your script on the data
pyne run my_script.py ccxt_BYBIT_BTC_USDT_USDT_1D.ohlcv
```
## Why Choose PyneCore?
- **Beyond TradingView Limitations**: No more platform restrictions, code size limits, or subscription fees
- **Python Ecosystem Access**: Use Python's data science, ML, and analysis libraries alongside trading logic
- **Performance & Precision**: Designed for speed and precision, the same results as Pine Script
- **Open Source Foundation**: The core library and runtime is open source under Apache 2.0 license
- **Professional Trading Tools**: Build institutional-grade systems with Pine Script simplicity
- **Advanced Backtesting**: Run sophisticated strategy tests outside platform constraints
## Documentation & Support
- **Documentation**: [pynecore.org](https://pynecore.org/docs)
### Community
- **Discussions**: [GitHub Discussions](https://github.com/pynesys/pynecore/discussions)
- **Discord**: [discord.com/invite/7rhPbSqSG7](https://discord.com/invite/7rhPbSqSG7)
- **X**: [x.com/pynesys](https://x.com/pynesys)
- **Website**: [pynecore.org](https://pynecore.org)
## License
PyneCore is licensed under the [Apache License 2.0](LICENSE.txt).
## Disclaimer
Pine Script™ is a trademark of TradingView, Inc. PyneCore is not affiliated with, endorsed by, or sponsored by TradingView. This project is an independent implementation that aims to provide compatibility with the Pine Script language concept in the Python ecosystem.
### Risk Warning
Trading involves significant risk of loss and is not suitable for all investors. The use of PyneCore does not guarantee any specific results. Past performance is not indicative of future results.
- PyneCore is provided "as is" without any warranty of any kind
- PyneCore is not a trading advisor and does not provide trading advice
- Scripts created with PyneCore should be thoroughly tested before using with real funds
- Users are responsible for their own trading decisions
- You should consult with a licensed financial advisor before making any financial decisions
By using PyneCore, you acknowledge that you are using the software at your own risk. The creators and contributors of PyneCore shall not be held liable for any financial loss or damage resulting from the use of this software.
## Commercial Support
PyneCore is part of the PyneSys ecosystem. For commercial support, custom development, or enterprise solutions:
- **Website**: [pynesys.com/contact](https://pynesys.com/contact)
---
Elevate Your Trading with the Power of Python & Pine Script