Viadot
Documentation: https://viadot.docs.dyvenia.com
Source Code: https://github.com/dyvenia/viadot/tree/main
A simple data ingestion library to guide data flows from some places to other places.
Getting Data from a Source
Viadot supports several API and RDBMS sources, private and public. Currently, we support the UK Carbon Intensity public API and base the examples on it.
from viadot.sources.uk_carbon_intensity import UKCarbonIntensity
ukci = UKCarbonIntensity()
ukci.query("/intensity")
df = ukci.to_df()
print(df)
Output:
| from | to | forecast | actual | index | |
|---|---|---|---|---|---|
| 0 | 2021-08-10T11:00Z | 2021-08-10T11:30Z | 211 | 216 | moderate |
The above df is a pandas DataFrame object. It contains data downloaded by viadot from the Carbon Intensity UK API.
Loading data to a destination
Depending on the destination, viadot provides different methods of uploading data. For instance, for databases, this would be bulk inserts. For data lakes, it would be file uploads.
For example:
from viadot.sources import UKCarbonIntensity
from viadot.sources import AzureDataLake
ukci = UKCarbonIntensity()
ukci.query("/intensity")
df = ukci.to_df()
adls = AzureDataLake(config_key="my_adls_creds")
adls.from_df(df, "my_folder/my_file.parquet")
Getting started
Prerequisites
We use uv. You can install it like so:
curl -LsSf https://astral.sh/uv/install.sh | sh
Installation
pip install viadot2
Running the Docker Environment
The project provides the run.sh script located in the docker/ directory to initialize Docker environment with optional configuration for image tags and target platform.
Make sure the script is executable.
chmod +x docker/run.sh
Usage
docker/run.sh [-t <image_tag>] [-p <platform>]
- -t <image_tag> - set Docker image tag (default: latest)
- -p - set the target platform for Docker (default: linux/amd64)
- This default ensures compatibility on macOS (Apple Silicon). Optionally, you can provide a different platform.
Examples
Run with default settings:
docker/run.sh
Run with a specific image tag and platform:
docker/run.sh -t dev -p linux/amd64
Configuration
In order to start using sources, you must configure them with required credentials. Credentials can be specified either in the viadot config file (by default, $HOME/.config/viadot/config.yaml), or passed directly to each source's credentials parameter.
You can find specific information about each source's credentials in the documentation.
Next steps
Check out the documentation for more information on how to use viadot.
1 maintainer
Metadata
1 maintainer
Release files for viadot2 2.14.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| viadot2-2.14.0.tar.gz | 979.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| viadot2-2.14.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.3 MB
Release files / viadot2-2.14.0.tar.gz
| Download URL | viadot2-2.14.0.tar.gz |
|---|---|
| Size | 979.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
07d3eed53c0dbc11285e64f15b73f0d309decdfda7188b6f0c5c8b421d671558
|
|
BLAKE2b-256 checksum How to use checksums |
21e54a19fb367f9ce1120b74457f5e5090e76ec08a0abbb628f32171b0cb811b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 22, 2026.
Transparency logRelease files / viadot2-2.14.0-py3-none-any.whl
| Download URL | viadot2-2.14.0-py3-none-any.whl |
|---|---|
| Size | 361.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
91858e75d6dc3fd43559b8037bf08be25fd15bf231acba4ff9e649e9960d27d2
|
|
BLAKE2b-256 checksum How to use checksums |
535797740e63a259fc7e8ce08448641e7fcfd12cc91e78a176917dff66c670c1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 22, 2026.
Transparency log
