skills.rest
cajias
cajiasCOMMUNITY
Explore all skills by this author →
GitHub

gfootball-docker-apple-silicon

Build and run Google Research Football in Docker on Apple Silicon.

Updated Nov 18, 2025
Search Tags:#docker#apple silicon#python 3.12#gfootball#boost.python#headless simulation#gym pinning
One-click install
npx skills add https://github.com/cajias/claude-skills --skill gfootball-docker-apple-silicon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gfootball-docker-apple-silicon
Source: https://github.com/cajias/claude-skills/tree/main/plugins/ci-build/skills/gfootball-docker-apple-silicon
Command: npx skills add https://github.com/cajias/claude-skills --skill gfootball-docker-apple-silicon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the common failure of building and running Google Research Football on macOS Apple Silicon with Python 3.12, where native installation and naive Docker setups run into Boost.Python mismatches, missing build-time modules, and incompatible runtime dependencies.

Core Features & Use Cases

  • Docker-based build strategy: Guides you to use an Ubuntu 24.04 container whose Python and Boost.Python versions match correctly for gfootball 2.10.2.
  • Build-time failure fixes: Addresses psutil and CMake isolation issues by preinstalling required packages and disabling build isolation.
  • Runtime compatibility fixes: Pins the right gym version, installs six, and configures headless SDL settings for reliable simulation runs.
  • Use Case: You are trying to launch a gfootball environment on an Apple Silicon Mac and need a repeatable recipe that builds successfully, imports cleanly, and runs without display access.

Quick Start

Ask Claude to help you build a Docker image for gfootball on Apple Silicon and then verify the container can create an environment, reset, and step successfully.

Frequently Asked Questions about gfootball-docker-apple-silicon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does gfootball fail to build on Apple Silicon with Python 3.12?▼

gfootball fails on Apple Silicon due to Boost.Python version mismatches, missing build-time modules like psutil and CMake, and incompatible runtime dependencies that native macOS installation cannot resolve.

How do I run Google Research Football in Docker on Apple Silicon?▼

To run gfootball in Docker on Apple Silicon, use an Ubuntu 24.04 container with matching Boost.Python versions, disable build isolation, pin the correct gym version, and configure headless SDL settings for simulation.

Does gfootball work with Python 3.12 on macOS?▼

gfootball does not work natively with Python 3.12 on macOS Apple Silicon due to build failures and missing modules, but it runs reliably inside an Ubuntu 24.04 Docker container with pinned dependencies.

What's the best way to fix missing Python modules when installing gfootball?▼

The best way to fix missing Python modules during gfootball installation is to preinstall required packages like psutil and CMake, and disable build isolation within a properly configured Ubuntu 24.04 Docker container.

How do I configure headless simulation for gfootball in Docker?▼

To configure headless simulation for gfootball in Docker, install the six package, pin the correct gym version, and apply headless SDL settings so the environment runs without requiring display access.

Can I use a native macOS installation instead of Docker for gfootball?▼

Native macOS installation for gfootball on Apple Silicon is not recommended because naive setups encounter Boost.Python mismatches and incompatible runtime dependencies, whereas Docker provides a repeatable, working build environment.

Related Skills

Explore More Software Engineering Skills→
schpetschpet
5

apple-container

Run Linux containers natively on macOS with Apple Silicon.

Community
Advanced
RamanEbrahimiRamanEbrahimi
3

pufferlib

Vectorize parallel environments to accelerate reinforcement learning training.

Community
Advanced
ovachieverovachiever
52

stable-baselines3

Train reinforcement learning agents with Stable Baselines3 algorithms.

Community
Advanced
NITISH-gitbitNITISH-gitbit

apple-notes

Manage Apple Notes via the memo CLI on macOS.

Community
Basic