fabricatio-agent

MIT

AI agent framework that integrates thinking, memory, judgment, task dispatching, and team collaboration into a single composable Agent class. The agent digests requests, decomposes them into tasks, and executes them through a cooperative multi-role pipeline.

Installation

pip install fabricatio[agent]

Or with full dependencies:

pip install fabricatio[full]

The package exposes a CLI entry point (falcon) when installed with the cli extra:

pip install fabricatio-agent[cli]
falcon code "write a fibonacci function in python"

Key Components

Agent (fabricatio_agent.capabilities.agent)

The central class composing these capabilities through multiple inheritance:

Agent.fulfill(request, sequential_thinking=False, check_capable=False, memory=False, top_k=100, boost_recent=True, **kwargs)

The main entry point. Orchestrates capability checking → memory recall → sequential thinking → request digestion into a task list → task execution. Returns None if the agent is not capable, otherwise returns the task execution results.

from fabricatio_agent.capabilities.agent import Agent

class MyAgent(Agent):
    pass

agent = MyAgent()
result = await agent.fulfill(
    "Refactor the authentication module to use JWT",
    sequential_thinking=True,
    memory=True,
)

Configuration

All options below are read through the fabricatio configuration chain (see the Configuration Guide). Set them under the [ext.agent] table in fabricatio.toml, equivalently under [tool.fabricatio.ext.agent] in pyproject.toml, or via FABRICATIO_EXT__AGENT__<FIELD_UPPER> environment variables.

[ext.agent]
memory = false
sequential_thinking = false
check_capable = false
fulfill_prompt_template = "built-in/fulfill_prompt"

Access at runtime: from fabricatio_agent.config import agent_config.

Actions (fabricatio_agent.actions.code)

Reusable Action subclasses that combine the Agent capability mixin:

• WriteCode — Generates code snippets from a prompt (with directory tree context), infers the coding language, and writes files to disk.
• Planning — Breaks complex tasks into subtasks via cooperative digestion, optionally preceded by sequential thinking.
• CleanUp — Removes unwanted files/directories using tool-based handling.
• ReviewCode — Saves a checkpoint of the current state for later review.
• MakeSpecification — Produces a specification document for a task.

CLI (fabricatio_agent.cli)

A Typer application (falcon) that assembles a multi-role team and dispatches tasks:

Roles — each implements Role + Cooperate and subscribes to event patterns:

TaskType enum: Coding, Orchestrate, CleanUp, Plot, Synthesize, Test, Documentation.

falcon code "write a fibonacci function in python"

This command spins up a Team with all four roles and delegates a coding task through the orchestrator. Complex tasks are automatically decomposed into subtasks.

Dependencies

• fabricatio-core — Core interfaces and utilities
• fabricatio-digest — Request digestion and task planning
• fabricatio-memory — Memory management and recall
• fabricatio-improve — Content improvement
• fabricatio-rule — Rule-based content processing
• fabricatio-judge — Judgment and evaluation
• fabricatio-capabilities — Base capability patterns
• fabricatio-diff — Difference editing operations
• fabricatio-thinking — Sequential thinking
• fabricatio-question — Interactive questioning
• fabricatio-tool — Tool handling and execution
• fabricatio-team — Team cooperation mechanisms
• fabricatio-capable — Capability assessment
• fabricatio-checkpoint — Execution checkpointing

License

MIT — see LICENSE