Skip to content

docs(install): fix macOS Homebrew install to use official cask - #5152

Merged
senamakel merged 1 commit into
tinyhumansai:mainfrom
senamakel:docs/fix-homebrew-install
Jul 23, 2026
Merged

docs(install): fix macOS Homebrew install to use official cask#5152
senamakel merged 1 commit into
tinyhumansai:mainfrom
senamakel:docs/fix-homebrew-install

Conversation

@senamakel

Copy link
Copy Markdown
Member

The old instructions referenced brew tap tinyhumansai/core && brew install openhuman which doesn't work because no formula exists in that tap.

The correct approach is brew install --cask openhuman using the official Homebrew/homebrew-cask package.

Fixes #3692

The old instructions referenced 'brew tap tinyhumansai/core && brew install openhuman' which doesn't work because no formula exists in that tap. The correct approach is 'brew install --cask openhuman' using the official Homebrew/homebrew-cask package.

Fixes tinyhumansai#3692
@senamakel
senamakel requested a review from a team July 23, 2026 12:56
@coderabbitai

coderabbitai Bot commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

You’ve reached a temporary PR review limit under our Fair Usage Limits Policy.

Your recent review volume is higher than typical usage, so adaptive limits are currently applied.

Next review available in: 56 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 57b7870e-ccad-4b45-84da-7824c780a694

📥 Commits

Reviewing files that changed from the base of the PR and between 6459790 and 477886b.

📒 Files selected for processing (1)
  • INSTALL.md

Comment @coderabbitai help to get the list of available commands.

@senamakel
senamakel merged commit 5199757 into tinyhumansai:main Jul 23, 2026
21 checks passed
@greptile-apps

greptile-apps Bot commented Jul 23, 2026

Copy link
Copy Markdown

Greptile Summary

This PR fixes the macOS Homebrew install instructions in INSTALL.md, replacing a broken two-step tap-based command (brew tap tinyhumansai/core && brew install openhuman) with the single official cask command (brew install --cask openhuman).

  • The old tap name (tinyhumansai/core) appears to have been incorrect; the fix pointing users to the Homebrew Cask is a cleaner, officially-supported path for a Tauri desktop app.
  • One open question: .github/workflows/release-packages.yml still smoke-tests installation via brew tap tinyhumansai/openhuman && brew install openhuman (a different tap from the broken one), so it's worth confirming whether that tap is still maintained or should also be updated to use --cask.

Confidence Score: 5/5

Safe to merge — the change is confined to a single documentation file and corrects a broken install command.

The only changed file is INSTALL.md, which replaces a clearly non-functional tap reference with the official cask command. The sole follow-up worth tracking is whether the release-packages CI smoke test (which still uses a different tap) should also be migrated, but that does not block correctness of this doc fix.

No files require special attention; the optional follow-up is .github/workflows/release-packages.yml if the tinyhumansai/openhuman tap is also being retired in favour of the cask.

Important Files Changed

Filename Overview
INSTALL.md Replaces broken two-step tap install (tinyhumansai/core) with brew install --cask openhuman; a working tap (tinyhumansai/openhuman) referenced in CI is not addressed.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User wants to install OpenHuman on macOS] --> B{Install method}
    B -->|Old docs| C[brew tap tinyhumansai/core]
    C --> D[brew install openhuman]
    D --> E[❌ Fails — no formula in tap]
    B -->|New docs this PR| F[brew install --cask openhuman]
    F --> G[✅ Official Homebrew Cask]
    B -->|CI release-packages.yml| H[brew tap tinyhumansai/openhuman]
    H --> I[brew install openhuman]
    I --> J[⚠️ Still used in CI smoke test — not updated by this PR]
Loading

Reviews (1): Last reviewed commit: "docs(install): fix macOS Homebrew instal..." | Re-trigger Greptile

Comment thread INSTALL.md
Comment on lines +9 to 13
**macOS (Homebrew Cask):**

```bash
brew tap tinyhumansai/core
brew install openhuman
brew install --cask openhuman
```

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Docs and CI now describe two different install paths

The user-facing docs now recommend brew install --cask openhuman, but the release-packages CI workflow still verifies installation using brew tap tinyhumansai/openhuman && brew install openhuman (.github/workflows/release-packages.yml, lines 217–218). Notably, the tap referenced in CI is tinyhumansai/openhuman — not tinyhumansai/core as the old docs had — which suggests that tap may be a live, working formula rather than a broken one. If both paths work (tap formula and cask), the docs should probably pick one definitively; if the tap is also being deprecated, the CI smoke test should be updated to use brew install --cask openhuman to match.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Installation instruction via Homebrew not working

1 participant