fabricatio-thinking

MIT

Sequential Chain-of-Thought reasoning for fabricatio agents, backed by a Rust-implemented version control system for thought management.

Installation

pip install fabricatio[thinking]
# or
uv pip install fabricatio[thinking]

For a full monorepo installation:

pip install fabricatio[full]

Overview

fabricatio-thinking provides structured, multi-step reasoning through a version-controlled thought process. Agents iterate through a chain of thoughts, with built-in support for revising past steps, branching into alternative reasoning paths, and managing the entire thought history via a lightweight VCS written in Rust.

Components

Capabilities

Models

Rust Bindings

Configuration

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

[ext.thinking]

The ThinkingConfig schema currently defines no options and is reserved for future use.

Access at runtime: from fabricatio_thinking.config import thinking_config.

Usage

from fabricatio_thinking.capabilities.thinking import Thinking
from fabricatio_thinking.rust import ThoughtVCS
from fabricatio_core.capabilities.propose import Propose

class MyAgent(Propose, Thinking):
    """An agent that can reason step-by-step."""

async def reason():
    agent = MyAgent()
    vcs = ThoughtVCS()

    # Run a thinking process for up to 10 steps
    result_vcs = await agent.thinking(
        question="Explain the difference between TCP and UDP.",
        vcs=vcs,
        max_steps=10,
    )

    # Export the final chain as a list of strings
    chain = result_vcs.export_branch()
    for commit in chain:
        print(commit)

    # Or as a single formatted string
    print(result_vcs.export_branch_string())

How thinking() works

1. The LLM proposes a Thought for the current step.
2. If the thought requests a revision (revision=True + revises_thought), the VCS updates that prior commit.
3. If the thought requests a checkout (checkout + branch), the VCS truncates the branch at the given step.
4. Otherwise, the thought is committed to the current branch.
5. The loop repeats until end=True or max_steps is reached.

ThoughtVCS API

Dependencies

• fabricatio-core — core interfaces (Propose, SketchedAble, CONFIG, loggers)

License

MIT — see LICENSE