Skip to main content

Installation and Setup

Welcome to Fiscus SDK! 🎉
This guide will get you up and running in no time, so let’s dive in.

Prerequisites​

Before installing Fiscus SDK, make sure you have the following:

  • Python 3.8+ installed on your system
  • Pip for managing Python packages
  • An active Fiscus API Key (Sign up at Fiscus Dashboard)

Step 1: Installing the SDK​

Let’s install the SDK using pip. Open up your terminal and run:

pip install fiscus

This will pull the latest version of the Fiscus SDK and install it on your machine.

Step 2: Setting Up Your Environment​

Once the installation is complete, you need to configure your environment to use Fiscus. Here’s what to do:

  1. Grab your API Key from your Fiscus account.
  2. Set up your environment variables (Recommended):

On MacOS/Linux, run:

export FISCUS_API_KEY='YOUR_FISCUS_API_KEY'

On Windows, run:

set FISCUS_API_KEY='YOUR_FISCUS_API_KEY'

Step 3: Testing the Installation​

Let’s make sure everything works! Create a Python file and add the following code:

from fiscus import FiscusClient

# Initialize the Fiscus client with your API key and user_id
client = FiscusClient(api_key='YOUR_FISCUS_API_KEY', user_id='user_123')

# Add the email connector (e.g., Gmail)
client.user.add_connector('Gmail')

# If the connector requires authentication, this will trigger an authentication flow
client.user.authenticate_connector('Gmail')

# Setup parameters to execute API call
response = client.execute('Gmail', 'send_email', {
    'to': 'test@example.com',
    'subject': 'Hello from Fiscus!',
    'body': 'This email was sent using Fiscus SDK.'
})

# Handle response
if response.success:
    print('Email sent successfully!')
else:
    print(f'Error: {response.error_message}')

Step 4: You’re All Set!​

That’s it! 🎉 You’ve installed Fiscus SDK and tested your first API call. Now you’re ready to start building AI-powered workflows and orchestrating APIs like a pro!

Need Help?​