Installation

System Requirements

Python Version

Python 3.11 or higher is required

Operating Systems

macOS, Linux, Windows (64-bit)

Installation Methods

Using pip (Recommended)

pip install fibonacci-sdk

Using Poetry

poetry add fibonacci-sdk

Using uv

uv add fibonacci-sdk

From Source

git clone https://github.com/fibonacci-ai/fibonacci-sdk.git
cd fibonacci-sdk
pip install -e .

Optional Dependencies

Security Features

For secure keychain storage and enhanced security features:

pip install fibonacci-sdk[security]

This includes:

keyring - System keychain integration (macOS Keychain, Windows Credential Manager, Linux Secret Service)
Secure API key storage
Migration tools from plaintext to encrypted storage

Development Dependencies

For contributing to Fibonacci or running tests:

pip install fibonacci-sdk[dev]

This includes:

pytest - Testing framework
pytest-asyncio - Async test support
black - Code formatting
ruff - Linting
mypy - Type checking

Full Installation

Install everything:

pip install fibonacci-sdk[security,dev]

Verify Installation

After installation, verify everything is working:

import fibonacci

# Check version
print(f"Fibonacci SDK v{fibonacci.__version__}")

# Check available classes
from fibonacci import (
    Workflow,
    LLMNode,
    ToolNode,
    CriticNode,
    ConditionalNode,
    Memory,
    FibonacciClient
)

print("✅ All core classes imported successfully!")

You should see:

Fibonacci SDK v0.1.0
✅ All core classes imported successfully!

CLI Installation

The SDK includes a command-line interface. After installation, the fibonacci command is available:

fibonacci version

Output:

  _____ _ _                                _   ____  ____  _  __
 |  ___(_) |__   ___  _ __   __ _  ___ ___(_) / ___||  _ \| |/ /
 | |_  | | '_ \ / _ \| '_ \ / _` |/ __/ __| | \___ \| | | | ' / 
 |  _| | | |_) | (_) | | | | (_| | (_| (__| |  ___) | |_| | . \ 
 |_|   |_|_.__/ \___/|_| |_|\__,_|\___\___|_| |____/|____/|_|\_\
                                                                 
         AI Workflow Automation • Build. Deploy. Execute.
v0.1.0

Troubleshooting

ImportError: No module named 'fibonacci'

Make sure you’ve activated your virtual environment:

source venv/bin/activate  # Linux/macOS
.\venv\Scripts\activate   # Windows

Then reinstall:

pip install fibonacci-sdk

Python version error

Fibonacci requires Python 3.11+. Check your version:

python --version

If needed, install a newer Python version or use pyenv:

pyenv install 3.11.0
pyenv local 3.11.0

Keyring not working on Linux

On Linux, you may need to install the Secret Service backend:

# Ubuntu/Debian
sudo apt-get install gnome-keyring

# Fedora
sudo dnf install gnome-keyring

SSL certificate errors

If you’re behind a corporate proxy:

pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org fibonacci-sdk

Getting Started

Core Concepts

Advanced Guides

System Requirements

Python Version

Operating Systems

Installation Methods

Using pip (Recommended)

Using Poetry

Using uv

From Source

Optional Dependencies

Security Features

Development Dependencies

Full Installation

Verify Installation

CLI Installation

Troubleshooting

Next Steps

Set Up Authentication

Quickstart

​System Requirements

Python Version

Operating Systems

​Installation Methods

​Using pip (Recommended)

​Using Poetry

​Using uv

​From Source

​Optional Dependencies

​Security Features

​Development Dependencies

​Full Installation

​Verify Installation

​CLI Installation

​Troubleshooting

​Next Steps

Set Up Authentication

Quickstart

System Requirements

Installation Methods

Using pip (Recommended)

Using Poetry

Using uv

From Source

Optional Dependencies

Security Features

Development Dependencies

Full Installation

Verify Installation

CLI Installation

Troubleshooting

Next Steps