| Name | optimum-rbln JSON |
| Version |
0.8.2
JSON |
| download |
| home_page | None |
| Summary | Optimum RBLN is the interface between the HuggingFace Transformers and Diffusers libraries and RBLN accelerators. It provides a set of tools enabling easy model loading and inference on single and multiple rbln device settings for different downstream tasks. |
| upload_time | 2025-07-31 06:23:23 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | <3.13,>=3.9 |
| license | None |
| keywords |
atom
diffusers
inference
rbln
rebel
transformers
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Optimum RBLN
<div align="center">
<img src="assets/rbln_logo.png" width="60%"/>
[](https://badge.fury.io/py/optimum-rbln)
[](https://github.com/rebellions-sw/optimum-rbln/blob/main/LICENSE)
[](https://docs.rbln.ai/software/optimum/optimum_rbln.html)
[](CODE_OF_CONDUCT.md)
</div>
🤗 Optimum RBLN provides an interface between HuggingFace libraries ([Transformers](https://huggingface.co/docs/transformers), [Diffusers](https://huggingface.co/docs/diffusers/index)) and RBLN NPUs, including [ATOM](https://rebellions.ai/rebellions-product/rbln-ca25/) and [REBEL](https://rebellions.ai/rebellions-product/rebel/).
This library enables seamless integration between the HuggingFace ecosystem and RBLN NPUs through a comprehensive toolkit for model loading and inference across single and multi-NPU environments. While we maintain a list of [officially validated models and tasks](https://docs.rbln.ai/software/optimum/optimum_rbln.html), users can easily adapt other models and tasks with minimal modifications.
## Key Features
🚀 **High Performance Inference**
- Optimized model execution on RBLN NPUs through RBLN SDK compilation
- Support for both single and multi-NPU inference
- Integrated with RBLN Runtime for optimal performance
🔧 **Easy Integration**
- Seamless compatibility with HuggingFace Model Hub
- Drop-in replacement for existing HuggingFace pipelines
- Minimal code changes required for NPU acceleration
## Seamless Replacement for Existing HuggingFace Code
```diff
- from diffusers import StableDiffusionXLPipeline
+ from optimum.rbln import RBLNStableDiffusionXLPipeline
# Load model
model_id = "stabilityai/stable-diffusion-xl-base-1.0"
prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k"
- pipe = StableDiffusionXLPipeline.from_pretrained(model_id)
+ pipe = RBLNStableDiffusionXLPipeline.from_pretrained(model_id, export=True)
# Generate image
image = pipe(prompt).images[0]
# Save image result
image.save("image.png")
+ # (Optional) Save compiled artifacts to skip the compilation step in future runs
+ pipe.save_pretrained("compiled_sdxl")
```
## Documentation
Check out [the documentation of Optimum RBLN](https://docs.rbln.ai/software/optimum/optimum_rbln.html) for more advanced usage.
## Getting Started
> **Note:** The `rebel-compiler` library, which is required for running `optimum-rbln`, is only available for approved users. Please refer to the [installation guide](https://docs.rbln.ai/getting_started/installation_guide.html) for instructions on accessing and installing `rebel-compiler`.
### Install from PyPI
To install the latest release of this package:
```bash
pip install optimum-rbln
# CPU-only installation (recommended if you don't plan to use CUDA-enabled PyTorch)
pip install optimum-rbln --extra-index-url https://download.pytorch.org/whl/cpu
```
### Install from source
#### Prerequisites
- Install [uv](https://docs.astral.sh/uv/) (refer to [this link](https://docs.astral.sh/uv/getting-started/installation/) for detailed commands)
The below command installs `optimum-rbln` along with its dependencies.
```bash
git clone https://github.com/rebellions-sw/optimum-rbln.git
cd optimum-rbln
./scripts/uv-sync.sh
```
### Need Help?
- Join discussions and get answers in our [Developer Community](https://discuss.rebellions.ai/)
- Contact maintainers at [support@rebellions.ai](mailto:support@rebellions.ai)
Raw data
{
"_id": null,
"home_page": null,
"name": "optimum-rbln",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.9",
"maintainer_email": null,
"keywords": "atom, diffusers, inference, rbln, rebel, transformers",
"author": null,
"author_email": "\"Rebellions Inc.\" <support@rebellions.ai>",
"download_url": "https://files.pythonhosted.org/packages/ee/ac/9da27c24884711a696d9777dcb485acb48e3a1ee94e610343d44d5de0c1d/optimum_rbln-0.8.2.tar.gz",
"platform": null,
"description": "\n# Optimum RBLN\n\n<div align=\"center\">\n\n<img src=\"assets/rbln_logo.png\" width=\"60%\"/>\n\n[](https://badge.fury.io/py/optimum-rbln)\n[](https://github.com/rebellions-sw/optimum-rbln/blob/main/LICENSE)\n[](https://docs.rbln.ai/software/optimum/optimum_rbln.html)\n[](CODE_OF_CONDUCT.md)\n\n\n</div>\n\n\ud83e\udd17 Optimum RBLN provides an interface between HuggingFace libraries ([Transformers](https://huggingface.co/docs/transformers), [Diffusers](https://huggingface.co/docs/diffusers/index)) and RBLN NPUs, including [ATOM](https://rebellions.ai/rebellions-product/rbln-ca25/) and [REBEL](https://rebellions.ai/rebellions-product/rebel/).\n\nThis library enables seamless integration between the HuggingFace ecosystem and RBLN NPUs through a comprehensive toolkit for model loading and inference across single and multi-NPU environments. While we maintain a list of [officially validated models and tasks](https://docs.rbln.ai/software/optimum/optimum_rbln.html), users can easily adapt other models and tasks with minimal modifications.\n\n## Key Features\n\n\ud83d\ude80 **High Performance Inference**\n- Optimized model execution on RBLN NPUs through RBLN SDK compilation\n- Support for both single and multi-NPU inference\n- Integrated with RBLN Runtime for optimal performance\n\n\ud83d\udd27 **Easy Integration**\n- Seamless compatibility with HuggingFace Model Hub\n- Drop-in replacement for existing HuggingFace pipelines\n- Minimal code changes required for NPU acceleration\n\n\n## Seamless Replacement for Existing HuggingFace Code\n\n```diff\n- from diffusers import StableDiffusionXLPipeline\n+ from optimum.rbln import RBLNStableDiffusionXLPipeline\n\n# Load model\nmodel_id = \"stabilityai/stable-diffusion-xl-base-1.0\"\nprompt = \"Astronaut in a jungle, cold color palette, muted colors, detailed, 8k\"\n- pipe = StableDiffusionXLPipeline.from_pretrained(model_id)\n+ pipe = RBLNStableDiffusionXLPipeline.from_pretrained(model_id, export=True)\n\n# Generate image\nimage = pipe(prompt).images[0]\n\n# Save image result\nimage.save(\"image.png\")\n\n+ # (Optional) Save compiled artifacts to skip the compilation step in future runs\n+ pipe.save_pretrained(\"compiled_sdxl\")\n```\n\n## Documentation\n\nCheck out [the documentation of Optimum RBLN](https://docs.rbln.ai/software/optimum/optimum_rbln.html) for more advanced usage.\n\n## Getting Started\n\n> **Note:** The `rebel-compiler` library, which is required for running `optimum-rbln`, is only available for approved users. Please refer to the [installation guide](https://docs.rbln.ai/getting_started/installation_guide.html) for instructions on accessing and installing `rebel-compiler`.\n\n### Install from PyPI\n\nTo install the latest release of this package:\n```bash\npip install optimum-rbln\n\n# CPU-only installation (recommended if you don't plan to use CUDA-enabled PyTorch)\npip install optimum-rbln --extra-index-url https://download.pytorch.org/whl/cpu\n```\n\n### Install from source\n\n#### Prerequisites\n\n- Install [uv](https://docs.astral.sh/uv/) (refer to [this link](https://docs.astral.sh/uv/getting-started/installation/) for detailed commands)\n\nThe below command installs `optimum-rbln` along with its dependencies.\n\n```bash\ngit clone https://github.com/rebellions-sw/optimum-rbln.git\ncd optimum-rbln\n./scripts/uv-sync.sh\n```\n\n### Need Help?\n\n- Join discussions and get answers in our [Developer Community](https://discuss.rebellions.ai/)\n- Contact maintainers at [support@rebellions.ai](mailto:support@rebellions.ai)\n",
"bugtrack_url": null,
"license": null,
"summary": "Optimum RBLN is the interface between the HuggingFace Transformers and Diffusers libraries and RBLN accelerators. It provides a set of tools enabling easy model loading and inference on single and multiple rbln device settings for different downstream tasks.",
"version": "0.8.2",
"project_urls": {
"Documentation": "https://docs.rbln.ai",
"Homepage": "https://rebellions.ai",
"Repository": "https://github.com/rebellions-sw/optimum-rbln"
},
"split_keywords": [
"atom",
" diffusers",
" inference",
" rbln",
" rebel",
" transformers"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "32eb6784c3d48a53146b371334d7dfe6fa3597d61f31a30b2e62cf2971f59805",
"md5": "30cf122fedbab6067d4c188730440217",
"sha256": "caf4c90a7761c981aef6ac43e88cf967dd7f3b9cbb683c4249fd9a8547983526"
},
"downloads": -1,
"filename": "optimum_rbln-0.8.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "30cf122fedbab6067d4c188730440217",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.9",
"size": 410901,
"upload_time": "2025-07-31T06:23:21",
"upload_time_iso_8601": "2025-07-31T06:23:21.698632Z",
"url": "https://files.pythonhosted.org/packages/32/eb/6784c3d48a53146b371334d7dfe6fa3597d61f31a30b2e62cf2971f59805/optimum_rbln-0.8.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "eeac9da27c24884711a696d9777dcb485acb48e3a1ee94e610343d44d5de0c1d",
"md5": "4f334c66254b5380cf6be2213234d79b",
"sha256": "e0cee81f3dbdc9defa1847fc6d72a1bdde290da9b067d069dc84cc024a619f3e"
},
"downloads": -1,
"filename": "optimum_rbln-0.8.2.tar.gz",
"has_sig": false,
"md5_digest": "4f334c66254b5380cf6be2213234d79b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.9",
"size": 394628,
"upload_time": "2025-07-31T06:23:23",
"upload_time_iso_8601": "2025-07-31T06:23:23.948526Z",
"url": "https://files.pythonhosted.org/packages/ee/ac/9da27c24884711a696d9777dcb485acb48e3a1ee94e610343d44d5de0c1d/optimum_rbln-0.8.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-31 06:23:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rebellions-sw",
"github_project": "optimum-rbln",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "optimum-rbln"
}
