docs: move standalone Agentic users to native pyfly

README.md

@@ -1,3 +1,28 @@
+> [!IMPORTANT]
+> **Moved to pyfly: `pyfly.agentic`.** Active development continues in
+> [fireflyframework-pyfly](https://github.com/fireflyframework/fireflyframework-pyfly), starting with
+> [pyfly v26.10.08](https://github.com/fireflyframework/fireflyframework-pyfly/releases/tag/v26.10.08) (package version `26.10.8`).
+> Use the [native Agentic documentation](https://fireflyframework.github.io/fireflyframework-pyfly/docs/modules/agentic/) and
+> [migration guide](https://fireflyframework.github.io/fireflyframework-pyfly/docs/modules/agentic/migration/). This repository, its releases and the
+> standalone documentation below are retained as historical material.
+> Replace `fireflyframework_agentic` imports with `pyfly.agentic`,
+> `FireflyAgent` with `Agent`, `BaseTool` with `AgentTool`, and
+> `@firefly_agent` / `@firefly_tool` with `@agent` / `@agent_tool`.
+> The native module provides no aliases for the old namespace or names.
+
+```bash
+python -m pip install "pyfly[agentic] @ https://github.com/fireflyframework/fireflyframework-pyfly/releases/download/v26.10.08/pyfly-26.10.8-py3-none-any.whl"
+```
+
+Enable `pyfly.agentic.enabled: true` in your pyfly application. Rename
+`FIREFLY_AGENTIC_*` settings to `PYFLY_AGENTIC_*` and select namespaced integration
+extras such as `agentic-postgres`. Follow the migration guide for configuration,
+application-owned runtime services, plugins and persistent data.
+
+---
+
+## Historical standalone project
+
 <p align="center">
   <a href="https://fireflyframework.github.io/fireflyframework-agentic/"><img src="assets/banner.svg" alt="agentic by Firefly — Intelligence, composed." width="100%"></a>
 </p>
@@ -21,7 +46,7 @@
   <a href="https://microsoft.github.io/pyright/"><img src="https://img.shields.io/badge/type--checked-pyright-2c8a1c.svg" alt="Type checked: pyright"></a>
 </p>
 
-Current release: [26.10.1](https://github.com/fireflyframework/fireflyframework-agentic/releases/tag/v26.10.1).
+Final standalone release: [26.10.1](https://github.com/fireflyframework/fireflyframework-agentic/releases/tag/v26.10.1).
 This release refreshes dependencies and preserves PostgreSQL's whole-batch
 rejection of cross-namespace ID conflicts. Read the
 [upgrade notes](docs/migration.md#dependency-refresh-in-26101) and

docs/README.md

@@ -1,4 +1,27 @@
-# Firefly Agentic documentation
+> [!IMPORTANT]
+> **Moved to pyfly: `pyfly.agentic`.** Active development continues in
+> [fireflyframework-pyfly](https://github.com/fireflyframework/fireflyframework-pyfly), starting with
+> [pyfly v26.10.08](https://github.com/fireflyframework/fireflyframework-pyfly/releases/tag/v26.10.08) (package version `26.10.8`).
+> Use the [native Agentic documentation](https://fireflyframework.github.io/fireflyframework-pyfly/docs/modules/agentic/) and
+> [migration guide](https://fireflyframework.github.io/fireflyframework-pyfly/docs/modules/agentic/migration/). This repository, its releases and the
+> standalone documentation below are retained as historical material.
+> Replace `fireflyframework_agentic` imports with `pyfly.agentic`,
+> `FireflyAgent` with `Agent`, `BaseTool` with `AgentTool`, and
+> `@firefly_agent` / `@firefly_tool` with `@agent` / `@agent_tool`.
+> The native module provides no aliases for the old namespace or names.
+
+```bash
+python -m pip install "pyfly[agentic] @ https://github.com/fireflyframework/fireflyframework-pyfly/releases/download/v26.10.08/pyfly-26.10.8-py3-none-any.whl"
+```
+
+Enable `pyfly.agentic.enabled: true` in your pyfly application. Rename
+`FIREFLY_AGENTIC_*` settings to `PYFLY_AGENTIC_*` and select namespaced integration
+extras such as `agentic-postgres`. Follow the migration guide for configuration,
+application-owned runtime services, plugins and persistent data.
+
+---
+
+# Historical standalone Agentic documentation
 
 Start with the [published documentation](https://fireflyframework.github.io/fireflyframework-agentic/)
 or follow the same guides here on GitHub.

docs/index.md

@@ -1,9 +1,8 @@
 ---
-title: Firefly Agentic
+title: Agentic moved to pyfly
 description: >-
-  The production-grade agentic metaframework, built on Pydantic AI. Build with
-  Firefly agents, tools and typed model options — gain lifecycle hooks, delegation,
-  memory, reasoning patterns, validation loops, RAG and DAG pipelines.
+  Agentic development has moved to pyfly's native pyfly.agentic module.
+  This site preserves the historical standalone documentation.
 template: home.html
 hide:
   - navigation

docs/migration.md

@@ -2,8 +2,23 @@
 
 Copyright 2026 Firefly Software Foundation. SPDX-License-Identifier: Apache-2.0.
 
-This guide covers the 26.10.1 dependency refresh, PostgreSQL vector-store safety
-in 26.10.0, the Pydantic AI 2.x upgrade, and earlier API changes.
+## Move to native pyfly Agentic
+
+Active development has moved to [pyfly](https://github.com/fireflyframework/fireflyframework-pyfly) and the `pyfly.agentic`
+namespace, starting with [v26.10.08](https://github.com/fireflyframework/fireflyframework-pyfly/releases/tag/v26.10.08) (package version `26.10.8`).
+Follow the [native migration checklist](https://fireflyframework.github.io/fireflyframework-pyfly/docs/modules/agentic/migration/) and
+[installation guide](https://fireflyframework.github.io/fireflyframework-pyfly/docs/modules/agentic/getting-started/installation/).
+
+Replace the standalone distribution with `pyfly[agentic]`; rename imports to
+`pyfly.agentic`, `FireflyAgent` to `Agent`, `BaseTool` to `AgentTool`, and
+`@firefly_agent` / `@firefly_tool` to `@agent` / `@agent_tool`.
+The native module provides no aliases for the old names. Rename settings to
+`PYFLY_AGENTIC_*`, enable `pyfly.agentic.enabled`, use namespaced integration extras,
+and adopt application-owned runtime services as described in the native guide.
+
+The rest of this page preserves the historical standalone 26.10.1 dependency
+refresh, PostgreSQL vector-store safety in 26.10.0, Pydantic AI 2.x upgrade, and
+earlier API changes. These version numbers refer to the standalone distribution.
 
 ## Dependency refresh in 26.10.1
 

docs/stylesheets/firefly.css

@@ -65,6 +65,10 @@
   --md-default-bg-color:        #10110f;
 }
 
+/* The migration announcement has a dark surface in both color schemes. */
+.md-banner a { color: var(--ff-accent-bright); text-decoration: underline; }
+.md-banner a:focus-visible { outline: 2px solid var(--ff-accent-bright); outline-offset: 3px; }
+
 /* Display face for all headings, in docs and on the landing. */
 .md-typeset h1,
 .md-typeset h2,

examples/README.md

@@ -1,3 +1,10 @@
+> [!IMPORTANT]
+> This is the historical standalone example catalogue. Native examples now live in
+> [pyfly's `examples/agentic`](https://github.com/fireflyframework/fireflyframework-pyfly/tree/main/examples/agentic).
+> Install [pyfly v26.10.08](https://github.com/fireflyframework/fireflyframework-pyfly/releases/tag/v26.10.08) or later and follow the
+> [migration guide](https://fireflyframework.github.io/fireflyframework-pyfly/docs/modules/agentic/migration/) before adapting an application.
+> The setup commands and old API names below describe the standalone release.
+
 # Examples
 
 Copyright 2026 Firefly Software Foundation. Licensed under the Apache License 2.0.

mkdocs.yml

@@ -1,12 +1,11 @@
 # Firefly Agentic — documentation site (MkDocs + Material).
 # Local preview:  pip install -r docs/requirements.txt && mkdocs serve
 # Build (CI):     mkdocs build --strict
-site_name: Firefly Agentic
+site_name: Firefly Agentic (historical)
 site_url: https://fireflyframework.github.io/fireflyframework-agentic/
 site_description: >-
-  The production-grade agentic metaframework, built on Pydantic AI. Build with
-  Firefly agents, tools and typed model options — gain lifecycle hooks, delegation,
-  memory, reasoning patterns, validation loops, RAG and DAG pipelines.
+  Historical standalone Agentic documentation. Active development has moved to
+  pyfly's native pyfly.agentic module, starting with pyfly v26.10.08.
 site_author: Firefly Software Foundation
 copyright: Copyright © 2026 Firefly Software Foundation — Apache-2.0
 

overrides/home.html

@@ -10,12 +10,12 @@
 
 {% block extrahead %}
   <meta property="og:type" content="website">
-  <meta property="og:title" content="Firefly Agentic — the production-grade agentic metaframework">
+  <meta property="og:title" content="Agentic moved to pyfly — historical standalone documentation">
   <meta property="og:description" content="{{ config.site_description }}">
   <meta name="twitter:card" content="summary_large_image">
 {% endblock %}
 
-{% block htmltitle %}<title>Firefly Agentic — production-grade agents on Pydantic AI</title>{% endblock %}
+{% block htmltitle %}<title>Agentic moved to pyfly — historical documentation</title>{% endblock %}
 
 {% block tabs %}
 <div class="ff-home">
@@ -24,41 +24,48 @@
   <section class="ff-hero">
     <canvas class="ff-constellation" id="ff-constellation" aria-hidden="true"></canvas>
     <div class="ff-wrap">
-      <h1 class="ff-hero__title">Agents you can run in <span class="ff-grad">production</span>.</h1>
+      <h1 class="ff-hero__title">Agentic has moved to <span class="ff-grad">pyfly</span>.</h1>
       <p class="ff-hero__lead">
-        Firefly Agentic is the production-grade metaframework built on Pydantic AI.
-        Use Firefly agents, tools, memory and typed model options — gain
-        lifecycle hooks, delegation, reasoning patterns, validation loops, RAG
-        and DAG pipelines. Keep provider choices in configuration and compose the features you need.
+        Active development continues in <code>pyfly.agentic</code>, the native,
+        opt-in Agentic module in pyfly v26.10.08 (package version 26.10.8).
+        Use <code>Agent</code>, <code>AgentTool</code>, <code>@agent</code> and
+        <code>@agent_tool</code>. The old namespace and public names have no aliases.
       </p>
 
       <div class="ff-install">
         <span class="ff-install__prompt">$</span>
-        <span class="ff-install__cmd">curl -fsSL https://raw.githubusercontent.com/fireflyframework/fireflyframework-agentic/main/install.sh | bash</span>
-        <button class="ff-install__copy" data-copy="curl -fsSL https://raw.githubusercontent.com/fireflyframework/fireflyframework-agentic/main/install.sh | bash" aria-label="Copy install command">
+        <span class="ff-install__cmd">python -m pip install &quot;pyfly[agentic] @ https://github.com/fireflyframework/fireflyframework-pyfly/releases/download/v26.10.08/pyfly-26.10.8-py3-none-any.whl&quot;</span>
+        <button class="ff-install__copy" data-copy="python -m pip install &quot;pyfly[agentic] @ https://github.com/fireflyframework/fireflyframework-pyfly/releases/download/v26.10.08/pyfly-26.10.8-py3-none-any.whl&quot;" aria-label="Copy install command">
           <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
         </button>
       </div>
 
-      <p class="ff-install-note">This installer follows <code>main</code>. For a pinned version, <a href="{{ base_url }}/getting-started/installation/#install-a-release">install the v26.10.0 release</a>.</p>
+      <p class="ff-install-note">Install the released pyfly wheel with the <code>agentic</code> extra, then enable <code>pyfly.agentic.enabled</code>. <a href="https://fireflyframework.github.io/fireflyframework-pyfly/docs/modules/agentic/migration/">Follow the migration checklist</a>. This site and the standalone releases are retained as historical material.</p>
 
       <div class="ff-cta-row">
-        <a class="ff-btn ff-btn--primary" href="{{ base_url }}/getting-started/installation/">
-          Get started
+        <a class="ff-btn ff-btn--primary" href="https://fireflyframework.github.io/fireflyframework-pyfly/docs/modules/agentic/">
+          Open native Agentic docs
           <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14M13 6l6 6-6 6"/></svg>
         </a>
-        <a class="ff-btn ff-btn--ghost" href="{{ base_url }}/tutorial/">
+        <a class="ff-btn ff-btn--ghost" href="https://fireflyframework.github.io/fireflyframework-pyfly/docs/modules/agentic/migration/">
           <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20"/><path d="M6.5 2H20v20H6.5A2.5 2.5 0 0 1 4 19.5v-15A2.5 2.5 0 0 1 6.5 2z"/></svg>
-          Read the tutorial
+          Migrate to pyfly
         </a>
-        <a class="ff-btn ff-btn--ghost" href="{{ config.repo_url }}" target="_blank" rel="noopener">
+        <a class="ff-btn ff-btn--ghost" href="https://github.com/fireflyframework/fireflyframework-pyfly" target="_blank" rel="noopener">
           <svg viewBox="0 0 24 24" fill="currentColor"><path d="M12 .5C5.7.5.5 5.7.5 12c0 5.1 3.3 9.4 7.9 10.9.6.1.8-.2.8-.5v-1.8c-3.2.7-3.9-1.5-3.9-1.5-.5-1.3-1.3-1.7-1.3-1.7-1.1-.7.1-.7.1-.7 1.2.1 1.8 1.2 1.8 1.2 1 1.8 2.7 1.3 3.4 1 .1-.8.4-1.3.7-1.6-2.6-.3-5.3-1.3-5.3-5.7 0-1.3.5-2.3 1.2-3.1-.1-.3-.5-1.5.1-3.1 0 0 1-.3 3.3 1.2a11.5 11.5 0 0 1 6 0C17.3 4.8 18.3 5.1 18.3 5.1c.6 1.6.2 2.8.1 3.1.8.8 1.2 1.8 1.2 3.1 0 4.4-2.7 5.4-5.3 5.7.4.4.8 1.1.8 2.2v3.3c0 .3.2.6.8.5A11.5 11.5 0 0 0 23.5 12C23.5 5.7 18.3.5 12 .5z"/></svg>
           GitHub
         </a>
       </div>
     </div>
   </section>
 
+  <section class="ff-section ff-section--tint">
+    <div class="ff-wrap">
+      <h2 class="ff-section__title">Historical standalone reference</h2>
+      <p class="ff-section__sub">The guides, examples and API names below describe the former standalone distribution. Use the native pyfly documentation for current development.</p>
+    </div>
+  </section>
+
   <!-- ============================ TRUST ============================ -->
   <div class="ff-wrap">
     <div class="ff-trust">

overrides/main.html

@@ -0,0 +1,8 @@
+{% extends "base.html" %}
+
+{% block announce %}
+  <strong>Agentic moved to <a href="https://fireflyframework.github.io/fireflyframework-pyfly/docs/modules/agentic/">pyfly: <code>pyfly.agentic</code></a>.</strong>
+  This is historical standalone documentation.
+  <a href="https://github.com/fireflyframework/fireflyframework-pyfly/releases/tag/v26.10.08">pyfly v26.10.08</a> ·
+  <a href="https://fireflyframework.github.io/fireflyframework-pyfly/docs/modules/agentic/migration/">Migration guide</a>
+{% endblock %}