HeyStat

HeyStat is a web-based statistical analysis platform, forked from jamovi.

About

HeyStat provides:

• ✅ Web-based statistical analysis (no installation required)
• ✅ Familiar interface for SPSS users
• ✅ Vietnamese-friendly deployment
• ✅ Educational focus for Vietnamese institutions

Built on jamovi 2.7.6 - See FORK_NOTICE.md for attribution.

Quick Access

🌐 Live Instance: https://heystat.truyenthong.edu.vn

Features

• Descriptive statistics, T-tests, ANOVA, regression
• Data visualization and plotting
• CSV/SPSS/SAS file import
• Real-time analysis updates
• R syntax generation

For Users

Access HeyStat

Visit: https://heystat.truyenthong.edu.vn

No installation required - works in any modern browser (Chrome, Firefox, Safari, Edge).

Documentation

• Based on jamovi - see jamovi user manual
• All jamovi analyses and features are available

For Developers

Quick Start with Docker

# Clone repository
git clone [your-repo-url]
cd HeyStat

# Build and run
docker-compose build
docker-compose up

Access at: http://127.0.0.1:42337

Development

Pre-requisites

• Python (3.8 or higher)
• pip
• Poetry
• Docker
• Docker Compose

Setup

Virtual Environment

Create a virtual environment using the following command:

poetry install

If poetry can't locate a Python executable with the correct version, ensure that you have the correct version installed and run these commands to force poetry to use it:

poetry env use PATH_TO_PYTHON_EXECUTABLE
poetry install

Usage

Deployment Configurations

HeyStat has been optimized for:

• Apple Silicon (ARM64) macOS deployment with Colima
• Web-based access via Cloudflare Tunnel
• Port configuration: 42337-42339 (avoids conflicts)
• Auto-start via LaunchDaemon

See deployment documentation:

• Mac Deployment Guide
• Auto-Start Configuration

Access Key for Security

HeyStat can be protected with an access key via JAMOVI_ACCESS_KEY environment variable.

• For local development: Set JAMOVI_ACCESS_KEY='' (empty) in docker-compose.yaml
• For production: Set a strong access key
• To disable for testing: Set JAMOVI_DISABLE_ACCESS_KEY=1 (NOT for production)

Activate the virtual environment

poetry shell

Developer section

Usage - Poetry

poetry shell  # to activate the virtual environment
poetry run COMMAND  # run a command in the venv without first activating it
poetry add DEPENDENCY  # add a production dependency
poetry add --group=dev DEVDEPENDENCY  # add a dev dependency
poetry add --group=GROUPNAME DEPENDENCY  # add a dependency to another group

poetry lock  # update the lock file
poetry install  # install dependencies from the lock file
poetry install --sync  # also remove untracked dependencies from venv
poetry update  # lock & install
poetry update --sync  # lock & install --sync

For more information about Poetry, see the [Poetry docs][poetry-docs].

Usage - Poe

We use poe to run tasks that simplify running things like tests, QA-tools, and docker. This is similar to how one might use make to simplify running commands with arguments or combinations of commands.

You can run poe in two ways:

# By first activating the virtual environment
poetry shell
poe TASKNAME [OPTIONAL_ADDITIONAL_ARGS]

# By using `poetry run` without activing the environment
poetry run poe TASKNAME [OPTIONAL_ADDITIONAL_ARGS]

For example, to run all tools that reformat code, you can run:

poetry shell
poe reformat

# or
poetry run poe reformat

For a list of all the available tasks, run poe --help or look at the task definitions in pypoetry.toml.

For more information about Poe the Poet, look at the [Poe docs][poe-docs].

Testing

Tests can be run with:

poe tests

VSCode

If you're using VSCode it's recommended to install the following extensions to make python development easier:

• ms-python.debugpy
• ms-python.pylint
• ms-python.python
• ms-python.vscode-pylance
• charliermarsh.ruff

Configure virtual environment for VSCode

You can configure the interpreter path for the workspace so that you don't have to manually activate the terminal every time you open a terminal.

You can find the path to the python interpreter associated with the virtual environment easily by:

# Activate the environment
poetry shell
# Find the python path for this environment
where python

Key Differences from jamovi

Deployment

• Optimized for Apple Silicon (ARM64) macOS
• Custom port configuration (42337-42339) to avoid conflicts
• Cloudflare Tunnel integration for public access
• Auto-start LaunchDaemon for reliability

Branding

• Application name: HeyStat (was: jamovi)
• Custom domain: https://heystat.truyenthong.edu.vn
• Vietnamese localization focus

Infrastructure

• Docker-based deployment on Colima (lightweight Docker for macOS)
• Nginx reverse proxy with WebSocket support
• Isolated Documents folder for user data
• Production-ready security configuration

See FORK_NOTICE.md for complete fork information.

License

HeyStat is licensed under AGPL3/GPL2+, same as jamovi.

Copyright (C) 2025 HeyStat Team
Copyright (C) 2016-2024 The jamovi team

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

See LICENSE.md for full license text.

Acknowledgments

HeyStat is built on jamovi by The jamovi team.

We are grateful to:

• The jamovi team for creating excellent open-source statistical software
• The R Project and all R package developers
• The open-source community for tools and libraries

Links

• jamovi: https://www.jamovi.org (original project)
• jamovi Source: https://github.com/jamovi/jamovi
• jamovi Community: https://forum.jamovi.org
• HeyStat Live: https://heystat.truyenthong.edu.vn

---

HeyStat - A fork of jamovi for Vietnamese educational institutions