Installation

Installing Faber

Faber is distributed as part of the unified Fractary CLI.

Prerequisites

• Node.js 18.0.0 or higher
• npm 9.0.0 or higher

Installation

Global Installation (Recommended)

npm install -g @fractary/cli

Verify installation:

fractary --version
fractary faber --help

Local Installation (Project-Specific)

npm install --save-dev @fractary/cli

Use via npx:

npx fractary faber init

Next Steps

• Quick Start Guide →
• Initialize your first project →

Troubleshooting

Permission Errors (EACCES)

If you get permission errors during global installation:

# Option 1: Use npx (no global install needed)
npx @fractary/cli faber init

# Option 2: Configure npm to use a different directory
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @fractary/cli

Version Conflicts

To update to the latest version:

npm update -g @fractary/cli