versipellis

README

Versipellis - The Data Flow Shape Shifter

Versipellis is a versatile, scalable tool for transferring and transforming data reliably across diverse media, protocols, and formats, without altering the data itself.

It is not a data pipeline, but rather a powerful yet easy-to-use conduit for pipeline inputs and outputs.

In other words: "Let's take all this data, and push it somewhere else."

Getting Started

1. Choose any of the installation options below
2. Quickstart demos & tutorials
3. Configuration reference

Installation Option 1: Docker Image

https://github.com/daabr/versipellis/pkgs/container/versipellis

Command line example:

docker run -d --name my-versi-container \
       -v $HOME/versi/config:/app/config -v $HOME/versi/data:/app/data \
       -p 4884:4884/tcp -p 4885:4885/tcp -p 3885:3885/udp \
       ghcr.io/daabr/versipellis:latest

• Platforms: Linux (amd64/arm64)
• Volumes / bind mount points:
  • /app/config - for Versipellis .toml files, ODBC .ini files (instead of /etc), Oracle .ora files, passwords and certificates, etc.
  • /app/data - for backup storage of runtime input data
• Already bundled and tested with:
  • Oracle Instant Client
  • unixODBC

Installation Option 2: Precompiled Executable Binary

https://github.com/daabr/versipellis/releases/latest

• Platforms:
  • Linux (amd64/arm64)
  • macOS (amd64/arm64)
  • Windows (amd64 only)
• Optional runtime dependencies:
  • Oracle Instant Client (basic lite) - needed only for Oracle Database
  • unixODBC - needed only for ODBC, and only on Linux and macOS

Installation Option 3: Build From Source

Required Go version: 1.27

Command line:

CGO_ENABLED=0 go build ./cmd/versi && ./versi -h

Or:

CGO_ENABLED=1 go build -tags=odbc ./cmd/versi && ./versi -h

• CGO_ENABLED=1 - optional, needed only for Oracle Database and unixODBC
• -tags=odbc - optional, needed only for unixODBC

Supported Inputs

SQL Input

Supported SQL-based databases:

• CockroachDB
• MariaDB
• Microsoft SQL Server
• MySQL
• ODBC
  • Teradata
• Oracle Database
• PostgreSQL
• SAP HANA
• Snowflake
• SQLite