Skip to main content

Installation Guide

Complete installation instructions for Qarion ETL.

Prerequisites​

  • Python 3.11 or higher
  • pip or poetry for package management

Installation Methods​

Install from PyPI​

pip install qarion-etl

Install from Source​

git clone https://github.com/yourorg/qarion-etl.git
cd qarion-etl
pip install -e .

Install with Poetry​

git clone https://github.com/yourorg/qarion-etl.git
cd qarion-etl
poetry install

Development Installation​

For development, install with development dependencies:

pip install -e ".[dev]"

Or with poetry:

poetry install --with dev

Verify Installation​

qarion-etl --version

You should see the version number printed.

Dependencies​

Qarion ETL has the following key dependencies:

  • toml - TOML file parsing
  • pandas - Data manipulation (for Pandas engine)
  • sqlalchemy - Database abstraction (for SQL engines)

Optional dependencies:

  • duckdb - DuckDB engine support
  • jinja2 - Template rendering (for DBT generation)

Troubleshooting​

Import Errors​

If you encounter import errors:

  1. Verify Python version: python --version (should be 3.11+)
  2. Reinstall: pip install --force-reinstall qarion-etl
  3. Check virtual environment is activated

Missing Dependencies​

If you get missing dependency errors:

pip install -r requirements.txt

Permission Errors​

If you get permission errors:

  • Use pip install --user qarion-etl for user installation
  • Or use a virtual environment: python -m venv venv && source venv/bin/activate

Next Steps​

After installation:

  1. Quick Start Guide
  2. Core Concepts
  3. Configuration Guide