agent-framework-hyperlight
Hyperlight CodeAct integrations for Microsoft Agent Framework.
Decision gist · record as of 2026-08-14
Yes, if you are building agents with Microsoft Agent Framework and need safe, isolated code execution. The package is actively maintained, has low install friction, and carries no security vulnerabilities. The main gotcha is platform availability of the Wasm backend—verify it is published for your target platform before relying on it in production. Beta status (1.0.0b260730) means the API may still shift, but the recent release and active maintenance suggest it is reasonably stable.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- The Wasm backend for hyperlight-sandbox may not be published for your platform; if missing, execute_code will fail at runtime when attempting to create a sandbox.
- Low friction install with a pure-Python wheel.
License · maintenance · safety
permissive license (permissive) — Permissive license treatment means you can use this package in commercial and proprietary projects without copyleft obligations.
last release 2026-07-30 (15 days) · last repo commit 2026-08-14 · 12,804 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 173,729 downloads/mo, #10,300 on PyPI
Alternatives
Verify before relying
pip install agent-framework-hyperlight --pre
from agent_framework import Agent, tool
from agent_framework_hyperlight import HyperlightCodeActProvider
@tool
def compute(operation: str, a: float, b: float) -> float:
ops = {"add": a + b, "subtract": a - b, "multiply": a * b, "divide": a / b}
return ops[operation]
codeact = HyperlightCodeActProvider(tools=[compute], approval_mode="never_require")
agent = Agent(client=client, name="CodeActAgent", context_providers=[codeact])- Whether the Wasm backend is currently available for all major platforms (Linux, macOS, Windows).
- Performance characteristics and latency overhead of sandbox creation and code execution.
- Resource limits and constraints enforced within the sandbox environment.
What it is and what it does
agent-framework-hyperlight provides CodeAct (code-act) integration for Microsoft Agent Framework, enabling agents to execute Python code inside an isolated Hyperlight sandbox. It wraps sandboxed execution as either a context provider that automatically injects the execute_code tool into agents, or as a standalone tool for mixed configurations. The sandbox isolates code execution from the host, and tools registered with the provider are available to the sandboxed code via call_tool() but not exposed as direct agent tools.
The package supports file mounts (mapping host directories into the sandbox), network access control (allowlisting specific domains and HTTP methods), and flexible tool approval modes. It depends on agent-framework-core, hyperlight-sandbox, and platform-specific backend packages. The package is intentionally separate from core so CodeAct remains optional; it can also be imported via the lazy-loading namespace agent_framework.hyperlight when the full framework is installed.
Use it for
- Let an agent execute Python code to perform calculations, data transformations, or API calls while keeping the code isolated from the host system.
- Register domain-specific tools (e.g., compute, send_email) that agents can call directly or invoke from within sandboxed code execution.
- Mount host directories into the sandbox to give agents controlled read/write access to files without exposing the entire filesystem.
- Restrict outbound network access from sandboxed code to specific domains and HTTP methods for security compliance.
- Mix sandboxed tools (available only inside execute_code) with direct-only tools (available only to the agent) on the same agent.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building agents with Microsoft Agent Framework and need safe, isolated code execution.
The package is actively maintained, has low install friction, and carries no security vulnerabilities. The main gotcha is platform availability of the Wasm backend—verify it is published for your target platform before relying on it in production. Beta status (1.0.0b260730) means the API may still shift, but the recent release and active maintenance suggest it is reasonably stable.
Install
agent-framework-hyperlight on PyPI
Before you install
Low friction install with a pure-Python wheel. Active maintenance (released 15 days ago, last commit 2026-08-14) and permissive licensing. Depends on four runtime packages including hyperlight-sandbox and platform-specific backends; the Wasm backend may not be available for all platforms yet, which could cause runtime failures when creating sandboxes.
Requires Python 3.10 or later. The Wasm backend for hyperlight-sandbox may not be published for your platform; if missing, execute_code will fail at runtime when attempting to create a sandbox.
License in practice
Permissive license treatment means you can use this package in commercial and proprietary projects without copyleft obligations.
Quickstart
pip install agent-framework-hyperlight --pre
from agent_framework import Agent, tool
from agent_framework_hyperlight import HyperlightCodeActProvider
@tool
def compute(operation: str, a: float, b: float) -> float:
ops = {"add": a + b, "subtract": a - b, "multiply": a * b, "divide": a / b}
return ops[operation]
codeact = HyperlightCodeActProvider(tools=[compute], approval_mode="never_require")
agent = Agent(client=client, name="CodeActAgent", context_providers=[codeact])Verify before relying
- Whether the Wasm backend is currently available for all major platforms (Linux, macOS, Windows).
- Performance characteristics and latency overhead of sandbox creation and code execution.
- Resource limits and constraints enforced within the sandbox environment.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesagent-framework-corehyperlight-sandboxhyperlight-sandbox-backend-wasmhyperlight-sandbox-python-guest |
| Maintenance | Actively maintained 15 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 173,729 / month, #10,300 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Typing :: Typed |
Evidence: agent_framework_hyperlight-1.0.0b260730-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “agent framework code execution”
- agent-framework-hyperlightIntegrates sandboxed code execution into Microsoft Agent Framework…
- stirrupStirrup is a lightweight Python framework for building LLM-powered…
- langchain-daytonaIntegrates Daytona sandboxes with LangChain's Deep Agents framework,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Application Frameworks packages
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Textual is a Python framework for building cross-platform user interfaces that run in the terminal or web browser using a modern, component-based API.
Install it if you're developing CLI tools, dashboards, or interactive terminal applications.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Build and connect to Model Context Protocol servers that expose tools, resources, and prompts to LLM applications over stdio, HTTP, or SSE transports.
Install it if you need to build or connect to servers.
Werkzeug is a WSGI utility library providing request/response objects, URL routing, an interactive debugger, HTTP utilities, and a development server for building web applications.
See also hyperlight-sandbox · hyperlight-sandbox-python-guest · hyperlight-sandbox-backend-wasm · agent-framework-github-copilot · agent-framework · agent-framework-core · openai-agents · agent-framework-azure-ai · pydantic-ai-harness · e2b