Installation

Quick Installation

Install fabricatio with full capabilities:

pip install fabricatio[full]

Or using UV (recommended):

uv add fabricatio[full]

Selective Installation

Install fabricatio with specific capabilities:

# Install with only RAG and rule capabilities
pip install fabricatio[rag,rule]

# Or with uv
uv add fabricatio[rag,rule]

Template Download

You can download the templates from the GitHub release manually and extract them to the work directory:

curl -L https://github.com/Whth/fabricatio/releases/download/v0.19.1/templates.tar.gz | tar -xz

Or you can use the CLI tdown bundled with fabricatio to achieve the same result:

tdown download --verbose -o ./

Note

fabricatio performs template discovery across multiple sources with filename-based identification. Template resolution follows a priority hierarchy where working directory templates override templates located in <ROAMING>/fabricatio/templates.

Available Optional Dependencies

Fabricatio supports various optional dependencies for different capabilities:

  • anki: Anki deck generation (fabricatio-anki)

  • memory: Memory management (fabricatio-memory)

  • digest: Content digestion (fabricatio-digest)

  • rag: Retrieval-Augmented Generation (fabricatio-rag)

  • judge: Judgment and evaluation (fabricatio-judge)

  • rule: Rule-based processing (fabricatio-rule)

  • cli: Command-line interface (typer-slim)

  • typst: Typst document generation (fabricatio-typst)

  • improve: Content improvement (fabricatio-improve)

  • capabilities: Core capabilities (fabricatio-capabilities)

  • actions: Action system (fabricatio-actions)

  • question: Question processing (fabricatio-question)

  • tagging: Content tagging (fabricatio-tagging)

  • yue: Yue language support (fabricatio-yue)

  • tool: Tool integration (fabricatio-tool)

  • plot: Plotting capabilities (fabricatio-plot)

  • translate: Translation services (fabricatio-translate)

  • locale: Localization support (fabricatio-locale)

  • diff: Diff utilities (fabricatio-diff)

  • thinking: Thinking/reasoning (fabricatio-thinking)

Development Installation

For development, clone the repository and install in development mode:

git clone https://github.com/Whth/fabricatio.git
cd fabricatio
make init
make dev

Or using UV with maturin:

git clone https://github.com/Whth/fabricatio.git
cd fabricatio
uvx --with-editable . maturin develop --uv -r

Building Distribution

To build distribution packages:

make bdist

Requirements

  • Python 3.12 or 3.13

  • Rust toolchain (for development builds)

  • UV package manager (recommended)