Valgo API

CI PyPI

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.

Deletion

Delete one exact artifact version using the ID returned by an upload:

result = client.delete(uploaded.artifact_id)
print(result.status)

Deleting by logical name requires explicit confirmation that every version should be removed:

client.delete("datasets/dataset.parquet", all_versions=True)

The API key must include the data:delete scope. Files uploaded through Valgo are removed from object storage. Customer-owned objects added with attach() are detached from Valgo by default; pass delete_source=True only when the source S3 object should also be removed. S3 versioning or Object Lock may retain historical versions according to the customer's AWS policy.

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).

Project links

Data verified by PyPI on Aug 31, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.3.1)

Owner

PyPI data
Data sourced directly from PyPI's database.

Credits

Author: Valgorithmic, Inc. (d.b.a. Valgo)

GitHub Statistics

Data verified by PyPI on Aug 31, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache License

Requires

Python >=3.11

Report project as malware

Download files

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

Source Distribution

valgo-0.2.0.tar.gz (13.0 kB view details)

Uploaded Source

Built Distribution

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

valgo-0.2.0-py3-none-any.whl (15.6 kB view details)

Uploaded Python 3

File details

Details for the file valgo-0.2.0.tar.gz.

File metadata

  • Download URL: valgo-0.2.0.tar.gz
  • Upload date:
  • Size: 13.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for valgo-0.2.0.tar.gz
Algorithm Hash digest
SHA256 6809c4d2635d8ed70bee69c598e07371843d91ec2360200c1e260e9341ea1765
MD5 6dfff505bdc861d9af5162142bbdaea5
BLAKE2b-256 f5fbc28744b83335aab0d41d5f38cf7b512078d91040f19fb28f4f7d55a321b6

See more details on using hashes here.

Provenance

The following attestation bundles were made for valgo-0.2.0.tar.gz:

Publisher: publish.yml on valgorithmic/valgo

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

File details

Details for the file valgo-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: valgo-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 15.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for valgo-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7aaa63b1fa475b98499fbdf0317cbcecca7c04755d0e59da13522b59c4125c47
MD5 b2c1fa5b9b9916567022c4ff3c1b626c
BLAKE2b-256 8c6abdd698249ead4e7be186e742e7dc28bfb01f12be54c2e95d156ee470d839

See more details on using hashes here.

Provenance

The following attestation bundles were made for valgo-0.2.0-py3-none-any.whl:

Publisher: publish.yml on valgorithmic/valgo

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

Release history Release notifications | RSS feed

0.3.1

2 files

0.3.0

2 files

This release

0.2.0 This release

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page