SharpeArena for Python
The Python distribution combines the native SharpeArena engine with a Gymnasium-compatible environment and optional adapters for multi-agent, RLVR, offline-RL, MCP, and local-model workflows.
Point-in-time observations prevent future-bar access through the environment API. They do not isolate Python code from the host. Run trusted local code here, or use SharpeBench's digest-pinned container path for an untrusted entrant.
Install
pip install sharpearena
The base install includes NumPy, Gymnasium, the Python package, and the compiled pyo3 extension. Optional integrations are explicit:
pip install "sharpearena[pettingzoo]"
pip install "sharpearena[verifiers]"
pip install "sharpearena[minari]"
pip install "sharpearena[mcp]"
Step a Gymnasium environment
from sharpearena import SharpeArenaEnv
env = SharpeArenaEnv(n_symbols=4, n_days=120, seed=7)
observation, info = env.reset(seed=7)
terminated = truncated = False
while not (terminated or truncated):
action = env.action_space.sample()
observation, reward, terminated, truncated, info = env.step(action)
Actions are signed target-weight vectors in the environment's symbol order. The
default range is [-1, 1]; pass allow_short=False to make it [0, 1], or set
max_weight to change the per-symbol bound.
Importing sharpearena registers the following Gymnasium IDs:
SharpeArena/Calm-v1 SharpeArena/Calm-Eval-v1
SharpeArena/Hard-v1 SharpeArena/Hard-Eval-v1
SharpeArena/Extreme-v1 SharpeArena/Extreme-Eval-v1
The -Eval-v1 environments draw from the disjoint evaluation seed band. The -v1
suffix freezes the environment semantics; a rule change requires a new versioned ID.
Native boundary
sharpearena.sharpearena_py.TradingEnv is the low-level binding. Its boundary is
JSON: reset() returns an observation string, and step(decision_json) returns
(observation_json, reward, done, info_json). The Python Gymnasium wrapper converts
between that wire format and NumPy spaces.
The wheel ships py.typed and a stub for the compiled extension. Typed boundary
exceptions distinguish invalid input, invalid JSON, invalid salt, unavailable data,
and engine failures.
Other surfaces
| Task | Surface |
|---|---|
| Batched Gymnasium rollout | SharpeArenaVectorEnv or gymnasium.make_vec(...) |
| Multi-agent environment | MultiAgentSharpeArenaEnv with the pettingzoo extra |
| RLVR / Prime RL | load_environment() with the verifiers extra |
| Offline RL export | to_minari, to_minari_train_test with the minari extra |
| External tool server | MCP server with the mcp extra |
| Evidence field | sharpearena-local-field and the model transport shims |
| Benchmark compilation | sharpearena-compile-bench |
| Strategy search | sharpearena-strategy-search |
See the repository's Gymnasium guide, training guide, and agent contract for the full workflows.
Build from source
python -m maturin develop --manifest-path crates/sharpearena-py/Cargo.toml
License
MIT OR Apache-2.0
1 maintainer
Metadata
1 maintainer
Release files for sharpearena 0.23.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sharpearena-0.23.0.tar.gz | 577.5 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| sharpearena-0.23.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.17+ x86-64 | Details |
| sharpearena-0.23.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.17+ x86-64 | Details |
| sharpearena-0.23.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.11 | CPython 3.11 | Linux glibc 2.17+ x86-64 | Details |
| sharpearena-0.23.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.10 | CPython 3.10 | Linux glibc 2.17+ x86-64 | Details |
Total release size: 4.8 MB
Release files / sharpearena-0.23.0.tar.gz
| Download URL | sharpearena-0.23.0.tar.gz |
|---|---|
| Size | 577.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
945a237023b586fa50859d7f4489c95398b14e442193c2a62bc0f41ab3eb1eda
|
|
BLAKE2b-256 checksum How to use checksums |
e805bcc8ae135f93e7a4791e1f6abadc9eff8bfe476c25251594760e56222ace
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.
Transparency logRelease files / sharpearena-0.23.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | sharpearena-0.23.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
ffdedbb3765dc563ef57eb2cea28718af1e419e3e0251a911b71fb14ed4a7aca
|
|
BLAKE2b-256 checksum How to use checksums |
cc4f92b224756ac16e1763503c22d45194215a0395da2177bc589836886fb406
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.
Transparency logRelease files / sharpearena-0.23.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | sharpearena-0.23.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
f94a96fb0f052015276623c04ef65b3bf7d0999c11bb0fe0a12bf225d338c8a1
|
|
BLAKE2b-256 checksum How to use checksums |
69efd59edbb427614a5ed92097a9029d819667bf96fca0c1a4f7d9bc7095d286
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.
Transparency logRelease files / sharpearena-0.23.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | sharpearena-0.23.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
e34dbab2ef19c752ee4c39ac6d71d58ccee80cd03f27b7c5c3f4634008fad1c7
|
|
BLAKE2b-256 checksum How to use checksums |
e4149f5140c042f3b7acc6198f60b9b41d42ca01f5985f6b05f7ae9bde4dac01
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.
Transparency logRelease files / sharpearena-0.23.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | sharpearena-0.23.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
98909e689c56444ac11850e5a6a6bf2a375a3d075f3ba0e409337b98dd84a82a
|
|
BLAKE2b-256 checksum How to use checksums |
fa9feb431cb40ea086ebdd1590df3fc5e1a938727a9e3509333bcf8ac171f5d2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.
Transparency log
