Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation

Prerequisites

To build and run Felico, you’ll need:

Building from Source

Currently, Felico is only available by building from source. Follow these steps:

1. Clone the Repository

git clone https://github.com/mwoelker/felico.git
cd felico

2. Build the Project

cargo build --release

The compiled binary will be available at target/release/felico.

3. (Optional) Add to PATH

To use felico from anywhere, add the binary to your PATH:

Linux/macOS:

export PATH="$PATH:$(pwd)/target/release"

Add this line to your ~/.bashrc or ~/.zshrc to make it permanent.

Windows: Add C:\path\to\felico\target\release to your system PATH environment variable.

4. Verify Installation

felico --version

Development Setup

If you plan to contribute to Felico, also set up the git hooks:

./scripts/git-hooks/install-hooks.sh

This will enable pre-commit checks that run formatting, linting, and tests.

Next Steps

Now that you have Felico installed, head to the Quick Start guide to write your first program!