Skip to content

Build AI methods with your coding agent, then run them anywhere: as an MCP for chatbots, as a webapp for people, or via API for your software.

feature/Docs-landing-hero · L-260924-1e66ad (#1251)

Louis Choquel4db52d7447ba
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 80db8292c..8ba1efbd1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,10 @@
## [Unreleased]
+### Changed
+
+- **The documentation's front page takes the README's hero**: it opens on "Turn your expertise into an AI-powered App, MCP or API" and the paragraph on building a method with your coding agent and where it runs. **Get Started** now follows the buttons, and **What a Method Looks Like**, which now introduces the MTHDS language, and **Why Methods?** come after it. The front page's entry in the navigation is now **Overview**.
+
### Fixed
- **The quick start says the Pipelex plugin needs Node.js**: the README's quick start and the documentation's **Quick Start** and **Pipelex Plugin** pages said, in the Claude Code install step, that the plugin needed nothing else to install. Both agents' install steps now say that the plugin's hook and the Pipelex tools run on Node.js, so you need Node.js on your `PATH`; without it the hook passes silently and the tools never start.
diff --git a/docs/index.md b/docs/index.md
index fc4ac61ee..4f50b88ff 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,15 +1,13 @@
---
-title: "Build & Run AI Methods"
+title: "Turn your expertise into an AI-powered App, MCP or API"
description: "Pipelex lets you build AI methods with your coding agent and run them anywhere — from your agent or your chatbot via MCP, as a webapp, or via API in any software."
---
![Pipelex Banner](https://d2cinlfp2qnig1.cloudfront.net/banners/pipelex_banner_docs_v2.png)
-# Build & Run AI Methods
+# Turn your expertise into an AI-powered App, MCP or API
-Pipelex lets you build AI methods with your coding agent and run them anywhere — from your agent or your chatbot via MCP, as a webapp, or via API in any software.
-
-A method is a reusable, typed AI procedure — declared in a `.mthds` file and executed by Pipelex. Each step is explicit, each output is structured, and every run is repeatable.
+Describe how the work gets done in plain English, and your coding agent builds it into a method with the Pipelex plugin. A method is a multi-step, deterministic AI procedure that chains LLMs, OCR, image generation and more. Then run it as a webapp for your team or as SaaS for your customers, from your agent or your chatbot via MCP, or via API in any software.
[:material-rocket-launch: Quick Start](./get-started/quick-start.md){ .md-button .md-button--primary }
[:material-account-plus: Sign up at app.pipelex.com](https://app.pipelex.com){ .md-button }
@@ -17,25 +15,25 @@ A method is a reusable, typed AI procedure — declared in a `.mthds` file and e
---
-## Why Methods?
+## Get Started
<div class="grid cards" markdown>
-- :material-file-document-check: **Declarative**
+- :material-rocket-launch: **[Quick Start](./get-started/quick-start.md)**
- Express business logic at a high level of abstraction, in human-readable `.mthds` files that work across models.
+ Sign up, install the Pipelex plugin in Claude Code or Codex, and ask your agent for the method you want — then run it from your chatbot, as a webapp, or via API.
-- :material-shape-outline: **Typed**
+- :material-laptop: **[Run It Yourself](./get-started/run-it-yourself.md)**
- Concepts are semantic types: AI understands what you mean, and every input and output connects with purpose.
+ Install the Pipelex runtime and run methods on your own machine, against the model providers you choose.
-- :material-refresh: **Repeatable**
+- :material-school: **[MTHDS Language Tutorial](./get-started/mthds-language-tutorial.md)**
- Deterministic orchestration that leaves exactly the room you want for AI to express its intelligence and creativity.
+ Learn the declarative language step by step: concepts, pipes, sequences, inputs, and structured outputs.
-- :material-puzzle: **Composable**
+- :material-book-open-variant: **[Cookbook Examples](./cookbook/index.md)**
- Chain pipes into sequences, nest methods inside methods, and share them with the community.
+ Production-ready recipes — from Hello World to document extraction, synthetic data, and image generation.
</div>
@@ -43,6 +41,8 @@ A method is a reusable, typed AI procedure — declared in a `.mthds` file and e
## What a Method Looks Like
+A method is a reusable, typed AI procedure, written in [MTHDS](https://mthds.ai/latest/), an open standard, and saved as a `.mthds` file. Each step is explicit, each output is structured, and every run is repeatable.
+
A single pipe in MTHDS — five lines that call an LLM with typed inputs and output:
```toml
@@ -57,6 +57,30 @@ From here, Pipelex handles model routing across 60+ models, structured output pa
---
+## Why Methods?
+
+<div class="grid cards" markdown>
+
+- :material-file-document-check: **Declarative**
+
+ Express business logic at a high level of abstraction, in human-readable `.mthds` files that work across models.
+
+- :material-shape-outline: **Typed**
+
+ Concepts are semantic types: AI understands what you mean, and every input and output connects with purpose.
+
+- :material-refresh: **Repeatable**
+
+ Deterministic orchestration that leaves exactly the room you want for AI to express its intelligence and creativity.
+
+- :material-puzzle: **Composable**
+
+ Chain pipes into sequences, nest methods inside methods, and share them with the community.
+
+</div>
+
+---
+
## Capabilities
<div class="grid cards" markdown>
@@ -102,28 +126,3 @@ MTHDS is the open standard behind Pipelex methods. It defines the language, the
- **[Pipelex plugin](./features/pipelex-plugin.md)** — The Pipelex plugin for Claude Code and Codex: skills that build and run methods, a hook that checks every edit, and the Pipelex tools
- **[Pipelex MCP](https://github.com/Pipelex/pipelex-mcp)** — The Pipelex MCP, which ChatGPT or Claude adds to run the methods saved in your account
-
----
-
-## Get Started
-
-<div class="grid cards" markdown>
-
-- :material-rocket-launch: **[Quick Start](./get-started/quick-start.md)**
-
- Sign up, install the Pipelex plugin in Claude Code or Codex, and ask your agent for the method you want — then run it from your chatbot, as a webapp, or via API.
-
-- :material-laptop: **[Run It Yourself](./get-started/run-it-yourself.md)**
-
- Install the Pipelex runtime and run methods on your own machine, against the model providers you choose.
-
-- :material-school: **[MTHDS Language Tutorial](./get-started/mthds-language-tutorial.md)**
-
- Learn the declarative language step by step: concepts, pipes, sequences, inputs, and structured outputs.
-
-- :material-book-open-variant: **[Cookbook Examples](./cookbook/index.md)**
-
- Production-ready recipes — from Hello World to document extraction, synthetic data, and image generation.
-
-</div>
-
diff --git a/docs/root-index.html b/docs/root-index.html
index 49af63840..a1cebcc7c 100644
--- a/docs/root-index.html
+++ b/docs/root-index.html
@@ -4,9 +4,9 @@
<meta charset="utf-8">
<meta http-equiv="refresh" content="0;url=/latest/">
<link rel="canonical" href="https://__SITE_DOMAIN__/latest/">
-<title>Pipelex — Build & Run AI Methods</title>
+<title>Pipelex — Turn your expertise into an AI-powered App, MCP or API</title>
<meta name="description" content="Pipelex lets you build AI methods with your coding agent and run them anywhere — from your agent or your chatbot via MCP, as a webapp, or via API in any software.">
-<meta property="og:title" content="Pipelex — Build & Run AI Methods">
+<meta property="og:title" content="Pipelex — Turn your expertise into an AI-powered App, MCP or API">
<meta property="og:description" content="Pipelex lets you build AI methods with your coding agent and run them anywhere — from your agent or your chatbot via MCP, as a webapp, or via API in any software.">
<meta property="og:url" content="https://__SITE_DOMAIN__/latest/">
<meta property="og:type" content="website">
@@ -28,10 +28,17 @@
</style>
</head>
<body>
-<h1>Pipelex: Build & Run AI Methods</h1>
-<p>Pipelex lets you build AI methods with your coding agent and run them anywhere — from your agent or your chatbot via MCP, as a webapp, or via API in any software.</p>
-<p>A method is a reusable, typed AI procedure declared in a .mthds file and executed by Pipelex. Each step is explicit, each output is structured, and every run is repeatable.</p>
+<h1>Pipelex: Turn your expertise into an AI-powered App, MCP or API</h1>
+<p>Describe how the work gets done in plain English, and your coding agent builds it into a method with the Pipelex plugin. A method is a multi-step, deterministic AI procedure that chains LLMs, OCR, image generation and more. Then run it as a webapp for your team or as SaaS for your customers, from your agent or your chatbot via MCP, or via API in any software.</p>
+<h2>Get Started</h2>
+<ul>
+<li><a href="/latest/get-started/quick-start/">Quick Start</a> — Sign up at <a href="https://app.pipelex.com">app.pipelex.com</a>, install the Pipelex plugin in Claude Code or Codex, and ask your agent for the method you want.</li>
+<li><a href="/latest/get-started/run-it-yourself/">Run It Yourself</a> — Install the Pipelex runtime and run methods on your own machine.</li>
+<li><a href="/latest/get-started/mthds-language-tutorial/">MTHDS Language Tutorial</a> — Learn concepts, pipes, sequences, and structured outputs.</li>
+<li><a href="/latest/cookbook/">Cookbook Examples</a> — From Hello World to document extraction and image generation.</li>
+</ul>
<h2>What a Method Looks Like</h2>
+<p>A method is a reusable, typed AI procedure, written in <a href="https://mthds.ai/latest/">MTHDS</a>, an open standard, and saved as a .mthds file. Each step is explicit, each output is structured, and every run is repeatable.</p>
<pre><code>[pipe.summarize_article]
type = "PipeLLM"
inputs = { article = "Text", audience = "Text" }
@@ -55,13 +62,6 @@ prompt = "Summarize $article in three bullet points for $audience."
<li><a href="/latest/features/validation-dry-run/">Validation and Dry Run</a> — Catch errors without spending tokens.</li>
<li><a href="/latest/features/cli/">CLI and Tooling</a> — Init, build, validate, run, and graph visualization.</li>
</ul>
-<h2>Get Started</h2>
-<ul>
-<li><a href="/latest/get-started/quick-start/">Quick Start</a> — Sign up at <a href="https://app.pipelex.com">app.pipelex.com</a>, install the Pipelex plugin in Claude Code or Codex, and ask your agent for the method you want.</li>
-<li><a href="/latest/get-started/run-it-yourself/">Run It Yourself</a> — Install the Pipelex runtime and run methods on your own machine.</li>
-<li><a href="/latest/get-started/mthds-language-tutorial/">MTHDS Language Tutorial</a> — Learn concepts, pipes, sequences, and structured outputs.</li>
-<li><a href="/latest/cookbook/">Cookbook Examples</a> — From Hello World to document extraction and image generation.</li>
-</ul>
<h2>The MTHDS Ecosystem</h2>
<ul>
<li><a href="https://mthds.ai">mthds.ai</a> — The MTHDS language specification</li>
diff --git a/mkdocs.yml b/mkdocs.yml
index d7a2131be..9b488ca57 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -195,7 +195,7 @@ plugins:
- llmstxt-md:
sections:
Get Started:
- - index.md: "Build & Run AI Methods (landing page)"
+ - index.md: "Turn your expertise into an AI-powered App, MCP or API (landing page)"
- get-started/quick-start.md: "Quick Start"
- get-started/run-it-yourself.md: "Run It Yourself"
- get-started/mthds-language-tutorial.md: "The MTHDS Language Tutorial"
@@ -410,7 +410,7 @@ not_in_nav: |
nav:
- Get Started:
- - Build & Run AI Methods: index.md
+ - Overview: index.md
- Quick Start: get-started/quick-start.md
- Run It Yourself: get-started/run-it-yourself.md
- The MTHDS Language Tutorial: get-started/mthds-language-tutorial.md