selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Pipelex logo

Self-host Pipelex

v0.93.1

Turn expertise into AI methods that run anywhere

BetaSource AvailableOther
Updated9 hours ago
LanguagePython
Setup difficultyAdvanced
Stars
949
Port
8081 (REST API server)
Requires
Python
Docker
pipelex/pipelex-api
Install with pip

What is Pipelex?

Pipelex lets software teams turn repeatable information-processing tasks — invoice extraction, contract review, HR screening, competitive intelligence — into version-controlled, typed AI methods. You describe the work in natural language; the plugin for Claude Code or Codex writes a .mthds file with explicit steps, typed inputs/outputs, and conditional routing. That single file then runs in three ways: as a FastAPI-based REST API (Docker image pipelex/pipelex-api on port 8081), as an MCP connector for ChatGPT or Claude, or as a generated Next.js web app. The runtime handles model routing across OpenAI, Anthropic, Google, Mistral, Bedrock, local models (Ollama, vLLM, llama.cpp), and adds OCR, image generation, and web search via optional extras. Configuration lives in ~/.pipelex with environment-variable overrides; authentication for the API server supports API-key or JWT modes. The code is source-available under Elastic License 2.0 (no managed-service resale), with a hosted SaaS tier and a fixed-price implementation service.

Should you self-host Pipelex?

Pipelex scores 48/100 on selfhost.directory (how scoring works) and ranks #110 of 209 in AI Agents. It has 949 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v0.93.1, came out on 28 October 2026. New versions land roughly every 1 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Other-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Activepieces (81/100, 25 258 stars). It scores higher overall, so compare the two before you pick. See Pipelex vs Activepieces side by side.

Features

  • AI Method Building
  • Batch Processing
  • Conditional Routing
  • Deterministic Orchestration
  • Image Generation
  • MCP Support
  • Multi-Provider Model Routing
  • OCR Support
  • REST API
  • Typed Concepts
  • TypeScript SDK
  • VS Code extension
  • Web App Scaffolding
  • Web Search

Pipelex README

How to install Pipelex

Install Pipelex with pip

Environment variables
PIPELEX_API_KEY, PIPELEX_BASE_URL, OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.

uv tool install "pipelex[cli]" pipelex init pipelex doctor

Installs the Pipelex CLI; `pipelex init` configures ~/.pipelex and signs in to hosted API or sets up local provider keys

How to configure Pipelex

  • ANTHROPIC_API_KEYAnthropic API key for Claude models

    Anthropic API key for Claude models

  • API_KEYAPI key when AUTH_MODE=api_key

    API key when AUTH_MODE=api_key

  • AUTH_MODEnoneAuthentication mode for the API server: none, api_key, or jwt

    Authentication mode for the API server: none, api_key, or jwt

    values: none | api_key | jwt

  • AWS_ACCESS_KEY_IDAWS access key ID for Bedrock

    AWS access key ID for Bedrock

  • AWS_REGIONAWS region for Bedrock

    AWS region for Bedrock

  • AWS_SECRET_ACCESS_KEYAWS secret access key for Bedrock

    AWS secret access key for Bedrock

  • AZURE_API_BASEAzure OpenAI endpoint base URL

    Azure OpenAI endpoint base URL

  • AZURE_API_KEYAzure OpenAI API key

    Azure OpenAI API key

  • AZURE_API_VERSIONAzure OpenAI API version

    Azure OpenAI API version

  • BLACKBOX_API_KEYBlackbox API key

    Blackbox API key

  • FAL_API_KEYfal.ai API key for image generation

    fal.ai API key for image generation

  • GCP_CREDENTIALS_FILE_PATHgcp_credentials.jsonPath to GCP credentials JSON file

    Path to GCP credentials JSON file

  • GCP_LOCATIONGoogle Cloud location for Vertex AI

    Google Cloud location for Vertex AI

  • GCP_PROJECT_IDGoogle Cloud project ID for Vertex AI

    Google Cloud project ID for Vertex AI

  • GOOGLE_API_KEYGoogle AI Studio API key for Gemini models

    Google AI Studio API key for Gemini models

  • GROQ_API_KEYGroq API key

    Groq API key

  • HF_TOKENHugging Face token

    Hugging Face token

  • JWT_SECRET_KEYJWT secret key when AUTH_MODE=jwt (HS256)

    JWT secret key when AUTH_MODE=jwt (HS256)

  • LANGFUSE_PUBLIC_KEYLangfuse public key for observability

    Langfuse public key for observability

  • LANGFUSE_SECRET_KEYLangfuse secret key for observability

    Langfuse secret key for observability

  • LINKUP_API_KEYLinkup API key for web search

    Linkup API key for web search

  • MAX_UPLOAD_MIB50Maximum upload size in MiB for /v1/upload endpoint

    Maximum upload size in MiB for /v1/upload endpoint

  • MISTRAL_API_KEYMistral API key

    Mistral API key

  • OPENAI_API_KEYOpenAI API key for models like GPT-4o and GPT-5

    OpenAI API key for models like GPT-4o and GPT-5

  • OPENROUTER_API_KEYOpenRouter API key

    OpenRouter API key

  • PIPELEX_API_KEYAPI key for the hosted Pipelex API; obtained via `pipelex login`

    API key for the hosted Pipelex API; obtained via `pipelex login`

  • PIPELEX_BASE_URLhttps://api.pipelex.comOverride the hosted API's origin (scheme://host[:port]) for a staging plane or self-hosted Pipelex API server

    Override the hosted API's origin (scheme://host[:port]) for a staging plane or self-hosted Pipelex API server

  • PIPELEX_ENVdevPipelex environment selector for config overrides

    Pipelex environment selector for config overrides

  • SCALEWAY_API_KEYScaleway API key

    Scaleway API key

  • SCALEWAY_ENDPOINTScaleway endpoint

    Scaleway endpoint

  • TEMPORAL_API_KEYTemporal API key for durable execution

    Temporal API key for durable execution

  • TRUST_FORWARDED_IDENTITY_HEADERSfalseTrust X-User-Id header from reverse proxy

    Trust X-User-Id header from reverse proxy

    values: true | false

  • TYPESAFE_API_KEYTypeSafe API key for judgment

    TypeSafe API key for judgment

  • XAI_API_ENDPOINThttps://api.x.ai/v1/x.ai API endpoint

    x.ai API endpoint

  • XAI_API_KEYx.ai API key for Grok models

    x.ai API key for Grok models

Pipelex releases & version history

FAQ

Who is the Sprint for?

Heads of AI, AI Engineering leads, and COOs in regulated or sensitive environments (banking, insurance, capital markets/PE, freelance platforms) who need repeatability, handle document volume, want code control, and can't afford a 6-month build cycle.

What happens after the Sprint?

You keep the code, methods, and Docker image. Three paths: run autonomously, keep an Extended Pipelex Support contract (monthly), or move to Pipelex Cloud (hosted platform at app.pipelex.com).

Do you offer paid implementation services?

Yes — the Pipelex AI Sprint is a fixed-price, 3-week engagement to ship three automations on your infrastructure for €20,000 (excl. VAT), with contract-backed reliability threshold and a 20% fee reduction if missed.

How is Pipelex licensed?

The MTHDS standard, SDKs, VS Code extension, and UI libraries are open source (MIT). The Pipelex runtime, runner API, MCP server, and plugin are source-available under Elastic License 2.0: you can use, build on, embed, and run them on your own infrastructure, but may not offer them as a hosted/managed service to third parties.

When is Pipelex the right choice?

For repeatable, deterministic AI tasks like invoice processing, contract analysis, report generation, and compliance review where consistent results at scale are needed. Not designed for creative exploration or open-ended tasks.

Is Pipelex an agent framework?

No. Pipelex provides deterministic methods that agents call as tools via MCP or API. It makes agents reliable at repeatable business tasks but doesn't replace your agent stack.

How does Pipelex compare to n8n, Make, Workato?

GUI-based platforms lock methods in their ecosystem. MTHDS methods are plain-text files that can be versioned in Git with semantic versioning, composed across packages with cross-package references, and deployed anywhere.

How does Pipelex compare to LangGraph, Mastra, Pydantic AI?

Those are code-first frameworks with proprietary formats where humans write Python or TypeScript. Pipelex implements the MTHDS open standard: a portable, typed language with a real package system, so methods aren't locked to any runtime.

Can other runtimes implement MTHDS?

Yes. MTHDS is an open standard with a public specification. Any platform can parse .mthds files, validate typed signatures, and execute methods. Pipelex is the reference runtime.

What is the MTHDS standard?

MTHDS is an open standard for defining, packaging, and distributing AI methods with a typed language (.mthds files) and a package system (versioned dependencies, lock files, cross-package references, federated registry at mthds.sh).

Why a new format instead of Python?

Agents need a format they can reliably generate and execute — not free-form code. .mthds files are declarative, deterministic, and portable: agents write them, humans review them, Pipelex runs them. Python stays in the runtime; the method definition stays agent-readable.

More in API Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…