Install & Compatibility
Where this runs
tested against v0.0.14 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.382s · 49.4MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 1.7s · import 0.318s · 50MB
47MB installed
● package 47MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
MiniRacer
✓ from py_mini_racer import MiniRacer
akracer acts as a provider of underlying binaries for py_mini_racer, so the primary interaction is still through the py_mini_racer library itself.
This quickstart demonstrates basic usage of py_mini_racer, which akracer enables by providing the necessary underlying binaries, especially for ARM-based systems. It shows how to evaluate JavaScript expressions and call JavaScript functions within a Python environment.
import os
from py_mini_racer import MiniRacer
# Initialize a MiniRacer context
context = MiniRacer()
# Evaluate JavaScript code
result = context.eval("1 + 1")
print(f"Result of '1 + 1': {result}")
# Call a JavaScript function
context.eval("var add = function(a, b) { return a + b; };")
add_result = context.call("add", 5, 3)
print(f"Result of add(5, 3): {add_result}")
# Example using a JavaScript file (simulate loading a file)
js_content = """
var greet = function(name) {
return 'Hello, ' + name + '!';
};
"""
context.eval(js_content)
greet_result = context.call("greet", "World")
print(f"Result of greet('World'): {greet_result}")
Debug
Known issues
gotchaakracer primarily addresses dynamic library issues for py_mini_racer on 64-bit ARM operating systems. While installing akracer may not hurt on other architectures, its primary benefit is for ARM users. On x86-64, py_mini_racer typically installs and compiles correctly without akracer.fixOnly install akracer if you are on a 64-bit ARM operating system and experiencing issues with py_mini_racer's native installation. Otherwise, `pip install py_mini_racer` might suffice.
affects: All versions
breakingThe project is currently in '4 - Beta' development status according to PyPI. This indicates that the API or stability might not be fully mature and could be subject to breaking changes in future releases.fixMonitor release notes and the GitHub repository for updates and potential breaking changes. Consider pinning to specific minor versions to mitigate unexpected issues.
affects: All versions (as of 0.0.14)
gotchaA security analysis by ReversingLabs indicated that the akracer package contains 'risks' and 'known severe vulnerabilities' that are actively being exploited. Users should review the analysis results before use.fixExercise caution and consult the latest security reports for the library. Implement robust security practices in projects using akracer, such as regular dependency scanning and ensuring isolated execution environments.
affects: 0.0.10 and potentially later versions
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'akracer'
The 'akracer' module is not installed in the Python environment.
fixInstall the 'akracer' module using pip: 'pip install akracer'.
ImportError: cannot import name 'akracer'
The 'akracer' module is not installed or the import statement is incorrect.
fixEnsure 'akracer' is installed with 'pip install akracer' and use the correct import statement: 'import akracer'.
AttributeError: module 'akracer' has no attribute 'some_function'
Attempting to access a function or attribute that does not exist in the 'akracer' module.
fixVerify the function or attribute name in the 'akracer' module's documentation and use the correct name.
TypeError: 'NoneType' object is not callable
Calling a function that returns None, possibly due to an incorrect function call in 'akracer'.
fixCheck the function's return value and ensure it is not None before calling it.
ValueError: Invalid parameter value in 'akracer' function
Passing an invalid parameter value to a function in the 'akracer' module.
fixReview the function's parameter requirements in the 'akracer' documentation and provide valid values.
Upgrade
Version history
0.0.14latest on PyPI · released Sep 10, 2025
Audit
Dependencies
py_mini_racerrequiredakracer is an extension library designed to provide necessary binaries for py_mini_racer, especially on ARM architectures. py_mini_racer is the primary interface users interact with.
hatchrequiredUsed for project management and building, as seen in requirements.txt.
requestsrequiredUsed for making HTTP requests, as seen in requirements.txt.
pandasrequiredUsed for data manipulation, as seen in requirements.txt and example usage.
numpyrequiredNumerical computing dependency, as seen in requirements.txt.