Metadata-Version: 2.4
Name: hojo-asr
Version: 0.1.2
Summary: HOJO ASR inference library
Author-email: HojoAI <develop@hojoai.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/HojoAI/Hojo-ASR
Project-URL: Repository, https://github.com/HojoAI/Hojo-ASR
Keywords: asr,speech-recognition,wenet,transformers
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: accelerate==1.12.0
Requires-Dist: huggingface_hub>=0.26.0
Requires-Dist: langid>=1.1.6
Requires-Dist: librosa>=0.11.0
Requires-Dist: numpy>=1.26.4
Requires-Dist: omegaconf>=2.3.0
Requires-Dist: onnx>=1.19.1
Requires-Dist: PyYAML>=6.0.3
Requires-Dist: requests>=2.32.5
Requires-Dist: safetensors>=0.7.0
Requires-Dist: scipy>=1.15.3
Requires-Dist: sentencepiece>=0.2.1
Requires-Dist: soundfile>=0.13.1
Requires-Dist: torch<2.6,>=2.5.1
Requires-Dist: torchaudio<2.6,>=2.5.1
Requires-Dist: tqdm>=4.67.1
Requires-Dist: transformers<5.0.0,>=4.57.3
Requires-Dist: openai-whisper>=20250625
Dynamic: license-file

# hojo-asr

HOJO ASR inference library

The bundled WeNet-derived code lives under `hojo_asr.wenet` (not the top-level
`wenet` package) to avoid import conflicts with the official WeNet project.

## Installation

```bash
pip install hojo-asr
```

Install from source for development:

```bash
cd inference/hojo_asr
pip install -e .
```

## Quick start

```python
from hojo_asr import HOJO_ASR

model = HOJO_ASR.load_model("/path/to/model_folder", device="cuda:0")
results = model.run_infer(["/path/to/audio.wav"], batch_size=1)

for item in results:
    print(item["key"], item["text"])
```

The model folder should contain:

- `merged_full_model.safetensors`
- `config.yaml`
- Subdirectories referenced in `config.yaml`

## Publish to PyPI

```bash
cd inference/hojo_asr
python -m pip install build twine
python -m build
twine upload dist/*
```

## Third-party notices

This package includes a trimmed subset of [WeNet](https://github.com/wenet-e2e/wenet)
(Apache License 2.0). Some modules are also derived from
[ESPnet](https://github.com/espnet/espnet) (Apache License 2.0).

See [NOTICE](NOTICE) for attribution and a summary of modifications to the
bundled code under `hojo_asr.wenet`. This package is **not** the official
WeNet distribution and does not install a top-level `wenet` module.

## License

Copyright 2026 HojoAI.

Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) and
[NOTICE](NOTICE) for details.
