Skip to content

Releases: MeridianAlgo/AraAI

v1.1.1

07 Jun 23:33

Choose a tag to compare

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

04 Jun 20:01

Choose a tag to compare

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-v2 endpoint (which was failing the hourly forex push). Now authenticates per request with 429-aware backoff retry.
  • GitHub Actions off Node 20 — bumped actions/cache and actions/github-script to 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.