Farama-Foundation · gvtret · May 17, 2026 · May 17, 2026
diff --git a/.github/workflows/test-python.yml b/.github/workflows/test-python.yml
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest  # todo, add more OS systems to see if they work as well
     strategy:
       matrix:
-        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
 
     steps:
       - uses: actions/checkout@v6

diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -90,6 +90,9 @@ find_package(PkgConfig)
 if(NOT BUILD_MANYLINUX)
   # CapnProto requires a newer kernel than manylinux1 provides
   find_package(CapnProto QUIET)
+  if(CapnProto_FOUND)
+    set(CAPN_PROTO_FOUND ON)
+  endif()
 endif()
 
 pkg_search_module(LIBZIP QUIET libzip)
@@ -318,8 +321,6 @@ if(NOT CAPN_PROTO_FOUND AND NOT BUILD_MANYLINUX)
   endif()
 endif()
 
-set(CAPN_PROTO_FOUND OFF)
-
 if(CAPN_PROTO_FOUND)
   add_definitions(-DUSE_CAPNP)
 

diff --git a/README.md b/README.md
@@ -141,7 +141,7 @@ Platforms:
 
 CPU with `SSE3` or better
 
-Supported Pythons: 3.7 to 3.12
+Supported Pythons: 3.9 to 3.13
 
 ## Citation
 

diff --git a/cores/flycast/core/deps/libzip/mkstemp.c b/cores/flycast/core/deps/libzip/mkstemp.c
@@ -43,7 +43,7 @@
 #include <stdio.h>
 #include <stdlib.h>
 
-#if defined(__APPLE__) || defined(__SWITCH__)
+#if defined(__APPLE__) || defined(__SWITCH__) || defined(__linux__)
 #include <unistd.h>
 #endif
 

diff --git a/cores/flycast/core/deps/libzip/zip_close.c b/cores/flycast/core/deps/libzip/zip_close.c
@@ -42,7 +42,7 @@
 
 #include "zipint.h"
 
-#if defined(__APPLE__) || defined(__SWITCH__)
+#if defined(__APPLE__) || defined(__SWITCH__) || defined(__linux__)
 #include <unistd.h>
 #endif
 

diff --git a/cores/n64/mupen64plus-core/src/r4300/hacktarux_dynarec/assemble.h b/cores/n64/mupen64plus-core/src/r4300/hacktarux_dynarec/assemble.h
@@ -1650,7 +1650,8 @@ static INLINE void fchs(void)
 }
 
 
-static INLINE void fsqrt(void)
+/* Renamed from fsqrt: glibc/mathcalls-narrow.h defines fsqrt() on GCC 15+ */
+static INLINE void m64_emit_fsqrt(void)
 {
    put8(0xD9);
    put8(0xFA);

diff --git a/cores/n64/mupen64plus-core/src/r4300/hacktarux_dynarec/hacktarux_dynarec.c b/cores/n64/mupen64plus-core/src/r4300/hacktarux_dynarec/hacktarux_dynarec.c
@@ -6317,13 +6317,13 @@ void gensqrt_d(void)
 #ifdef __x86_64__
    mov_xreg64_m64rel(RAX, (uint64_t *)(&reg_cop1_double[dst->f.cf.fs]));
    fld_preg64_qword(RAX);
-   fsqrt();
+   m64_emit_fsqrt();
    mov_xreg64_m64rel(RAX, (uint64_t *)(&reg_cop1_double[dst->f.cf.fd]));
    fstp_preg64_qword(RAX);
 #else
    mov_eax_memoffs32((unsigned int *)(&reg_cop1_double[dst->f.cf.fs]));
    fld_preg32_qword(EAX);
-   fsqrt();
+   m64_emit_fsqrt();
    mov_eax_memoffs32((unsigned int *)(&reg_cop1_double[dst->f.cf.fd]));
    fstp_preg32_qword(EAX);
 #endif
@@ -7301,13 +7301,13 @@ void gensqrt_s(void)
 #ifdef __x86_64__
    mov_xreg64_m64rel(RAX, (uint64_t *)(&reg_cop1_simple[dst->f.cf.fs]));
    fld_preg64_dword(RAX);
-   fsqrt();
+   m64_emit_fsqrt();
    mov_xreg64_m64rel(RAX, (uint64_t *)(&reg_cop1_simple[dst->f.cf.fd]));
    fstp_preg64_dword(RAX);
 #else
    mov_eax_memoffs32((unsigned int *)(&reg_cop1_simple[dst->f.cf.fs]));
    fld_preg32_dword(EAX);
-   fsqrt();
+   m64_emit_fsqrt();
    mov_eax_memoffs32((unsigned int *)(&reg_cop1_simple[dst->f.cf.fd]));
    fstp_preg32_dword(EAX);
 #endif

diff --git a/cores/nes/src/fds.c b/cores/nes/src/fds.c
@@ -104,7 +104,7 @@ static void FDSStateRestore(int version) {
 		}
 }
 
-void FDSSound();
+void FDSSound(int c);
 void FDSSoundReset(void);
 void FDSSoundStateAdd(void);
 static void RenderSound(void);

diff --git a/docs/getting_started.md b/docs/getting_started.md
@@ -1,6 +1,6 @@
 # Getting Started
 
-Stable Retro requires Python 3.8 through 3.12. Please make sure to install the appropriate distribution for your OS beforehand. Please note that due to compatibility issues with some of the cores, 32-bit operating systems are not supported.
+Stable Retro requires Python 3.9 through 3.13. Please make sure to install the appropriate distribution for your OS beforehand. Please note that due to compatibility issues with some of the cores, 32-bit operating systems are not supported.
 
 ```shell
 pip3 install stable-retro

diff --git a/docs/linux_installation.md b/docs/linux_installation.md
@@ -4,7 +4,7 @@ This guide covers installing Stable Retro on Linux distributions.
 
 ## Requirements
 
-- Python 3.8 to 3.12
+- Python 3.9 to 3.13
 - Linux (manylinux1 compatible)
 - CPU with SSE3 or better
 - Ubuntu 22.04 is recommended
@@ -155,7 +155,7 @@ env.close()
 
 ### Common Issues
 
-- **Import errors**: Ensure you have the correct Python version (3.8-3.12)
+- **Import errors**: Ensure you have the correct Python version (3.9-3.13)
 - **Missing shared libraries**: Install the required system dependencies listed above
 - **Permission errors**: You may need to use `pip3 install --user` or a virtual environment
 - **32-bit systems**: Not supported due to compatibility issues with some cores

diff --git a/docs/macos_installation.md b/docs/macos_installation.md
@@ -4,7 +4,7 @@ This guide covers installing Stable Retro on macOS, including both Intel and App
 
 ## Requirements
 
-- Python 3.8 to 3.12
+- Python 3.9 to 3.13
 - macOS 10.13 (High Sierra) or later
 
 ## Standard Installation
@@ -106,7 +106,7 @@ env.close()
 
 ### Common Issues
 
-- **Import errors**: Ensure you have the correct Python version (3.8-3.12)
+- **Import errors**: Ensure you have the correct Python version (3.9-3.13)
 - **Build failures on Apple Silicon**: Make sure you've set `SDKROOT` correctly
 - **Qt not found**: Verify Qt is in your PATH after running the export command
 - **Game Boy games not working on Apple Silicon**: This is expected; the gambatte core is not supported on arm64
diff --git a/pyproject.toml b/pyproject.toml
@@ -3,11 +3,11 @@ requires = ["cmake>=3.2.0", "setuptools", "wheel", "build"]
 
 [tool.cibuildwheel]
 # We need to build for the following Python versions:
-build = "cp{38,39,310,311,312}-*"
+build = "cp{39,310,311,312,313}-*"
 
 [tool.cibuildwheel.linux]
 # Only manylinux is supported (no musl)
-build = "cp{38,39,310,311,312}-manylinux*"
+build = "cp{39,310,311,312,313}-manylinux*"
 
 # For manylinux_2_28 we need to install the following dependencies using yum:
 before-all = "yum install -y cmake git pkgconf-pkg-config zlib-devel libzip-devel bzip2-devel"

diff --git a/setup.py b/setup.py
@@ -113,11 +113,12 @@ def run(self):
     version=open(VERSION_PATH).read().strip(),
     license="MIT",
     install_requires=[
-        "gymnasium>=0.27.1",
-        "pyglet>=1.3.2,==1.*",
+        "gymnasium>=1.0.0",
+        "pyglet>=1.5.27,<2",
         "farama-notifications>=0.0.1",
+        "numpy>=1.26.0",
     ],
-    python_requires=">=3.8.0,<3.13",
+    python_requires=">=3.9.0,<3.14",
     ext_modules=[Extension("stable_retro._retro", ["CMakeLists.txt", "src/*.cpp"])],
     cmdclass={"build_ext": CMakeBuild},
     packages=[

diff --git a/src/memory.h b/src/memory.h
@@ -2,6 +2,7 @@
 
 #include "gtest/gtest.h"
 
+#include <cstdint>
 #include <functional>
 #include <map>
 #include <memory>

diff --git a/src/ui/CMakeLists.txt b/src/ui/CMakeLists.txt
@@ -9,8 +9,9 @@ set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
 file(GLOB SRC *.cpp)
 
 set(RETRO_EXTRA)
-# Temporarily disable CapnProto until we upgrade it to a newer version
-# if(CapnProto_FOUND) list(APPEND RETRO_EXTRA retro-capnp) endif()
+if(CAPN_PROTO_FOUND)
+  list(APPEND RETRO_EXTRA retro-capnp)
+endif()
 
 get_target_property(QT_TYPE Qt5::Core TYPE)