Tailer Documentation
  • What is Tailer Platform?
  • Getting Started
    • Prepare your local environment for Tailer
    • Install Tailer SDK
    • Set up Google Cloud Platform
    • Encrypt your credentials
  • [Tutorial] Create a first data pipeline
    • Introduction
    • Prepare the demonstration environment
    • Copy files from one bucket to another
    • Load files into BigQuery tables
    • Prepare data
    • Build predictions
    • Export data
    • Congratulations!
    • [Video] Automatic Script
      • SQL script file
      • DDL script file
      • Tables to Tables script file
      • Launch configuration and furthermore
  • Data Pipeline Operations
    • Overview
    • Set constants with Context
      • Context configuration file
    • Move files with Storage to Storage
      • Storage to Storage configuration file
    • Load data with Storage to Tables
      • Storage to Tables configuration file
      • Storage to Tables DDL files
    • Stream incoming data with API To Storage
      • API To Storage configuration file
      • API To Storage usage examples
    • Transform data with Tables to Tables
      • Tables to Tables configuration file
      • Table to Table SQL and DDL files
    • Export data with Tables to Storage
      • [V3] Table to Storage configuration file
      • Table to Storage SQL file
      • [V1-V2: deprecated] Table to Storage configuration file
    • Orchestrate processings with Workflow
      • [V2] Workflow configuration file
      • [V1: deprecated] Workflow configuration file
    • Convert XML to CSV
      • Convert XML to CSV configuration file
    • Use advanced features with VM Launcher
      • Process code with VM Launcher
        • VM Launcher configuration file for code processing
      • Encrypt/Decrypt data with VM Launcher
        • VM Launcher configuration file for data encryption
        • VM Launcher configuration file for data decryption
    • Monitoring and Alerting
      • Monitoring and alerting parameters
    • Asserting Data quality with Expectations
      • List of Expectations
    • Modify files with File Utilities
      • Encrypt/Decrypt data with File Utilities
        • Configuration file for data encryption
        • Configuration file for data decryption
    • Transfer data with GBQ to Firestore
      • Table to Storage: configuration file
      • Table to Storage: SQL file
      • VM Launcher: configuration file
      • File-to-firestore python file
  • Tailer Studio
    • Overview
    • Check data operations' details
    • Monitor data operations' status
    • Execute data operations
    • Reset Workflow data operations
    • Archive data operations
    • Add notes to data operations and runs
    • View your data catalog
    • Time your data with freshness
  • Tailer API
    • Overview
    • Getting started
    • API features
  • Release Notes
    • Tailer SDK Stable Releases
    • Tailer Beta Releases
      • Beta features
      • Beta configuration
      • Tailer SDK API
    • Tailer Status
Powered by GitBook
On this page
  • Windows
  • Install Python
  • Create a working folder
  • macOS/Linux
  • Set Bash as default shell
  • Create a working folder
  • Upgrade Python
  • Always use a Virtual Environment

Was this helpful?

Edit on GitHub
  1. Getting Started

Prepare your local environment for Tailer

Before installing the Tailer SDK package, you need to prepare your local environment.

PreviousWhat is Tailer Platform?NextInstall Tailer SDK

Last updated 1 year ago

Was this helpful?

Tailer SDK runs on Windows, Linux, and macOS. Tailer SDK requires Python. Supported versions are 3.8 or higher.

Before installing Tailer SDK, a number of tasks need to be performed depending if you're planning to use a Windows or macOS/Linux environment.

Windows

Install Python

To install Python:

  1. Access this page: https://www.python.org/downloads/release/python-382/

  2. Select and download the installer for the release (3.8 or higher) that matches your operating system.

  3. Launch the installer.

  4. Select the Customize installation option, and make sure you check the Add Python to environment variables checkbox.

  5. To check if Python installation was successful, open a terminal, and run the following command:

    python3 --version

The Python release number displays.

Create a working folder

To create a working folder for Tailer SDK:

  1. Access the working folder of your choice:

    cd your_working_folder
  2. Create a folder for Tailer SDK and access it:

    mkdir tailer
    cd tailer

Set Bash as default shell

To change the default shell to Bash:

  1. Run the following command:

    chsh -s /bin/bash
  2. Close your terminal and reopen it.

  3. Run the following command to make sure the default shell is now bash:

    env

If you get the following result, Bash has been installed successfully:

SHELL=/bin/bash

Create a working folder

We recommend that you create the Tailer SDK working folder in your home root directory.

To create and access the working folder, run the following commands:

mkdir ~/tailer
cd ~/tailer

Examples in this documentation will assume that you're working in the tailer folder created at this step.

Upgrade Python

While current versions of macOS and Linux include a version of Python 2, Tailer SDK only supports Python 3.8 or higher, so you need to upgrade to a newer version.

Install Homebrew

To install Python, you first need to install Homebrew, a package management system that simplifies software installation:

  1. Run the following command:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  2. Make sure the installation was successful by running the following command:

    brew doctor

Now that Homebrew is installed, you can upgrade to Python 3.

Upgrade to Python 3

To upgrade Python:

  1. Check your current version of Python by running the following command:

    python --version
  2. If your version is inferior to 3.8, install the latest version of Python 3 by running the following command:

    brew install python3
  3. To confirm which version of Python 3 was installed, run the following command:

    python3 --version

Always use a Virtual Environment

Virtual environments let you have a stable, reproducible, and portable environment. You are in control of which packages versions are installed and when they are upgraded. You can have as many venvs as you want.

  1. You can install venv to your host Python by running this command in your terminal:

    pip3 install virtualenv
  2. To use venv in your project, in your terminal, create a new project folder, cd to the Tailer folder in your terminal, and run the following command:

    python3 -m venv tailerenv
  3. Now that you have created the virtual environment, you will need to activate it before you can use it in your project. On a mac, to activate your virtual environment, run the code below:

    source /Users/username/tailerenv/bin/activate

Don't forget to change username by the name of your user. Keep this line on a notepad. You need it each time you open a new terminal to use the Tailer SDK set on the venv.

  • To confirm which version of Python 3 was installed, run the following command:

    python3 --version

Your Windows environment is now ready. You can proceed with the .

macOS/Linux

Your macOS/Linux environment is now ready. You can proceed with the .

💻
🍏
installation
installation