Unified workflow for all platforms — with AI assistance.
From Raspberry Pi to macOS, get your node running in minutes.
This document gathers the installation procedures for the Tajcoin wallet across all supported platforms. It also integrates a collaborative workflow designed for AI agents.
🌟 Level: ★★☆☆☆ · ⏳ Time: 30–45 min
The Bash script below automates the installation on Debian/Ubuntu (x86_64).
install_tajcoin.sh#!/bin/bash
set -e
# Variables
TAJ_VERSION="v1.1"
BOOTSTRAP_URL="https://github.com/Taj-Coin/tajcoin/releases/download/${TAJ_VERSION}/bootstrap-900600.zip"
QT_ARCHIVE="tajcoin-Qt-20.04-${TAJ_VERSION}.zip"
QT_URL="https://github.com/Taj-Coin/tajcoin/releases/download/${TAJ_VERSION}/${QT_ARCHIVE}"
DATA_DIR="$HOME/.tajcoin"
INSTALL_DIR="$HOME/Applications/tajcoin-qt"
# 1. Install dependencies
echo "📦 Installing dependencies..."
sudo apt-get update
sudo apt-get install -y libqt5gui5 libqt5widgets5 libqt5network5 \
libboost-system-dev libboost-filesystem-dev \
libboost-program-options-dev libboost-thread-dev \
libssl-dev libdb5.3++ libminiupnpc-dev libqrencode-dev \
wget unzip
# 2. Download and extract the Qt wallet
echo "⬇️ Downloading Qt wallet..."
mkdir -p "$INSTALL_DIR"
cd "$INSTALL_DIR"
wget -O "$QT_ARCHIVE" "$QT_URL"
unzip -o "$QT_ARCHIVE"
chmod +x tajcoin-qt
# 3. First launch (creates the data directory)
echo "🚀 First launch of the wallet (creating $DATA_DIR)..."
./tajcoin-qt -datadir="$DATA_DIR" &
# 4. Clean old chain (if it exists)
if [ -d "$DATA_DIR/blocks" ] || [ -d "$DATA_DIR/chainstate" ]; then
echo "🧹 Cleaning old chain..."
rm -rf "$DATA_DIR/blocks" "$DATA_DIR/chainstate" "$DATA_DIR/peers.dat"
fi
# 5. Apply the bootstrap
echo "⬇️ Downloading bootstrap..."
cd "$DATA_DIR"
wget -O bootstrap.zip "$BOOTSTRAP_URL"
unzip -o bootstrap.zip
rm bootstrap.zip
echo "✅ Installation complete. Restart the wallet with: $INSTALL_DIR/tajcoin-qt"
Execution: chmod +x install_tajcoin.sh && ./install_tajcoin.sh
🌟 Level: ★★☆☆☆ · ⏳ Time: 20–30 min
The PowerShell script below automates the installation on Windows 10/11.
install_tajcoin.ps1# install_tajcoin.ps1
# Automated installation script for Tajcoin Wallet on Windows
param(
[string]$TajVersion = "v1.1",
[string]$InstallDir = "$env:LOCALAPPDATA\Programs\Tajcoin"
)
# Directories
$DataDir = "$env:APPDATA\Tajcoin"
$BootstrapUrl = "https://github.com/Taj-Coin/tajcoin/releases/download/$TajVersion/bootstrap-900600.zip"
$QtArchive = "tajcoin-Qt-win64-$TajVersion.zip"
$QtUrl = "https://github.com/Taj-Coin/tajcoin/releases/download/$TajVersion/$QtArchive"
# Console colors
$Green = "Green"
$Yellow = "Yellow"
$Cyan = "Cyan"
Write-Host "=== AUTOMATED TAJCOIN INSTALLATION (Windows) ===" -ForegroundColor $Cyan
# 1. Check privileges
if (-NOT ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")) {
Write-Host "⚠️ It is recommended to run this script as Administrator." -ForegroundColor $Yellow
$continue = Read-Host "Do you want to continue anyway? (y/N)"
if ($continue -ne "y") { exit }
}
# 2. Create installation directory
Write-Host "📁 Creating installation directory..." -ForegroundColor $Green
New-Item -ItemType Directory -Force -Path $InstallDir | Out-Null
# 3. Download Qt wallet
Write-Host "⬇️ Downloading Qt wallet..." -ForegroundColor $Green
$QtZipPath = "$env:TEMP\$QtArchive"
Invoke-WebRequest -Uri $QtUrl -OutFile $QtZipPath -UseBasicParsing
# 4. Extract
Write-Host "📦 Extracting archive..." -ForegroundColor $Green
Expand-Archive -Path $QtZipPath -DestinationPath $InstallDir -Force
Remove-Item $QtZipPath -Force
# 5. Verify the .exe exists
$WalletExe = Get-ChildItem -Path $InstallDir -Filter "*.exe" | Select-Object -First 1
if (-not $WalletExe) {
Write-Host "❌ No executable found in the archive." -ForegroundColor Red
exit 1
}
Write-Host "✅ Wallet found: $($WalletExe.Name)" -ForegroundColor Green
# 6. First launch (creates data directory)
Write-Host "🚀 First launch to create $DataDir..." -ForegroundColor $Green
Start-Process -FilePath $WalletExe.FullName -ArgumentList "-datadir=`"$DataDir`"" -Wait -WindowStyle Hidden
Start-Sleep -Seconds 3
# 7. Clean old chain (if updating)
if (Test-Path "$DataDir\blocks") {
Write-Host "🧹 Removing old blockchain..." -ForegroundColor $Yellow
Remove-Item -Recurse -Force "$DataDir\blocks", "$DataDir\chainstate", "$DataDir\peers.dat" -ErrorAction SilentlyContinue
}
# 8. Download and apply bootstrap
Write-Host "⬇️ Downloading bootstrap (may take a while)..." -ForegroundColor $Green
$BootstrapZip = "$env:TEMP\bootstrap.zip"
Invoke-WebRequest -Uri $BootstrapUrl -OutFile $BootstrapZip -UseBasicParsing
Write-Host "📦 Extracting bootstrap to $DataDir..." -ForegroundColor $Green
Expand-Archive -Path $BootstrapZip -DestinationPath $DataDir -Force
Remove-Item $BootstrapZip -Force
Write-Host "`n✅ INSTALLATION COMPLETE!" -ForegroundColor Green
Write-Host "👉 Launch the wallet from: $($WalletExe.FullName)" -ForegroundColor Cyan
Write-Host "👉 Data directory: $DataDir" -ForegroundColor Cyan
# 9. Create desktop shortcut
$DesktopPath = [Environment]::GetFolderPath("Desktop")
$ShortcutPath = Join-Path $DesktopPath "Tajcoin.lnk"
$WScriptShell = New-Object -ComObject WScript.Shell
$Shortcut = $WScriptShell.CreateShortcut($ShortcutPath)
$Shortcut.TargetPath = $WalletExe.FullName
$Shortcut.WorkingDirectory = $InstallDir
$Shortcut.Save()
Write-Host "✅ Desktop shortcut created." -ForegroundColor Green
Execution: Open PowerShell as administrator and run .\install_tajcoin.ps1.
🌟 Level: ★★★★☆ · ⏳ Time: 2–4 h
No pre-compiled binaries are officially distributed for macOS. Compilation is required.
build_tajcoin_macos.sh#!/bin/bash
set -e
echo "🔧 Installing dependencies via Homebrew..."
brew update
brew install boost openssl berkeley-db@4 miniupnpc qrencode qt@5 git
echo "📥 Cloning repository..."
git clone https://github.com/Taj-Coin/tajcoin.git || true
cd tajcoin
echo "⚙️ Configuring with qmake..."
export PATH="/opt/homebrew/opt/qt@5/bin:$PATH"
qmake tajcoin-qt.pro RELEASE=1
echo "🛠️ Compiling (this may take a while)..."
make -j$(sysctl -n hw.ncpu)
echo "✅ Compilation complete!"
echo "👉 Launch the wallet with: ./tajcoin-qt"
Execution: chmod +x build_tajcoin_macos.sh && ./build_tajcoin_macos.sh
⚠️ Complexity & AI assistance: macOS compilation is the trickiest. AI agents like Claude Cowork can guide you step by step, resolve linking errors, and adjust paths according to your architecture.
🌟 Level: ★★☆☆☆ · ⏳ Time: 15–30 min
Official ARM64 binaries are available as a .deb package or a ZIP archive.
wget https://tajafrica.pro/Applications/tajcoin-qt_1.1.0.0-1_arm64.deb
sudo dpkg -i tajcoin-qt_1.1.0.0-1_arm64.deb
sudo apt-get install -f # if dependencies are missing
tajcoin-qt
wget https://tajafrica.pro/Applications/tajcoin-qt_1.1.0.0-1_arm64.zip
unzip tajcoin-qt_1.1.0.0-1_arm64.zip -d ~/tajcoin
chmod +x ~/tajcoin/tajcoin-qt
~/tajcoin/tajcoin-qt
wget https://tajafrica.pro/Applications/tajcoind_1.1.0.0-1_arm64.zip
unzip tajcoind_1.1.0.0-1_arm64.zip -d ~/tajcoin-node
chmod +x ~/tajcoin-node/tajcoind
~/tajcoin-node/tajcoind -daemon
~/tajcoin-node/tajcoin-cli getinfo
This workflow is designed for AI agents (Claude, Grok, Gemini, etc.) to guide the user step by step, solve problems, and automate repetitive tasks.
💡 For macOS users: Compilation can be lengthy and fraught with pitfalls. Claude Cowork can take over: it will analyze errors, adjust compilation flags, and even execute commands via terminal integration.
⏺️ Question: "I'm on macOS M2, compilation fails with 'library not found for -lboost_system'. What should I do?"
🌟 Level: ★★★☆☆ · ⏳ Time: 15 min
Agent's response: Let's check the Boost path. On Apple Silicon, it's in /opt/homebrew/lib. Run qmake with BOOST_LIB_PATH=/opt/homebrew/lib.
— Claude 🇫🇷, August 18, 2026
| Action / Decision | 🌟 Difficulty | ⏳ Time | Status | Priority | Responsible |
|---|---|---|---|---|---|
| Write Bash script for Linux | ★★☆☆☆ | 1h | ✅ Validated | High | Claude |
| Write PowerShell script for Windows | ★★☆☆☆ | 1h | ✅ Validated | High | Claude |
| Write macOS compilation guide | ★★★★☆ | 2h | ✅ Validated | Medium | Claude |
| Raspberry Pi installation guide | ★★☆☆☆ | 30min | ✅ Validated | High | Claude |
| Test Windows script on Win10/11 | ★☆☆☆☆ | 30min | To do | High | — |
| Test compilation on macOS Intel & Apple Silicon | ★★★☆☆ | 1h each | To do | Medium | — |
| Test installation on Raspberry Pi 4/5 | ★☆☆☆☆ | 30min | To do | High | — |
| Add SHA256 verification for archives | ★★☆☆☆ | 30min | Optional | Medium | — |
| Create Chocolatey package for Windows | ★★★☆☆ | 2h | Optional | Low | — |
| Create Homebrew package for macOS | ★★★★★ | 4h | Optional | Low | — |
CLAUDE.md.Version: 2.1 · Last updated: August 18, 2026 · Next review: in 7 days or after a major feature
Exported from Bran's Memory — Living multi-AI document
💡 A 📋 Copy button appears at the top right of each code block. Click it to copy the code.