---
title: "Strands Agents integration"
description: "A Strands agent handed a Promigence sandbox runs its shell and file-editor tools there. Output streams back while a command is still running, so a line a…"
url: "https://www.promigence.ai/integrations/strands"
site: "Promigence"
---

# Strands Agents integration

A Strands agent handed a Promigence sandbox runs its shell and file-editor tools there. Output streams back while a command is still running, so a line a long test run prints early reaches the agent well before the run ends.

The package is `strands-promigence` on PyPI, for Python.

## Install

Install it and set your key.

```bash
pip install strands-promigence
export PROMIGENCE_API_KEY=prom_api_...
export PROMIGENCE_SPEND_CAP=5
```

## Example

From the guide [Run Strands agents in a Promigence sandbox](https://www.promigence.ai/docs/guides/strands), which goes on to the spend cap, cleaning up, and what the package does not support.

```python
import asyncio
from strands import Agent
from strands_promigence import PromigenceSandbox

async def main() -> None:
    async with PromigenceSandbox(image="python:3.12-slim", spend_cap=1) as sandbox:
        agent = Agent(sandbox=sandbox)
        await agent.invoke_async("Install httpx and print its version.")

asyncio.run(main())
```

## Next

- [Run Strands agents in a Promigence sandbox](https://www.promigence.ai/docs/guides/strands)
- [strands-promigence on PyPI](https://pypi.org/project/strands-promigence/)
- [All integrations](https://www.promigence.ai/integrations)