Installation

Installation

Pipe compiles to a single static binary. No dependencies needed at runtime.

Pipe kompiliert zu einer einzigen statischen Binary. Keine Abhängigkeiten zur Laufzeit nötig.

Pipe (SPR) is a Semantic Pipeline Runtime — AI operations as language primitives.

Pipe (SPR) ist eine Semantic Pipeline Runtime — KI-Operationen als Sprachbestandteile.

Quick Install

Schnellinstallation

Download a pre-built static binary — no Go, no Git, no dependencies. On Apple Silicon use the arm64 build.

Lade eine vorkompilierte statische Binary herunter — kein Go, kein Git, keine Abhängigkeiten. Auf Apple Silicon den arm64-Build verwenden.

# One-liner install (Linux & macOS)# Installation mit einem Befehl (Linux & macOS)
curl -fsSL https://pipe-lang.com/install.sh | bash
# Windows (PowerShell)# Windows (PowerShell)
irm https://pipe-lang.com/install.ps1 | iex

The installer downloads the latest release, verifies its SHA256 checksum and installs pipe into ~/.local/bin (or /usr/local/bin as root). Pin a version with PIPE_VERSION=v1.0.0.

Der Installer lädt die neueste Version herunter, prüft ihre SHA256-Prüfsumme und installiert pipe nach ~/.local/bin (als root nach /usr/local/bin). Version pinnen mit PIPE_VERSION=v1.0.0.

🐧 Linux
⬇ amd64 ⬇ arm64 
curl -L -o pipe.tar.gz https://github.com/MachuraHarry/pipe/releases/latest/download/pipe-linux-amd64.tar.gz
tar xzf pipe.tar.gz && sudo mv pipe /usr/local/bin/ && rm pipe.tar.gz
🍎 macOS
⬇ amd64 ⬇ arm64 
curl -L -o pipe.tar.gz https://github.com/MachuraHarry/pipe/releases/latest/download/pipe-darwin-arm64.tar.gz
tar xzf pipe.tar.gz && sudo mv pipe /usr/local/bin/ && rm pipe.tar.gz
🪟 Windows
⬇ amd64 
curl.exe -L -o pipe.tar.gz https://github.com/MachuraHarry/pipe/releases/latest/download/pipe-windows-amd64.tar.gz
tar -xf pipe.tar.gz

Move pipe.exe to a folder in your PATH.

Verschiebe pipe.exe in einen Ordner in deinem PATH.

Older versions and checksums: GitHub Releases.

Ältere Versionen und Prüfsummen: GitHub Releases.

Verify Installation

Installation überprüfen

pipe -h

API Key Setup

API-Key einrichten

Pipe supports OpenAI, Anthropic, DeepSeek, and local Ollama:

Pipe unterstützt OpenAI, Anthropic, DeepSeek und lokales Ollama:

export DEEPSEEK_API_KEY="sk-..."

No API key needed for ollama — it runs fully local. Switch providers at runtime with ai_provider "openai".

Für ollama ist kein API-Key nötig — es läuft vollständig lokal. Provider zur Laufzeit wechseln mit ai_provider "openai".

First Pipeline

Erste Pipeline

pipe -vm -q -c 'ai_provider "deepseek"; ask "Hello!" > print'

This sets DeepSeek as the provider, asks the model "Hello!", and prints the response.

Das setzt DeepSeek als Provider, fragt das Modell "Hello!" und gibt die Antwort aus.

Build from Source

Aus dem Quellcode bauen

For developers who want the latest master or to hack on Pipe itself:

Für Entwickler, die den neuesten Master wollen oder an Pipe selbst mitarbeiten:

  • Go 1.21 or newer
  • Go 1.21 oder neuer
  • Git (for cloning the repository)
  • Git (zum Klonen des Repositorys)
git clone https://github.com/MachuraHarry/pipe && cd pipe && make build

The binary is at bin/pipe. Copy it anywhere — it's statically linked.

Die Binary liegt unter bin/pipe. Kopiere sie beliebig — sie ist statisch gelinkt.

VSCode Extension — Highlighting + IntelliSense

VSCode-Erweiterung — Highlighting + IntelliSense

The extension (vscode/) adds TextMate syntax highlighting for .pipe files and connects to the pipe-lsp language server for completion, hover docs, go-to-definition, rename, diagnostics, and formatting.

Die Erweiterung (vscode/) fügt TextMate-Syntax-Highlighting für .pipe-Dateien hinzu und verbindet sich für Vervollständigung, Hover-Doku, Go-to-Definition, Umbenennen, Diagnostik und Formatierung mit dem pipe-lsp-Language-Server.

make vsix          # packages vscode/pipe-syntax-1.0.0.vsix

Then in VSCode press Ctrl+Shift+P → "Extensions: Install from VSIX..." and select vscode/pipe-syntax-1.0.0.vsix. Files ending in .pipe are recognized automatically.

Danach in VSCode Ctrl+Shift+P → "Extensions: Install from VSIX..." drücken und vscode/pipe-syntax-1.0.0.vsix auswählen. Dateien mit der Endung .pipe werden automatisch erkannt.

Build the language server yourself with make lsp → bin/pipe-lsp. The extension looks for it in this order: the pipe.lspPath setting, then bin/pipe-lsp inside the extension folder, then <workspace>/bin/pipe-lsp, then pipe-lsp on PATH.

Den Language Server selbst bauen: make lsp → bin/pipe-lsp. Die Erweiterung sucht ihn in dieser Reihenfolge: die Einstellung pipe.lspPath, dann bin/pipe-lsp im Erweiterungsordner, dann <workspace>/bin/pipe-lsp, dann pipe-lsp im PATH.

Settings: pipe.lspPath — absolute path to the pipe-lsp binary (default "") · pipe.lsp.enabled — set to false to disable the language server (default true).

Einstellungen: pipe.lspPath — absoluter Pfad zur pipe-lsp-Binary (Standard "") · pipe.lsp.enabled — false, um den Language Server zu deaktivieren (Standard true).

LSP Server in Any Editor

LSP-Server in jedem Editor

pipe-lsp speaks the Language Server Protocol over stdin/stdout (stdio), so any LSP-capable editor can use it — for example Neovim:

pipe-lsp spricht das Language Server Protocol über stdin/stdout (stdio), sodass jeder LSP-fähige Editor ihn nutzen kann — z. B. Neovim:

make lsp             # builds bin/pipe-lsp
pipe-lsp -version    # verify: prints "pipe-lsp 0.1.0"
-- init.lua
vim.lsp.start({
  name = "pipe",
  cmd = { "pipe-lsp", "--stdio" },
})

Supported capabilities: completion, hover, signature help, go-to-definition, references, rename, formatting, semantic tokens, and diagnostics.

Unterstützte Fähigkeiten: Vervollständigung, Hover, Signatur-Hilfe, Go-to-Definition, Referenzen, Umbenennen, Formatierung, semantische Tokens und Diagnostik.

Full details in the VSCode Extension docs (EN).

Alle Details in der VSCode-Erweiterungs-Doku (DE).