Force Agg matplotlib backend + miner-facing polish

README.md

@@ -3,6 +3,8 @@
 Tools for downloading minute-level market data and backtesting miners against
 [Synth Subnet](https://github.com/synthdataco/synth-subnet) scoring.
 
+New to mining on SN50? Start with the [miner tutorial](https://github.com/synthdataco/synth-subnet/blob/main/docs/miner_tutorial.md) — backtesting is step 2.3 of that journey.
+
 The library is organised into two pieces:
 
 - [synth_lib/preparation/market_data.py](synth_lib/preparation/market_data.py) — downloads

pyproject.toml

@@ -9,7 +9,7 @@ packages = ["synth_lib"]
 [project]
 name = "synth-lib"
 version = "0.1.0"
-description = "Add your description here"
+description = "Market-data preparation and validator-faithful backtesting for Synth Subnet miners"
 readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [

synth_lib/backtester/backtest.py

@@ -19,6 +19,12 @@
 from pathlib import Path
 from typing import Any
 
+import matplotlib
+
+# Charts are rendered inside worker threads; GUI backends (the macOS default)
+# can only run on the main thread, so force the non-interactive Agg backend.
+matplotlib.use("Agg")
+
 import matplotlib.pyplot as plt
 import numpy as np
 import pandas as pd