ART — A Real-Time Time-Series Analysis toolkit + MCP server

art-tseries (ART) builds univariate time series models following the Box-Jenkins-Treadway methodology: an iterative, decision-driven process that uses graphical tools and formal tests to identify, estimate, diagnose and refine a model until it is adequate and parsimonious.

ART is the orchestration layer of a four-part suite:

Package	Role
fue	Exact maximum-likelihood estimation (ARMAX + transfer functions) and FUF forecasting. C engine with a pure-Python fallback.
pyfug	High-definition graphics for time series analysis.
ART (`art-tseries`)	Identification, model building, diagnosis, formal tests, versioning — and an MCP server that exposes all of this to an LLM.

The Box-Jenkins-Treadway loop needs judgement at each decision node. ART supplies the evidence (graphs, tests, numbers); a human analyst and/or Claude supply the criterion. Two modes:

Guided — analyst + Claude: Claude proposes with arguments, the analyst decides.
Autonomous — Claude/heuristic decides every step and presents a final model.

Install

pip install art-tseries          # pulls fue + pyfug automatically

This installs the art-mcp command (the MCP server).

Use as an MCP server (Claude Code, etc.)

claude mcp add art -- art-mcp

Then ask Claude to analyse a series. ART will ask whether you want a guided or autonomous analysis and drive the workflow from there.

Use as a library

import fue
from art.describe import describe_boxcox, describe_identification, model_equation

ts, _ = fue.inp.load("series.inp")
print(describe_boxcox(ts).summary)

Methodology

The model-building process is iterative and sequential: each estimation starts from the previous likelihood optimum (the .pre of the previous model), and every step produces a .pre (estimated parameters as initial values) and a .out (results), mirroring fue. Decisions and changes are recorded in a guion.json audit trail. See docs/ARCHITECTURE.md for the full design and the evidence-vs-criterion philosophy.

Documentation

PyPI renders this page only, so everything below is linked absolutely and also ships inside the source distribution — pip download art-tseries --no-binary :all: — so it reads without network.


Quickstart	install, first analysis, EN / ES
MCP tool reference	every `art-mcp` tool, generated from the docstrings
Architecture	how ART, FUE, FUG and FUF fit together
Rescaling	why the scale factor exists and where it acts
Changelog	what changed, version by version

The suite as a whole installs with pip install atsw.

License

GPL-2.0-or-later. © David E. Guerrero.

Download files

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

Source Distribution

art_tseries-0.1.11.tar.gz (313.6 kB view details)

Uploaded Aug 13, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

art_tseries-0.1.11-py3-none-any.whl (182.8 kB view details)

Uploaded Aug 13, 2026 Python 3

File details

Details for the file art_tseries-0.1.11.tar.gz.

File metadata

Download URL: art_tseries-0.1.11.tar.gz
Upload date: Aug 13, 2026
Size: 313.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for art_tseries-0.1.11.tar.gz
Algorithm	Hash digest
SHA256	`97ae196bc9c1cb829ca9cbfe273066f4991216c4f3af55b2ef51d69c2c2d4ca9`
MD5	`0daf95aa8aec21b4e2056771f151bc40`
BLAKE2b-256	`9f8c8d9792972733d5571b3983b3c439fcabca46a29a5bc283e3d1919562d654`

See more details on using hashes here.

Provenance

The following attestation bundles were made for art_tseries-0.1.11.tar.gz:

Publisher: publish-art.yml on davidesg/art-python

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: art_tseries-0.1.11.tar.gz
- Subject digest: 97ae196bc9c1cb829ca9cbfe273066f4991216c4f3af55b2ef51d69c2c2d4ca9
- Sigstore transparency entry: 2455435773
- Sigstore integration time: Aug 13, 2026
Source repository:
- Permalink: davidesg/art-python@6937299667c8cf99951aaaa9d4044bb1c9703e5d
- Branch / Tag: refs/tags/art-v0.1.11
- Owner: https://github.com/davidesg
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-art.yml@6937299667c8cf99951aaaa9d4044bb1c9703e5d
- Trigger Event: push