From cbddbb62977490e97eb6269c570e1878c30bea1e Mon Sep 17 00:00:00 2001 From: Bryant Date: Mon, 13 Jul 2026 21:06:35 +0800 Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20(docs):=20Add=20poetry/conda=20inst?= =?UTF-8?q?all=20tabs=20to=20quick-start?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit poetry mirrors pip's --pre behavior via --allow-prereleases (package is pre-release-only on PyPI). agent-assembly is not published on conda-forge or the Anaconda default channel, so the conda tab creates an env and installs from PyPI with pip inside it rather than showing a native `conda install` command. Refs AAASM-4576 --- docs/quick-start.md | 18 ++++++++++++++++++ docs_macros.py | 4 ++++ 2 files changed, 22 insertions(+) diff --git a/docs/quick-start.md b/docs/quick-start.md index 9c7a2c9f..a9944c99 100644 --- a/docs/quick-start.md +++ b/docs/quick-start.md @@ -24,6 +24,24 @@ The package is published on PyPI as {{ aa.commands.install_uv }} ``` +=== "poetry" + + ```bash + {{ aa.commands.install_poetry }} # pure-Python SDK + {{ aa.commands.install_poetry_runtime }} # SDK + bundled aasm runtime binary (platform wheel) + ``` + +=== "conda" + + `{{ aa.python_sdk.package_name }}` is not published on conda-forge or the + Anaconda default channel — create a conda environment, then install from + PyPI with `pip` inside it: + + ```bash + {{ aa.commands.install_conda }} + {{ aa.commands.install_conda_pip }} + ``` + !!! note "`--pre` is required for now" Agent Assembly is currently published only as a pre-release on PyPI, and `pip` skips pre-releases unless you pass `--pre` (already included above). Drop the flag diff --git a/docs_macros.py b/docs_macros.py index 9c451c95..c87b201f 100644 --- a/docs_macros.py +++ b/docs_macros.py @@ -63,6 +63,10 @@ def define_env(env: Any) -> None: "install_uv": "uv add --prerelease=allow agent-assembly", "install_pip": "pip install --pre agent-assembly", "install_pip_runtime": "pip install --pre 'agent-assembly[runtime]'", + "install_poetry": "poetry add agent-assembly --allow-prereleases", + "install_poetry_runtime": "poetry add 'agent-assembly[runtime]' --allow-prereleases", + "install_conda": "conda create -n agent-assembly python=3.12 && conda activate agent-assembly", + "install_conda_pip": "pip install --pre agent-assembly", }, }