PHPackages                             feral/agent - 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 &amp; Helpers](/categories/utility)
4. /
5. feral/agent

ActiveSymfony-bundle[Utility &amp; Helpers](/categories/utility)

feral/agent
===========

This package provides an AI Agent symfony bundle to make Feral available as a symfony package.

1.0.7(1y ago)00Apache-2.0PHPPHP &gt;=8.2CI passing

Since Mar 12Pushed 1y ago1 watchersCompare

[ Source](https://github.com/cybermantix/feral-agent)[ Packagist](https://packagist.org/packages/feral/agent)[ RSS](/packages/feral-agent/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (10)Versions (10)Used By (0)

Feral Agent
===========

[](#feral-agent)

Overview
--------

[](#overview)

Feral Agent is an Open Source AI Agent framework that enables the creation and execution of AI-driven processes. The framework is designed around a collection of **Catalog Nodes**, which are dynamically assembled into workflows. Each node's **Result** determines the next node to execute, ensuring an adaptive and context-aware process.

A **Context** object is passed through the process, providing the necessary data for decision-making at each node. This approach enables flexible, AI-driven execution strategies, making Feral Agent ideal for autonomous workflow generation and AI agent integrations.

Feral Agent is built on the **Symfony** framework, leveraging its powerful features to provide a robust and extensible architecture.

Modes of Operation
------------------

[](#modes-of-operation)

Feral Agent operates in two distinct modes:

### 1. Tool Mode

[](#1-tool-mode)

In **Tool Mode**, multiple predefined processes are hardcoded into the system. The AI Agent selects and executes a process based on its interaction with a Large Language Model (LLM). This mode is useful when there are well-defined workflows that should be executed deterministically.

- Processes are manually defined and structured.
- The AI Agent chooses which predefined process to run based on context.
- Ensures controlled execution of structured tasks.

### 2. Autonomous Mode

[](#2-autonomous-mode)

In **Autonomous Mode**, the system dynamically constructs workflows using an LLM. Instead of selecting from predefined processes, the AI generates a process from scratch based on available **Catalog Nodes** and their descriptions.

- All available Catalog Nodes and their descriptions are sent to the LLM.
- The LLM generates the process flow, determining result connections and the initial context.
- The process is built dynamically, adapting to the situation and input context.

This mode allows for highly flexible, self-assembling workflows, enabling AI-driven decision-making without requiring predefined structures.

Available Console Commands
--------------------------

[](#available-console-commands)

Feral Agent provides a set of Symfony-based console commands for managing and executing processes:

```
feral
  feral:catalog               List all of the catalog nodes available on the platform.
  feral:details:catalog       Provide all of the details for each catalog node in the catalog.
  feral:details:catalog-node  List the configuration for a catalog node.
  feral:details:node-code     List the configuration for a node code.
  feral:list:node-code        List all of Node Codes on the platform.
  feral:list:processes        List all of the processes or use a filter to match processes.
  feral:prompt                Make a prompt for an LLM engine to create a configuration.
  feral:run                   Run a process and pass in context data.
  feral:test                  Simple tests for Feral.
  feral:validate:process      Validate a process which is defined as input via the argument or a file that contains the process.
  feral:validate:processes    Validate all of the processes or use a filter to match processes.

```

Getting Started
---------------

[](#getting-started)

To use Feral Agent, you can either:

- Run predefined workflows in **Tool Mode**.
- Let the AI generate adaptive workflows in **Autonomous Mode**.

More details on installation, configuration, and usage will be available in the full documentation.

License
-------

[](#license)

Feral Agent is open-source and available under the [Apache 2.0 License](LICENSE).

---

For contributions, issues, or discussions, visit the [Feral Agent Project Website](https://feralccf.com).

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance45

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 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

Every ~0 days

Total

9

Last Release

429d ago

Major Versions

0.0.1 → 1.0.02025-03-12

### Community

Maintainers

![](https://www.gravatar.com/avatar/54d13ee349ed75688cf144c858bb158fd0c581fa732e61f83e27b07a490bc9c8?d=identicon)[gclift](/maintainers/gclift)

---

Top Contributors

[![gclift](https://avatars.githubusercontent.com/u/2327942?v=4)](https://github.com/gclift "gclift (11 commits)")

---

Tags

symfonybundleai-agentferal

### Embed Badge

![Health badge](/badges/feral-agent/health.svg)

```
[![Health](https://phpackages.com/badges/feral-agent/health.svg)](https://phpackages.com/packages/feral-agent)
```

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[kimai/kimai

Kimai - Time Tracking

4.6k7.4k1](/packages/kimai-kimai)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[easycorp/easyadmin-demo

EasyAdmin Demo Application

145.7k](/packages/easycorp-easyadmin-demo)

PHPackages © 2026

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