curl -fsSL https://pipe-lang.com/install.sh | bash   # Linux & macOS

import openai
client = openai.OpenAI()
def summarize(text):
    r = client.chat.completions.create(model="gpt-4o", messages=[{"role":"user","content":text}])
    return r.choices[0].message.content
def translate(text, lang):
    r = client.chat.completions.create(model="gpt-4o",
        messages=[{"role":"system","content":f"Translate to {lang}"},{"role":"user","content":text}])
    return r.choices[0].message.content
text = open("news.txt").read()
print(translate(summarize(text), "de"))

read_file "news.txt"
    > summarize       -- LLM call
    > translate "de"  -- LLM call
    > print

fn get_weather city
    match city
        | "Berlin" -> "22°C, sunny"
        | "London" -> "15°C, rainy"
        | _ -> city ++ ": no data"

ai_tool "get_weather" "Get weather for a city" {city: "City name"} get_weather
mcp_server "Weather Agent" "1.0.0"
mcp_serve_stdio

{ "mcpServers": { "pipe": { "command": "/tmp/pipe", "args": ["agent.pipe"] } } }

ai_provider "deepseek"
ai_set_key "deepseek" (env "DEEPSEEK_API_KEY")

-- Connect to GitHub + Filesystem MCP servers
mcp_use_stdio "npx" "-y" "@modelcontextprotocol/server-github" {GITHUB_TOKEN: (env "GITHUB_TOKEN")}
mcp_use_stdio "npx" "-y" "@modelcontextprotocol/server-filesystem" "/tmp"

-- AI discovers and uses all tools automatically
result: ai_with_tools "You are a DevOps assistant." "Search pipe's open issues and list files in /tmp." 10
print result

is_critical: fn line
    contains line "critical"

read_file "/var/log/app/errors.log"
    > split "\n"
    > filter is_critical
    > summarize
    > translate "de"
    > save "incident_report.txt"

ai_provider "deepseek"

docs: read_lines "knowledge_base.txt"
vectors: embed_batch docs

question: "How does the bytecode VM work?"
q_vec: embed question
top: nearest q_vec vectors 3

context: ""
for idx in top
    context: context ++ (at docs idx) ++ "\n---\n"

ask ("Context:\n" ++ context ++ "\nQuestion: " ++ question)
    > print

fn get_weather city
    match city
        | "Berlin" -> "22°C, sunny"
        | "London" -> "15°C, rainy"
        | _ -> city ++ ": no data"

ai_tool "get_weather" "Get current weather for a city" {city: "Name of the city"} get_weather

ai_with_tools "You are a weather assistant." "What's the weather in Berlin and London?"
    > print

import "discord.pipe" as d
ai_provider "deepseek"

-- AI code review per commit, sent as Discord embed
review: ai_chat "Review this code change" diff 800

d.d_webhook_embed (env "DISCORD_WEBHOOK") {
    title: "🔧 CI: Push to master",
    color: 3447003,
    fields: [
        {name: "Changed Files", value: stat},
        {name: "AI Review", value: review}
    ]
}

git clone https://github.com/MachuraHarry/pipe && cd pipe && make build
export DEEPSEEK_API_KEY="sk-..."
./bin/pipe -vm -q -c 'ai_provider "deepseek"; ask "What makes Pipe different?" > print'

-- Paste this into the playground and hit Run
levels: ["error","warn","info"]
read_file "server.log"
    > classify levels
    > summarize
    > print

- uses: MachuraHarry/pipe/.github/actions/pipe-action@master
  with:
    script: |
      print "Hello from CI/CD!"
      log: exec "git log --oneline -20"
      print (get log "output")

make vsix     # builds the server and packages vscode/pipe-syntax-0.1.0.vsix

pipe -search                 # Browse modules
pipe -search sql             # Filter by keyword
pipe -get sqlite             # Install latest
pipe -get sqlite@0.8.0       # Install specific version

import "sqlite"                            -- database engine
import "pipe-http"                         -- HTTP client
import "discord.pipe" as d                 -- Discord webhooks + bot
import "x.pipe" as x                       -- X (Twitter) API v2

idx: index_create h "knowledge"
index_add idx "Pipe is an AI-native language."
index_search idx "language" 3 > each print

ai_provider "deepseek"

result: try_ai
    "42" * 3           -- E002 Type Error → AI wraps with to_num → 126
catch e
    0                   -- only reached if AI fix fails

print result           -- 126

a: "Frage A"
    >> ask
b: "Frage B"
    >> ask
c: "Frage C"
    >> ask

print a ++ b ++ c   -- Future auto-resolution

sandbox_profile "safe" {fs: "read-only", network: false, exec: false, ai: true}
sandbox_profile "agent" {fs: "temp-only", network: true, exec: false, ai: true}

set_sandbox "safe"
read_file "/etc/config"     -- ✅ reading allowed
write_file "/etc/config"    -- ❌ E_SANDBOX blocked

Source (.pipe) → Lexer → Parser → AST → [ Tree-Walker | Compiler + VM ]
                                            ↓
                                  Builtins (198 total: 18 ai_*, 6 mcp_*, 174 stdlib)
                                            ↓
                              MCP Server ↔ MCP Clients (stdio + HTTP)

pipe/
├── cmd/
│   ├── pipe/main.go           # Entry point
│   └── pipe-lsp/              # Language Server Protocol server (IntelliSense)
├── pkg/
│   ├── ai/                    # AI provider integrations
│   │   ├── ai.go
│   │   ├── ai_test.go
│   │   ├── embeddings.go
│   │   ├── providers.go
│   │   └── tools.go
│   ├── analysis/              # IntelliSense library (builtins, diagnostics, completion…)
│   ├── ast/                   # AST node definitions
│   │   └── ast.go
│   ├── build/                 # Self-extracting binary builder
│   │   └── build.go
│   ├── cache/                 # Bytecode cache
│   │   ├── cache.go
│   │   └── cache_test.go
│   ├── compiler/              # Compiler to bytecode
│   │   ├── compiler.go
│   │   ├── compiler_test.go
│   │   └── opcode.go
│   ├── eval/                  # Tree-walk interpreter
│   │   ├── builtins.go
│   │   ├── eval.go
│   │   └── eval_test.go
│   ├── formatter/             # Code formatter
│   │   ├── formatter.go
│   │   └── formatter_test.go
│   ├── lexer/                 # Lexer and tokens
│   │   ├── lexer.go
│   │   ├── lexer_test.go
│   │   └── token.go
│   ├── mcp/                   # MCP server + client (zero-dependency)
│   │   ├── types.go
│   │   ├── server.go
│   │   ├── client.go
│   │   ├── stdio.go
│   │   └── schema.go
│   ├── object/                # Runtime objects
│   │   ├── ai_builtins_test.go
│   │   ├── environment.go
│   │   └── object.go
│   ├── parser/                # Parser
│   │   ├── parser.go
│   │   └── parser_test.go
│   ├── stdlib/                # Standard library helpers
│   └── vm/                    # Bytecode VM
│       ├── vm.go
│       └── vm_test.go
├── examples/                  # ~60 example programs
│   ├── mcp_server.pipe        # MCP server with weather/docs/shell tools
│   ├── mcp_filesystem.pipe    # MCP client using filesystem server
│   ├── mcp_github.pipe        # MCP client using GitHub server
│   ├── mcp_combined.pipe      # MCP hub: own tools + external servers
│   ├── ai_tool_demo.pipe
│   ├── selfhost/              # Self-hosting lexer/parser
│   └── ...
├── test/integration/          # Integration tests
├── vscode/                    # VSCode extension (syntax highlighting + LSP client)
│   ├── src/                   # LSP client bootstrap (TypeScript)
│   ├── syntaxes/pipe.tmLanguage.json
│   └── package.json
├── docs/                      # Documentation (DE + EN)
│   ├── en/                    # English docs (25 chapters)
│   └── de/                    # German docs (25 chapters)
├── website/                   # Project website
├── Makefile
├── go.mod
└── LICENSE