precog-api
Precog REST Execution API: Google TimesFM-3 zero-shot forecasting as a synchronous, typed HTTP service.
This is the Python distribution of the Precog API. Containers and Helm remain the preferred production deployment path; install this package for development, labs and Python-native environments. The distribution contains no model weights.
Install
pip install precog-api # base install: fake engine only, no torch
pip install "precog-api[engine]" # real TimesFM-3 engine (weights download at runtime)
The base install is lightweight and runs the deterministic fake engine, which is enough to exercise the REST contract.
Run
PRECOG_ENGINE=fake precog-api # http://localhost:8000
precog-api # real engine (requires the [engine] extra)
Configuration uses the PRECOG_ prefix (PRECOG_ENGINE, PRECOG_DEVICE,
PRECOG_MAX_*, PRECOG_API_KEY, ...). See the repository documentation.
License
Application code is MIT. The TimesFM-3 model weights are distributed under the TimesFM Non-Commercial License v1.0 and are not part of this distribution.
1 maintainer
Release files for precog-api 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| precog_api-1.0.1.tar.gz | 20.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| precog_api-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 39.1 kB
Release files / precog_api-1.0.1.tar.gz
| Download URL | precog_api-1.0.1.tar.gz |
|---|---|
| Size | 20.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
728cdd395b179dd504641996963b18cb985f188dc70fac6c52250c1adaf6662c
|
|
BLAKE2b-256 checksum How to use checksums |
30d048af1fbd290209b54c31ab8cd582a1b967e5585aeb90940463d3744e97be
|
| 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 20, 2026.
Transparency logRelease files / precog_api-1.0.1-py3-none-any.whl
| Download URL | precog_api-1.0.1-py3-none-any.whl |
|---|---|
| Size | 18.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
afde7ef384773abcf068523796393c2d647ab593fb2fdd78e2d1905f661113ca
|
|
BLAKE2b-256 checksum How to use checksums |
356a19dc65910acb08ac7340a591f37cdb565d5850d358a43ef005080961addb
|
| 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 20, 2026.
Transparency log
