Environment Components

LinaPro depends on the following components during source development. Install them locally before continuing.

Component	Version requirement	Notes
Git	-	Version control; required by installation scripts
Go	1.25+	Backend service runtime
Node.js	20.19+	Frontend build environment
pnpm	10.0+	Frontend package manager
PostgreSQL	14+	Default relational database

Git

Git is preinstalled on macOS and most Linux distributions. Run git --version to confirm that it is available. If it is not installed:

macOS / Linux

# macOS
brew install git

# Ubuntu / Debian
sudo apt install git

# CentOS / RHEL
sudo yum install git

Windows

Download and install Git for Windows from git-scm.com. After installation, you can use the git command in cmd.exe, PowerShell, Git Bash, or WSL.

Go

Go 1.25 or later is required. Run go version to check your current version.

macOS / Linux

# macOS (Homebrew)
brew install go

# Linux — download the official prebuilt package and replace the version with the latest stable release
# Latest versions: https://go.dev/dl/
# Example for Linux amd64 go1.25.10:
wget https://go.dev/dl/go1.25.10.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.25.10.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc && source ~/.bashrc

Windows

Download the Windows installer (.msi) from go.dev/dl and complete the graphical setup, or install Go inside WSL using the Linux steps.

Node.js

Using nvm to manage Node.js versions is recommended. The minimum required version is v20.19.0.

macOS / Linux

# Install via nvm (recommended)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/HEAD/install.sh | bash
# Reload your shell, then run
nvm install --lts
nvm use --lts

# Or via Homebrew (macOS only)
brew install node

Windows

Use nvm-windows, or download the Windows build from nodejs.org. You can also install nvm inside WSL using the Linux steps.

After installation, run node --version and confirm that the output is at least v20.19.0.

pnpm

pnpm is the package manager specified for LinaPro's frontend project. Do not replace it with npm or yarn.

npm install -g pnpm

After installation, run pnpm --version and confirm that the output is at least 10.0.0.

PostgreSQL

LinaPro uses PostgreSQL 14+ as its default database. Before running make db.init or make dev, prepare a reachable PostgreSQL instance.

macOS / Linux

# macOS (Homebrew)
brew install postgresql@14
brew services start postgresql@14

# Ubuntu / Debian
sudo apt install postgresql
sudo systemctl enable --now postgresql

# CentOS / RHEL
sudo yum install postgresql-server postgresql-contrib
sudo postgresql-setup --initdb
sudo systemctl enable --now postgresql

Docker

If Docker is already installed locally, you can start a local PostgreSQL container directly:

docker run \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=postgres \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_DB=linapro \
  postgres:14-alpine

Windows

Install it on the Windows side with the PostgreSQL Windows installer, or run the PostgreSQL container above with Docker Desktop. If you use WSL, you can connect from WSL to the Windows database through 127.0.0.1, or install PostgreSQL directly inside your WSL distribution.

Development Skills (Agent Skills)

LinaPro recommends installing the following Agent Skills:

Skill	Required	Purpose
OpenSpec	Recommended	Optional spec-driven workflow tool, recommended for the best experience
goframe-v2	Recommended	GoFrame-specific AI skill that provides code generation, diagnostics, and performance optimization guidance to improve generated Go framework code quality
find-skills	Recommended	AI skill marketplace search tool for quickly finding and evaluating skills that fit the project

OpenSpec

OpenSpec is an optional spec-driven workflow command-line tool. Install it to unlock the full spec-driven workflow experience. Once installed, workflow skills such as /opsx:explore, /opsx:propose, /opsx:apply, and /opsx:archive will automatically use OpenSpec as their underlying engine.

npm install -g @fission-ai/openspec@latest

goframe-v2

goframe-v2 is an Agent Skill built specifically for the GoFrame development framework. It includes GoFrame coding rules, ORM usage patterns, and best-practice examples. The skill activates automatically when you write or modify backend Go code.

npx skills add github.com/gogf/skills -g

find-skills

find-skills is an AI skill marketplace search tool that helps developers quickly find and evaluate AI skills suited to the project, improving skill selection efficiency.

npx skills add vercel-labs/skills --skill find-skills -g