feat: add Python SDK with PyO3 bindings

- Add pyo3 and pyo3-asyncio dependencies with python feature flag
- Implement Python bindings in src/python.rs mirroring napi.rs structure
- Add pyproject.toml for maturin build configuration
- Create Python package structure with type stubs
- Support async/await for sandbox operations

Signed-off-by: danbugs <danilochiarlone@gmail.com>

Author: danbugs

Cargo.lock

@@ -14,9 +14,14 @@ libc = "0.2.178"
 napi = { version = "3.5.0", optional = true, features = ["async", "serde-json"] }
 napi-derive = { version = "3.3.0", optional = true }
 
+# Python bindings (optional)
+pyo3 = { version = "0.20", optional = true, features = ["extension-module", "abi3-py38"] }
+pyo3-asyncio = { version = "0.20", optional = true, features = ["tokio-runtime"] }
+
 [features]
 default = []
 napi = ["dep:napi", "dep:napi-derive", "dep:napi-build"]
+python = ["dep:pyo3", "dep:pyo3-asyncio"]
 
 [lib]
 crate-type = ["cdylib", "rlib"]

Cargo.toml

@@ -0,0 +1,13 @@
+[build-system]
+requires = ["maturin>=1.0,<2.0"]
+build-backend = "maturin"
+
+[project]
+name = "hyperlight-nanvix"
+version = "0.1.0"
+requires-python = ">=3.8"
+
+[tool.maturin]
+features = ["python"]
+module-name = "hyperlight_nanvix.hyperlight_nanvix"
+python-source = "python"

pyproject.toml

@@ -0,0 +1,12 @@
+"""
+hyperlight-nanvix: Python bindings for running sandboxed workloads
+
+This module provides a Python interface to the Nanvix microkernel-based
+sandbox system, allowing you to run JavaScript, Python, C, and C++
+workloads in isolated environments.
+"""
+
+from .hyperlight_nanvix import NanvixSandbox, SandboxConfig, WorkloadResult
+
+__version__ = "0.1.0"
+__all__ = ["NanvixSandbox", "SandboxConfig", "WorkloadResult"]

python/hyperlight_nanvix/__init__.py

@@ -0,0 +1,17 @@
+from typing import Optional
+
+class SandboxConfig:
+    log_directory: Optional[str]
+    tmp_directory: Optional[str]
+    def __init__(self, log_directory: Optional[str] = None, tmp_directory: Optional[str] = None) -> None: ...
+
+class WorkloadResult:
+    success: bool
+    error: Optional[str]
+
+class NanvixSandbox:
+    def __init__(self, config: Optional[SandboxConfig] = None) -> None: ...
+    async def run(self, workload_path: str) -> WorkloadResult: ...
+    async def clear_cache(self) -> None: ...
+
+__all__ = ["NanvixSandbox", "SandboxConfig", "WorkloadResult"]

python/hyperlight_nanvix/__init__.pyi

@@ -7,6 +7,9 @@ pub mod runtime;
 #[cfg(feature = "napi")]
 pub mod napi;
 
+#[cfg(feature = "python")]
+pub mod python;
+
 #[cfg(test)]
 mod unit_tests;