Skip to content

[AAASM-4576] ✨ (python-sdk-docs): Add poetry/conda install tabs to quick-start - #249

Merged
Chisanan232 merged 1 commit into
masterfrom
v0.1.0/AAASM-4576/feat/poetry_conda_tabs
Jul 13, 2026
Merged

[AAASM-4576] ✨ (python-sdk-docs): Add poetry/conda install tabs to quick-start#249
Chisanan232 merged 1 commit into
masterfrom
v0.1.0/AAASM-4576/feat/poetry_conda_tabs

Conversation

@Chisanan232

@Chisanan232 Chisanan232 commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Description

Adds poetry and conda install tabs to docs/quick-start.md's install section, alongside the existing pip/uv tabs (4 tabs total). Install commands are sourced from docs_macros.py's shared aa.commands.* metadata (same pattern as the existing install_pip/install_uv entries), not hardcoded in the Markdown.

  • poetry: poetry add agent-assembly --allow-prereleases (pure-Python) and poetry add 'agent-assembly[runtime]' --allow-prereleases (bundled-runtime extra — the runtime extra name is confirmed from pyproject.toml's [project.optional-dependencies]). --allow-prereleases is poetry's equivalent of pip's --pre / uv's --prerelease=allow, needed because agent-assembly is currently only published as a pre-release (0.0.1rc3/rc4) on PyPI.
  • conda: agent-assembly is not published on conda-forge or the Anaconda default channel — I checked https://anaconda.org/conda-forge/agent-assembly (404) and searched for a agent-assembly-feedstock conda-forge repo (none found). Rather than show a fabricated conda install agent-assembly command, the conda tab shows the standard real-world workaround for a pip-only package: create a conda env, then pip install --pre agent-assembly inside it. This is called out explicitly in the tab body so it isn't mistaken for a native conda-forge package.

Type of Change

  • ✨ New feature
  • 🔧 Bug fix
  • ♻️ Refactoring
  • 🍀 Performance improvement
  • 📚 Documentation update
  • 🚀 Release

Breaking Changes

  • No
  • Yes (please describe below)

Related Issues

  • Related JIRA ticket: AAASM-4576
  • Related GitHub issues: n/a

Testing

  • Unit tests added/updated
  • Integration tests added/updated
  • Manual testing performed
  • No tests required (explain why)

Ran uv sync --group docs && uv run mkdocs build --strict (exit 0, no new warnings) and inspected the rendered site/quick-start/index.html to confirm all 4 tabs (pip/uv/poetry/conda) render with the correct macro-substituted commands.

Checklist

  • Code follows project style guidelines
  • Self-review completed
  • Comments added for complex logic
  • Documentation updated if needed
  • All tests passing (docs-only change; ci.yaml's path allow-list excludes docs/**, so no CI runs on this PR per repo convention — mkdocs build --strict was validated locally)

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
@Chisanan232

Copy link
Copy Markdown
Contributor Author

Review: AAASM-4576 poetry/conda install tabs

CI: All 5 applicable checks green (Analyze (python), analyze, quick-start tabs drift, Build documentation (PR, no deploy), CodeQL). The 3 deploy jobs show SKIPPED, which is expected for a non-merge PR build. No red checks to fix.

Scope completeness: Confirmed.

  • All 4 tabs (pip / uv / poetry / conda) render in docs/quick-start.md §1 Install, sourced from docs_macros.py's aa.commands.* macros as claimed.
  • Conda honesty: verified agent-assembly is not on conda-forge (checked https://anaconda.org/conda-forge/agent-assembly → 404, and there's no agent-assembly-feedstock). The conda tab body explicitly says "is not published on conda-forge or the Anaconda default channel" before showing the conda create + pip install workaround — matches the PR description, not misrepresented as a native package.
  • Poetry syntax: poetry add <pkg> --allow-prereleases is real, current Poetry CLI syntax (confirmed against python-poetry.org docs) — not invented.
  • [runtime] extra: confirmed against pyproject.toml[project.optional-dependencies] defines runtime = [], matching poetry add 'agent-assembly[runtime]' --allow-prereleases in the new tab.

Regression check: git diff against master shows 2 files changed, 22 insertions / 0 deletions — the existing pip/uv tabs in quick-start.md and all previously-existing macros in docs_macros.py (install_uv, install_pip, install_pip_runtime, plus python_sdk/urls sections) are untouched; only the 4 new keys (install_poetry, install_poetry_runtime, install_conda, install_conda_pip) and the 2 new tab blocks were added.

Playwright validation: Built with uv sync --group docs && uv run mkdocs build --strict — exit 0, no strict-mode warnings/errors. Served locally and drove a real browser through all 4 tabs on /quick-start/:

  • pip — unchanged, renders as before.
  • uv — unchanged.
  • poetry — both poetry add agent-assembly --allow-prereleases and poetry add 'agent-assembly[runtime]' --allow-prereleases render fully, correctly quoted, not truncated.
  • conda — the "not published on conda-forge" disclaimer renders above the commands; conda create -n agent-assembly python=3.12 && conda activate agent-assembly and pip install --pre agent-assembly render fully and readably.

Verdict: READY

No blocking issues found across CI, scope, regression, or rendering.

— Claude Code

@Chisanan232
Chisanan232 merged commit 4e95ddb into master Jul 13, 2026
8 checks passed
@Chisanan232
Chisanan232 deleted the v0.1.0/AAASM-4576/feat/poetry_conda_tabs branch July 13, 2026 13:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant