Valgo API
The official Python client for the Valgo API to upload, share, and retrieve datasets programmatically.
Installation
pip install valgo
Valgo supports Python 3.11 and newer.
Quick start
Set the API key issued by your Valgo administrator:
export VALGO_API_KEY="valgo_live_..."
Upload a file:
from valgo import Valgo
client = Valgo()
uploaded = client.upload("data/dataset.parquet")
print(uploaded.artifact_id)
The SDK connects to https://api.valgo.ai by default.
You can also pass the key directly:
client = Valgo(api_key="valgo_live_...")
Uploads
Upload a file with an optional logical name and metadata:
uploaded = client.upload(
"data/dataset.parquet",
name="datasets/dataset.parquet",
metadata={"source": "example"},
)
Directories are uploaded concurrently:
result = client.upload("data/datasets")
for uploaded in result.completed:
print(uploaded.path, uploaded.artifact_id)
for failure in result.failures:
print(failure.path, failure.error)
Interrupted uploads are resumable. Retrying the same file continues the existing transfer rather than creating a duplicate.
Downloads
Download the latest version by logical name:
client.download("datasets/dataset.parquet", "downloads/dataset.parquet")
Or retrieve an exact immutable version:
client.download(uploaded.artifact_id, "downloads/dataset.parquet")
The SDK verifies the downloaded size and SHA-256 checksum before replacing the destination file.
Configuration
| Environment variable | Purpose | Default |
|---|---|---|
VALGO_API_KEY |
Customer API credential | Required |
VALGO_BASE_URL |
Valgo API endpoint | https://api.valgo.ai |
Constructor arguments override environment variables:
client = Valgo(
api_key="valgo_live_...",
base_url="https://api.valgo.ai",
timeout=60,
max_workers=8,
)
Development
From this repository:
python -m pip install -e .
pytest
Do not commit API keys, presigned URLs, or customer data. Report security issues privately to the Valgo team rather than opening a public issue.
License
Licensed under the Apache License 2.0.
Copyright © 2026 Valgorithmic, Inc. (d.b.a. Valgo).
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file valgo-0.1.0.tar.gz.
File metadata
- Download URL: valgo-0.1.0.tar.gz
- Upload date:
- Size: 12.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c54a79db12ee7ef6b5b64a74a76eedff6c077d6ab99c828cf4030b4cc59cd691
|
|
| MD5 |
73635d6482655b1667e8b9afb1f3eb2d
|
|
| BLAKE2b-256 |
f43a0e943d3c2a26961341ee0bbb7218ab652ebc2d0c3f3c4fd6a53e014682eb
|
Provenance
The following attestation bundles were made for valgo-0.1.0.tar.gz:
Publisher:
publish.yml on valgorithmic/valgo
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
valgo-0.1.0.tar.gz -
Subject digest:
c54a79db12ee7ef6b5b64a74a76eedff6c077d6ab99c828cf4030b4cc59cd691 - Sigstore transparency entry: 2669148483
- Sigstore integration time:
-
Permalink:
valgorithmic/valgo@c885620fa7bfb08a5bf92f1abbf75fa125f8c512 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/valgorithmic
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c885620fa7bfb08a5bf92f1abbf75fa125f8c512 -
Trigger Event:
release
-
Statement type:
File details
Details for the file valgo-0.1.0-py3-none-any.whl.
File metadata
- Download URL: valgo-0.1.0-py3-none-any.whl
- Upload date:
- Size: 15.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
66b1688c5b1e814a89b72d19c0bc47cfa4f3e6e4fb401c4415ad4494d6055957
|
|
| MD5 |
9cc619509ba9be49fb9efbf8ae49942c
|
|
| BLAKE2b-256 |
8a27980d50068a4636f239da619606de2c8bb617fad03d7339ccbc0d4700b975
|
Provenance
The following attestation bundles were made for valgo-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on valgorithmic/valgo
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
valgo-0.1.0-py3-none-any.whl -
Subject digest:
66b1688c5b1e814a89b72d19c0bc47cfa4f3e6e4fb401c4415ad4494d6055957 - Sigstore transparency entry: 2669148563
- Sigstore integration time:
-
Permalink:
valgorithmic/valgo@c885620fa7bfb08a5bf92f1abbf75fa125f8c512 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/valgorithmic
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c885620fa7bfb08a5bf92f1abbf75fa125f8c512 -
Trigger Event:
release
-
Statement type:
