Installation

MindSafe is designed to be portable and lightweight. You can either download a pre-built binary or compile it yourself to verify the source code.

Windows

1. Download the mindsafe-windows.zip from the Latest Releases.
2. Extract the .zip file to a folder of your choice.
3. Run mindsafe.exe to start the application.

Important

Since MindSafe is an independent open-source project, Windows SmartScreen may show a warning. You can click "More Info" > "Run Anyway" to proceed.

macOS (Universal)

Our macOS build is Universal, meaning it runs natively on both Intel and Apple Silicon (M1/M2/M3) chips.

1. Download mindsafe-macos.dmg or the .tar.gz archive.
2. Open the .dmg and drag MindSafe to your Applications folder.
3. If the app is blocked by Gatekeeper, go to System Settings > Privacy & Security and click Open Anyway.

Linux

1. Download mindsafe-linux.tar.gz.
2. Ensure you have the necessary runtime dependencies installed. On Debian/Ubuntu-based systems:

   sudo apt update
   sudo apt install libgtk-3-0 libssl3 libsqlite3-0
   

3. Extract the archive and run the mindsafe binary:

   tar -xzf mindsafe-linux.tar.gz
   ./mindsafe
   

Build from Source

If you wish to audit the code or build for a different architecture, follow these steps.

1. Prerequisites

You will need the Rust toolchain installed. If you don’t have it:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

2. Install System Dependencies

Depending on your OS, you may need specific development libraries:

• Linux (Ubuntu/Debian):

  sudo apt install libgtk-3-dev libssl-dev libsqlite3-dev pkg-config
  

• macOS: No additional dependencies required beyond Xcode Command Line Tools.
• Windows: Ensure you have the C++ Build Tools installed.

3. Clone and Build

# Clone the repository
git clone https://github.com/aryawork-com/MindSafe.git
cd mindsafe

# Build the release binary
cargo build --release

The compiled binary will be located in target/release/.

Verifying Authenticity

To ensure your download has not been tampered with, we provide SHA256 checksums for every release.

1. Download the SHA256SUMS.txt file from the release page.
2. Run the verification command in your terminal:
   • Linux/macOS: sha256sum -c SHA256SUMS.txt
   • Windows (PowerShell): Get-FileHash ./mindsafe-windows.zip (then compare with the text file).