ExpMan Python Wrapper
The expman Python package provides a seamless, idiomatic interface for logging experiments in Python projects while leveraging the high-performance Rust core.
Key Features
- Idiomatic Python: Uses context managers and singletons for clean integration into scripts and notebooks.
- Fast Logging: Native calls to the Rust engine ensure sub-microsecond logging latency.
- Automatic Cleanup: Ensures all file handles are closed and data is flushed upon script completion.
- TensorBoard Drop-in: Replace
from torch.utils.tensorboard import SummaryWriterwithfrom expman import SummaryWriter.
Installation
pip install expman-rs
Basic Usage
Global Singleton
import expman as exp
exp.init("my_model")
exp.log_vector({"loss": 0.42})
Context Manager
from expman import Experiment
with Experiment("my_model") as exp:
exp.log_vector({"loss": 0.42})
TensorBoard SummaryWriter (Drop-in Replacement)
Replace your existing TensorBoard import with expman's drop-in replacement. All metrics are stored in expman's high-performance Parquet format instead of TensorBoard event files.
# Before:
# from torch.utils.tensorboard import SummaryWriter
# After:
from expman import SummaryWriter
writer = SummaryWriter(log_dir="runs/my_experiment")
for epoch in range(100):
loss = 1.0 / (epoch + 1)
writer.add_scalar("train/loss", loss, epoch)
writer.add_scalars("metrics", {"accuracy": 0.95, "f1": 0.92}, 100)
writer.add_hparams({"lr": 0.001, "batch_size": 32}, {"hparam/accuracy": 0.95})
writer.close()
Supported methods:
| Method | Status | Notes |
|---|---|---|
add_scalar |
✅ Full | Logs as expman vector metric |
add_scalars |
✅ Full | Auto-prefixes tags with main_tag |
add_text |
✅ Full | Logged as info message |
add_hparams |
✅ Full | Logs params + initial metrics |
flush |
✅ No-op | Expman auto-flushes asynchronously |
close |
✅ Full | Graceful shutdown |
add_histogram |
⚠️ Stub | No-op, won't raise errors |
add_image/images |
⚠️ Stub | No-op, won't raise errors |
add_figure |
⚠️ Stub | No-op, won't raise errors |
add_video |
⚠️ Stub | No-op, won't raise errors |
add_audio |
⚠️ Stub | No-op, won't raise errors |
add_graph |
⚠️ Stub | No-op, won't raise errors |
add_embedding |
⚠️ Stub | No-op, won't raise errors |
add_pr_curve |
⚠️ Stub | No-op, won't raise errors |
add_custom_scalars |
⚠️ Stub | No-op, won't raise errors |
add_mesh |
⚠️ Stub | No-op, won't raise errors |
Internal Architecture
The wrapper uses PyO3 to create native Python extension modules that link directly to the Rust expman library.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file expman_rs-1.0.1-cp39-abi3-win_amd64.whl.
File metadata
- Download URL: expman_rs-1.0.1-cp39-abi3-win_amd64.whl
- Upload date:
- Size: 7.2 MB
- Tags: CPython 3.9+, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
615892055edcfe5322fe2d5259f1c9dac3f1070c3ef3fb23b11ae03356498b8e
|
|
| MD5 |
ba07b302c767be4d91a99b66e57e6b8d
|
|
| BLAKE2b-256 |
927680d6218b01a3f3c963418a929675da4bc27f6f9bdf81dfa901cefbd08ba7
|
File details
Details for the file expman_rs-1.0.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: expman_rs-1.0.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 7.8 MB
- Tags: CPython 3.9+, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a7f4a62edbbf15e85c963561eb1a254c12fbcf98302ada54d3a69b3f0c4d5a93
|
|
| MD5 |
6a01d4ce2a0e2e295a72118ee4cd2c48
|
|
| BLAKE2b-256 |
1be5558d8b27461eb56b6cea2ff3a3f09b9cf07df67182e4348c15ce8e8b5df5
|
File details
Details for the file expman_rs-1.0.1-cp39-abi3-macosx_11_0_arm64.whl.
File metadata
- Download URL: expman_rs-1.0.1-cp39-abi3-macosx_11_0_arm64.whl
- Upload date:
- Size: 6.9 MB
- Tags: CPython 3.9+, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fa449fe5182e39d9c88dba31c79e3fa3ed038dc4dad8db2ef164cd2c30943186
|
|
| MD5 |
fead5e2dc620003aaa27d564a23da8f1
|
|
| BLAKE2b-256 |
bbb08231004d7bdc8b08c62c334e9c83c6f3927d6dcbf00231c335d68e1e7f65
|
