Getting Started

Installation

Pseudo ships as a standalone binary - no Python, no pip, no runtime required. One command and you're running.

ℹ

Standalone binary - the pseudo executable bundles everything it needs internally. Python does not need to be installed on your machine.

🪟 Windows

Open PowerShell and run:

powershell

iwr -useb https://pseudo.wiki/install.ps1 | iex

This downloads pseudo.exe from GitHub Releases, places it in %LOCALAPPDATA%\Programs\pseudo\, and adds it to your PATH automatically. Open a new terminal and you're done.

Manual download

powershell

# Download install script and run it
curl -o install.ps1 https://pseudo.wiki/install.ps1
.\install.ps1

💡

No admin required - the installer places the binary in your user folder and updates your user PATH only.

🍎 macOS

bash

curl -fsSL https://pseudo.wiki/install.sh | bash

Installs to ~/.local/bin/pseudo and appends the PATH line to ~/.zshrc (and ~/.bash_profile). Supports both Intel and Apple Silicon.

Source the shell config (current session)

bash

source ~/.zshrc

🐧 Linux

bash

curl -fsSL https://pseudo.wiki/install.sh | bash

Or with wget:

bash

wget -qO- https://pseudo.wiki/install.sh | bash

Installs to ~/.local/bin/pseudo and updates ~/.bashrc. Supports x86-64 and ARM64.

Source the shell config (current session)

bash

source ~/.bashrc

Supported Platforms

Platform	Binary	Notes
🪟 Windows x64	`pseudo-windows-x64.exe`	Windows 10/11
🍎 macOS x64	`pseudo-macos-x64`	Intel Mac
🍎 macOS ARM64	`pseudo-macos-arm64`	Apple Silicon (M1/M2/M3)
🐧 Linux x64	`pseudo-linux-x64`	Ubuntu, Debian, Fedora, etc.
🐧 Linux ARM64	`pseudo-linux-arm64`	Raspberry Pi, ARM servers

All binaries are available on the GitHub Releases page.

Verify Installation

bash

pseudo version

Output

pseudo 0.1.1

Alternative - pip (if Python 3.8+ is installed)

bash

pip install runpseudo

bash

pip install --upgrade runpseudo

Init a Project

Run inside any directory to create a local config and custom mapping file:

bash

pseudo init

This creates:

pseudo.config - local project config (links to your pmap)
A new or existing .pmap file at the path you specify

What Gets Created on First Run

On first run, Pseudo creates a home directory at ~/.pseudo/:

~/.pseudo/ structure

~/.pseudo/
  config.json         ← global settings
  core/
    default.pmap      ← ships with pseudo (read-only)
  custom/
    custom.pmap       ← created by: pseudo init
  cache/
    default.pmap.cache
  packages/           ← future package manager

File Extensions

Extension	Use
`.pseudo`	Primary source file extension
`.psu`	Short alias - identical behavior
`.pmap`	Mapping file (not source code)
`.pseudo`	❌ Error - common misspelling
`.py`	❌ Error - that looks like a Python file