Skip to content

Homebrew distribution for LocalCoworkΒ #52

@pierretokns

Description

@pierretokns

Hi Liquid AI team! πŸ‘‹

First off β€” LocalCowork is a fantastic showcase of what LFM2-24B-A2B can do locally. The tool-calling accuracy at sub-second latency is genuinely impressive, and the MCP server architecture is really well thought out.

I'd love to help make LocalCowork easier for people to install. Right now, getting it running requires cloning the repo and installing Node.js, Python 3.12, Rust, Tauri CLI, and several MCP server dependencies manually. That's a lot of friction for someone who just wants to try a local AI agent.

Proposal: Homebrew distribution

Homebrew is the standard way macOS users install software. A brew install --cask localcowork that handles all dependencies would make this much more accessible.

What I've done so far

  1. CI/CD for macOS releases β€” PR Add CI/CD for LocalCowork macOS releases (.dmg)Β #51 adds a GitHub Actions workflow that builds LocalCowork as .dmg installers for arm64 and x86_64, triggered by version tags. Both architectures build and produce working artifacts.

  2. Community Homebrew tap β€” I've set up pierretokns/homebrew-localcowork as a proof of concept. It:

    • Installs llama.cpp, node@22, python@3.12, and tesseract as dependencies
    • Restricts to Apple Silicon only (per the PRD's hardware requirements)
    • Requires macOS 12+ (per tauri.conf.json)
    • Shows model download instructions (LiquidAI/LFM2-24B-A2B-GGUF / LFM2-24B-A2B-Q4_K_M.gguf) and hardware requirements in post-install caveats

What would be needed for official Homebrew (brew.sh)

To get LocalCowork into the official homebrew-cask repository, two things are required:

  1. Signed macOS builds β€” The .dmg must be signed with an Apple Developer ID for Gatekeeper. Homebrew rejects unsigned apps. This would mean adding APPLE_CERTIFICATE, APPLE_CERTIFICATE_PASSWORD, APPLE_ID, and APPLE_TEAM_ID secrets to the CI workflow and configuring Tauri's code signing.

  2. Notability threshold β€” Homebrew requires 75+ GitHub stars, 30+ forks, and 30+ watchers. LocalCowork is new, but given the interest in local AI agents, this should come naturally.

How you could help

  • Review PR Add CI/CD for LocalCowork macOS releases (.dmg)Β #51 β€” the CI/CD workflow is ready to merge and would enable tagged releases
  • Consider code signing β€” if you have an Apple Developer ID, adding signing secrets to the repo would unblock official Homebrew distribution
  • Publish releases β€” even unsigned releases would let the community tap work immediately

Happy to help iterate on any of this. The community tap is functional today β€” anyone can run brew tap pierretokns/localcowork && brew install --cask localcowork right now using the builds from my fork.

Thank you for open-sourcing LocalCowork!

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions