Skip to content
Astromesh Astromesh

Install on Windows

This guide covers installing Astromesh Node as a Windows Service on Windows 10/11 and Windows Server 2019/2022.

Prerequisites

Section titled “Prerequisites”
RequirementVersionCheck
Windows10 21H2+ / 11 / Server 2019+winver
PowerShell5.1+ (included in Windows)$PSVersionTable.PSVersion
Architecturex64 or arm64echo %PROCESSOR_ARCHITECTURE%
Python3.12+ (bundled by the installer)—
NetworkOutbound to LLM provider or local Ollama—

Administrator privileges are required for installation.

Download

Section titled “Download”

Download the latest .zip package from GitHub Releases.

PowerShell:

Terminal window
Invoke-WebRequest `
  -Uri https://github.com/monaccode/astromesh/releases/latest/download/astromesh_latest_windows_amd64.zip `
  -OutFile astromesh.zip

Or download via browser: visit the GitHub Releases page and download astromesh_latest_windows_amd64.zip.

Install

Section titled “Install”

Extract the archive and run the installer script as Administrator:

Terminal window
# Extract
Expand-Archive -Path astromesh.zip -DestinationPath .\astromesh


# Open an Administrator PowerShell and run the installer
cd .\astromesh
.\install.ps1

If PowerShell script execution is blocked, run:

Terminal window
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\install.ps1

The installer:

  1. Copies astromeshd.exe and astromeshctl.exe to C:\Program Files\Astromesh\bin\
  2. Creates configuration and data directories
  3. Registers the AstromeshDaemon Windows Service
  4. Adds C:\Program Files\Astromesh\bin\ to the system PATH

Expected output:

Installing Astromesh Node v0.18.0...
Creating directories...
  C:\ProgramData\Astromesh\config\
  C:\ProgramData\Astromesh\data\
  C:\ProgramData\Astromesh\logs\
Installing binaries...
Installing Python environment...
Registering Windows Service 'AstromeshDaemon'...
astromesh installed successfully.


Run 'astromeshctl init' to configure.

Open a new terminal (to pick up the PATH update) and verify:

Terminal window
astromeshctl version

Expected output:

Astromesh Node v0.18.0
Daemon:   C:\Program Files\Astromesh\bin\astromeshd.exe
CLI:      C:\Program Files\Astromesh\bin\astromeshctl.exe
Python:   3.12.x
Platform: windows/amd64

Configure

Section titled “Configure”

Run the interactive wizard (from an Administrator terminal):

Terminal window
astromeshctl init

For a non-interactive setup:

Terminal window
astromeshctl init --profile full --provider ollama --model llama3.1:8b --non-interactive

This creates:

  • C:\ProgramData\Astromesh\config\runtime.yaml
  • C:\ProgramData\Astromesh\config\providers.yaml
  • C:\ProgramData\Astromesh\config\agents\default.agent.yaml

See Configuration for the full schema.

Start the Service

Section titled “Start the Service”
Terminal window
# Start the service
Start-Service AstromeshDaemon


# Set to start automatically on boot
Set-Service AstromeshDaemon -StartupType Automatic

Or use the Services console (services.msc) — find Astromesh Daemon and start it.

To stop:

Terminal window
Stop-Service AstromeshDaemon

Verify

Section titled “Verify”
Terminal window
astromeshctl status
Terminal window
Invoke-RestMethod http://localhost:8000/v1/health

Windows Firewall

Section titled “Windows Firewall”

To allow external access to the API (optional, only needed if accessing from other machines):

Terminal window
New-NetFirewallRule `
  -DisplayName "Astromesh API" `
  -Direction Inbound `
  -Protocol TCP `
  -LocalPort 8000 `
  -Action Allow

Log Access

Section titled “Log Access”

Logs are written to C:\ProgramData\Astromesh\logs\:

Terminal window
# Follow live logs
Get-Content "C:\ProgramData\Astromesh\logs\astromeshd.log" -Wait -Tail 50


# View errors
Select-String -Path "C:\ProgramData\Astromesh\logs\astromeshd.log" -Pattern "ERROR"


# Windows Event Log
Get-EventLog -LogName Application -Source AstromeshDaemon -Newest 50

Filesystem Paths

Section titled “Filesystem Paths”
PathPurpose
C:\ProgramData\Astromesh\config\Configuration files
C:\ProgramData\Astromesh\data\Persistent state (memory, models)
C:\ProgramData\Astromesh\logs\Log files
C:\Program Files\Astromesh\bin\astromeshd.exe and astromeshctl.exe

Upgrade

Section titled “Upgrade”
Terminal window
# Download new version
Invoke-WebRequest `
  -Uri https://github.com/monaccode/astromesh/releases/latest/download/astromesh_latest_windows_amd64.zip `
  -OutFile astromesh.zip


Expand-Archive -Path astromesh.zip -DestinationPath .\astromesh -Force
cd .\astromesh
.\install.ps1

The installer stops the service, upgrades binaries, and restarts the service.

Uninstall

Section titled “Uninstall”
Terminal window
# Stop and remove the service
Stop-Service AstromeshDaemon
sc.exe delete AstromeshDaemon


# Remove binaries
Remove-Item "C:\Program Files\Astromesh" -Recurse -Force

To remove all configuration and data:

Terminal window
Remove-Item "C:\ProgramData\Astromesh" -Recurse -Force

Next Steps

Section titled “Next Steps”