English · 简体中文
AC-Prof profiles containerized AI model inference across CPU, memory, GPU, and input-size configurations. It prepares Docker runtimes, mounts shared model weights read-only, and produces reproducible measurements and analysis artifacts. Compatible models can be profiled without changing their code.
What AC-Prof does
| Capability | Description |
|---|---|
| Performance and resources | Application latency, throughput, CPU and memory usage; GPU metrics when available |
| Full profiling | Energy, packet-level timing, CPU hardware counters, and optional independent profilers |
| Reproducible experiments | Input and environment metadata, layered CSV results, plots, and reports |
AC-Prof supports text, vision, audio, time series, diffusion, multimodal, and structured-data workloads when the model meets the supported task interfaces. A task label alone does not guarantee that every checkpoint will run.
Quick start
Install the latest published release with uv and launch the interactive terminal interface:
uv tool install acprof
acprof tui
Until the package is available on PyPI, install the verified v0.2.0 wheel from GitHub Releases instead:
uv tool install https://github.com/kainam15/AC-Prof/releases/download/v0.2.0/acprof-0.2.0-py3-none-any.whl
acprof tui
See the installation guide for download checksums and the standalone Linux binary.
Collection requires a suitable Linux host with a local Docker Engine and cgroup v2. Native Linux x86_64 is the FULL measurement platform; WSL2 has limited basic/PARTIAL support. See host requirements.
Develop from source
To contribute or work on the latest source code, clone the repository and let uv prepare the editable project and development tools:
git clone https://github.com/kainam15/AC-Prof.git
cd AC-Prof
uv sync
uv run acprof tui
uv sync creates and updates this checkout's .venv; no manual activation is needed. Each Git worktree has its own environment and shares uv's download cache. Ordinary release users continue to use uv tool install acprof and acprof tui.
See developer setup and testing for the full workflow.
Current source builds reuse verified model images automatically and build missing ones. Use --rebuild-image or the TUI's advanced image options for a one-time rebuild; Docker cache may still be used. See image preparation.
The TUI tracks collection and probe progress through structured events. After a collection exits, it verifies the saved experiment identity and audits the result before reporting success; a successful process exit alone is insufficient.
Documentation
| Goal | Guide |
|---|---|
| Prepare the host, run a first CPU experiment, or inspect results | Installation and experiments |
| Understand the terminal interface | TUI user guide |
| Use command-line options and tools | CLI reference |
| Interpret metrics, CSV layers, and reports | Metrics and results |
| Understand supported models and runtimes | Runtime compatibility |
| Develop or contribute to AC-Prof | Developer installation, architecture, testing |
All documentation · Troubleshooting
Contributing and security
See CONTRIBUTING.md for development and review practices, and SECURITY.md for confidential vulnerability reporting and the third-party model trust boundary.
License and origins
Project code is licensed under Apache-2.0. Bundled LibriSpeech audio retains CC-BY-4.0; model code and weights have their own licenses. AC-Prof is part of the DOR project at JNU DISTINT. See NOTICE and project origins.
1 maintainer
Metadata
1 maintainer
Release files for acprof 0.3.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 | Provenance | |
|---|---|---|---|---|
| acprof-0.3.0.tar.gz | 3.0 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| acprof-0.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 6.1 MB
Release files / acprof-0.3.0.tar.gz
| Download URL | acprof-0.3.0.tar.gz |
|---|---|
| Size | 3.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c983c337ba8d2e7f173ba11f5cac1896c83be61b27bc59a584a8ce804f35db2f
|
|
BLAKE2b-256 checksum How to use checksums |
e7af8f24dd6298f955f7114d62182712ca4fe34fa06bed226eaaccd923ba19b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Oct 25, 2026.
Transparency logRelease files / acprof-0.3.0-py3-none-any.whl
| Download URL | acprof-0.3.0-py3-none-any.whl |
|---|---|
| Size | 3.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b4e344fcab04379ee172a153dac4807f25352a0d54b71331d23f5d17dd40a35f
|
|
BLAKE2b-256 checksum How to use checksums |
f8f747b4615d0fc6f3370199198b395ec8d638686e434e59b892daeccae4a88a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Oct 25, 2026.
Transparency logSecurity for acprof 0.3.0
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for acprof-0.3.0.tar.gz
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 Oct 25, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
