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.

Release/v0.18.1 (#713)

Thomas Hebrard310c1411b5ad
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 892392af4..5fa782fc3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,12 @@
# Changelog
+## [v0.18.1] - 2026-02-25
+
+### Fixed
+
+- Fix docs deployment failure caused by shell metacharacters (parentheses) in Makefile `PRINT_TITLE` macro argument for `docs-deploy-root` target
+- Fix `mike` unable to find `mkdocs` binary by adding venv `bin/` to PATH in all mike-based Makefile targets
+
## [v0.18.0] - 2026-02-25
**Highlights:**
diff --git a/Makefile b/Makefile
index f45b419d1..ae43bc784 100644
--- a/Makefile
+++ b/Makefile
@@ -828,24 +828,29 @@ docs-check: env
$(call PRINT_TITLE,"Checking documentation build with mkdocs")
$(VENV_MKDOCS) build --strict
+docs-serve-versioned: export PATH := $(VIRTUAL_ENV)/bin:$(PATH)
docs-serve-versioned: env
$(call PRINT_TITLE,"Serving versioned documentation with mike")
$(VENV_MIKE) serve
+docs-list: export PATH := $(VIRTUAL_ENV)/bin:$(PATH)
docs-list: env
$(call PRINT_TITLE,"Listing deployed documentation versions")
$(VENV_MIKE) list
+docs-deploy: export PATH := $(VIRTUAL_ENV)/bin:$(PATH)
docs-deploy: env
$(call PRINT_TITLE,"Deploying documentation version $(if $(VERSION),$(VERSION),$(DOCS_VERSION))")
$(VENV_MIKE) deploy $(if $(VERSION),$(VERSION),$(DOCS_VERSION))
+docs-deploy-stable: export PATH := $(VIRTUAL_ENV)/bin:$(PATH)
docs-deploy-stable: env
$(call PRINT_TITLE,"Deploying stable documentation $(DOCS_VERSION) with latest alias")
$(VENV_MIKE) deploy --push --update-aliases $(DOCS_VERSION) latest
$(VENV_MIKE) set-default --push latest
$(MAKE) docs-deploy-root
+docs-deploy-specific-version-pre-release: export PATH := $(VIRTUAL_ENV)/bin:$(PATH)
docs-deploy-specific-version-pre-release: env
$(call PRINT_TITLE,"Deploying documentation $(DOCS_VERSION) with pre-release alias")
$(VENV_MIKE) deploy --push --update-aliases $(DOCS_VERSION) pre-release
@@ -855,7 +860,7 @@ docs-deploy-root:
ifeq ($(SITE_DOMAIN),)
$(error SITE_DOMAIN is empty — docs/CNAME is missing or blank. Cannot generate root assets with valid URLs)
endif
- $(call PRINT_TITLE,"Deploying root assets (404.html, robots.txt, index.html) to gh-pages")
+ $(call PRINT_TITLE,"Deploying root assets to gh-pages")
@git fetch origin gh-pages:gh-pages 2>/dev/null || true; \
TMPDIR=$$(mktemp -d); \
trap "cd '$(CURDIR)'; git worktree remove '$$TMPDIR' 2>/dev/null || true; rm -rf '$$TMPDIR'" EXIT; \
@@ -868,6 +873,7 @@ endif
(git diff --cached --quiet || git commit -m "Update root assets (404.html, robots.txt, index.html)") && \
git push origin gh-pages
+docs-delete: export PATH := $(VIRTUAL_ENV)/bin:$(PATH)
docs-delete: env
ifndef VERSION
$(error VERSION is required. Usage: make docs-delete VERSION=x.y.z)
diff --git a/docs/home/2-get-started/pipe-builder.md b/docs/home/2-get-started/pipe-builder.md
index a35d96202..2d87be724 100644
--- a/docs/home/2-get-started/pipe-builder.md
+++ b/docs/home/2-get-started/pipe-builder.md
@@ -7,7 +7,7 @@ title: "Generate Methods with Pipe Builder"
## Install
```bash
-pip install pipelex --pre
+pip install pipelex
```
```bash
diff --git a/docs/home/4-cookbook-examples/hello-world.md b/docs/home/4-cookbook-examples/hello-world.md
index 38180b476..5e3abee1c 100644
--- a/docs/home/4-cookbook-examples/hello-world.md
+++ b/docs/home/4-cookbook-examples/hello-world.md
@@ -68,7 +68,6 @@ Write a haiku about Hello World.
1. Clone the cookbook repository:
```bash
- # PRERELEASE_LINK
git clone https://github.com/Pipelex/pipelex-cookbook.git
cd pipelex-cookbook
```
@@ -79,7 +78,6 @@ Write a haiku about Hello World.
3. Set up your environment variables by copying `.env.example` to `.env` and adding your API keys.
4. Run the example:
```bash
- # PRERELEASE_LINK
python examples/a_quick_start/hello_world.py
```
diff --git a/pyproject.toml b/pyproject.toml
index 1f3602ede..da9b5706c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "pipelex"
-version = "0.18.0"
+version = "0.18.1"
description = "Execute composable AI methods declared in the MTHDS open standard"
authors = [{ name = "Evotis S.A.S.", email = "[email protected]" }]
maintainers = [{ name = "Pipelex staff", email = "[email protected]" }]
diff --git a/uv.lock b/uv.lock
index 41c8a58c1..2437ceace 100644
--- a/uv.lock
+++ b/uv.lock
@@ -3301,7 +3301,7 @@ wheels = [
[[package]]
name = "pipelex"
-version = "0.18.0"
+version = "0.18.1"
source = { editable = "." }
dependencies = [
{ name = "aiofiles" },