feral/agent

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

1.0.7 2025-03-15 23:46 UTC

Requires

• php: >=8.2
• ext-ctype: *
• ext-iconv: *
• feral/core: ^1.0
• symfony/console: 7.2.*
• symfony/dotenv: 7.2.*
• symfony/flex: ^2
• symfony/framework-bundle: 7.2.*
• symfony/http-client: 7.2.*
• symfony/monolog-bundle: ^3.10
• symfony/runtime: 7.2.*
• symfony/serializer: 7.2.*
• symfony/yaml: 7.2.*

Conflicts

• symfony/symfony: *

Replaces

• symfony/polyfill-ctype: *
• symfony/polyfill-iconv: *
• symfony/polyfill-php72: *
• symfony/polyfill-php73: *
• symfony/polyfill-php74: *
• symfony/polyfill-php80: *
• symfony/polyfill-php81: *
• symfony/polyfill-php82: *

Apache-2.0

• symfony
• bundle
• feral
• ai agent

README

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

Feral Agent operates in two distinct modes:

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

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

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

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

Feral Agent is open-source and available under the Apache 2.0 License.

For contributions, issues, or discussions, visit the Feral Agent Project Website.