This page provides comprehensive instructions for migrating from the legacy (Python-based) version of Fabric to the new, high-performance Go version. Additionally, it details the simple process for up
This page provides comprehensive instructions for migrating from the legacy (Python-based) version of Fabric to the new, high-performance Go version. Additionally, it details the simple process for upgrading your Go-based Fabric installation.
If you are currently using the older Python version of Fabric and wish to transition to the Go version, follow these steps. This process involves uninstalling the old version, installing the new one, and updating your environment configuration.
First, remove the Python-based Fabric installation from your system. This is typically done using pipx, which is recommended for isolated Python application installs.
If you installed it globally with pip, you might use pip uninstall fabric, but pipx is the primary method to check.
The Python version might have created aliases in your shell configuration files (e.g., .bashrc, .zshrc). It's important to remove these to avoid conflicts with the new Go executable.
Manually open and review the following files (if they exist in your home directory) and remove any lines that define fabric or fabric-ai aliases:
~/.bashrc~/.zshrc~/.profile~/.bash_profileWith the legacy version removed, you can now install the Go-based Fabric. Ensure you have Go installed↗ on your system.
Run the following command to install Fabric directly from its GitHub repository:
After installation, you may need to set specific Go environment variables in your shell's startup file (e.g., ~/.bashrc for Linux or ~/.zshrc for macOS) to ensure the fabric command is recognized.
For Intel-based Macs or Linux:
For Apple Silicon-based Macs:
After adding these lines, restart your terminal or run source ~/.bashrc (or source ~/.zshrc) for the changes to take effect.
The Go version of Fabric requires its own initial setup to create configuration directories and files. This is a crucial step after installation.
This command will guide you through setting up API keys, downloading patterns, and configuring other essential components. For more details on this process, refer to the Getting Started guide.
If you used aliases for individual patterns (e.g., summarize instead of fabric --pattern summarize) with the Python version, you might want to re-add them for the Go version. The Shell Completions page provides instructions and scripts for generating these aliases for your shell.
Upgrading your Go-based Fabric installation is straightforward. Simply re-run the go install command you used for the initial installation:
This command fetches the latest version of Fabric from the repository and updates your executable, ensuring you always have the most recent features and bug fixes.