PipeAI

Natural language → shell commands. Cloud or local AI.

Install

From Release

# Linux/macOS (AMD64)
curl -L https://github.com/brasa-ai/pipeai/releases/download/stable/pipeai-linux-amd64.tar.gz -o pipeai-linux-amd64.tar.gz
tar -xvf pipeai-linux-amd64.tar.gz pipeai-linux-amd64
chmod +x pipeai-linux-amd64
sudo mv pipeai-linux-amd64 /usr/local/bin/pipeai

# Linux/macOS (ARM64)
curl -L https://github.com/brasa-ai/pipeai/releases/download/stable/pipeai-linux-arm64.tar.gz -o pipeai-linux-arm64.tar.gz
tar -xvf pipeai-linux-arm64.tar.gz pipeai-linux-arm64
chmod +x pipeai-linux-arm64
sudo mv pipeai-linux-arm64 /usr/local/bin/pipeai

# Windows (PowerShell)
Invoke-WebRequest -Uri https://github.com/brasa-ai/pipeai/releases/download/stable/pipeai-windows-amd64.zip -OutFile pipeai-windows-amd64.zip
Expand-Archive -Path pipeai-windows-amd64.zip -DestinationPath .
Move-Item -Path pipeai-windows-amd64/pipeai-windows-amd64.exe -Destination pipeai.exe

From Source

# Clone repository
git clone https://github.com/brasa-ai/pipeai.git
cd pipeai

# Build binary
go build -o pipeai .

# Install globally (Linux/macOS)
sudo mv pipeai /usr/local/bin/

# Or use go install
go install github.com/brasa-ai/pipeai@latest

Usage

# Generate only
pipeai --ask "list PDF files"

# Generate + execute
pipeai --act "list PDF files"

# Configure
pipeai setup

Configuration

PipeAI supports multiple AI providers through an interactive setup process:

# Run interactive setup
pipeai setup

# Example session:
LLM provider (gemini/openai/ollama) []: gemini
API key (skip for ollama) []: YOUR_GEMINI_KEY
Model []: gemini-pro

The configuration is stored in ~/.pipeai/config.yaml:

# Example config for different providers:

# Gemini
llm: gemini
model: gemini-pro
key: YOUR_GEMINI_KEY

# OpenAI
llm: openai
model: gpt-4o
key: YOUR_OPENAI_KEY

# Ollama (local)
llm: ollama
model: llama2
key: ""  # not needed

You can also override config values via flags:

pipeai --llm ollama --model codellama --ask "find large files"

Examples

Cross-Platform Commands

# Same command, different OS:
pipeai --ask "show memory usage"
# → Windows: wmic OS get FreePhysicalMemory,TotalVisibleMemorySize /Value
# → Linux: free -h
# → macOS: vm_stat && system_profiler SPHardwareDataType | grep Memory

pipeai --ask "find process by name"
# → Windows: tasklist | findstr "process"
# → Linux/macOS: ps aux | grep process

pipeai --ask "show disk usage"
# → Windows: wmic logicaldisk get size,freespace,caption
# → Linux/macOS: df -h

Kubernetes

# Pod management
pipeai --act "get all pods not running in namespace prod"
# → kubectl get pods -n prod --field-selector status.phase!=Running

pipeai --act "list pods with high restart count"
# → kubectl get pods --all-namespaces --sort-by='.status.containerStatuses[0].restartCount'

# Resource usage
pipeai --act "show memory usage of all nodes"
# → kubectl top nodes | sort -k4 -hr

pipeai --act "find pods using more than 2GB memory"
# → kubectl top pods --all-namespaces | awk '$4 > 2000Mi'

# Logs and debugging
pipeai --act "show errors in all pod logs from last hour"
# → kubectl logs --all-containers --since=1h | grep -i error

Docker & Containers

# Cleanup
pipeai --act "remove all stopped containers and unused images"
# → docker rm $(docker ps -aq) && docker image prune -af

# Monitoring
pipeai --act "show containers using most memory"
# → docker stats --no-stream --format "{{.Container}}: {{.MemUsage}}" | sort -k2 -hr

pipeai --act "list containers with open ports"
# → docker ps --format "{{.Names}}: {{.Ports}}" | grep -v '^:'

System Operations

# File operations
pipeai --act "find large log files modified in last 24h"
# → Windows: forfiles /P "C:\Logs" /M *.log /D -1 /C "cmd /c if @fsize GEQ 104857600 echo @path @fsize"
# → Linux/macOS: find /var/log -type f -mtime -1 -size +100M -exec ls -lh {} \;

# Process management
pipeai --act "show processes eating CPU sorted by usage"
# → Windows: tasklist /v /fi "CPUTIME gt 00:01:00" /fo list
# → Linux/macOS: ps aux --sort=-%cpu | head -n 11

# Network
pipeai --act "show active connections by port usage"
# → Windows: netstat -ano | findstr LISTENING
# → Linux/macOS: netstat -tuln | awk 'NR>2 {print $4}' | sort | uniq -c | sort -nr

Pipeline Processing

# File processing
echo "*.pdf" | pipeai --act "find all matching files recursively"
# → Windows: dir /s /b *.pdf
# → Linux/macOS: find . -type f -name "*.pdf"

# Process filtering
ps aux | pipeai --act "show processes using more than 1GB RAM"
# → awk 'NR>1 && $6>1000000 {print}'

# JSON/YAML handling
kubectl get pods -o json | pipeai --act "extract container images"
# → jq -r '.items[].spec.containers[].image' | sort | uniq

cat values.yaml | pipeai --act "get all image tags"
# → yq -r '.. | select(has("image")) | .image' | sort | uniq

Git Operations

# History analysis
pipeai --act "show commits touching kubernetes files in last week"
# → git log --since="1 week ago" --pretty=format:"%h %s" -- "**/k8s/*.yaml"

pipeai --act "find who changed this line in git history"
# → git log -L '/pattern/',+1:file.txt

# Branch management
pipeai --act "list branches not merged to main"
# → git branch --no-merged main | grep -v '^*'

Providers

• Gemini: pipeai --llm gemini --model gemini-pro --key YOUR_KEY
• OpenAI: pipeai --llm openai --model gpt-4o --key YOUR_KEY
• Ollama: pipeai --llm ollama --model llama2 (local, install)

Debug

pipeai --act "list files" --debug