Download the PHP package woutersf/ai-connection-bundle without Composer
On this page you can find all versions of the php package woutersf/ai-connection-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download woutersf/ai-connection-bundle
More information about woutersf/ai-connection-bundle
Files in woutersf/ai-connection-bundle
Package ai-connection-bundle
Short Description Core AI connection plugin for Mautic - manages LiteLLM integration and shared AI services
License GPL-3.0-or-later
Informations about the package ai-connection-bundle
Mautic AI Connection Bundle
A core AI connection plugin for Mautic that manages LiteLLM integration and provides centralized AI services for all Mautic AI-powered plugins.
Overview
The Mautic AI Connection Bundle serves as the foundation for AI functionality in Mautic. It provides a centralized LiteLLM service that can be used by other AI-powered plugins such as:
- Mautic AI Console - AI-powered console interface with voice input
- Mautic AI Reports - AI-powered report generation
- Mautic AI Eval - AI evaluation features
Features
- Centralized AI Configuration - Single source of truth for LiteLLM endpoint and credentials
- LiteLLM Integration - Connect to multiple AI providers (OpenAI, Anthropic Claude, Llama, etc.) through LiteLLM proxy
- Shared Service Architecture - Other plugins access AI capabilities through this bundle's service
- Model Management - Dynamically fetch available models from your LiteLLM instance
- Secure Credential Storage - API keys are encrypted and stored securely
Requirements
- Mautic 4.0+ or Mautic 5.0+
- PHP 7.4 or 8.0+
- A running LiteLLM instance (proxy server)
Installation
Via Composer
Manual Installation
- Download or clone this repository
- Place the
MauticAIconnectionBundlefolder indocroot/plugins/ -
Clear Mautic cache:
- Go to Mautic Settings → Plugins
- Click "Install/Upgrade Plugins"
- Find "Mautic AI Connection" and publish it
Configuration
Navigate to Mautic Settings → Plugins → Mautic AI Connection to configure the plugin.
Required Settings
-
LiteLLM Endpoint
- URL of your LiteLLM proxy server or an OPENAI API key.
- Example:
http://localhost:4000orhttps://your-litellm-server.comor https://api.openai.com/v1 - Note: This should point to your LiteLLM proxy, NOT directly to OpenAI or other providers
- LiteLLM Secret Key
- API key for authenticating with your LiteLLM instance or Openai.
- This credential is encrypted and stored securely
Usage in Other Plugins
Other Mautic plugins can use the LiteLLM service provided by this bundle.
Accessing the Service
Available Methods
1. Chat Completion (with tools support)
2. Simple Completion
3. Streaming Completion
4. Speech-to-Text
5. Get Available Models
Subscribing to the Service in Controllers
Architecture
This plugin follows a centralized service architecture:
Composer Dependency
Other AI plugins should declare this bundle as a dependency in their composer.json:
Security
- API keys are encrypted using Mautic's encryption helper
- All requests use HTTPS when connecting to remote LiteLLM instances
- The service validates configuration before making API calls
Troubleshooting
"LiteLLM endpoint and secret key must be configured"
Solution: Configure the LiteLLM endpoint and secret key in the plugin settings.
"404 Not Found" when making AI requests
Issue: The endpoint is pointing directly to OpenAI/Anthropic instead of LiteLLM proxy.
Solution: Ensure you're using your LiteLLM proxy URL (e.g., http://localhost:4000), not https://api.openai.com.
Models not appearing in dropdown
Issue: LiteLLM instance is not reachable or not properly configured.
Solution:
- Verify LiteLLM is running:
curl http://localhost:4000/models - Check endpoint URL in plugin settings
- Verify secret key is correct
Development
Running Tests
Code Style
Follow Mautic coding standards:
Support
- GitHub Issues: Report an issue
- Mautic Community: community.mautic.org
- Documentation: LiteLLM Docs
License
GPL-3.0-or-later
Credits
Created by Frederik Wouters
Version
1.0.0
Changelog
1.0.0 (2024)
- Initial release
- LiteLLM service integration
- Chat completion support
- Streaming support
- Speech-to-text support
- Model discovery
- Secure credential storage