Fungi App

April 19, 2026 · View on GitHub

The official graphical user interface for Fungi, built with Flutter.

On macOS, we recommend installing Fungi App through our Homebrew tap:

brew tap enbop/fungi
brew install --cask fungi-app

For the nightly channel instead:

brew tap enbop/fungi
brew install --cask fungi-app-nightly

Architecture

Fungi App communicates with the underlying fungi binary via gRPC. The app can start and stop an app-managed daemon, or connect to a compatible daemon that was already started by the user.

Versioning

Fungi App currently tracks the fungi core release line directly.

The app version should match the compatible core daemon version, for example 0.6.1.
UI-only repackaging or platform-specific release increments should use build metadata, for example 0.6.1+2.

Development

Prerequisites

Flutter SDK: Ensure you have the latest Flutter SDK installed.
Fungi Artifacts: download the matching core binary and proto:
```
scripts/fetch_core_artifacts.sh
```
Use --platform android for Android, or --platform all to prepare every packaged target. Artifacts are placed under fungi-artifacts/<channel>/<platform>/<arch>/.
macOS: If you're building on macOS, install CocoaPods (required for macOS Flutter plugins):
```
brew install cocoapods
pod setup
```

Code Generation

If you modify the .proto definitions, regenerate the Dart gRPC code:

# Install protoc_plugin
dart pub global activate protoc_plugin 21.1.2

# Update path
export PATH="$PATH:$HOME/.pub-cache/bin"

# Regenerate gRPC code
protoc --dart_out=grpc:lib/src/grpc/generated -Ifungi-artifacts fungi-artifacts/fungi_daemon.proto

Running the App

flutter pub get
flutter run

For Android development builds, select the nightly flavor:

flutter run --flavor nightly

Distribution Build

scripts/build_macos_dist.sh
scripts/build_linux_dist.sh
scripts/build_windows_dist.sh
scripts/build_android_dist.sh

Stable builds must opt in explicitly:

scripts/build_macos_dist.sh --channel stable