Virtual Environment Isolation: Creates isolated Python environment to avoid conflicts
Clean Installation/Uninstallation: Proper cleanup when removing
Homebrew Best Practices: Follows official Homebrew formula conventions
Comprehensive Testing: Automated test suite validates all functionality
🧪 Testing Results
All tests pass successfully:
✅Formula Syntax: Ruby syntax validation passes
✅Installation: Successfully installs Open WebUI v0.6.14 (2.6GB, 80,500 files)
✅CLI Functionality: All commands work (open-webui --help, open-webui serve, etc.)
✅Uninstallation: Clean removal of all files and dependencies
✅Reinstallation: Works perfectly after uninstallation
✅Homebrew Built-in Tests: Passes brew test open-webui
📦 Installation Details
Dependencies:
Runtime: Python 3.12
Build: Node.js 22
Python packages: ~98 packages installed automatically via pip
Installation Size: ~2.6GB (80,500 files)
🚀 Usage
# Installcd path/to/open-webui/homebrew
brew install --formula ./open-webui.rb
# Verify
open-webui --help
# Run server
open-webui serve
🔗 Related Issues
Addresses multiple community requests for native Homebrew installation support.
✅ Testing Instructions
To test this PR:
# Navigate to the homebrew directorycd homebrew
# Run comprehensive tests
./test-homebrew-formula.sh
The test script automatically validates:
Formula syntax
Installation process
CLI functionality
Uninstallation process
Reinstallation process
📝 Notes
This formula is ready for submission to the official Homebrew repository
All Python dependencies are managed automatically via pip in an isolated virtualenv
The formula follows Homebrew best practices and conventions
Clean installation and uninstallation tested extensively
🏷️ Type of Change
New feature (Homebrew formula)
Documentation updates
Testing improvements
📋 Checklist
Code follows project style guidelines
Self-review completed
Documentation updated
Tests added and passing
No breaking changes
Ready for review
🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.
## 📋 Pull Request Information
**Original PR:** https://github.com/open-webui/open-webui/pull/14981
**Author:** [@cdamken](https://github.com/cdamken)
**Created:** 6/14/2025
**Status:** ❌ Closed
**Base:** `main` ← **Head:** `feature/homebrew-formula`
---
### 📝 Commits (1)
- [`4118f12`](https://github.com/open-webui/open-webui/commit/4118f12a82f9ed858d059b103f4d06b76be80fdc) feat: Add Homebrew formula for Open WebUI
### 📊 Changes
**3 files changed** (+183 additions, -0 deletions)
<details>
<summary>View changed files</summary>
➕ `homebrew/README.md` (+83 -0)
➕ `homebrew/open-webui.rb` (+28 -0)
➕ `homebrew/test-homebrew-formula.sh` (+72 -0)
</details>
### 📄 Description
# Pull Request: Add Homebrew Formula for Open WebUI
## 📋 Summary
This PR adds a fully tested and working Homebrew formula for installing Open WebUI on macOS and Linux systems via Homebrew.
## 🎯 What's Added
### Files Added:
- **`homebrew/open-webui.rb`** - Main Homebrew formula for Open WebUI v0.6.14
- **`homebrew/test-homebrew-formula.sh`** - Comprehensive test script
- **`homebrew/README.md`** - Documentation and usage instructions
## ✅ Features
- **Automatic Dependency Management**: Handles Python 3.12, Node.js 22, and ~98 Python packages
- **Virtual Environment Isolation**: Creates isolated Python environment to avoid conflicts
- **Clean Installation/Uninstallation**: Proper cleanup when removing
- **Homebrew Best Practices**: Follows official Homebrew formula conventions
- **Comprehensive Testing**: Automated test suite validates all functionality
## 🧪 Testing Results
All tests pass successfully:
- ✅ **Formula Syntax**: Ruby syntax validation passes
- ✅ **Installation**: Successfully installs Open WebUI v0.6.14 (2.6GB, 80,500 files)
- ✅ **CLI Functionality**: All commands work (`open-webui --help`, `open-webui serve`, etc.)
- ✅ **Uninstallation**: Clean removal of all files and dependencies
- ✅ **Reinstallation**: Works perfectly after uninstallation
- ✅ **Homebrew Built-in Tests**: Passes `brew test open-webui`
## 📦 Installation Details
**Dependencies:**
- **Runtime**: Python 3.12
- **Build**: Node.js 22
- **Python packages**: ~98 packages installed automatically via pip
**Installation Size**: ~2.6GB (80,500 files)
## 🚀 Usage
```bash
# Install
cd path/to/open-webui/homebrew
brew install --formula ./open-webui.rb
# Verify
open-webui --help
# Run server
open-webui serve
```
## 🔗 Related Issues
Addresses multiple community requests for native Homebrew installation support.
## ✅ Testing Instructions
To test this PR:
```bash
# Navigate to the homebrew directory
cd homebrew
# Run comprehensive tests
./test-homebrew-formula.sh
```
The test script automatically validates:
1. Formula syntax
2. Installation process
3. CLI functionality
4. Uninstallation process
5. Reinstallation process
## 📝 Notes
- This formula is ready for submission to the official Homebrew repository
- All Python dependencies are managed automatically via pip in an isolated virtualenv
- The formula follows Homebrew best practices and conventions
- Clean installation and uninstallation tested extensively
---
## 🏷️ Type of Change
- [x] New feature (Homebrew formula)
- [x] Documentation updates
- [x] Testing improvements
## 📋 Checklist
- [x] Code follows project style guidelines
- [x] Self-review completed
- [x] Documentation updated
- [x] Tests added and passing
- [x] No breaking changes
- [x] Ready for review
---
<sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
📋 Pull Request Information
Original PR: https://github.com/open-webui/open-webui/pull/14981
Author: @cdamken
Created: 6/14/2025
Status: ❌ Closed
Base:
main← Head:feature/homebrew-formula📝 Commits (1)
4118f12feat: Add Homebrew formula for Open WebUI📊 Changes
3 files changed (+183 additions, -0 deletions)
View changed files
➕
homebrew/README.md(+83 -0)➕
homebrew/open-webui.rb(+28 -0)➕
homebrew/test-homebrew-formula.sh(+72 -0)📄 Description
Pull Request: Add Homebrew Formula for Open WebUI
📋 Summary
This PR adds a fully tested and working Homebrew formula for installing Open WebUI on macOS and Linux systems via Homebrew.
🎯 What's Added
Files Added:
homebrew/open-webui.rb- Main Homebrew formula for Open WebUI v0.6.14homebrew/test-homebrew-formula.sh- Comprehensive test scripthomebrew/README.md- Documentation and usage instructions✅ Features
🧪 Testing Results
All tests pass successfully:
open-webui --help,open-webui serve, etc.)brew test open-webui📦 Installation Details
Dependencies:
Installation Size: ~2.6GB (80,500 files)
🚀 Usage
🔗 Related Issues
Addresses multiple community requests for native Homebrew installation support.
✅ Testing Instructions
To test this PR:
The test script automatically validates:
📝 Notes
🏷️ Type of Change
📋 Checklist
🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.