This release is a pre-release and may not be stable for production use.
chronocratic-models
Ready-to-use time series models implemented in PyTorch and Lightning.
Note: The PyPI package name uses a hyphen (
chronocratic-models), but the import uses thechronocratic.modelsnamespace.
Installation
pip install chronocratic-models
Quick Start
import torch
from lightning.pytorch import Trainer
from chronocratic.models import TS2Vec, TS2VecModelParameters
# Create model using parameters dataclass
params = TS2VecModelParameters(input_dims=1)
model = TS2Vec(**vars(params))
# Prepare synthetic time series (n_instance, n_timestamps, n_features)
synthetic_data = torch.randn(2, 100, 1)
# Train the model first (models do not ship with pre-trained weights)
trainer = Trainer(max_epochs=1, accelerator="cpu", enable_checkpointing=False)
trainer.fit(model, train_dataloaders=synthetic_data)
# Get multi-scale representations
representations = model.encode(
synthetic_data,
batch_size=2,
num_workers=0,
encoding_window="multiscale",
)
print(representations.shape)
Models
Convolutional (Dilated)
| Model | Description |
|---|---|
| TS2Vec | Multi-scale hierarchical representation learning via dilated convolutions with hierarchical clustering. Code source: zhihanyue/ts2vec |
| CoST | Decomposition-based contrastive self-supervised learning with trend-seasonal decomposition and contrastive objectives. Code source: salesforce/CoST |
| AutoTCL | Automatic temporal contrastive learning with a trainable augmentation module for self-supervised time-series encoding. Code source: AslanDing/AutoTCL |
Convolutional (Standard)
| Model | Description |
|---|---|
| Series2Vec | Self-supervised pretraining via contrastive learning on augmented time-series segments. |
| TSTCC | Temporal and contextual contrastive pretraining for time-series representation learning. |
| MCL | Fully convolutional encoder designed for Mixup Contrastive Learning objectives. |
Transformer
| Model | Description |
|---|---|
| TST | Time Series Transformer with masked-reconstruction-based self-supervised pretraining. |
Recurrent
| Model | Description |
|---|---|
| TimeNet | Recurrent encoder-decoder architecture for time-series representation learning. |
| RecurrentAutoEncoder | Recurrent autoencoder for time-series representation learning. Code source: time-series-foundation-models/time-series-autoencoder |
Generative
| Model | Description |
|---|---|
| TimeVAE | Variational autoencoder for time-series data with latent representation encoding and generation. |
Important: These models are provided as training-ready implementations. No pre-trained weights are included — you must train them on your own data before using them for inference.
Features
- Polymorphic augmentation producer contract — models accept any augmentation through a unified interface, eliminating enum-based branching.
- Lightning integration — all models are built on PyTorch Lightning for clean training loops and extensibility.
- Self-supervised representation learning — train encoders for downstream tasks without labeled data.
- Pre-configured model parameters — each model ships with tested default configuration dataclasses.
- NumPy and PyTorch tensor support — flexible input handling for both frameworks.
Documentation
For full API reference, guides, and examples, visit chronocratic-models.readthedocs.io.
License
This project is licensed under the BSD 3-Clause License — see the LICENSE file for details.
1 maintainer
Metadata
1 maintainer
Release files for chronocratic-models 0.1.0a13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| chronocratic_models-0.1.0a13.tar.gz | 343.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| chronocratic_models-0.1.0a13-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 488.4 kB
Release files / chronocratic_models-0.1.0a13.tar.gz
| Download URL | chronocratic_models-0.1.0a13.tar.gz |
|---|---|
| Size | 343.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
019154957f91cc08cd283fd54158fe9a3ecdb82026e3a0ee05a1048dcbd2f3d7
|
|
BLAKE2b-256 checksum How to use checksums |
23182b918a8e8be4661cb41550b566cdc7c7e46101804f919813edc74f164d66
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jul 10, 2026.
Transparency logRelease files / chronocratic_models-0.1.0a13-py3-none-any.whl
| Download URL | chronocratic_models-0.1.0a13-py3-none-any.whl |
|---|---|
| Size | 144.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3aab982e2ff80819b808007834545e4924c24326eb2ea5ff4e32d6a226f0f76b
|
|
BLAKE2b-256 checksum How to use checksums |
e00e0414085f6473055624445f973cf2bad5321efcc0416fa8e5023bdba0ae7d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jul 10, 2026.
Transparency log
