Skip to main content

Prerequisites

Before you begin, make sure you have:

Python 3.11+

Fibonacci requires Python 3.11 or higher

API Key

Sign up at fibonacci.today to get your API key

Installation

Install the Fibonacci SDK using pip:
pip install fibonacci-sdk
For secure API key storage, install with the security extras:
pip install fibonacci-sdk[security]

Set Up Authentication

Create a .env file in your project root:
.env
FIBONACCI_API_KEY=fib_live_your_api_key_here
Never commit your .env file to version control. Add it to your .gitignore.
Or use secure keychain storage (recommended for production):
from fibonacci import save_api_key_secure

# Save to system keychain (macOS Keychain, Windows Credential Manager, etc.)
save_api_key_secure("fib_live_your_api_key_here")

Your First Workflow

Let’s create a simple workflow that uses AI to analyze text:
from fibonacci import Workflow, LLMNode
from dotenv import load_dotenv
import os

# Load environment variables
load_dotenv()

# Create a workflow
wf = Workflow(
    name="Text Analyzer",
    description="Analyzes text for sentiment and key points"
)

# Add an LLM node
analyze = LLMNode(
    id="analyze_text",
    name="Analyze Text",
    instruction="""
    Analyze the following text and provide:
    1. Overall sentiment (positive, negative, neutral)
    2. Key points (bullet list)
    3. Suggested actions
    
    Text: {{input.text}}
    """
)

wf.add_node(analyze)

# Deploy to Fibonacci
workflow_id = wf.deploy(api_key=os.getenv("FIBONACCI_API_KEY"))
print(f"✅ Deployed! Workflow ID: {workflow_id}")

# Execute the workflow
result = wf.run(input_data={
    "text": "Our Q4 sales exceeded expectations by 15%. The team did an amazing job!"
})

print(f"Status: {result.status}")
print(f"Output: {result.output_data['analyze_text']}")

Expected Output

✅ Deployed! Workflow ID: wf_abc123xyz

Status: completed
Output: 
**Sentiment:** Positive

**Key Points:**
- Q4 sales exceeded expectations by 15%
- Team performance was exceptional

**Suggested Actions:**
- Recognize and reward the team
- Analyze what contributed to success
- Set ambitious Q1 targets

What’s Next?

Congratulations! You’ve just created and deployed your first Fibonacci workflow.