collective.aitools

This package provides tools powered by AI, both for editors as for anonymous visitors

Features

All features are individually enabled and configured (model, prompt) from the AI Tools control panel, and reach a model through collective.aisettings (configure your provider/models in AI Settings).

Editor tools (buttons on the classic-UI add/edit forms; fill a field only when it's empty):

• Summarize — generate a Description / summary from the item's body text (also usable as the SEO meta description).
• Suggest tags — propose Subject keywords from the body text, reusing tags already in use on the site where possible.
• Get image details — title, description (alt text) and tags for an item's image, using a vision model.
• Help me write — drafting and rewriting assistance (start a draft, grammar check, change tone).

Assistant — a floating chat widget for authenticated users. It's agentic: it can call capabilities to ground its answers and guide editors, rather than guessing. Built-in capabilities:

• Search the site — full-text search (respects each user's permissions).
• Where to add — suggest folders where a given content type can be created.
• Propose a draft — from a rough brief, generate a draft (title, summary, body) for the editor to confirm and then adjust. Content is only created after an explicit confirmation, and always re-validated server-side.

Loose content-type names ("page", "news", "article", …) are accepted, and add-ons can contribute their own synonyms by registering an IContentTypeSynonyms utility.

Installation

Install collective.aitools with uv.

uv add collective.aitools

Create the Plone site.

make create-site

Contribute

• Issue tracker
• Source code

Prerequisites ✅

• An operating system that runs all the requirements mentioned.
• uv
• Make
• Git
• Docker (optional)

Installation 🔧

1. Clone this repository.

   git clone git@github.com:collective/collective-ai-tools.git
   cd collective-ai-tools/backend
   

2. Install this code base.

   make install
   

Add features using plonecli or bobtemplates.plone

This package provides markers as strings (<!-- extra stuff goes here -->) that are compatible with plonecli and bobtemplates.plone. These markers act as hooks to add all kinds of features through subtemplates, including behaviors, control panels, upgrade steps, or other subtemplates from bobtemplates.plone. plonecli is a command line client for bobtemplates.plone, adding autocompletion and other features.

To add a feature as a subtemplate to your package, use the following command pattern.

make add <template_name>

For example, you can add a content type to your package with the following command.

make add content_type

You can add a behavior with the following command.

make add behavior

You can check the list of available subtemplates in the [`bobtemplates.plone` `README.md` file](https://github.com/plone/bobtemplates.plone/?tab=readme-ov-file#provided-subtemplates).
See also the documentation of [Mockup and Patternslib](https://6.docs.plone.org/classic-ui/mockup.html) for how to build the UI toolkit for Classic UI.

License

The project is licensed under GPLv2.

Credits and acknowledgements 🙏

Generated using Cookieplone (2.0.0b3) and cookieplone-templates (4aa42c6) on 2026-06-29 18:13:58.341660. A special thanks to all contributors and supporters!