fibonacci-sdk 0.1.0__tar.gz

fibonacci_sdk-0.1.0/LICENSE

@@ -0,0 +1,270 @@
+Fibonacci SDK License Agreement
+Version 1.0, January 2026
+
+Copyright (c) 2026-2027 Fibonacci, Inc. All rights reserved.
+
+================================================================================
+IMPORTANT: READ THIS LICENSE AGREEMENT CAREFULLY BEFORE USING THIS SOFTWARE.
+================================================================================
+
+This License Agreement ("Agreement") is a legal agreement between you (either an
+individual or a single entity, referred to herein as "You" or "Licensee") and
+Fibonacci, Inc. ("Fibonacci", "Company", "We", or "Us") for the Fibonacci SDK
+software, including any associated documentation, source code, and related
+materials (collectively, the "Software").
+
+By downloading, installing, copying, or otherwise using the Software, you agree
+to be bound by the terms of this Agreement. If you do not agree to the terms of
+this Agreement, do not download, install, copy, or use the Software.
+
+--------------------------------------------------------------------------------
+1. GRANT OF LICENSE
+--------------------------------------------------------------------------------
+
+Subject to the terms and conditions of this Agreement, Fibonacci grants you a
+limited, non-exclusive, non-transferable, revocable license to:
+
+   a) USE the Software solely for the purpose of developing applications that
+      integrate with the Fibonacci Platform using a valid Fibonacci API key;
+
+   b) VIEW and READ the source code for educational and reference purposes;
+
+   c) MAKE copies of the Software solely for backup or archival purposes;
+
+   d) CREATE applications ("Applications") that use the Software to communicate
+      with the Fibonacci Platform, provided such Applications do not expose,
+      redistribute, or resell the Software itself.
+
+--------------------------------------------------------------------------------
+2. RESTRICTIONS
+--------------------------------------------------------------------------------
+
+You may NOT, under any circumstances:
+
+   a) MODIFY, alter, adapt, translate, or create derivative works based on the
+      Software, except as expressly permitted in Section 1;
+
+   b) REDISTRIBUTE, sublicense, rent, lease, loan, sell, or otherwise transfer
+      the Software or any rights therein to any third party;
+
+   c) REMOVE, alter, or obscure any copyright notices, trademarks, or other
+      proprietary rights notices contained in or on the Software;
+
+   d) USE the Software to develop a product or service that competes with
+      Fibonacci or the Fibonacci Platform;
+
+   e) REVERSE ENGINEER, disassemble, decompile, or attempt to derive the source
+      code of any proprietary components of the Fibonacci Platform (the SDK
+      source code itself is viewable under this license);
+
+   f) USE the Software for any unlawful purpose or in violation of any
+      applicable laws or regulations;
+
+   g) USE the Software without a valid Fibonacci API key, except for viewing
+      the source code as permitted in Section 1(b);
+
+   h) PUBLISH, distribute, or make available the Software (in whole or in part)
+      as part of any other software package, library, or framework;
+
+   i) CLAIM ownership of the Software or represent that you have any rights to
+      the Software beyond those expressly granted in this Agreement;
+
+   j) USE the Fibonacci name, logo, or trademarks without prior written consent
+      from Fibonacci, Inc.
+
+--------------------------------------------------------------------------------
+3. API KEY REQUIREMENT
+--------------------------------------------------------------------------------
+
+   a) A valid Fibonacci API key is required to use the Software for its intended
+      purpose of communicating with the Fibonacci Platform.
+
+   b) API keys are subject to separate terms of service and usage policies as
+      published on the Fibonacci website.
+
+   c) Fibonacci reserves the right to revoke, suspend, or terminate API keys at
+      any time, with or without cause.
+
+   d) You are responsible for maintaining the confidentiality of your API key
+      and for all activities that occur under your API key.
+
+--------------------------------------------------------------------------------
+4. INTELLECTUAL PROPERTY
+--------------------------------------------------------------------------------
+
+   a) The Software is protected by copyright laws and international copyright
+      treaties, as well as other intellectual property laws and treaties.
+
+   b) Fibonacci retains all right, title, and interest in and to the Software,
+      including all copyrights, patents, trade secrets, trademarks, and other
+      intellectual property rights.
+
+   c) This Agreement does not grant you any rights to use Fibonacci's
+      trademarks, service marks, trade names, or logos.
+
+   d) Any feedback, suggestions, or improvements you provide regarding the
+      Software may be used by Fibonacci without any obligation to you.
+
+--------------------------------------------------------------------------------
+5. CONTRIBUTIONS
+--------------------------------------------------------------------------------
+
+   a) Fibonacci may, at its sole discretion, accept contributions to the
+      Software from third parties.
+
+   b) By submitting any contribution (including but not limited to code,
+      documentation, or suggestions), you:
+
+      i.   Grant Fibonacci a perpetual, irrevocable, worldwide, royalty-free,
+           non-exclusive license to use, reproduce, modify, distribute, and
+           sublicense your contribution;
+
+      ii.  Represent that you have the legal right to grant such license;
+
+      iii. Understand that your contribution may or may not be included in the
+           Software at Fibonacci's sole discretion.
+
+--------------------------------------------------------------------------------
+6. DISCLAIMER OF WARRANTIES
+--------------------------------------------------------------------------------
+
+THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND NON-INFRINGEMENT.
+
+FIBONACCI DOES NOT WARRANT THAT:
+
+   a) THE SOFTWARE WILL MEET YOUR REQUIREMENTS;
+
+   b) THE SOFTWARE WILL BE UNINTERRUPTED, TIMELY, SECURE, OR ERROR-FREE;
+
+   c) THE RESULTS OBTAINED FROM THE USE OF THE SOFTWARE WILL BE ACCURATE OR
+      RELIABLE;
+
+   d) ANY ERRORS IN THE SOFTWARE WILL BE CORRECTED.
+
+--------------------------------------------------------------------------------
+7. LIMITATION OF LIABILITY
+--------------------------------------------------------------------------------
+
+TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW:
+
+   a) IN NO EVENT SHALL FIBONACCI BE LIABLE FOR ANY INDIRECT, INCIDENTAL,
+      SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO
+      LOSS OF PROFITS, DATA, USE, GOODWILL, OR OTHER INTANGIBLE LOSSES;
+
+   b) IN NO EVENT SHALL FIBONACCI'S TOTAL LIABILITY TO YOU FOR ALL DAMAGES
+      EXCEED THE AMOUNT YOU HAVE PAID TO FIBONACCI IN THE TWELVE (12) MONTHS
+      PRECEDING THE CLAIM, OR ONE HUNDRED DOLLARS ($100), WHICHEVER IS GREATER;
+
+   c) THESE LIMITATIONS SHALL APPLY REGARDLESS OF THE LEGAL THEORY UPON WHICH
+      DAMAGES MAY BE CLAIMED AND EVEN IF FIBONACCI HAS BEEN ADVISED OF THE
+      POSSIBILITY OF SUCH DAMAGES.
+
+--------------------------------------------------------------------------------
+8. INDEMNIFICATION
+--------------------------------------------------------------------------------
+
+You agree to indemnify, defend, and hold harmless Fibonacci, its officers,
+directors, employees, agents, and affiliates from and against any and all
+claims, damages, losses, liabilities, costs, and expenses (including reasonable
+attorneys' fees) arising out of or related to:
+
+   a) Your use of the Software;
+
+   b) Your violation of this Agreement;
+
+   c) Your violation of any rights of any third party;
+
+   d) Any Applications you develop using the Software.
+
+--------------------------------------------------------------------------------
+9. TERMINATION
+--------------------------------------------------------------------------------
+
+   a) This Agreement is effective until terminated.
+
+   b) Fibonacci may terminate this Agreement at any time, with or without cause,
+      upon notice to you.
+
+   c) Your rights under this Agreement will terminate automatically without
+      notice if you fail to comply with any term of this Agreement.
+
+   d) Upon termination, you must:
+
+      i.   Cease all use of the Software;
+
+      ii.  Destroy all copies of the Software in your possession or control;
+
+      iii. Certify in writing, upon request, that you have complied with these
+           termination requirements.
+
+   e) Sections 2, 4, 5, 6, 7, 8, 10, and 11 shall survive termination.
+
+--------------------------------------------------------------------------------
+10. GOVERNING LAW AND DISPUTE RESOLUTION
+--------------------------------------------------------------------------------
+
+   a) This Agreement shall be governed by and construed in accordance with the
+      laws of the State of Delaware, United States, without regard to its
+      conflict of laws provisions.
+
+   b) Any dispute arising out of or relating to this Agreement shall be resolved
+      through binding arbitration in accordance with the rules of the American
+      Arbitration Association.
+
+   c) The arbitration shall be conducted in English and shall take place in
+      Wilmington, Delaware, or remotely at the discretion of the arbitrator.
+
+   d) The decision of the arbitrator shall be final and binding on both parties.
+
+   e) Notwithstanding the foregoing, Fibonacci may seek injunctive or other
+      equitable relief in any court of competent jurisdiction to protect its
+      intellectual property rights.
+
+--------------------------------------------------------------------------------
+11. GENERAL PROVISIONS
+--------------------------------------------------------------------------------
+
+   a) ENTIRE AGREEMENT: This Agreement constitutes the entire agreement between
+      you and Fibonacci concerning the Software and supersedes all prior
+      agreements, understandings, and communications.
+
+   b) AMENDMENT: Fibonacci may modify this Agreement at any time by posting a
+      revised version. Your continued use of the Software after such posting
+      constitutes acceptance of the modified Agreement.
+
+   c) SEVERABILITY: If any provision of this Agreement is held to be
+      unenforceable, such provision shall be reformed only to the extent
+      necessary to make it enforceable, and the remaining provisions shall
+      continue in full force and effect.
+
+   d) WAIVER: The failure of Fibonacci to enforce any right or provision of this
+      Agreement shall not constitute a waiver of such right or provision.
+
+   e) ASSIGNMENT: You may not assign or transfer this Agreement or any rights
+      hereunder without Fibonacci's prior written consent. Fibonacci may assign
+      this Agreement without restriction.
+
+   f) NOTICES: All notices under this Agreement shall be in writing and shall be
+      deemed given when delivered personally, sent by confirmed email, or sent
+      by certified mail to the addresses specified by the parties.
+
+   g) EXPORT COMPLIANCE: You agree to comply with all applicable export and
+      import laws and regulations in your use of the Software.
+
+--------------------------------------------------------------------------------
+12. CONTACT INFORMATION
+--------------------------------------------------------------------------------
+
+For questions about this License Agreement, please contact:
+
+   Fibonacci, Inc.
+   Website: https://fibonacci.today
+
+================================================================================
+
+BY USING THE FIBONACCI SDK, YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT,
+UNDERSTAND IT, AND AGREE TO BE BOUND BY ITS TERMS AND CONDITIONS.
+
+================================================================================

fibonacci_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,415 @@
+Metadata-Version: 2.4
+Name: fibonacci-sdk
+Version: 0.1.0
+Summary: Python SDK for Fibonacci Workflow Automation Platform
+License: Proprietary
+License-File: LICENSE
+Keywords: workflow,automation,ai,llm,orchestration
+Author: Fibonacci Team
+Author-email: team@fibonacci.today
+Requires-Python: >=3.11,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: httpx (>=0.27.0,<0.28.0)
+Requires-Dist: pydantic (>=2.5.0,<3.0.0)
+Requires-Dist: python-dotenv (>=1.0.0,<2.0.0)
+Requires-Dist: pyyaml (>=6.0.1,<7.0.0)
+Requires-Dist: rich (>=13.7.0,<14.0.0)
+Requires-Dist: typer (>=0.12.0,<0.13.0)
+Project-URL: Documentation, https://docs.fibonacci.today
+Project-URL: Homepage, https://fibonacci.today
+Project-URL: Repository, https://github.com/RohanBanerjee88/fibonacci-sdk
+Description-Content-Type: text/markdown
+
+# Fibonacci SDK
+
+<p align="center">
+  <strong>Build and deploy AI-powered workflows programmatically</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/fibonacci-sdk/"><img src="https://img.shields.io/pypi/v/fibonacci-sdk.svg" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/fibonacci-sdk/"><img src="https://img.shields.io/pypi/pyversions/fibonacci-sdk.svg" alt="Python versions"></a>
+  <a href="https://github.com/RohanBanerjee88/fibonacci-sdk/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Proprietary-blue.svg" alt="License"></a>
+</p>
+
+<p align="center">
+  <a href="https://docs.fibonacci.today">Documentation</a> •
+  <a href="#installation">Installation</a> •
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#features">Features</a> •
+  <a href="https://github.com/fibonacci-ai/fibonacci-sdk/issues">Issues</a>
+</p>
+
+---
+
+## What is Fibonacci?
+
+Fibonacci is a platform for building autonomous AI agents and workflows. The SDK allows developers to:
+
+- 🤖 **Build AI Workflows** - Chain LLM calls, tools, and logic programmatically
+- 🚀 **Deploy Instantly** - One command to deploy to production
+- 🔧 **40+ Integrations** - Connect to Slack, Google Sheets, GitHub, and more
+- 📊 **Monitor & Optimize** - Track costs, performance, and optimize automatically
+
+---
+
+## Installation
+
+```bash
+pip install fibonacci-sdk
+```
+
+### With Security Features (Recommended)
+
+```bash
+pip install fibonacci-sdk[security]
+```
+
+This includes secure keychain storage for API keys.
+
+---
+
+## Quick Start
+
+### 1. Get Your API Key
+
+Sign up at [fibonacci.today](https://fibonacci.today) to get your API key.
+
+### 2. Set Up Authentication
+
+```bash
+# Option 1: Environment variable
+export FIBONACCI_API_KEY="fib_live_your_api_key"
+
+# Option 2: Secure keychain storage (recommended)
+fibonacci security save
+# Then enter your API key when prompted
+```
+
+### 3. Create Your First Workflow
+
+```python
+from fibonacci import Workflow, LLMNode, ToolNode
+
+# Create a workflow
+wf = Workflow(
+    name="Customer Support Bot",
+    description="AI-powered customer support assistant"
+)
+
+# Add an LLM node
+respond = LLMNode(
+    id="respond",
+    name="Generate Response",
+    instruction="""
+    You are a helpful customer support assistant.
+    
+    Customer message: {{input.message}}
+    
+    Provide a friendly, helpful response.
+    """
+)
+
+wf.add_node(respond)
+
+# Deploy to Fibonacci platform
+workflow_id = wf.deploy()
+print(f"Deployed! Workflow ID: {workflow_id}")
+
+# Execute the workflow
+result = wf.run(input_data={"message": "How do I reset my password?"})
+print(result.output_data)
+```
+
+---
+
+## Features
+
+### 🔗 Node Types
+
+| Node | Description | Example Use Case |
+|------|-------------|------------------|
+| **LLMNode** | Call Claude AI models | Text generation, analysis, summarization |
+| **ToolNode** | Execute platform tools | Read Google Sheets, send Slack messages |
+| **CriticNode** | Evaluate outputs | Quality scoring, validation |
+| **ConditionalNode** | Branch logic | Route based on sentiment, conditions |
+
+### 📦 Example: Multi-Step Workflow
+
+```python
+from fibonacci import Workflow, LLMNode, ToolNode, ConditionalNode
+
+wf = Workflow(name="Sales Report Pipeline")
+
+# Step 1: Read data from Google Sheets
+read_data = ToolNode(
+    id="read_data",
+    name="Read Sales Data",
+    tool="google_sheets_read",
+    params={"spreadsheet_id": "{{input.sheet_id}}"}
+)
+
+# Step 2: Analyze with AI
+analyze = LLMNode(
+    id="analyze",
+    name="Analyze Sales",
+    instruction="Analyze this sales data and identify trends: {{read_data}}",
+    dependencies=["read_data"]
+)
+
+# Step 3: Check if urgent
+check_urgent = ConditionalNode(
+    id="check_urgent",
+    name="Check Urgency",
+    left_value="{{analyze}}",
+    operator="contains",
+    right_value="urgent",
+    true_branch=["send_alert"],
+    false_branch=["send_report"],
+    dependencies=["analyze"]
+)
+
+# Step 4a: Send alert if urgent
+send_alert = ToolNode(
+    id="send_alert",
+    name="Send Urgent Alert",
+    tool="slack_send_message",
+    params={
+        "channel": "#sales-alerts",
+        "message": "🚨 URGENT: {{analyze}}"
+    },
+    dependencies=["check_urgent"]
+)
+
+# Step 4b: Send regular report
+send_report = ToolNode(
+    id="send_report",
+    name="Send Report",
+    tool="slack_send_message",
+    params={
+        "channel": "#sales-reports",
+        "message": "📊 Daily Report: {{analyze}}"
+    },
+    dependencies=["check_urgent"]
+)
+
+wf.add_nodes([read_data, analyze, check_urgent, send_alert, send_report])
+
+# Deploy and run
+wf.deploy()
+result = wf.run(input_data={"sheet_id": "abc123"})
+```
+
+### 💾 Memory & State
+
+Persist data across workflow runs:
+
+```python
+from fibonacci import Memory
+
+# Store data
+memory = Memory(scope="workflow", workflow_id="your-workflow-id")
+memory.set("user_preferences", {"theme": "dark", "language": "en"})
+
+# Retrieve later
+prefs = memory.get("user_preferences")
+print(prefs)  # {"theme": "dark", "language": "en"}
+```
+
+### 📄 YAML Support
+
+Define workflows in YAML:
+
+```yaml
+# workflow.yaml
+name: Email Summarizer
+description: Summarize incoming emails
+
+nodes:
+  - id: summarize
+    type: llm
+    name: Summarize Email
+    instruction: "Summarize this email: {{input.email_body}}"
+    config:
+      model: claude-haiku-4-5
+      max_tokens: 500
+```
+
+```python
+from fibonacci import Workflow
+
+# Load from YAML
+wf = Workflow.from_yaml("workflow.yaml")
+wf.deploy()
+
+# Export to YAML
+wf.to_yaml("exported.yaml")
+```
+
+---
+
+## CLI Commands
+
+```bash
+# Initialize a new workflow project
+fibonacci init "My Workflow"
+
+# List your workflows
+fibonacci list
+
+# Execute a workflow
+fibonacci run <workflow-id> '{"message": "hello"}'
+
+# Check run status
+fibonacci status <run-id>
+
+# Security commands
+fibonacci security status    # Check API key security
+fibonacci security save      # Save API key to secure keychain
+fibonacci security migrate   # Migrate from .env to keychain
+
+# Audit logs
+fibonacci audit view         # View recent audit events
+```
+
+---
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `FIBONACCI_API_KEY` | Your API key | Required |
+| `FIBONACCI_BASE_URL` | API base URL | `http://api.fibonacci.today` |
+| `FIBONACCI_TIMEOUT` | Request timeout (seconds) | `300` |
+| `FIBONACCI_DEBUG` | Enable debug logging | `false` |
+
+### Configuration File
+
+Create `~/.fibonacci/config.yaml`:
+
+```yaml
+api_key: fib_live_your_key
+base_url: http://api.fibonacci.today
+timeout: 300
+debug: false
+```
+
+### Secure Storage (Recommended)
+
+Store your API key in the system keychain:
+
+```bash
+fibonacci security save
+```
+
+This uses:
+- **macOS**: Keychain
+- **Windows**: Credential Manager
+- **Linux**: Secret Service
+
+---
+
+## Tool Discovery
+
+Find available tools programmatically:
+
+```python
+from fibonacci import list_tools, get_tool_schema, search_tools
+
+# List all tools
+tools = list_tools()
+for tool in tools:
+    print(f"{tool['name']}: {tool['description']}")
+
+# Get detailed schema
+schema = get_tool_schema("google_sheets_read")
+print(schema)
+
+# Search for tools
+results = search_tools("slack")
+print(results)
+```
+
+---
+
+## Error Handling
+
+```python
+from fibonacci import (
+    Workflow,
+    FibonacciError,
+    AuthenticationError,
+    ValidationError,
+    ExecutionError
+)
+
+try:
+    wf = Workflow(name="My Workflow")
+    wf.deploy()
+except AuthenticationError:
+    print("Invalid API key")
+except ValidationError as e:
+    print(f"Workflow validation failed: {e.errors}")
+except ExecutionError as e:
+    print(f"Execution failed: {e.message}")
+except FibonacciError as e:
+    print(f"General error: {e.message}")
+```
+
+---
+
+## Requirements
+
+- Python 3.11 or higher
+- Valid Fibonacci API key
+
+### Dependencies
+
+- `httpx` - HTTP client
+- `pydantic` - Data validation
+- `typer` - CLI framework
+- `rich` - Terminal formatting
+- `pyyaml` - YAML support
+- `keyring` (optional) - Secure credential storage
+
+---
+
+## Documentation
+
+- 📖 **Full Documentation**: [docs.fibonacci.today](https://docs.fibonacci.today)
+- 🔧 **API Reference**: [docs.fibonacci.today/api](https://docs.fibonacci.today/api)
+
+---
+
+## License
+
+This SDK is proprietary software. See [LICENSE](LICENSE) for terms.
+
+**TL;DR**: You can use this SDK with a valid Fibonacci API key. You cannot modify, redistribute, or create competing products.
+
+---
+
+## Contributing
+
+We welcome bug reports and feature suggestions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+---
+
+<p align="center">
+  <strong>Built with ❤️ by Fibonacci, Inc.</strong>
+</p>
+
+<p align="center">
+  <a href="https://fibonacci.today">Website</a> •
+  <a href="https://docs.fibonacci.today">Docs</a> •
+</p>