omniload

Copy data between any source and any destination.

About

omniload is a polyglot data loader framework based on dlt, the open-source Python library for building data pipelines. dlt does the heavy lifting (schema inference, normalization, and incremental load state); omniload wraps it behind a single CLI and a URI scheme, so you can copy data between any source and any destination without writing pipeline code, either from your shell or the Python API.

omniload provides the same efficient incremental data loading modes inherited by dlt: append, merge, and delete+insert.

Install

Container

For running omniload in a container environment, use the provided OCI images.

docker run --rm ghcr.io/panodata/omniload:latest version

Package

For running or installing the omniload Python package, we are recommending to use uv. ¹²

uvx omniload

Alternatively, if you like to install it account-wide on your system:

uv tool install omniload

Synopsis

CLI

Instruct omniload to read from the PostgreSQL table public.some_data, and write to the BigQuery warehouse table omniload.some_data.

omniload ingest \
    --source-uri 'postgresql://admin:admin@localhost:8837/web?sslmode=disable' \
    --source-table 'public.some_data' \
    --dest-uri 'bigquery://<your-project-name>?credentials_path=/path/to/service/account.json' \
    --dest-table 'omniload.some_data'

Python API

Using omniload.run_ingest, you can run the same ingestion from your own application. The keyword arguments map one-to-one to the CLI options, and it returns the dlt LoadInfo for the run (or None for a dry run).

from omniload import run_ingest

info = run_ingest(
    source_uri="sqlite:///./source.db",
    dest_uri="duckdb:///./warehouse.duckdb",
    source_table="main.some_table",
    dest_table="public.some_table",
)
print(info)

See the Python API documentation for dry runs, error handling, and passing enum options as strings.

Handbook

Please visit the quickstart documentation, or inspect the list of supported sources and destinations.

Project

Contribute

Contributions are very much welcome. Please visit the sandbox documentation to learn how to spin up a development environment on your workstation and submit patches, or create a ticket to report a bug or propose a feature.

Status

Breaking changes should be expected until a 1.0 release, so version pinning is strongly recommended, especially when using this software as a library. For example:

pip install 'omniload[full]==0.0.42'

License

The project is licensed under the MIT License, see the LICENSE file for details. Some components are licensed under the Apache 2.0 license, see the NOTICE file for details.

Acknowledgements

This project would not have been possible without the amazing work by the authors and contributors to SQLAlchemy, dlt, and ingestr, turtles all the way down. Kudos.

You can install uv using pip install uv, or another method that matches your operating system. ↩
While installing omniload with vanilla pip is possible, it is an order of magnitude slower. ↩

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

omniload-0.9.1.tar.gz (427.9 kB view details)

Uploaded Aug 5, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

omniload-0.9.1-py3-none-any.whl (576.3 kB view details)

Uploaded Aug 5, 2026 Python 3

File details

Details for the file omniload-0.9.1.tar.gz.

File metadata

Download URL: omniload-0.9.1.tar.gz
Upload date: Aug 5, 2026
Size: 427.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for omniload-0.9.1.tar.gz
Algorithm	Hash digest
SHA256	`2d6bd9b7f6da2e4e843c659de5617dbc4aefa8f9cb6eb1b70ea5185acebcff94`
MD5	`d55c0367f651901782e1bc540874cd8b`
BLAKE2b-256	`cedd9001e404c49228e9de536fd6f15a2237441a5018ecc12781d4e5e815d651`

See more details on using hashes here.

Provenance

The following attestation bundles were made for omniload-0.9.1.tar.gz:

Publisher: release-pypi.yml on panodata/omniload

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: omniload-0.9.1.tar.gz
- Subject digest: 2d6bd9b7f6da2e4e843c659de5617dbc4aefa8f9cb6eb1b70ea5185acebcff94
- Sigstore transparency entry: 2342594238
- Sigstore integration time: Aug 5, 2026
Source repository:
- Permalink: panodata/omniload@7c812f9f2cf0e07c5f7c050bfd8599f06d20a6b3
- Branch / Tag: refs/tags/v0.9.1
- Owner: https://github.com/panodata
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-pypi.yml@7c812f9f2cf0e07c5f7c050bfd8599f06d20a6b3
- Trigger Event: push