[PR #14981] [CLOSED] feat: Add Homebrew formula for Open WebUI #62523

Closed
opened 2026-05-06 06:42:28 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/open-webui/pull/14981
Author: @cdamken
Created: 6/14/2025
Status: Closed

Base: mainHead: feature/homebrew-formula


📝 Commits (1)

  • 4118f12 feat: 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.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

# Install
cd path/to/open-webui/homebrew
brew install --formula ./open-webui.rb

# Verify
open-webui --help

# Run server
open-webui serve

Addresses multiple community requests for native Homebrew installation support.

Testing Instructions

To test this PR:

# 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

  • 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>
GiteaMirror added the pull-request label 2026-05-06 06:42:28 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/open-webui#62523