MDB2SQL - Windows 11 Installation Guide

Document Information

Date: 2025-11-20
Platform: Windows 11 Pro/Home (64-bit)
Minimum Build: 22000

Prerequisites

System Requirements

Windows 11 Build 22000 or higher (64-bit)
PowerShell 5.1 or higher
Administrator privileges for tool installation
8GB RAM minimum (16GB recommended)
10GB free disk space

Base Tools Installation

1. Install Git

Using winget:

winget install --id Git.Git -e --source winget

Direct download alternative:

URL: https://git-scm.com/download/win
Download Git for Windows (64-bit)
Run installer with default options

Configure Git:

git config --global user.name "Your Name"
git config --global user.email "your@email.com"

Verify installation:

git --version

2. Install Node.js 23.x

Using winget:

winget install OpenJS.NodeJS

Direct download alternative:

URL: https://nodejs.org/en/download/
Download Node.js 23.3.0 LTS (64-bit Windows Installer)
Run installer with default options

Verify installation:

node --version
npm --version

Install pnpm globally:

npm install -g pnpm@10.18.2

Verify pnpm:

pnpm --version

3. Install Python 3.12 (stable)

Direct download (recommended):

URL: https://www.python.org/downloads/windows/
Download Python 3.12.x (64-bit)
CRITICAL: Check "Add Python to PATH" during installation
Select "Install for all users" if prompted

Verify installation:

python --version
pip --version

Install uv (Python package manager):

irm https://astral.sh/uv/install.ps1 | iex

Add uv to PATH (if needed):

$env:Path += ";$env:USERPROFILE\.cargo\bin"
[Environment]::SetEnvironmentVariable("Path", $env:Path, [System.EnvironmentVariableTarget]::User)

Verify uv:

uv --version

4. Install Rust 1.83.0

Direct download:

URL: https://rustup.rs/
Download rustup-init.exe
Run with default options (select option 1)

PowerShell alternative:

Invoke-WebRequest -Uri https://win.rustup.rs/x86_64 -OutFile rustup-init.exe
.\rustup-init.exe -y

Refresh environment:

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")

Verify installation:

rustc --version
cargo --version

5. Install Go 1.23.3

Using winget:

winget install GoLang.Go

Direct download alternative:

URL: https://go.dev/dl/
Download go1.23.3.windows-amd64.msi
Run installer with default options

Verify installation:

go version

6. Install Pandoc + MiKTeX (PDF toolchain para scripts)

Uso: Necessario para scripts/generate_pdfs_and_rename.sh (pandoc + xelatex). Instalacao pode demorar por causa do MiKTeX.

Using winget (recomendado):

winget install Pandoc.Pandoc
winget install MiKTeX.MiKTeX

Alternativa: Downloads diretos pelos instaladores oficiais (sem choco para evitar dependencia adicional).

Verificar:

pandoc --version
xelatex --version

7. Install Wails v2.11.0

Prerequisites: Go must be installed first

go install github.com/wailsapp/wails/v2/cmd/wails@latest

Add to PATH:

# Adiciona Go/bin ao PATH do usuario se ainda nao estiver presente
$userPath   = [System.Environment]::GetEnvironmentVariable('Path', 'User')
$goBinPath  = "$env:USERPROFILE\go\bin"
if (-not ($userPath -split ';' | Where-Object { $_ -eq $goBinPath })) {
    [System.Environment]::SetEnvironmentVariable('Path', "$userPath;$goBinPath", 'User')
    Write-Host "Go/bin adicionado ao PATH do usuario. Reinicie o terminal para aplicar."
} else {
    Write-Host "Go/bin ja esta no PATH do usuario."
}

Verify installation:

wails version

8. Install Tauri Prerequisites

WebView2 Runtime:

Check if already installed:

Get-ItemProperty -Path 'HKLM:\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}' -ErrorAction SilentlyContinue

If not installed, download from:

URL: https://developer.microsoft.com/en-us/microsoft-edge/webview2/

Microsoft Visual Studio Build Tools:

Using winget:

winget install Microsoft.VisualStudio.2022.BuildTools

Direct download:

URL: https://visualstudio.microsoft.com/downloads/
Download "Build Tools for Visual Studio 2022"
During installation, select "Desktop development with C++"

Install Tauri CLI:

cargo install tauri-cli

Verify installation:

cargo tauri --version

Repository Setup

Clone Repository

cd C:\Users\$env:USERNAME\Documents
git clone https://github.com/your-username/mdb2sql.git
cd mdb2sql
git checkout dev

Implementation Configuration

1. Python + PyQt6

Navigate to directory:

cd C:\Users\$env:USERNAME\Documents\mdb2sql\py_qt6

Install dependencies:

uv sync

Verify installation:

uv run python --version

Create data directory:

New-Item -ItemType Directory -Force -Path data

Copy sample database:

Copy-Item -Path ..\data\sample.duckdb -Destination .\data\sample.duckdb

Run application:

uv run python src\main.py

2. Go + Wails + React

Navigate to directory:

cd C:\Users\$env:USERNAME\Documents\mdb2sql\go_wails_react

Create data directory:

New-Item -ItemType Directory -Force -Path data

Copy sample database:

Copy-Item -Path ..\data\sample.duckdb -Destination .\data\sample.duckdb

Install Go dependencies:

go mod tidy

Install frontend dependencies:

pnpm install

Build frontend (outDir separado por OS/arch):

$env:OUT_DIR = "dist/windows-$env:PROCESSOR_ARCHITECTURE"
pnpm run build

Run in development mode:

wails dev

Build em modo release (binario em build\bin\windows-amd64):

wails build -clean -platform windows/amd64
New-Item -ItemType Directory -Force -Path build\bin\windows-amd64 | Out-Null
Move-Item -Force -Path build\bin\mdb2sql.exe -Destination build\bin\windows-amd64\mdb2sql.exe

Build offline para pacote minimo:

Frontend: OUT_DIR="dist/windows-$env:PROCESSOR_ARCHITECTURE" pnpm run build
Python: uv run pyinstaller --onefile --windowed --distpath build\windows-$env:PROCESSOR_ARCHITECTURE src\main.py
Rust/Tauri release: cargo tauri build (binarios em src-tauri\target\**\release\)

3. Rust + Tauri + Svelte

WARNING: This implementation usa Tauri v1; upgrade para v2 esta em avaliacao.

Navigate to directory:

cd C:\Users\$env:USERNAME\Documents\mdb2sql\rust_tauri_svelte

Install frontend dependencies:

cd ui
pnpm install
cd ..

Attempt build (may fail):

cd src-tauri
cargo build

On version incompatibility errors:

Refer to temp/ErrosEProblemasPoc.md for details
This is a known POC limitation

Integration Testing

PowerShell Script to Run All GUIs

Create file: run_all_guis.ps1

# MDB2SQL - Multi-implementation launcher

Write-Host "=========================================" -ForegroundColor Green
Write-Host "MDB2SQL - Launching GUI Implementations" -ForegroundColor Green
Write-Host "=========================================" -ForegroundColor Green
Write-Host ""

$ProjectRoot = "C:\Users\$env:USERNAME\Documents\mdb2sql"

# Launch Python + PyQt6
Write-Host "[1/3] Launching Python + PyQt6..." -ForegroundColor Cyan
Start-Process powershell -ArgumentList "-NoExit", "-Command", "cd $ProjectRoot\py_qt6; uv run python src\main.py"
Start-Sleep -Seconds 2

# Launch Go + Wails + React
Write-Host "[2/3] Launching Go + Wails + React..." -ForegroundColor Cyan
Start-Process powershell -ArgumentList "-NoExit", "-Command", "cd $ProjectRoot\go_wails_react; wails dev"
Start-Sleep -Seconds 3

# Launch Rust + Tauri + Svelte (may fail)
Write-Host "[3/3] Launching Rust + Tauri + Svelte..." -ForegroundColor Cyan
Start-Process powershell -ArgumentList "-NoExit", "-Command", "cd $ProjectRoot\rust_tauri_svelte; cargo tauri dev"

Write-Host ""
Write-Host "All implementations launching in separate windows" -ForegroundColor Yellow
Write-Host "Close each window individually to terminate" -ForegroundColor Yellow

Execute:

.\run_all_guis.ps1

Troubleshooting

uv nao encontrado

Symptom: uv nao resolve no terminal

Solution:

$env:Path += ";$env:USERPROFILE\.cargo\bin"
[Environment]::SetEnvironmentVariable("Path", $env:Path, [System.EnvironmentVariableTarget]::User)
uv --version

Wails WebView2 Not Found

Symptom: WebView2 runtime not found

Solution:

# Download and install WebView2 Runtime
$WebView2Url = "https://go.microsoft.com/fwlink/p/?LinkId=2124703"
Invoke-WebRequest -Uri $WebView2Url -OutFile "MicrosoftEdgeWebview2Setup.exe"
.\MicrosoftEdgeWebview2Setup.exe /silent /install

Rust Linker Errors

Symptom: link.exe not found or MSVC errors

Solution:

# Install complete Visual Studio Build Tools
winget install Microsoft.VisualStudio.2022.BuildTools

# During installation, select:
# - Desktop development with C++
# - Windows 10 SDK

Long Path Issues

Symptom: The system cannot find the path specified in node_modules

Solution - Enable Long Path Support:

# Run PowerShell as Administrator
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" `
  -Name "LongPathsEnabled" `
  -Value 1 `
  -PropertyType DWORD `
  -Force

Restart computer after applying

Firewall Blocking Wails Dev Server

Symptom: Wails dev does not open application window

Solution:

Open Windows Defender Firewall
Allow wails.exe through firewall
Ou desabilitar temporariamente para teste (nao recomendado para uso continuo)

Tested Versions

Windows 11 Build 22000+

Node.js: 23.3.0
npm: 10.9.0
pnpm: 10.18.2
Python: 3.12.x
uv: latest
Go: 1.23.3
Wails: v2.11.0
Rust: 1.83.0
Cargo: 1.83.0
Tauri CLI: 1.5.14

Note: manter as versoes acima para evitar quebrar dependencias; evite upgrades/downgrades sem testar.

Next Steps

Test installation on clean Windows 11 VM
Create automated installation script (winget + PowerShell)
Document Windows-specific edge cases
Add Windows Server 2022 support

Last Updated: 2025-11-20 22:00 UTC-3 Maintainer: Development Team Document Version: 1.0

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

MDB2SQL - Windows 11 Installation Guide

Document Information

Prerequisites

System Requirements

Base Tools Installation

1. Install Git

2. Install Node.js 23.x

3. Install Python 3.12 (stable)

4. Install Rust 1.83.0

5. Install Go 1.23.3

6. Install Pandoc + MiKTeX (PDF toolchain para scripts)

7. Install Wails v2.11.0

8. Install Tauri Prerequisites

Repository Setup

Clone Repository

Implementation Configuration

1. Python + PyQt6

2. Go + Wails + React

3. Rust + Tauri + Svelte

Integration Testing

PowerShell Script to Run All GUIs

Troubleshooting

uv nao encontrado

Wails WebView2 Not Found

Rust Linker Errors

Long Path Issues

Firewall Blocking Wails Dev Server

Tested Versions

Windows 11 Build 22000+

Next Steps

FilesExpand file tree

SetupWindows.md

Latest commit

History

SetupWindows.md

File metadata and controls

MDB2SQL - Windows 11 Installation Guide

Document Information

Prerequisites

System Requirements

Base Tools Installation

1. Install Git

2. Install Node.js 23.x

3. Install Python 3.12 (stable)

4. Install Rust 1.83.0

5. Install Go 1.23.3

6. Install Pandoc + MiKTeX (PDF toolchain para scripts)

7. Install Wails v2.11.0

8. Install Tauri Prerequisites

Repository Setup

Clone Repository

Implementation Configuration

1. Python + PyQt6

2. Go + Wails + React

3. Rust + Tauri + Svelte

Integration Testing

PowerShell Script to Run All GUIs

Troubleshooting

uv nao encontrado

Wails WebView2 Not Found

Rust Linker Errors

Long Path Issues

Firewall Blocking Wails Dev Server

Tested Versions

Windows 11 Build 22000+

Next Steps