ANNE Wizard: The Essential ANNE Installation Suite

ANNE Wizard is a cross-platform installation suite that automates the setup of the ANNE ecosystem. It manages dependency installation, database configuration with a pre-imported chain snapshot, desktop shortcuts, and more, all within a single graphical wizard.

Features

• Easy installation of ANNE Node, ANNE Hasher, and ANNE Miner.
• Automated dependency handling (Java, MariaDB) using native package managers (apt/dnf/pacman)
• Datachain snapshot import – downloads and imports the latest chain snapshot into MariaDB.
• Automatic configuration – sets up node.properties, miner settings (config.yaml), and desktop/menu shortcuts.
• Cross‑platform – runs on any Linux (GLIBC 2.35+), and macOS 10.15+ (Catalina+), and Windows 10/11

*Please note that Linux platforms that do not use apt, dnf, or pacman do not support automated dependency handling for Java and MariaDB. On these systems, you will need to install Java and MariaDB manually. Once you have completed their installation, ANNE Wizard will be able to detect both, allowing you to use it to install your annode.

*If you prefer manual installation or your OS is headless, see the Installation Guide. It is intended for advanced users, those who want to learn what it takes to install ANNE manually, or anyone needing to run a headless annode on a server without a desktop environment.

Get Started with ANNE in Minutes

What the Wizard Does For You

• Install ANNE for the first time – complete setup from scratch.
• Upgrade existing installations – run the wizard again to update ANNE Node, Hasher, and Miner to the latest versions. Your existing configuration and keys will be preserved.
• Re-import the chain snapshot – if you need to reset your database or recover from an inconsistent database, run the wizard again and choose to re-import the snapshot (this will not affect your ANNE Node configuration and keys).
• Create another instance – run the wizard in a different directory to set up a second independent ANNE Node (e.g., for testing or separate networks). Use the “Custom Install Location” option when available.

Note: Because ANNE Wizard is open‑source software distributed without a paid code‑signing certificate, Windows and macOS may show security warnings when you first run it. This is normal. The app is safe, and the warnings only appear because our build is not signed with a widely‑trusted certificate.

Download the Latest Release

Head over to the Releases page and download the installer for your operating system

Linux

Make sure the AppImage has executable permissions and open it from your file explorer.

macOS

Open the dmg and drag the app to your Applications folder, run it from there. If you get an unidentified developer warning, either change the settings under System Preferences > Security & Privacy > General > Allow applications downloaded from: to Anywhere or in a Terminal, OR strip the xattr com.apple.quarantine attribute from the downloaded file, like so:

cd /Applications
xattr -dr com.apple.quarantine "Anne Wizard.app"

Alternatively, you can bypass the quarantine by downloading the app via Terminal, like so:

curl -L -o  anne-wizard-macos.zip https://github.com/annemedia/anne-wizard/releases/download/v1.1.0/anne-wizard-macos.zip

Windows

Run the exe, and if you get a warning "Windows Defender SmartScreen prevented an unrecognized app from starting. Running this app might put your PC at risk.", click on More info and Run anyway.

Alternatively, you can avert the SmartScreen by downloading the app via PowerShell, like so:

curl -o  anne-wizard-windows.zip https://github.com/annemedia/anne-wizard/releases/download/v1.1.0/anne-wizard-windows.zip

or Command Prompt:

curl -L -o  anne-wizard-windows.zip https://github.com/annemedia/anne-wizard/releases/download/v1.1.0/anne-wizard-windows.zip

What Happens When You Run the Wizard Again?

• If your installation folder (e.g., ~/ANNE or C:\Program Files\ANNE) still exists and contains the encrypted node.properties file, the wizard will skip the configuration pages (the ones where you generate your keys for ANNE Node and ANNE Miner). It will simply update the binaries and snapshots without touching your existing identities.
• If you delete the installation folder (or choose a new empty folder), the wizard treats it as a fresh install and will show all configuration pages, allowing you to create new keys.

After Installation

• Start ANNE Node from the desktop or start menu shortcut.
• Once synced, open your browser to http://localhost:12126/TheBridge.html to access purely peer-to-peer E2E2 BASED messenger, GhostTab, Coupons, Numiner, Booty Miner Swaps, Market, Midmanne, or http://localhost:12126/ANNE.html to access the hypergraph explorer, neuron builders, ANNE worldview collab, and dossier views. You can also explore a 3js app at http://localhost:12126/annexapp.html and check out feelz explore, annex and revelatian.
• To mine, run ANNE Hasher to plot your drives, then start ANNE Miner.

Building ANNE Wizard from source

Prerequisites

To build ANNE Wizard from source you need:

• CMake (3.20 or later)
• Qt6 (6.10.1 recommended) with the following components:
  • Core
  • Widgets
  • Network
  • Qml
  • Concurrent
  • DBus
• A C++17 compiler (MinGW (recommended), MSVC, GCC, Clang)
• Ninja (optional)

General CMake Build

git clone https://github.com/annemedia/anne-wizard.git
cd anne-wizard
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

The executable will be placed in build/annewizard

Platform‑Specific Instructions

Get QT Online Instaler or see setup.sh provided in the repository.

Linux (AppImage)

Use the provided script build_linux.sh (adjust paths)

Get:

• linuxdeployqt – linuxdeployqt or
• appimagetool – appimagetool , or both.

macOS (DMG)

Use the provided script build_mac.sh (adjust paths)

Windows

Dynamic Build

# Ensure Qt6 is in PATH or set QT6_DIR
$env:QT6_DIR = "C:\Qt\6.10.1\mingw_64"   # adjust to your Qt installation
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build
# Deploy Qt libraries
C:\Qt\6.10.1\mingw_64\bin\windeployqt.exe build\annewizard.exe

Static Build

Build a static Qt6, see instructions in build_windows file provided in the repository (adjust paths)

Contributing

We welcome contributions! You can help by:

• Reporting bugs or suggesting features via GitHub Issues
• Submitting pull requests for bug fixes or improvements
• Improving documentation
• Adding translations

For discussions, join our community at ANNE Forum.

Limitations

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Acknowledgements & Attribution

This application is licensed under CC0 1.0 Universal. It uses the Qt framework under the terms of the GNU Lesser General Public License, version 3 (LGPLv3).

• A copy of the LGPLv3 license is included in this repository as LICENSE.LGPLv3. For more information about Qt and its licensing, visit https://www.qt.io/licensing/ and Qt framework – qt.io

• linuxdeployqt – linuxdeployqt

• appimagetool – appimagetool

• ANNE Official – anne.network

• ANNE Media – anne.media

• The ANNE community – annetalk.org

      __/\__
. _   \\''//
-( )--/_||_\\
 .'.  \_()_/
  |    | . \
  |anne| .  \  
 .'.  ,\_____'.

  Power to the people.