---
id: 1d3eaf3a-416c-4962-a531-fff4e92c0e66
type: solution
title: "NumPy X86_V2 CPU compatibility fix"
tags: [paper-dynasty, python, docker, numpy, fix]
importance: 0.7
confidence: 0.8
created: "2026-01-07T19:17:16.601527+00:00"
updated: "2026-02-20T04:32:10.279808+00:00"
relations:
  - target: 1695d110-7bcf-4e06-92e1-ffed8f686538
    type: BUILDS_ON
    direction: incoming
    strength: 0.9
    edge_id: 970d7ac1-a8ea-4217-b93b-49f5750d5354
---

NumPy 2.x requires X86_V2 instruction set (SSE4.2/AVX) which older server CPUs don't support. When building Docker images locally on newer hardware then deploying to older servers, pin numpy<2 in requirements.txt to use numpy 1.26.x which doesn't have this requirement. Error message: RuntimeError: NumPy was built with baseline optimizations: (X86_V2) but your machine doesn't support: (X86_V2).