Skip to main content

​
System Requirements

Python Version

Python 3.11 or higher is required

Operating Systems

macOS, Linux, Windows (64-bit)

​
Installation Methods

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

Make sure you’ve activated your virtual environment:
source venv/bin/activate  # Linux/macOS
.\venv\Scripts\activate   # Windows
Then reinstall:
pip install fibonacci-sdk
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
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
If you’re behind a corporate proxy:
pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org fibonacci-sdk

​
Next Steps

Set Up Authentication

Configure your API key securely

Quickstart

Build your first workflow