langchain-opsen

Run LangChain deepagents on opsen — with machine, model and tool spend on one bill and a budget the runtime enforces mid-run.

pip install langchain-opsen

from deepagents import create_deep_agent
from langchain_anthropic import ChatAnthropic
from langchain_opsen import OpsenSandbox

agent = create_deep_agent(
    model=ChatAnthropic(model="claude-sonnet-4-6"),
    system_prompt="You are a Python coding assistant.",
    backend=OpsenSandbox(task_id="nightly-report", budget_usd=2.00),
)

Set OPSEN_API_KEY, or pass api_key=. Get one here:

https://opsen.dev/keys

What this adds

Every sandbox backend bills you for the machine and leaves the model bill with a different vendor, on a different invoice, with no shared identifier. Two bills, reconciled by hand, and no answer to "what did that agent cost".

opsen sits in both paths, so:

agent_cost = backend.cost()
# {'total_usd': 0.41, 'compute_usd': 0.02, 'tokens_usd': 0.39,
#  'calls': 34, 'input_tokens': 84120, 'output_tokens': 9310,
#  'task_id': 'nightly-report'}

budget_usd is a ceiling the gateway enforces during the run. An agent that would cross it is refused mid-flight rather than noticed afterwards on an invoice.

Behaviour worth knowing

The session starts lazily. Constructing OpsenSandbox starts no machine — the first command does. An agent built and never run costs nothing.

File operations and the shell share one channel. Both go through the same exec path, so the file tools and execute() always agree about the working directory.

Ports depend on the runtime. host(port) works on E2B, works on Modal when the port was declared at sandbox creation, and raises on the local runtime with a message naming the limitation. A provider that hands back a URL which does not answer turns "preview my server" into a debugging session.

Configuration

Argument Default Meaning
api_key $OPSEN_API_KEY From opsen.dev/keys
task_id "deepagents" Groups this agent's spend. One id, one line on the spend page.
budget_usd none Hard ceiling, enforced mid-run
labels {} Arbitrary tags — customer, environment, whatever you group by
base_url https://opsen.dev For self-hosted deployments
timeout 300 Default seconds per command

Licence

Apache-2.0

Project links

Data verified by PyPI on Sep 7, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.6)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for opsen from gravatar.com opsen

Credits

Author: opsen

GitHub Statistics

Data verified by PyPI on Sep 7, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License (Apache-2.0)

Requires

Python >=3.10

Provides Extra

test

Tags

langchain deepagents agents sandbox opsen

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

langchain_opsen-0.1.2.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

langchain_opsen-0.1.2-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

File details

Details for the file langchain_opsen-0.1.2.tar.gz.

File metadata

  • Download URL: langchain_opsen-0.1.2.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for langchain_opsen-0.1.2.tar.gz
Algorithm Hash digest
SHA256 ec743ddf05c15f17d9a2dadcb3bfc1b169258044655c3e5cd46f357d44730099
MD5 2f766da911ca1c29bcf036a648b05790
BLAKE2b-256 32023912e6fc5c46487bb776673b17887033ac4c95bd3392e66e507435e84f35

See more details on using hashes here.

Provenance

The following attestation bundles were made for langchain_opsen-0.1.2.tar.gz:

Publisher: release.yml on md322613/opsen

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file langchain_opsen-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for langchain_opsen-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 555f420a98c1a21aab752909419ceff10aac222e1c911282ff4e380fd30160a3
MD5 bbc75b8b4c8ef1a5c12e02ecb002b659
BLAKE2b-256 3976f0c2c357288e67bd7ee981a6dfc007fe24e37f838bde32131af2ec5217f6

See more details on using hashes here.

Provenance

The following attestation bundles were made for langchain_opsen-0.1.2-py3-none-any.whl:

Publisher: release.yml on md322613/opsen

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

This release

0.1.2 This release

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page