Releases: MeridianAlgo/AraAI
v1.1.1
Fix recurring forex/stock training run failures on Hugging Face push.
When HF rate-limits the hourly stock+forex pushes it sometimes returns an empty/HTML 429 body, causing huggingface_hub to raise a raw JSONDecodeError (Expecting value: line 1 column 1 (char 0)) that slipped past the 429 retry loop and failed the whole run. The pusher now treats non-JSON/transient responses (and 5xx) as retryable with exponential backoff.
v1.0.0 — Production
Meridian.AI v1.0.0 — First Production Release
This is the first production release of Meridian.AI. Every prior tag (v1.0.0-Beta through v6.0.1) was pre-production — a long sequence of architecture experiments, data-pipeline rewrites, and honesty corrections. Those releases and tags have been retired and folded into the changelog as development history. v1.0.0 is the single supported release going forward.
Validated with a walk-forward backtest
Before cutting the release, both models were tested across many random historical dates: the model sees only the data available up to each date, predicts the next day's direction, and that sign is compared to the realized move. Every feature is backward-looking and the target is strictly future — no lookahead.
| Model | Samples | Directional accuracy | Always-up baseline | Edge | Significance |
|---|---|---|---|---|---|
| Forex | 960 | 63.5% | 51.7% | +11.9 pts | z = 8.4 (highly significant) |
| Stocks | 1,680 | 51.6% | 51.5% | +0.1 pts | z = 1.3 (not significant) |
- Forex is the flagship — a large, statistically robust next-day directional edge across eight major pairs (EUR/USD 72.5%, USD/JPY and EUR/GBP 67.5%). The model is trained for direction, not magnitude; the production path clips the return size to a realistic daily range. Use the sign, not the number.
- Stocks ship as experimental — at roughly chance once the market's upward drift is accounted for (51.6% vs a 51.5% baseline, not statistically distinguishable). No demonstrated live edge; included for research completeness.
Neither model is a multi-day or week-ahead forecaster. Treat the output as a next-day directional tilt, not a crystal ball.
Operational fixes in this release
- Hugging Face push hardened — dropped the
login()call that validated through the hard-rate-limited/whoami-v2endpoint (which was failing the hourly forex push). Now authenticates per request with 429-aware backoff retry. - GitHub Actions off Node 20 — bumped
actions/cacheandactions/github-scriptto clear the deprecation warnings.
Versioning
The product version (__version__, pyproject.toml) is now 1.0.0. The checkpoint architecture version (MODEL_VERSION / _MIN_LOADABLE) stays on the 6.x line because it gates which checkpoint formats the loader accepts — the two are intentionally decoupled. The checkpoints themselves are unchanged from v6.0.1.
Get the models
from huggingface_hub import hf_hub_download
from meridianalgo.forex_ml import ForexML
path = hf_hub_download(repo_id="meridianal/ARA.AI", filename="models/Meridian.AI_Forex.pt")
ml = ForexML(model_path=path)
print(ml.predict_forex("EUR/USD", days=5))Full history in docs/CHANGELOG.md.