PHPackages                             alt-design/alt-ai - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. alt-design/alt-ai

ActiveLibrary[Utility & Helpers](/categories/utility)

alt-design/alt-ai
=================

Alt AI addon, content bits and bobs at their finest

V1.0.0-beta(6mo ago)018MITJavaScriptPHP ^8.1

Since Nov 11Pushed 6mo agoCompare

[ Source](https://github.com/alt-design/Alt-AI-Addon)[ Packagist](https://packagist.org/packages/alt-design/alt-ai)[ RSS](/packages/alt-design-alt-ai/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

Alt AI Addon - BETA
===================

[](#alt-ai-addon---beta)

> AI-powered content assistance for Bard & Other bits using OpenAI

Features
--------

[](#features)

- AI Agent with conversational modal for multi-turn interactions with full document context
- Global AI chat widget available throughout the Statamic control panel
- AI completion for auto-completing text based on context
- Content enhancement to improve grammar, clarity, and readability
- Text summarisation for creating concise summaries
- Translation capabilities for multiple languages
- Tone adjustment (formal, casual, professional, friendly)
- Context-aware assistance that understands your page, collection, and entry
- Keyboard shortcuts for quick access to AI features
- Conversation history maintained across sessions

How to Install
--------------

[](#how-to-install)

```
composer require alt-design/alt-ai
```

Publish the configuration file:

```
php artisan vendor:publish --tag=alt-ai-config
```

This will create a configuration file at `config/alt-ai.php`

Configuration
-------------

[](#configuration)

### API Key Setup

[](#api-key-setup)

Get your OpenAI API key from [OpenAI Platform](https://platform.openai.com/api-keys) and add it to your `.env` file:

```
OPENAI_API_KEY=your_openai_api_key_here
OPENAI_MODEL=gpt-4
```

### Configuration Options

[](#configuration-options)

Edit `config/alt-ai.php` to customize the addon:

```
return [
    'api_key' => env('OPENAI_API_KEY', ''),

    'capabilities' => [
        'completion' => true,
        'enhancement' => true,
        'summarization' => true,
        'translation' => true,
        'tone_adjustment' => true,
    ],

    'model' => [
        'name' => env('OPENAI_MODEL', 'gpt-4'),
        'temperature' => 0.7,
        'max_tokens' => 2000,
    ],
];
```

Available OpenAI models: `gpt-4` (most capable), `gpt-4-turbo-preview` (faster), or `gpt-3.5-turbo` (efficient for simpler tasks).

Usage
-----

[](#usage)

### What the frig can it do?

[](#what-the-frig-can-it-do)

Good question. AI's somewhat unpredictable - so sometimes it'll work better than others. Prompt it specifically and it should be able to do "stuff". **What we know it does do**

- It knows the context of the page
- It can edit simple fields

**What we're unsure of**

- Complex page builders
- Every field type

We've tested it on Bard fields, simple fields, radio buttons and checkboxes - I'll add to the list as I come across them.

### Enabling AI Buttons in Bard Fields

[](#enabling-ai-buttons-in-bard-fields)

The addon registers AI toolbar buttons, but you must manually enable them in your Bard field configurations:

1. Open your blueprint in the Statamic Control Panel
2. Edit your Bard field settings
3. In the Buttons section, add: `aiAgent`, `aiComplete`, `aiEnhance`, `aiSummarize`
4. Save and refresh

Example Bard field configuration in YAML:

```
-
  handle: content
  field:
    type: bard
    display: Content
    buttons:
      - h2
      - h3
      - bold
      - italic
      - link
      - aiAgent      # AI conversational modal
      - aiComplete   # AI auto-complete
      - aiEnhance    # AI text enhancement
      - aiSummarize  # AI summarization
```

### Using the AI Agent

[](#using-the-ai-agent)

The AI Agent button (chat bubble icon) opens a conversational modal:

1. Click the AI Agent button in the Bard toolbar
2. Ask the AI to help with your content - it has access to your full document and selected text
3. Example requests:
    - "Make this section more formal"
    - "Add more detail about the benefits"
    - "Rewrite this in a more engaging tone"
    - "Check for grammar and clarity issues"
4. Click "Apply to Editor" to insert AI-generated content

### Using the Global Chat Widget

[](#using-the-global-chat-widget)

A chat widget appears in the bottom-right corner of the Statamic CP:

- Context-aware: knows what page you're viewing, which collection you're editing, and entry titles
- Ask for help with content creation, editing, or general Statamic questions
- Conversation history saved in browser session
- Click minimize to get it out of the way

Example questions:

- "How should I structure this blog post?"
- "Help me write a meta description for this page"
- "What's a good way to phrase this call-to-action?"

### Keyboard Shortcuts

[](#keyboard-shortcuts)

- **Cmd/Ctrl + Space**: Trigger AI completion
- **Cmd/Ctrl + Shift + E**: Enhance selected text

### Button Functions

[](#button-functions)

- **AI Agent**: Opens conversational modal for complex interactions
- **AI Complete**: Auto-complete text from cursor position
- **AI Enhance**: Improve grammar, clarity, and readability of selected text
- **AI Summarize**: Generate concise summary of selected text

### Programmatic Usage

[](#programmatic-usage)

Trigger AI features programmatically using editor commands:

```
editor.commands.aiComplete()
editor.commands.aiEnhance()
editor.commands.aiSummarize()
editor.commands.aiTranslate('es')
editor.commands.aiAdjustTone('formal')
```

Troubleshooting
---------------

[](#troubleshooting)

### Buttons not showing

[](#buttons-not-showing)

- Clear your browser cache
- Run `php artisan cache:clear` and `php please stache:clear`
- Refresh the control panel

### API Key Issues

[](#api-key-issues)

- Ensure `OPENAI_API_KEY` is set correctly in `.env`
- Check the browser console for authentication errors
- Verify your OpenAI account has sufficient credits
- Confirm your API key has necessary permissions

### No AI Suggestions

[](#no-ai-suggestions)

- Check your internet connection
- Verify the OpenAI API is accessible
- Check the browser console for API errors
- Ensure you're using a valid OpenAI model

### Rate Limiting

[](#rate-limiting)

OpenAI has rate limits based on your account tier. Consider upgrading your OpenAI plan if you encounter rate limit errors.

Questions etc
-------------

[](#questions-etc)

Drop us a big shout-out if you have any questions, comments, or concerns. We're always looking to improve our addons, so if you have any feature requests, we'd love to hear them.

### Starter Kits

[](#starter-kits)

- [Alt Starter Kit](https://statamic.com/starter-kits/alt-design/alt-starter-kit)

### Addons

[](#addons)

- [Alt Admin Bar Addon](https://github.com/alt-design/Alt-Admin-Bar-Addon)
- [Alt Redirect Addon](https://github.com/alt-design/Alt-Redirect-Addon)
- [Alt Sitemap Addon](https://github.com/alt-design/Alt-Sitemap-Addon)
- [Alt Akismet Addon](https://github.com/alt-design/Alt-Akismet-Addon)
- [Alt Password Protect Addon](https://github.com/alt-design/Alt-Password-Protect-Addon)
- [Alt Cookies Addon](https://github.com/alt-design/Alt-Cookies-Addon)
- [Alt Inbound Addon](https://github.com/alt-design/Alt-Inbound-Addon)
- [Alt Google 2FA Addon](https://github.com/alt-design/Alt-Google-2fa-Addon)
- [Alt SEO Addon](https://github.com/alt-design/Alt-SEO-Addon)
- [Alt RiffRaff Addon](https://github.com/alt-design/Alt-RiffRaff-Addon)

Postcardware
------------

[](#postcardware)

Send us a postcard from your hometown if you like this addon. We love getting mail from other cool peeps!

Alt Design
St Helens House
Derby
DE1 3EE
UK

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance68

Regular maintenance activity

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity29

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

188d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e352e57b5dcf7df2c63eab5bb5c8c152a06917fc08bbba2e9996bdee9d9c1117?d=identicon)[alt-design](/maintainers/alt-design)

---

Top Contributors

[![Alt-Ben](https://avatars.githubusercontent.com/u/12431318?v=4)](https://github.com/Alt-Ben "Alt-Ben (13 commits)")

### Embed Badge

![Health badge](/badges/alt-design-alt-ai/health.svg)

```
[![Health](https://phpackages.com/badges/alt-design-alt-ai/health.svg)](https://phpackages.com/packages/alt-design-alt-ai)
```

###  Alternatives

[statamic/ssg

Generate static sites with Statamic.

254302.4k](/packages/statamic-ssg)[statamic/seo-pro

65440.7k](/packages/statamic-seo-pro)[jacksleight/statamic-bard-texstyle

17172.5k](/packages/jacksleight-statamic-bard-texstyle)[visuellverstehen/statamic-classify

A useful helper to add CSS classes to all HTML tags generated by the bard editor.

20116.8k](/packages/visuellverstehen-statamic-classify)[marcorieser/statamic-livewire

A Laravel Livewire integration for Statamic.

2381.5k10](/packages/marcorieser-statamic-livewire)[withcandour/aardvark-seo

Save time and get your Statamic site to rank better with the SEO addon for Statamic.

13128.3k](/packages/withcandour-aardvark-seo)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)