PHPackages                             theuargb/magento2-steroids - 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. theuargb/magento2-steroids

ActiveMagento2-module[Utility & Helpers](/categories/utility)

theuargb/magento2-steroids
==========================

Performance and reliability steroids for Magento 2 — powered by neuron-ai

111PHP

Since Feb 17Pushed 2mo agoCompare

[ Source](https://github.com/theuargb/magento2-steroids)[ Packagist](https://packagist.org/packages/theuargb/magento2-steroids)[ RSS](/packages/theuargb-magento2-steroids/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Magento 2 Steroids
==================

[](#magento-2-steroids)

Performance and reliability steroids for Magento 2 — powered by neuron-ai.

Overview
--------

[](#overview)

Steroids is an AI-powered module for Magento 2 that automatically detects, diagnoses, and heals runtime errors in your store. When an exception occurs, the module captures comprehensive context and uses AI to suggest and apply fixes, minimizing downtime and manual intervention.

Features
--------

[](#features)

- **Automatic Error Detection**: Intercepts exceptions at the HTTP layer
- **AI-Powered Healing**: Uses advanced LLM models to analyze and fix errors
- **Fallback Responses**: Provides graceful fallback content when healing isn't possible
- **Circuit Breaker**: Prevents excessive healing attempts for recurring errors
- **Comprehensive Logging**: Detailed healing attempt logs in admin panel
- **Homepage Snapshots**: Captures and caches homepage state for fallback scenarios
- **Configurable Safety Controls**: Fine-grained control over healing behavior and permissions

Requirements
------------

[](#requirements)

- Magento 2.4.x or higher
- PHP 8.1, 8.2, 8.3, or 8.4
- [neuron-ai](https://github.com/inspector-apm/neuron-ai) ^2.0

Installation
------------

[](#installation)

### Via Composer (Recommended)

[](#via-composer-recommended)

```
composer require theuargb/magento2-steroids
bin/magento module:enable Theuargb_Steroids
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
```

### Manual Installation

[](#manual-installation)

1. Download the module and extract to `app/code/Theuargb/Steroids`
2. Run the following commands:

```
bin/magento module:enable Theuargb_Steroids
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
```

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

[](#configuration)

Navigate to **Stores > Configuration > Theuargb > Steroids** in the Magento Admin panel.

### General Settings

[](#general-settings)

- **Enable Steroids**: Master switch to enable/disable the module
- **LLM Provider**: Choose your AI provider (OpenAI, Azure OpenAI, Anthropic, etc.)
- **API Key**: Your LLM provider API key
- **Model**: The AI model to use (e.g., gpt-4o, claude-3-5-sonnet)
- **Base URL**: Optional custom endpoint for API calls

### Agent Settings

[](#agent-settings)

- **Heal Timeout**: Maximum time (seconds) for healing attempts
- **Fallback Timeout**: Maximum time (seconds) for generating fallback responses
- **Fallback Cache TTL**: How long to cache fallback responses
- **Max Tool Calls**: Limit on agent tool invocations per healing attempt

### Safety Controls

[](#safety-controls)

- **Max Attempts Per Hour**: Circuit breaker threshold per error fingerprint
- **Max Concurrent Healings**: Prevent resource exhaustion
- **Disallowed Tool Actions**: Blacklist specific agent tools
- **Allow File Writes**: Enable/disable file modification capabilities

### URL Filters

[](#url-filters)

Configure URL patterns and custom prompts for specific routes that need special healing instructions.

### Snapshot Settings

[](#snapshot-settings)

- **Cron Frequency**: How often to capture homepage snapshots for fallback scenarios

Usage
-----

[](#usage)

Once configured, Steroids automatically monitors your Magento store. When an error occurs:

1. The module intercepts the exception
2. Captures comprehensive context (request, environment, code)
3. Sends to the AI agent for analysis
4. Agent suggests and optionally applies fixes
5. Returns either a healed response or graceful fallback
6. Logs the attempt in **System > Steroids > Healing Log**

Admin Features
--------------

[](#admin-features)

### Healing Log

[](#healing-log)

View detailed logs of all healing attempts at **System > Steroids > Healing Log**:

- Error details and stack traces
- Agent reasoning and actions taken
- Success/failure status
- Performance metrics (tokens used, execution time)

### Manual Snapshot Capture

[](#manual-snapshot-capture)

Capture a fresh homepage snapshot on-demand via the **Capture Snapshot Now** button in system configuration.

Database Tables
---------------

[](#database-tables)

- `steroids_attempt`: Healing attempt logs
- `steroids_homepage_snapshot`: Homepage snapshots for fallback responses

Cron Jobs
---------

[](#cron-jobs)

- `steroids_capture_homepage_snapshot`: Periodic homepage snapshot capture

License
-------

[](#license)

This module is licensed under the [Open Software License 3.0 (OSL-3.0)](LICENSE).

Support
-------

[](#support)

For issues, feature requests, or contributions, please visit the [GitHub repository](#).

Credits
-------

[](#credits)

Powered by [neuron-ai](https://github.com/inspector-apm/neuron-ai) - Advanced AI agent framework for PHP.

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance56

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

 Bus Factor1

Top contributor holds 75% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/bcd3b8a9631d0f2741c846e127cd8e0cd535a78b3a3e30c93965f0c9fb656c68?d=identicon)[theuargb](/maintainers/theuargb)

---

Top Contributors

[![theuargb](https://avatars.githubusercontent.com/u/83121880?v=4)](https://github.com/theuargb "theuargb (9 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (3 commits)")

### Embed Badge

![Health badge](/badges/theuargb-magento2-steroids/health.svg)

```
[![Health](https://phpackages.com/badges/theuargb-magento2-steroids/health.svg)](https://phpackages.com/packages/theuargb-magento2-steroids)
```

###  Alternatives

[aucor/dynamic-mo-loader

Better text domain loading with object cache support for WordPress

4554.1k1](/packages/aucor-dynamic-mo-loader)

PHPackages © 2026

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