eulogik / nanoforecast-v03

🔮 NanoForecast v0.3
_{World's most deployable time series transformer}

6.5M params · 512 context · Streaming RNN · ONNX-ready
Runs on CPU, Raspberry Pi, and in the browser

---

🚀 Why NanoForecast?

Most time series foundation models are too big to ship — they need GPUs, terabytes of training data, and a PhD to deploy. NanoForecast is different:

Stop renting GPUs for forecasting. Train on your laptop. Deploy to a $35 Raspberry Pi. Get production forecasts in minutes.

🏆 Benchmarks

Benchmarks on 6 standard datasets. Overall MASE improved 21% from v0.2 (3.45 → 2.73). See GitHub for full results on 3 model sizes.

📦 Quick Start

pip install nanoforecast

import numpy as np
from nanoforecast import NanoForecast

model = NanoForecast.from_pretrained("eulogik/nanoforecast-v03")
context = np.sin(np.linspace(0, 8*np.pi, 512)) + 0.1 * np.random.randn(512)
out = model.predict(context, horizon=48, freq=1)
print(out["forecast"].shape)  # (48,) point forecast

🔄 Streaming Inference (Unique to NanoForecast)

NanoForecast's DeltaNet RNN maintains a recurrent state across calls — no other TS model does this .

result = model.predict(context, horizon=48, return_state=True)
state = result.pop("state")

for new_val in incoming_data_stream:
    result = model.predict_step(new_val, state, horizon=48)
    print(result["forecast"][0, :5])  # updated forecast instantly

Use it for:

• Real-time IoT sensor monitoring
• Live financial tick data
• Interactive dashboards
• Edge devices with limited memory

🎯 Try It in 1 Click

Upload a CSV → get forecast + prediction intervals + decomposition. No code. No GPU.

🧠 Model Details

⚡ Training Details

✨ What Makes NanoForecast Special

• 🪶 Featherweight : 200K–6.5M params, not 200M+. Ships as a dependency, not an API call.
• 📡 Streaming native : Feed one value at a time, get updated forecasts. Perfect for IoT and real-time data.
• 💻 Zero-GPU inference : Runs on ARM, x86, RISC-V. Benchmarked at <50ms on Raspberry Pi 4.
• 📦 Single pip install : pip install nanoforecast → ready in 30 seconds.
• 🏭 Production-grade : ONNX export, Docker, FastAPI server all included.
• 📊 Full uncertainty : 5 quantiles + prediction intervals + trend/seasonal decomposition.
• 🔌 HuggingFace native : from_pretrained / push_to_hub — works like any HF model.

🔧 Deploy Anywhere

# FastAPI server
pip install nanoforecast fastapi uvicorn python-multipart
python3 deploy/fastapi_server.py

# ONNX export (edge/IoT/browser)
pip install "nanoforecast[onnx]"
python3 -m nanoforecast.export.onnx_export \
    --checkpoint <dir> \
    --output nanoforecast.onnx

# Docker
docker build -t nanoforecast .
docker run -p 8000:8000 nanoforecast

📚 Pretrained Variants

📄 Paper

Read the tech report: deploy/paper.tex (LaTeX, 8 sections).

⚠️ Known Limitations

• Modest accuracy vs. 200M+ param models (MASE 2.73 vs TimesFM ~0.72)
• Fixed context window (512 for v0.3)
• Univariate channels (no cross-channel attention)
• Training requires PyTorch (inference can be pure ONNX)

❤️ Built by Eulogik

Eulogik builds deployable AI for the real world. We believe ML models should run on the hardware people actually have, not the hardware vendors want to sell.

• 🌐 eulogik.com
• 🐙 GitHub
• 📦 PyPI

Star the repo ⭐ if you find this useful — it helps others discover NanoForecast!