Journal of ADaM Install, Windows 10

[ForrestErickson]

Summary

Journal of an install of ADaM on a Windows 10 computer.

Steps

Cloned into a folder with other Public Invention projects
Did a pull after a few days:

The resulting folder:

Open Windows 10 power shell by typing "powershell" in the file address bar:

Create and activate a virtual environment by copy and paste the following code

python -m venv .venv
.\.venv\Scripts\Activate.ps1

The shell was not responsive.

Try again one at a time for the two commands
Error

Set execution policy by running this command in the power shell:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Restart: Close and reopen your terminal or PowerShell window for the change to take effect in the new session.

This time the script did not report an error:

Addition to Instructions.

Include instructions for setting the "ExecutionPolicy" above.

Resume at Install dependencies

Copy and paste,

# If requirements.txt exists:
pip install -r requirements.txt

# If not, minimum:
pip install paho-mqtt

PowerShell returned error

Try the powershell commands one at a time, Worked!

Set MQTT credentials locally (required)
Copy and paste individually the three commands. Success.

Run the system (3 terminals) Notes

Three times, command: C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe

Terminal 1: Start ADaMServer
Copy and paste, "python .\ADaMServer.py". Fails: No such file or directory

Change directory with "cd ADaMpy". Run the command and success.

Terminal 2: Start Krake Simulator
Copy paste "python .\Krake_Simulator.py". Again got error:

Change directory again and it works with the warning on Depreciated callback..

Terminal 3: Start a simulator (choose one)
CD to ADaMpy.
Copy paste "python .\simulators\alarm_generator.py" Appears to run with success.

[saivishwanatha]

Thanks for the install journal. This is not a code bug — it’s README gaps + shell mismatch.

1) PowerShell venv activation blocked (ExecutionPolicy)

If you see:
Activate.ps1 cannot be loaded because running scripts is disabled

Fix it once:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Close and reopen PowerShell, then run:

python -m venv .venv
.\.venv\Scripts\Activate.ps1

2) You ran pip install -r requirements.txt from the wrong folder

requirements.txt is inside ADaMpy/, so running it from repo root fails.

Do either:

cd ADaMpy
pip install -r requirements.txt

OR from repo root:
pip install -r .\ADaMpy\requirements.txt

3) MQTT env var verification depends on the shell

PowerShell:
echo $env:MQTT_USER

bash/zsh (macOS, Git Bash, etc):
echo $MQTT_USER

Also, the README steps are PowerShell-specific.
If you’re using Git Bash, do NOT use Activate.ps1. Use:
source .venv/Scripts/activate

I’ll update the README to include:

• ExecutionPolicy note
• correct cd ADaMpy / requirements path
• correct env var echo commands per shell

**🚨 IMPORTANT:
The MQTT credentials are public.
Use:
MQTT_USER="public"
MQTT_PASS="public"

NOT YOUR_USERNAME / YOUR_PASSWORD.**