Metadata-Version: 2.1
Name: wagtail-ai
Version: 2.0.1
Summary: Get a hand writing your content with AI super powers!
Author-email: Tom Usher <tom@tomusher.com>
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.0
Classifier: Framework :: Wagtail
Classifier: Framework :: Wagtail :: 5
Requires-Dist: Django>=4.2
Requires-Dist: Wagtail>=5.2
Requires-Dist: llm>=0.12
Requires-Dist: mkdocs>=1.5.3 ; extra == "docs"
Requires-Dist: mkdocs-material>=9.4.5 ; extra == "docs"
Requires-Dist: mkdocs-awesome-pages-plugin>=2.9.2 ; extra == "docs"
Requires-Dist: dj-database-url==2.1.0 ; extra == "testing"
Requires-Dist: pre-commit>=3.6.0 ; extra == "testing"
Requires-Dist: django-types>=0.18.0 ; extra == "testing"
Requires-Dist: pytest>=7.4.2 ; extra == "testing"
Requires-Dist: pytest-django>=4.5.2 ; extra == "testing"
Requires-Dist: pytest-mock>=3.12.0 ; extra == "testing"
Requires-Dist: wagtail-factories>=4.1.0 ; extra == "testing"
Requires-Dist: factory-boy>=3.3.0 ; extra == "testing"
Requires-Dist: coverage>=7.4.0 ; extra == "testing"
Project-URL: Home, https://github.com/wagtail/wagtail-ai
Provides-Extra: docs
Provides-Extra: testing

![wagtail-ai](https://user-images.githubusercontent.com/27112/223072917-8354f8f2-b687-44dd-9db7-33f2cc340233.png)

# Wagtail AI

Get help with your content using AI superpowers.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI version](https://badge.fury.io/py/wagtail-ai.svg)](https://badge.fury.io/py/wagtail-ai)
[![ai CI](https://github.com/wagtail/wagtail-ai/actions/workflows/test.yml/badge.svg)](https://github.com/wagtail/wagtail-ai/actions/workflows/test.yml)

Wagtail AI integrates Wagtail with AI's APIs (think ChatGPT) to help you write and correct your content.

Right now, it can:

* Finish what you've started - write some text and tell Wagtail AI to finish it off for you
* Correct your spelling/grammar
* Let you add your own custom prompts
* Work with multiple LLM providers including local models, OpenAI, Mistral, Claude and many others

https://user-images.githubusercontent.com/27112/223072938-8cb5ccff-4835-489a-8be4-cca85001885e.mp4

## Requirements & Costs

Wagtail AI supports [many different LLMs](https://wagtail-ai.readthedocs.io/latest/ai-backends/), with OpenAI models available by default.

To use these, you'll need an OpenAI account and an API key. There'll also be some cost involved. For the OpenAI API used here, OpenAI charges $0.002 for 1,000 tokens (a word is about 1.3 tokens). Every token sent to the API, and every token we get back counts, so you can expect using 'correction' on 1,000 word paragraph to cost roughly:

* (1,000 * 1.3) + (35 * 1.3) (for the initial prompt) tokens sent to the API
* \+ (1,000 * 1.3) tokens received from the API
* = 2,645 tokens = $0.0053

## Links

- [Documentation](https://wagtail-ai.readthedocs.io/)
- [Changelog](https://github.com/wagtail/wagtail-ai/blob/main/CHANGELOG.md)
- [Contributing](https://wagtail-ai.readthedocs.io/latest/contributing/)
- [Discussions](https://github.com/wagtail/wagtail-ai/discussions)
- [Security](https://github.com/wagtail/wagtail-ai/security)

## Supported Versions

* Wagtail 5.2
* Django 4.2
* Python 3.11

