Reading the repo
Reading the repo
How to install on Linux
Portable local AI studio for Windows, Linux, and macOS. Zero-setup GUI for Image Generation, GGUF LLMs, Text to Speech & Speech to Text
Fresh setup, read just now
Will it work on Linux?
The app is designed around single-file local models that can be loaded directly by the bundled backend engines.
| Model type | Supported | Put files in | Notes |
| :--- | :--- | :--- | :--- |
| Stable Diffusion 1.5 checkpoints | Yes | app/models/ | Best compatibility. Use .safetensors or .ckpt files. |
| SDXL checkpoints | Yes | app/models/ | Supported as single-file checkpoints. Requires more RAM/VRAM than SD 1.5. |
| Single-file SD/SDXL GGUF checkpoints | Limited | app/models/ | Only complete single-file checkpoints are supported. |
| OpenVINO image model folders | Intel NPU only | app/openvino-models/ | Download from the Model Manager after running the OpenVINO setup. |
| CoreML image models | Apple Silicon only | app/models/ | Requires macOS on Apple Silicon and the CoreML setup path. |
| Flux, HiDream, Hunyuan, Wan, Qwen Image, Z-Image workflows | No | N/A | These usually require separate diffusion, VAE, and text encoder files and are not one-click checkpoint loads in this app. |
| LoRA, ControlNet, VAE-only, text-encoder-only, or diffusion-only files | No | N/A | Companion files are not loaded as standalone image models. |
Known-good image models available from the Model Manager:
| Name | Filename | Type | Approx. size | Recommended use |
| :--- | :--- | :--- | :--- | :--- |
| Juggernaut XL v9 Lightning | Juggernaut_RunDiffusionPhoto2_Lightning_4Steps.safetensors | SDXL | 7.1 GB | High-quality photorealism on mid/high tier machines. |
| DreamShaper XL Lightning | DreamShaperXL_Lightning.safetensors | SDXL | 6.9 GB | General SDXL images, fantasy, renders, and illustration. |
| DreamShaper 8 | DreamShaper_8_pruned.safetensors | SD 1.5 | 2.1 GB | Faster, lower-memory image generation. |
| CyberRealistic V8 | CyberRealistic_V8_FP16.safetensors | SD 1.5 | 2.0 GB | Realistic SD 1.5 images and lower-memory systems. |
| Rev Animated | rev-animated-v1-2-2.safetensors | SD 1.5 | 2.0 GB | Stylized/anime SD 1.5 images. |
| LCM DreamShaper OpenVINO | OpenVINO/LCM_Dreamshaper_v7-fp16-ov | OpenVINO | 2.7 GB | Intel Core Ultra NPU test model. |
| Workspace | Supported model files | Put files in | Notes |
| :--- | :--- | :--- | :--- |
| Text Chat | .gguf llama.cpp models | app/llm-models/ | Use single-file GGUF chat/instruct models. Vision models may also require a matching mmproj file. |
| Speech-to-Text | whisper.cpp .bin models | app/speech-models/ | Use Whisper GGML/whisper.cpp model files. |
| Text-to-Speech | Kokoro .json manifests and model assets | app/tts-models/ / app/tts-runtime/ | Use the built-in Kokoro setup and Model Manager entries. |
[!NOTE] Linux release binaries are built for Ubuntu 24.04-era systems and require
glibc 2.38+plusGLIBCXX_3.4.32+. On older Ubuntu/Debian VMs, a model such as CyberRealistic may be valid but the backend can still fail before loading it. Upgrade the VM OS or build the backend from source.
Ensure you have a modern web browser installed. Follow the quick guide below for your platform:
windows.bat.
[!NOTE] On the first run, the script will automatically download a portable Node.js runtime and configure pre-compiled GPU/CPU backend binaries.
.safetensors, .gguf, or .ckpt weights into app/models/ (or download them via the Model Manager tab in the UI).http://localhost:1420 in your browser, select your model, and write a prompt.chmod +x linux.sh
./linux.sh.
./linux.sh --max-perf to add the ROCm backend (~1.3 GB download)../linux.sh --setup-openvino to configure Intel NPU support (requires Intel Linux NPU driver).app/models/ or download them via the Model Manager tab.http://localhost:1420 in your browser.chmod +x mac.sh
./mac.sh.
[!IMPORTANT] The prebuilt macOS backend is optimized for Apple Silicon (M1 or newer) and uses Metal GPU acceleration. (macOS Intel hardware is completely unsupported).
app/models/ or download them via the Model Manager tab.http://localhost:1420 in your browser.Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Compare yours with the README's “Supported Models” list above before installing anything.
git clone https://github.com/techjarves/Portable-Local-Studio.git cd Portable-Local-Studio
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
chmod +x linux.sh chmod +x mac.sh
No reports for Linux yet.
Opens a chat with this manual already filled in, for Linux. It uses your own account; gitmanual sends nothing.