Metadata-Version: 2.4
Name: hrx-solutions
Version: 0.3.0
Summary: Loom Serve application built on the HRX runtime
Author: The HRX Authors
License-Expression: MIT
Project-URL: Homepage, https://github.com/ROCm/hrx-solutions
Project-URL: Repository, https://github.com/ROCm/hrx-solutions
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# HRX Solutions

Worked solutions built on HRX (HIP Runtime eXtended), with runnable examples
and implementation guidebooks for humans and agents.

The current package provides Loom Serve for streaming LLM chat on AMD GPUs.
It includes native server and compatibility-checker executables, the Qwen
Loom source catalog, and the required ROCm runtime libraries. Model weights
are downloaded separately.

## Install

On Linux x86-64 with Python 3.9 or newer, preferably in a virtual environment:

```bash
python -m pip install hrx-solutions
loom-serve-setup --help
loom-serve-setup models pipelines
loom-serve-start --help
```

Inference requires a supported AMD GPU and driver. Follow the
[LLM serving walkthrough](https://github.com/ROCm/hrx-solutions/blob/main/docs/solutions/llm-serving.md)
for hardware coverage, checkpoint requirements, import and validation,
streaming chat, and Pi configuration.

## Learn more

- [Project overview](https://github.com/ROCm/hrx-solutions#readme)
- [Pipeline implementation guide](https://github.com/ROCm/hrx-solutions/blob/main/loom-pipeline/llm/README.md)
- [Release assets](https://github.com/ROCm/hrx-solutions/releases)
- [HRX platform](https://github.com/ROCm/hrx-system)

The Python launcher and packaging code are MIT licensed. Bundled native code,
pipeline sources, and ROCm libraries retain their upstream licenses and
notices. Model weights are not redistributed.
