ighoshsubho's picture
Update README.md
873c401 verified
---
license: apache-2.0
---
# LTX-Q8-Kernels Pre-built Wheel
This repository contains pre-built wheel files for the LTX-Q8-Kernels to avoid the need for building on SM89 instances with Python 3.11.
## Quick Install
Instead of building the kernels from source (which requires SM89 compute capability), you can directly install the pre-built wheel:
```bash
pip install https://huggingface.co/ModelsLab/LTX-Q8-Kernels-build-ada/resolve/main/q8_kernels-0.0.5-cp311-cp311-linux_x86_64.whl
```
## Requirements
- **Python**: 3.11
- **Platform**: Linux x86_64
- **CUDA**: Compatible CUDA installation
- **Architecture**: Built for Ada Lovelace (RTX 40 series) and compatible GPUs
## Usage
After installation, you can import and use the kernels in your LTX-Video projects:
```python
import q8_kernels
# Your LTX-Video code here
```
## Benefits
- **No SM89 Build Requirements**: Skip the complex build process that requires specific GPU compute capabilities
- **Faster Setup**: Direct installation without compilation time
- **Pre-optimized**: Built with optimal settings for Ada Lovelace architecture
## Compatibility
This wheel is specifically built for:
- **Python 3.11** (`cp311-cp311`)
- **Linux x86_64** systems
- **Ada Lovelace GPU architecture** (RTX 4090, RTX 4080, etc.)
## Alternative Installation Methods
### From Hugging Face Hub
```bash
# Using huggingface_hub
pip install huggingface_hub
python -c "from huggingface_hub import hf_hub_download; hf_hub_download(repo_id='ModelsLab/LTX-Q8-Kernels-build-ada', filename='q8_kernels-0.0.5-cp311-cp311-linux_x86_64.whl', local_dir='.')"
pip install q8_kernels-0.0.5-cp311-cp311-linux_x86_64.whl
```
### Download and Install
```bash
wget https://huggingface.co/ModelsLab/LTX-Q8-Kernels-build-ada/resolve/main/q8_kernels-0.0.5-cp311-cp311-linux_x86_64.whl
pip install q8_kernels-0.0.5-cp311-cp311-linux_x86_64.whl
```
## Troubleshooting
If you encounter issues:
1. **Verify Python version**: `python --version` should show 3.11.x
2. **Check platform**: This wheel only works on Linux x86_64
3. **CUDA compatibility**: Ensure you have a compatible CUDA installation
4. **GPU support**: Verify your GPU supports the required compute capability
## Building from Source (Alternative)
If you need to build from source or for different architectures, refer to the main [LTX-Video repository](https://github.com/Lightricks/LTX-Video) for build instructions.
## Version Information
- **Package Version**: 0.0.5
- **Python**: 3.11
- **Platform**: linux_x86_64
- **Build Target**: Ada Lovelace (SM89)
## License
This package follows the same license as the original LTX-Video project.