Skip to main content

TimeNet

Find, build, and load time-series datasets through one shared format.

PyPI Docs License: MIT

Time-series datasets use many incompatible layouts. TimeF gives them one storage format. TimeNet provides one API to find, build, download, and load them.

TimeNet handles the data layer. Model training, inference, and evaluation stay in your chosen framework.

TimeNet Hackathon

TimeNet Online Hackathon

TimeNet Online Hackathon is live. Pick a time-series problem, onboard a dataset in TimeNet format, then train or fine-tune a Temporal AI Model (e.g. OpenTSLM) to explore what it can do. Choose any use case, from forecasting and classification to explanation, reasoning and beyond.

Register here: challenge.timenet.ai

Quick start

TimeNet needs Python 3.11 or newer.

uv add 'timenet[cli]'
uv tool install timenet-connectors
timenet-build build timenet/hello-world

The build lands in the local registry at ~/.timenet/registry/timenet/hello-world/1.0.0/. Load it with Python:

from timenet import TimeNet

dataset = TimeNet().load("timenet/hello-world@1.0.0")
dataset.describe()

signal = dataset.records[0].signals[0]
values = signal.to_numpy()

TimeNet() reads the local registry first, and the local registry holds this exact version. So the example works without registry credentials or network access.

See the Get started guide for installation options and a longer example.

How it fits together

TimeNet architecture diagram

A connector converts a raw source into a TimeF version. The version contains:

  • manifest.json, which identifies the dataset and lists its files
  • control.duckdb, which stores the hierarchy and relationships
  • a Parquet or Zarr values plane, which stores Signal values

A registry stores immutable TimeF versions. The client reads a version without importing its connector.

The repository is a uv workspace with two packages:

Package Purpose
timenet The TimeF model, reader, writer, registries, SDK, and consumer CLI.
timenet-connectors Dataset connectors and the timenet-build producer CLI.

Read the architecture guide for the complete design.

License

TimeNet uses the MIT License.

This license covers the TimeNet code, not the datasets that connectors fetch. Each dataset keeps its upstream license and access terms. Read the dataset licensing guide before redistribution.

Metadata

Release files for timenet 0.12.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for timenet 0.12.0
File Size Uploaded Provenance Actions
timenet-0.12.0.tar.gz 340.0 kB Without provenance Details for timenet-0.12.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for timenet 0.12.0
File Interpreter ABI Platform Actions
timenet-0.12.0-py3-none-any.whl Python 3 none any Details for timenet-0.12.0-py3-none-any.whl

Total release size: 744.6 kB

Release files / timenet-0.12.0.tar.gz

Download URL timenet-0.12.0.tar.gz
Size 340.0 kB
Tags Source
SHA-256 checksum
How to use checksums
d8bd014a13afa0dc0a789af40ba6afc4f347defbfa25ac5b71b7f4552021a02c
BLAKE2b-256 checksum
How to use checksums
42f19a047253373b09001b5170ca6258c85dab736cf2f4d2973d3d4718d2fbf5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / timenet-0.12.0-py3-none-any.whl

Download URL timenet-0.12.0-py3-none-any.whl
Size 404.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b74e27771c64878a90b751fafa6c7a974c698d5067546d8d843a8bf7a6de0931
BLAKE2b-256 checksum
How to use checksums
2ef1617b7991f664a125e604863e205c68c67f0a31e23e0a0120377cf439f89b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for timenet 0.12.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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