Download the PHP package sferra/filament-side-chat without Composer

Filament Side Chat

AI-powered chat assistant for Filament admin panels. Adds a sidebar chat button that opens a slide-over modal with real-time SSE streaming via sferra/delta.

Installation

Publish and run the migration:

Include the package views in your Tailwind build

The chat UI is styled with Tailwind classes. If your panel uses Tailwind v4 (@tailwindcss/vite), add the package views to your @source list in resources/css/app.css — otherwise the chat renders unstyled:

Then rebuild your assets:

For Tailwind v3, add the path to content in tailwind.config.js instead: './vendor/sferra/filament-side-chat/resources/views/**/*.blade.php'

Setup

1. Configure the Delta provider

Add your AI provider credentials to .env:

See sferra/delta for all supported providers (OpenAI, Ollama, OpenCode, vLLM, etc.).

2. Register the plugin

In your AppPanelProvider.php:

That's it. A chat button appears in the Filament topbar.

Features

• ✅ Slide-over modal with AI chat
• ✅ Real-time streaming via SSE
• ✅ Multi-session support — switch between conversations
• ✅ Session deletion with confirmation dialog
• ✅ Chat history persisted to the database
• ✅ Cancel streaming button
• ✅ Copy response button
• ✅ Export conversation as Markdown
• ✅ Resend / edit user messages
• ✅ Context-aware assistant — auto-injects user identity, current Filament page, and custom blocks into a system prompt on every request
• ✅ Configurable icon, assistant name and render hook
• ✅ Works with any OpenAI-compatible API

Configuration

Fluent methods (Panel Provider)

Context-aware assistant

On every Delta::stream() call, the plugin prepends a role: system message so the model knows who is asking and from where. Nothing is persisted — the system message lives only in the request payload.

What's injected by default

• User identity — id, name, email
• Page state — current Filament panel, resource class, record id, route name
• Custom blocks — any closures registered via ->context(...)

Toggles (master + granular)

Pass null to context() to clear all custom providers:

Custom system prompt via Markdown file

Publish the stub:

Edit resources/ai/system-context.md (path is configurable). The {auto_context} placeholder is replaced with the auto-generated block (user + page + custom providers):

Activate it with:

Disable everything (use only your own prompt)

Config keys (all overridable per ENV)

Multiple panels: if you have more than one Filament panel and each one registers a different context config, the last-registered panel wins (since the config() values are global). In that case, prefer the config file or FILAMENT_SIDE_CHAT_CONTEXT_* env vars instead of the fluent setters.

Config file

Publish the config file:

Fluent methods take precedence over the config file.

Customization

Change the render position

Publish and customize views

Publish the system context stub

Requirements

• PHP ^8.2
• Laravel ^11|^12|^13
• Filament ^3.0|^4.0|^5.0
• sferra/delta ^1.0

License

MIT