Package Distribution
Installation and Distribution
Udility is distributed as a standard Python package via PyPI, allowing for streamlined integration into educational and research workflows. The distribution includes all necessary logic for interfacing with Llama-based models and rendering SVG content into high-quality imagery.
Installing via pip
The most efficient way to install the latest stable version of Udility is through the Python Package Index (PyPI):
pip install Udility
This command automatically resolves and installs the core library along with its required dependencies.
Core Dependencies
Udility relies on several specialized libraries to handle text-to-SVG generation and image rendering. These are automatically managed during the installation process:
| Dependency | Purpose |
| :--- | :--- |
| openai | Handles communication with the OpenRouter API and Llama-3.5 models. |
| cairosvg | Converts SVG scripts generated by the model into PNG format. |
| Pillow (PIL) | Used for image manipulation and processing. |
| matplotlib | Provides the interface for displaying generated illustrations in notebooks or scripts. |
[!NOTE] While
piphandles library dependencies,cairosvgmay require system-level C libraries (likelibcairo) depending on your operating system. Users on Linux or macOS may need to installcairovia their respective package managers (aptorbrew) if it is not already present.
System Requirements
To ensure optimal performance and compatibility, your environment should meet the following specifications:
- Python Version: Python 3.6 or higher.
- API Access: An active OpenRouter API key is required to facilitate communication with the Meta Llama 3.5 backend.
- Operating System: Cross-platform support (Windows, macOS, Linux).
Manual Installation (Development)
For users who wish to install the package directly from the source or contribute to its development, you can clone the repository and install it in editable mode:
git clone https://github.com/uditakhourii/Udility.git
cd Udility
pip install -e .
Versioning
Udility follows semantic versioning. You can verify your installed version using the following command:
import Udility
print(Udility.__version__) # Current stable version: 2.0