Metadata-Version: 2.4
Name: art-tseries
Version: 0.1.8
Summary: ART — A Real-Time Time-Series Analysis toolkit (Box-Jenkins-Treadway methodology) + MCP server (uses fue and pyfug)
Author-email: "David E. Guerrero" <davidesg@ucm.es>
License: GPL-2.0-or-later
Project-URL: Homepage, https://github.com/davidesg/art-python
Project-URL: Documentation, https://github.com/davidesg/art-python/tree/master/docs
Project-URL: Repository, https://github.com/davidesg/art-python
Project-URL: Issues, https://github.com/davidesg/art-python/issues
Project-URL: Changelog, https://github.com/davidesg/art-python/blob/master/CHANGELOG.md
Keywords: time series,real-time,ARIMA,Box-Jenkins,Treadway,MCP,forecasting
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fue>=0.1.9
Requires-Dist: pyfug>=2.0
Requires-Dist: numpy>=1.24
Requires-Dist: matplotlib>=3.7
Requires-Dist: scipy>=1.10
Requires-Dist: statsmodels>=0.14
Requires-Dist: mcp<2,>=1.0
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"

# 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](https://pypi.org/project/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

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

```bash
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

```python
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`](https://github.com/davidesg/art-python/blob/master/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](https://github.com/davidesg/art-python/blob/master/docs/QUICKSTART.md) | install, first analysis, EN / ES |
| [MCP tool reference](https://github.com/davidesg/art-python/blob/master/docs/TOOLS.md) | every `art-mcp` tool, generated from the docstrings |
| [Architecture](https://github.com/davidesg/art-python/blob/master/docs/ARCHITECTURE.md) | how ART, FUE, FUG and FUF fit together |
| [Rescaling](https://github.com/davidesg/art-python/blob/master/docs/RESCALING_ARCHITECTURE.md) | why the scale factor exists and where it acts |
| [Changelog](https://github.com/davidesg/art-python/blob/master/CHANGELOG.md) | what changed, version by version |

The suite as a whole installs with `pip install atsw`.

## License

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