`fabricatio-agent`

MIT Python Versions

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:

Capability	Trait	Role
Checkpoint	`Checkpoint`	Save/restore execution state
Capable	`Capable`	Assess whether the agent can handle a request
CooperativeDigest	`CooperativeDigest`	Decompose requests into task lists with team-aware dispatch
Remember	`Remember`	Recall relevant memories to enrich context
Censor	`Censor`	Rule-based content filtering
EvidentlyJudge	`EvidentlyJudge`	Evidence-aware judgment and evaluation
DispatchTask	`DispatchTask`	Dispatch tasks to team members
DiffEdit	`DiffEdit`	Difference-based editing operations
Questioning	`Questioning`	Interactive question-asking
Thinking	`Thinking`	Sequential chain-of-thought reasoning
Handle	`Handle`	Tool execution and handling

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,
)

`AgentConfig` (`fabricatio_agent.config`)

Dataclass controlling agent behavior, loaded from the Fabricatio configuration system:

Field	Default	Description
`memory`	`False`	Enable memory recall globally
`sequential_thinking`	`False`	Enable sequential thinking globally
`check_capable`	`False`	Check capabilities before every request
`fulfill_prompt_template`	`"built-in/fulfill_prompt"`	Template used for request digestion

Values set on AgentConfig act as defaults; the fulfill() method accepts per-call overrides.

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:

Role	Handles	Workflow
`Developer`	`Coding`, `CleanUp`, `Plot`, `Synthesize`	WriteCode, CleanUp, chart/synthesis generation
`ProjectLeader`	`Orchestrate`	Planning (decomposes into subtasks)
`TestEngineer`	`Test`	WriteCode (generates test cases)
`DocumentationWriter`	`Documentation`	WriteCode (generates documentation)

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

fabricatio_agent-0.3.2-cp314-cp314-win_amd64.whl (129.2 kB view details)

Uploaded Aug 1, 2026 CPython 3.14Windows x86-64

fabricatio_agent-0.3.2-cp314-cp314-manylinux_2_34_x86_64.whl (239.1 kB view details)

Uploaded Aug 1, 2026 CPython 3.14manylinux: glibc 2.34+ x86-64

fabricatio_agent-0.3.2-cp314-cp314-manylinux_2_34_aarch64.whl (222.3 kB view details)

Uploaded Aug 1, 2026 CPython 3.14manylinux: glibc 2.34+ ARM64

fabricatio_agent-0.3.2-cp314-cp314-macosx_11_0_arm64.whl (207.0 kB view details)

Uploaded Aug 1, 2026 CPython 3.14macOS 11.0+ ARM64

fabricatio_agent-0.3.2-cp313-cp313-win_amd64.whl (131.1 kB view details)

Uploaded Aug 1, 2026 CPython 3.13Windows x86-64

fabricatio_agent-0.3.2-cp313-cp313-manylinux_2_34_x86_64.whl (240.6 kB view details)

Uploaded Aug 1, 2026 CPython 3.13manylinux: glibc 2.34+ x86-64

fabricatio_agent-0.3.2-cp313-cp313-manylinux_2_34_aarch64.whl (223.9 kB view details)

Uploaded Aug 1, 2026 CPython 3.13manylinux: glibc 2.34+ ARM64

fabricatio_agent-0.3.2-cp313-cp313-macosx_11_0_arm64.whl (207.8 kB view details)

Uploaded Aug 1, 2026 CPython 3.13macOS 11.0+ ARM64

fabricatio_agent-0.3.2-cp312-cp312-win_amd64.whl (131.1 kB view details)

Uploaded Aug 1, 2026 CPython 3.12Windows x86-64

fabricatio_agent-0.3.2-cp312-cp312-manylinux_2_34_x86_64.whl (240.5 kB view details)

Uploaded Aug 1, 2026 CPython 3.12manylinux: glibc 2.34+ x86-64

fabricatio_agent-0.3.2-cp312-cp312-manylinux_2_34_aarch64.whl (223.3 kB view details)

Uploaded Aug 1, 2026 CPython 3.12manylinux: glibc 2.34+ ARM64

fabricatio_agent-0.3.2-cp312-cp312-macosx_11_0_arm64.whl (207.7 kB view details)

Uploaded Aug 1, 2026 CPython 3.12macOS 11.0+ ARM64

File details

Details for the file fabricatio_agent-0.3.2-cp314-cp314-win_amd64.whl.

File metadata

Download URL: fabricatio_agent-0.3.2-cp314-cp314-win_amd64.whl
Upload date: Aug 1, 2026
Size: 129.2 kB
Tags: CPython 3.14, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fabricatio_agent-0.3.2-cp314-cp314-win_amd64.whl
Algorithm	Hash digest
SHA256	`ecb6eff9828d75c990ebfb78e8ad0ca578740670e99987e234e72bbe463d61aa`
MD5	`9b3d1e711a1527f413cef8764b329a93`
BLAKE2b-256	`d0986341087a0ee294062326ae11e7a724b477a11f83671771e7c19641537cb9`

See more details on using hashes here.

File details

Details for the file fabricatio_agent-0.3.2-cp314-cp314-manylinux_2_34_x86_64.whl.

File metadata

Download URL: fabricatio_agent-0.3.2-cp314-cp314-manylinux_2_34_x86_64.whl
Upload date: Aug 1, 2026
Size: 239.1 kB
Tags: CPython 3.14, manylinux: glibc 2.34+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fabricatio_agent-0.3.2-cp314-cp314-manylinux_2_34_x86_64.whl
Algorithm	Hash digest
SHA256	`3af6f3dc7a27f7f2ed44533a00d63a3c25b10d07ec15407e4f211c10753f6a22`
MD5	`e6024e71a7c3ebb8bd88c9fb754a869e`
BLAKE2b-256	`258dbdf5f507e9c7aad24d59db78cbf20ca06f045158fc437528cf05d7a88e40`

See more details on using hashes here.

File details

Details for the file fabricatio_agent-0.3.2-cp314-cp314-manylinux_2_34_aarch64.whl.

File metadata

Download URL: fabricatio_agent-0.3.2-cp314-cp314-manylinux_2_34_aarch64.whl
Upload date: Aug 1, 2026
Size: 222.3 kB
Tags: CPython 3.14, manylinux: glibc 2.34+ ARM64
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fabricatio_agent-0.3.2-cp314-cp314-manylinux_2_34_aarch64.whl
Algorithm	Hash digest
SHA256	`1a942135adb23eaecad60f7acaf6c441e072bf04da9623a9070a9f3fe960e959`
MD5	`5a396a433441f797d3382318ab1d544f`
BLAKE2b-256	`5214a4228280bc42ff18acf8f956cf8e4d2c067cec60f42585a6118c7d866810`

See more details on using hashes here.

File details

Details for the file fabricatio_agent-0.3.2-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

Download URL: fabricatio_agent-0.3.2-cp314-cp314-macosx_11_0_arm64.whl
Upload date: Aug 1, 2026
Size: 207.0 kB
Tags: CPython 3.14, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fabricatio_agent-0.3.2-cp314-cp314-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`75abb91249738baf3f5cab2e6fd7f800bcc08fd578ef416356ae71bf27a39071`
MD5	`f81dfdefdf8c84fa227e7818da4ab1fb`
BLAKE2b-256	`1d19c78ca251d00632a2def6f23edf1c4cad516c0bdce2d43b5f217d3692c6f1`

See more details on using hashes here.

File details

Details for the file fabricatio_agent-0.3.2-cp313-cp313-win_amd64.whl.

File metadata

Download URL: fabricatio_agent-0.3.2-cp313-cp313-win_amd64.whl
Upload date: Aug 1, 2026
Size: 131.1 kB
Tags: CPython 3.13, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fabricatio_agent-0.3.2-cp313-cp313-win_amd64.whl
Algorithm	Hash digest
SHA256	`43ca88dd02af601a87af1be7e028af22017a7b0c6ec5c57cae962afb69874c5c`
MD5	`361cb73fae4e9a7012e560f75785a434`
BLAKE2b-256	`7d1ff374b1fcd11f1fdf1db20b41c0cff4612582fa8fc2888f6472bfb2544eed`

See more details on using hashes here.

File details

Details for the file fabricatio_agent-0.3.2-cp313-cp313-manylinux_2_34_x86_64.whl.

File metadata

Download URL: fabricatio_agent-0.3.2-cp313-cp313-manylinux_2_34_x86_64.whl
Upload date: Aug 1, 2026
Size: 240.6 kB
Tags: CPython 3.13, manylinux: glibc 2.34+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fabricatio_agent-0.3.2-cp313-cp313-manylinux_2_34_x86_64.whl
Algorithm	Hash digest
SHA256	`103bc84a95c419fa79a6e4c3dad24c20a423078d35b5d5f4bcfe0274440450f7`
MD5	`89d715aa16bbeb4f19213fcf67bb981c`
BLAKE2b-256	`4cac92b8417fa747e784a636272d87f10e37f1fbb19918b45e71a14e4a13d3ee`

See more details on using hashes here.

File details

Details for the file fabricatio_agent-0.3.2-cp313-cp313-manylinux_2_34_aarch64.whl.

File metadata

Download URL: fabricatio_agent-0.3.2-cp313-cp313-manylinux_2_34_aarch64.whl
Upload date: Aug 1, 2026
Size: 223.9 kB
Tags: CPython 3.13, manylinux: glibc 2.34+ ARM64
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fabricatio_agent-0.3.2-cp313-cp313-manylinux_2_34_aarch64.whl
Algorithm	Hash digest
SHA256	`de4ce32f9588bd8c73aac7a572d10948ec0c2cec417081577f99f2737d9c4d8c`
MD5	`69b6f7949a64801612746f57e85c805e`
BLAKE2b-256	`3d64871d4dec4f133d0d89d17d12647739e5f0957b157a9083c943b8e3283a25`

See more details on using hashes here.

File details

Details for the file fabricatio_agent-0.3.2-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

Download URL: fabricatio_agent-0.3.2-cp313-cp313-macosx_11_0_arm64.whl
Upload date: Aug 1, 2026
Size: 207.8 kB
Tags: CPython 3.13, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fabricatio_agent-0.3.2-cp313-cp313-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`b7f366261aaf0065d3a81772b00b5f8b03fd6d3faed27bc4a86b69ece01fd781`
MD5	`7146f8c14f8ebfeefa656ccb17dce5ae`
BLAKE2b-256	`aa9e9516f5124ea6cbe7d478e248587313dd2cdcaf869955ff757651831cf57f`

See more details on using hashes here.

File details

Details for the file fabricatio_agent-0.3.2-cp312-cp312-win_amd64.whl.

File metadata

Download URL: fabricatio_agent-0.3.2-cp312-cp312-win_amd64.whl
Upload date: Aug 1, 2026
Size: 131.1 kB
Tags: CPython 3.12, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fabricatio_agent-0.3.2-cp312-cp312-win_amd64.whl
Algorithm	Hash digest
SHA256	`f55bab1deac5d15788d2749cf1ab5d5d643b438b2b917506a24c38349e2a2e64`
MD5	`7afa8b87b38684845dd6e30c1292468f`
BLAKE2b-256	`0c45c24fa13f9f4a11e0d8ef5a22861c8609ac2d3c38a62f39ec28306ad2541e`

See more details on using hashes here.

File details

Details for the file fabricatio_agent-0.3.2-cp312-cp312-manylinux_2_34_x86_64.whl.

File metadata

Download URL: fabricatio_agent-0.3.2-cp312-cp312-manylinux_2_34_x86_64.whl
Upload date: Aug 1, 2026
Size: 240.5 kB
Tags: CPython 3.12, manylinux: glibc 2.34+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fabricatio_agent-0.3.2-cp312-cp312-manylinux_2_34_x86_64.whl
Algorithm	Hash digest
SHA256	`ad3ce9b5adabe607b75740a01e0d035223a888d6c085778393aa3ba4578da131`
MD5	`5136b6ea6e9929a13fb66c199b23b8dd`
BLAKE2b-256	`667503cd50e62fba3cfa5ba7831738a7a33df1ce512f71764b827795fca74976`

See more details on using hashes here.

File details

Details for the file fabricatio_agent-0.3.2-cp312-cp312-manylinux_2_34_aarch64.whl.

File metadata

Download URL: fabricatio_agent-0.3.2-cp312-cp312-manylinux_2_34_aarch64.whl
Upload date: Aug 1, 2026
Size: 223.3 kB
Tags: CPython 3.12, manylinux: glibc 2.34+ ARM64
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fabricatio_agent-0.3.2-cp312-cp312-manylinux_2_34_aarch64.whl
Algorithm	Hash digest
SHA256	`3a897bb8c2d9370afa5688da821699a9a6a32bec87c68baa60dc49da14d4b0ee`
MD5	`72e130ecf3a2bfa49b3326f5ac0753ef`
BLAKE2b-256	`655c2ba1dbe0805de09c6ebd89328f49a276fbe8de8a05d2f828242b4739c91b`

See more details on using hashes here.

File details

Details for the file fabricatio_agent-0.3.2-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

Download URL: fabricatio_agent-0.3.2-cp312-cp312-macosx_11_0_arm64.whl
Upload date: Aug 1, 2026
Size: 207.7 kB
Tags: CPython 3.12, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fabricatio_agent-0.3.2-cp312-cp312-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`9d2fdc1e7a5104a6d9e5b5d8b11ad3c0fa96e9ae3b2ef1b81f8add3bea18c4f3`
MD5	`b7ab309f9af5dca029997ac88042f294`
BLAKE2b-256	`fa7324aebee69c23b4d858e3367924f6225df13ce48a384043d3d2559fee4af8`