Skip to content

Releases: SadhanaArivoli/neuravian

Release list

Neuravian v0.1.0 — Early Access

Neuravian v0.1.0 — Early Access Pre-release
Pre-release

Choose a tag to compare

View all tags
@SadhanaArivoli SadhanaArivoli released this 22 Jul 06:26
v0.1.0
413de61

Neuravian v0.1.0 — Early Access

A local-first desktop workspace for reproducible neuroimaging research.

What's included in this build (commit 0fb2ef8)

RC1 prerelease readiness fixes:

  • FreeSurfer recon-all integration — full recon-all pipeline manifest with 7-stage progress contract, preflight checks (CPU architecture, RAM, license, Docker image), and platform-aware container scheduling. On Apple Silicon the preflight correctly blocks local launches and directs users to cloud execution.
  • Platform hardcoding fix (P0) — docker_executor previously passed platform="linux/amd64" unconditionally on every container. Now only applied when the pipeline manifest declares required_architecture: x86_64 and the host is ARM64, eliminating silent QEMU emulation for native pipelines.
  • DB conflict surfacing (P0) — when both legacy neuroforge.db and canonical neuravian.db contain data, the conflict is now surfaced through /api/health and shown as a dismissible amber warning banner in the sidebar.
  • Health fetch timeout (P0) — fetchHealth now times out after 10 seconds with AbortSignal.timeout. useHealth exposes isLoading, isError, and isSuccess. The status badge has four distinct states: Connecting, Service error (amber), Ready (green), Backend offline (red).
  • Docker availability check — /api/health pings the Docker daemon on every call and returns docker_available: bool. A dismissible red banner appears in the sidebar if Docker is not running when the app starts.
  • Friendly Docker errors — ImageNotFound and APIError from the Docker SDK are now caught and re-raised as user-readable messages instead of raw Python tracebacks.
  • Local unit tests unblocked — pydantic Settings extra="ignore" lets the 31 backend unit tests run locally without requiring the Docker Compose environment.

Earlier in this release cycle:

  • Automatic migration of historical workspace sessions, run history, and offline metadata from NeuroForge
  • Generic per-user dataset root configuration and native folder pickers
  • Immutable commit-pinned Docker images in docker-compose.packaged.yml
  • AWS NeuroForge workspace visible in the selector after migration
  • Anatomy viewer NiiVue repaint fix on mode switch
  • Memory, listener, and abort-signal defect fixes
  • Docker-held port conflict detection and compose stderr capture
  • Unsupported cached Atlas run reporting

Supported platform

Apple Silicon Mac (arm64) — macOS 13 Ventura or later recommended.

Requirements

Docker Desktop for Mac must be installed and running before launching Neuravian.
The app starts its backend and frontend services as Docker containers on your local machine.
No internet connection is required after the initial Docker pull.

Download Docker Desktop: https://docs.docker.com/desktop/setup/install/mac-install/

Installation

  1. Download Neuravian-0.1.0-arm64.dmg
  2. Open the DMG and drag Neuravian into your Applications folder
  3. Start Docker Desktop and wait until it shows "Docker Desktop is running"
  4. Open Neuravian from Applications

First launch note: macOS may show a security warning because this release is not signed with an Apple Developer ID. To open it, right-click (or Control-click) Neuravian.app → Open → Open in the dialog that appears.

First-launch behavior

On first launch Neuravian will:

  1. Verify Docker Desktop is running
  2. Pull and start the backend and frontend containers (this may take a minute on the first run)
  3. Open the main interface in the Electron window

Subsequent launches are faster — containers restart immediately if they are already present.

Verify download integrity

shasum -a 256 Neuravian-0.1.0-arm64.dmg
shasum -a 256 Neuravian-0.1.0-arm64.zip

Expected hashes are in SHA256SUMS.txt.

84c7805d5282c6fb832875fbdd95830cbac95ccd38261502d57a8bee4673ae36  Neuravian-0.1.0-arm64.dmg
e3a37c7a2e045864fc15a4680b7a40cb3caf3ce07a6910a95df13cb3bfb25f14  Neuravian-0.1.0-arm64.zip

Known limitations

  • Unsigned release: no Apple Developer ID signing or notarization. macOS Gatekeeper will warn on first open. Use right-click → Open to bypass.
  • Apple Silicon only: Intel (x86_64) Mac builds are not included in this release.
  • Docker Desktop required: the app does not support Colima, Rancher Desktop, or other Docker runtimes in this release.
  • FreeSurfer / fMRIPrep on Apple Silicon: these pipelines require x86_64 Linux. The app correctly blocks local ARM64 launches with a clear preflight message; use the cloud/EC2 execution target instead.
  • Anatomy Viewer / Atlas Explorer: functional code is shipped but not execution-tested (requires a completed FreeSurfer or FastSurfer run).
  • Local-only: no cloud sync or multi-user features in v0.1.0.
  • Dataset root change requires restart: after changing the dataset root folder, restart Neuravian so Docker Compose mounts the new path.

Feedback and issues

Report bugs and feature requests at: https://github.com/SadhanaArivoli/neuravian/issues

License

Apache License 2.0 — see LICENSE in the repository.

Loading