Reason

Own your social network

Reason is a decentralized social platform where you own your data. Built on the Wish P2P stack, it connects you directly to friends without central servers. Share posts, images, and videos - all encrypted and stored on your devices.

Reason serves as an example application demonstrating the Wish Model - an architecture for building distributed apps with identity at the foundation.

Download

macOS

Architecture	Download
Apple Silicon (M1/M2/M3)	Reason-0.1.19-arm64.dmg
Intel	Reason-0.1.19.dmg

Requirements: macOS 12 (Monterey) or later

Linux

Format	Download
AppImage	Reason-0.1.19.AppImage
Debian	reason-desktop_0.1.19_amd64.deb

Note on unsigned builds

These builds are currently unsigned. On macOS, you may need to right-click and select "Open" to bypass Gatekeeper. On Linux, you may need to mark the AppImage as executable: chmod +x Reason-*.AppImage

Build from Source

Prerequisites

macOS:

• Xcode Command Line Tools: xcode-select --install
• CMake: brew install cmake

Linux (Debian/Ubuntu):

sudo apt install build-essential cmake

Linux firewall: Nearby discovery uses UDP broadcast. If nearby peers aren't visible, allow UDP on your firewall.

Build and Run

git config --global credential.helper cache
git clone --recurse-submodules https://git.wishtech.fi/wish-stack

# Terminal 1: Start Wish (p2p networking layer)
cd wish-stack/apps/wish
./run-wish-desktop.sh

# Terminal 2: Start Reason (connects to Wish)
cd wish-stack/apps/reason
./run-reason-desktop.sh

First run builds wish-core (C), installs dependencies, and starts both apps. Reason requires Wish to be running.