Metadata-Version: 2.4
Name: aihw-bench
Version: 2.0.0
Summary: A universal benchmarking and profiling framework for AI hardware, simulators, CPUs, GPUs, embedded AI platforms, and custom accelerators.
License: Apache-2.0
License-File: LICENSE
Keywords: benchmark,ai,hardware,profiling,pytorch,onnx,tflite,rtl,accelerator
Author: AIHW Bench Maintainers
Requires-Python: >=3.12
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Benchmark
Provides-Extra: all-backends
Provides-Extra: onnx
Provides-Extra: pytorch
Provides-Extra: tflite
Requires-Dist: jinja2 (>=3.1)
Requires-Dist: onnxruntime (>=1.18) ; extra == "all-backends"
Requires-Dist: onnxruntime (>=1.18) ; extra == "onnx"
Requires-Dist: pydantic (>=2.7)
Requires-Dist: pyyaml (>=6.0)
Requires-Dist: rich (>=13.7)
Requires-Dist: tflite-runtime (>=2.14) ; (platform_system != "Windows") and (extra == "tflite")
Requires-Dist: torch (>=2.3) ; extra == "all-backends"
Requires-Dist: torch (>=2.3) ; extra == "pytorch"
Requires-Dist: typer (>=0.12)
Project-URL: Changelog, https://github.com/aihw-bench/aihw-bench/blob/main/CHANGELOG.md
Project-URL: Documentation, https://aihw-bench.github.io/aihw-bench
Project-URL: Homepage, https://github.com/aihw-bench/aihw-bench
Project-URL: Issues, https://github.com/aihw-bench/aihw-bench/issues
Project-URL: Repository, https://github.com/aihw-bench/aihw-bench
Description-Content-Type: text/markdown

# AI Hardware Benchmark Suite

AI Hardware Benchmark Suite (`aihw-bench`) is an open-source Python framework for reproducible benchmarking and profiling of AI workloads across CPUs, supported GPUs, embedded targets, simulator-backed environments, and extensible hardware backends.

## Current Release

**v2.0.0** is feature complete. It provides the benchmark engine, reproducible official-suite contracts, hardware capability reporting, static reports and dashboards, local workspace/history foundations, and a deterministic **local benchmark analysis assistant**. The assistant is metric-grounded and is not an LLM-backed service.

Hardware detection, capability reporting, executable backends, and accelerated execution are distinct concepts. See the [hardware support guide](docs/developer-guide/hardware-support.md) before selecting a device target.

## CLI

```bash
aihw-bench benchmark
aihw-bench profile
aihw-bench compare
aihw-bench report
aihw-bench dashboard
aihw-bench suite list
aihw-bench assistant SESSION_ID
aihw-bench version
```

## Documentation

Start with [docs/index.md](docs/index.md). Key current guides:

- [Hardware support](docs/developer-guide/hardware-support.md)
- [Official benchmark suite](docs/benchmarks/official-suite.md)
- [Dashboard](docs/user-guide/dashboard.md)
- [Local benchmark analysis assistant](docs/user-guide/assistant.md)
- [Enterprise foundations](docs/enterprise.md)
- [Security policy](SECURITY.md)

## Development

This repository targets Python 3.12+ and uses Poetry-compatible PEP 621 metadata.

```bash
python -m pip install --upgrade pip
python -m pip install poetry
poetry install --with dev,docs
poetry run pytest
poetry run ruff check .
poetry run mypy src
```

## License

Apache License 2.0. See [LICENSE](LICENSE).

