anomx 0.2.0__tar.gz

anomx-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+      - name: Lint
+        run: ruff check .
+      - name: Type check
+        run: mypy src/anomx
+      - name: Test
+        run: pytest --cov

anomx-0.2.0/.gitignore

@@ -0,0 +1,29 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+build/
+dist/
+
+# Environments
+.env
+.venv/
+venv/
+
+# Editors and OS files
+.DS_Store
+.idea/
+.vscode/
+
+# Data and artifacts
+/data/
+/artifacts/
+/models/
+*.parquet
+*.pkl
+*.joblib

anomx-0.2.0/.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.5.7
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

anomx-0.2.0/AGENTS.md

@@ -0,0 +1,48 @@
+# AGENTS.md
+
+This repository contains the open-source Python package that backs Anomx, a
+data intelligence platform for time series, forecasting, anomaly detection, and
+human-in-the-loop operational workflows.
+
+## Project Intent
+
+The package should stay focused on reusable library primitives:
+
+- `datasets`: time series containers, dataset loaders, splits, transforms, and metadata.
+- `scorers`: functions and classes that turn observations, residuals, forecasts, or model
+  outputs into anomaly scores.
+- `detectors`: online and batch anomaly detectors that produce actionable anomaly labels
+  and detection results.
+- `models`: forecasting, representation, and predictive models.
+- `integrations`: optional adapters for third-party ecosystems such as Darts.
+
+The platform itself owns orchestration, persistence, workers, user feedback loops,
+audit trails, and product-specific APIs. This library should expose the clean core
+that the platform can compose.
+
+## Engineering Guidelines
+
+- Prefer small, typed, composable abstractions over platform-specific coupling.
+- Keep the default install lightweight. Put heavy ML dependencies behind extras such as
+  `anomx[darts]`.
+- Treat batch and online use cases as first-class design constraints.
+- Favor interpretable outputs: anomaly scores, thresholds, labels, timestamps, and
+  metadata should be easy to inspect.
+- Match the existing public API style before adding new patterns.
+- Add or update tests for behavior changes.
+
+## Local Commands
+
+```bash
+python -m pip install -e ".[dev]"
+pytest
+ruff check .
+mypy src/anomx
+python -m pip install -e ".[release]"
+python -m build
+```
+
+## Compatibility
+
+The package targets Python 3.10+ and uses a `src/` layout. Public APIs should be
+documented in docstrings and exported deliberately through package `__init__.py` files.

anomx-0.2.0/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0
+
+- Initial package scaffold for datasets, scorers, detectors, models, and optional Darts integration.

anomx-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing
+
+Anomx is early-stage. Contributions should make the core library easier to compose,
+test, or integrate into production time-series workflows.
+
+## Development Setup
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+## Checks
+
+Run the core checks before opening a pull request:
+
+```bash
+pytest
+ruff check .
+mypy src/anomx
+```
+
+Install the release tooling only when building or publishing distributions:
+
+```bash
+python -m pip install -e ".[release]"
+python -m build
+twine check dist/*
+```
+
+## Design Principles
+
+- Keep the core package platform-agnostic.
+- Put optional integrations behind optional dependencies.
+- Use typed dataclasses or protocols for shared contracts.
+- Make anomaly outputs inspectable and auditable.
+- Prefer clear algorithms and adapters before deep framework coupling.

anomx-0.2.0/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 Anomx
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

anomx-0.2.0/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.4
+Name: anomx
+Version: 0.2.0
+Summary: Installable time-series anomaly library with forecasting, reconstruction, and representation base approaches.
+Project-URL: Homepage, https://www.anomx.io
+Project-URL: Repository, https://github.com/theorieken/anomx
+Project-URL: Issues, https://github.com/theorieken/anomx/issues
+Author: Theo Rieken
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: anomaly-detection,data-intelligence,forecasting,machine-learning,observability,time-series
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: scikit-learn>=1.3
+Provides-Extra: darts
+Requires-Dist: u8darts[all]>=0.30; extra == 'darts'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pandas-stubs>=2.2; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
+Requires-Dist: mkdocs>=1.6; extra == 'docs'
+Provides-Extra: platform
+Requires-Dist: fsspec>=2024.6; extra == 'platform'
+Requires-Dist: pyarrow>=16.0; extra == 'platform'
+Requires-Dist: redis>=5.0; extra == 'platform'
+Provides-Extra: release
+Requires-Dist: build>=1.2; extra == 'release'
+Requires-Dist: docutils<0.22,>=0.21.2; extra == 'release'
+Requires-Dist: twine<7.0,>=6.2; extra == 'release'
+Description-Content-Type: text/markdown
+
+# anomx
+
+`anomx` is the core Python library for the Anomx platform: time-series datasets,
+forecasting models, anomaly scorers, and anomaly detectors built for interpretable,
+production-oriented workflows.
+
+Anomx is a data intelligence platform focused on anomaly detection and predictive
+insights in complex, data-driven systems. The platform handles orchestration,
+workers, storage, connectors, audit trails, and human-in-the-loop feedback. This
+repository contains the reusable modeling layer that those systems compose.
+
+## Goals
+
+- Provide clean primitives for time-series datasets, scorers, detectors, and models.
+- Support both batch and online anomaly detection workflows.
+- Keep outputs interpretable: scores, thresholds, timestamps, labels, and metadata.
+- Stay modular enough to power the Anomx platform without coupling the library to
+  the platform's storage or orchestration layer.
+- Integrate with the broader time-series ecosystem, especially Darts, through
+  optional adapters.
+
+## Installation
+
+The package is structured for PyPI distribution:
+
+```bash
+pip install anomx
+```
+
+For local development:
+
+```bash
+git clone https://github.com/anomx/anomx.git
+cd anomx
+python -m pip install -e ".[dev]"
+```
+
+Optional extras:
+
+```bash
+pip install "anomx[darts]"     # Darts forecasting model adapters
+pip install "anomx[docs]"      # Documentation tooling
+pip install "anomx[platform]"  # Platform-facing IO dependencies
+pip install "anomx[release]"   # Build and PyPI publishing tooling
+```
+
+## Package Layout
+
+```text
+src/anomx/
+  datasets/      TimeSeriesDataset, metadata, dataset loaders, transforms
+  scorers/       Anomaly score contracts and scoring implementations
+  detectors/     Batch and online anomaly detector contracts and implementations
+  models/        Forecasting model contracts and baseline forecasters
+  integrations/  Optional adapters, including Darts
+```
+
+## Quick Start
+
+```python
+from anomx.datasets import make_sine_anomaly_dataset
+from anomx.detectors import MovingAverageDetector
+from anomx.models import NaiveSeasonalModel
+
+dataset = make_sine_anomaly_dataset()
+
+detector = MovingAverageDetector(window=24, threshold=3.0)
+result = detector.fit_predict(dataset)
+print(result.to_dataframe().tail())
+
+model = NaiveSeasonalModel(season_length=24).fit(dataset)
+forecast = model.predict(12)
+print(forecast.to_dataframe())
+```
+
+## Darts Integration
+
+The default install stays lightweight. To use Darts models, install the optional
+extra and wrap any compatible Darts forecasting model:
+
+```python
+from darts.models import ExponentialSmoothing
+
+from anomx.datasets import make_sine_anomaly_dataset
+from anomx.integrations import DartsForecastingModel
+
+dataset = make_sine_anomaly_dataset()
+model = DartsForecastingModel(ExponentialSmoothing())
+forecast = model.fit(dataset).predict(24)
+```
+
+The intent is to let Anomx expose Darts-backed forecasting and anomaly workflows
+without making Darts a required dependency for every user.
+
+## Development
+
+```bash
+python -m pip install -e ".[dev]"
+pytest
+ruff check .
+mypy src/anomx
+python -m pip install -e ".[release]"
+python -m build
+```
+
+## Platform Context
+
+Anomx prioritizes:
+
+- Signal over noise: surface only relevant insights.
+- Clarity over complexity: outputs should be interpretable.
+- Actionability: every insight should support a decision.
+
+The platform is designed around modular pipelines, real-time and batch workers,
+heterogeneous data sources, and versioned entities such as datasets, datasources,
+channels, jobs, runs, findings, and model artifacts. This library is the focused
+modeling and time-series package used by that larger system.
+
+## Status
+
+This repository is in pre-alpha scaffold stage. The public API should be treated
+as provisional until the first stable release.

anomx-0.2.0/README.md

@@ -0,0 +1,122 @@
+# anomx
+
+`anomx` is the core Python library for the Anomx platform: time-series datasets,
+forecasting models, anomaly scorers, and anomaly detectors built for interpretable,
+production-oriented workflows.
+
+Anomx is a data intelligence platform focused on anomaly detection and predictive
+insights in complex, data-driven systems. The platform handles orchestration,
+workers, storage, connectors, audit trails, and human-in-the-loop feedback. This
+repository contains the reusable modeling layer that those systems compose.
+
+## Goals
+
+- Provide clean primitives for time-series datasets, scorers, detectors, and models.
+- Support both batch and online anomaly detection workflows.
+- Keep outputs interpretable: scores, thresholds, timestamps, labels, and metadata.
+- Stay modular enough to power the Anomx platform without coupling the library to
+  the platform's storage or orchestration layer.
+- Integrate with the broader time-series ecosystem, especially Darts, through
+  optional adapters.
+
+## Installation
+
+The package is structured for PyPI distribution:
+
+```bash
+pip install anomx
+```
+
+For local development:
+
+```bash
+git clone https://github.com/anomx/anomx.git
+cd anomx
+python -m pip install -e ".[dev]"
+```
+
+Optional extras:
+
+```bash
+pip install "anomx[darts]"     # Darts forecasting model adapters
+pip install "anomx[docs]"      # Documentation tooling
+pip install "anomx[platform]"  # Platform-facing IO dependencies
+pip install "anomx[release]"   # Build and PyPI publishing tooling
+```
+
+## Package Layout
+
+```text
+src/anomx/
+  datasets/      TimeSeriesDataset, metadata, dataset loaders, transforms
+  scorers/       Anomaly score contracts and scoring implementations
+  detectors/     Batch and online anomaly detector contracts and implementations
+  models/        Forecasting model contracts and baseline forecasters
+  integrations/  Optional adapters, including Darts
+```
+
+## Quick Start
+
+```python
+from anomx.datasets import make_sine_anomaly_dataset
+from anomx.detectors import MovingAverageDetector
+from anomx.models import NaiveSeasonalModel
+
+dataset = make_sine_anomaly_dataset()
+
+detector = MovingAverageDetector(window=24, threshold=3.0)
+result = detector.fit_predict(dataset)
+print(result.to_dataframe().tail())
+
+model = NaiveSeasonalModel(season_length=24).fit(dataset)
+forecast = model.predict(12)
+print(forecast.to_dataframe())
+```
+
+## Darts Integration
+
+The default install stays lightweight. To use Darts models, install the optional
+extra and wrap any compatible Darts forecasting model:
+
+```python
+from darts.models import ExponentialSmoothing
+
+from anomx.datasets import make_sine_anomaly_dataset
+from anomx.integrations import DartsForecastingModel
+
+dataset = make_sine_anomaly_dataset()
+model = DartsForecastingModel(ExponentialSmoothing())
+forecast = model.fit(dataset).predict(24)
+```
+
+The intent is to let Anomx expose Darts-backed forecasting and anomaly workflows
+without making Darts a required dependency for every user.
+
+## Development
+
+```bash
+python -m pip install -e ".[dev]"
+pytest
+ruff check .
+mypy src/anomx
+python -m pip install -e ".[release]"
+python -m build
+```
+
+## Platform Context
+
+Anomx prioritizes:
+
+- Signal over noise: surface only relevant insights.
+- Clarity over complexity: outputs should be interpretable.
+- Actionability: every insight should support a decision.
+
+The platform is designed around modular pipelines, real-time and batch workers,
+heterogeneous data sources, and versioned entities such as datasets, datasources,
+channels, jobs, runs, findings, and model artifacts. This library is the focused
+modeling and time-series package used by that larger system.
+
+## Status
+
+This repository is in pre-alpha scaffold stage. The public API should be treated
+as provisional until the first stable release.

anomx-0.2.0/docs/api.md

@@ -0,0 +1,30 @@
+# API Outline
+
+## Datasets
+
+- `anomx.datasets.TimeSeriesDataset`
+- `anomx.datasets.ChannelMetadata`
+- `anomx.datasets.make_sine_anomaly_dataset`
+
+## Scorers
+
+- `anomx.scorers.AnomalyScorer`
+- `anomx.scorers.ZScoreScorer`
+- `anomx.scorers.ThresholdScorer`
+
+## Detectors
+
+- `anomx.detectors.AnomalyDetector`
+- `anomx.detectors.DetectionResult`
+- `anomx.detectors.MovingAverageDetector`
+
+## Models
+
+- `anomx.models.ForecastingModel`
+- `anomx.models.Forecast`
+- `anomx.models.NaiveSeasonalModel`
+
+## Integrations
+
+- `anomx.integrations.DartsForecastingModel`
+- `anomx.integrations.is_darts_available`

anomx-0.2.0/docs/index.md

@@ -0,0 +1,15 @@
+# Anomx
+
+Anomx is a Python library for time-series datasets, forecasting models, anomaly
+scorers, and anomaly detectors.
+
+The library is designed to be the modeling core for the Anomx platform while
+remaining useful as a standalone package.
+
+## Main Concepts
+
+- `TimeSeriesDataset`: a typed wrapper around timestamp-indexed data and metadata.
+- `AnomalyScorer`: converts observations or residuals into anomaly scores.
+- `AnomalyDetector`: converts datasets into scores and anomaly labels.
+- `ForecastingModel`: produces future values for a time horizon.
+- `DartsForecastingModel`: optional adapter for Darts models.

anomx-0.2.0/examples/baseline_detection.py

@@ -0,0 +1,15 @@
+"""Run a baseline anomaly detector on a synthetic dataset."""
+
+from anomx.datasets import make_sine_anomaly_dataset
+from anomx.detectors import MovingAverageDetector
+
+
+def main() -> None:
+    dataset = make_sine_anomaly_dataset()
+    detector = MovingAverageDetector(window=24, threshold=3.0)
+    result = detector.fit_predict(dataset)
+    print(result.to_dataframe().query("is_anomaly").head())
+
+
+if __name__ == "__main__":
+    main()

anomx-0.2.0/examples/naive_forecast.py

@@ -0,0 +1,15 @@
+"""Fit a naive seasonal forecast model."""
+
+from anomx.datasets import make_sine_anomaly_dataset
+from anomx.models import NaiveSeasonalModel
+
+
+def main() -> None:
+    dataset = make_sine_anomaly_dataset()
+    model = NaiveSeasonalModel(season_length=24).fit(dataset)
+    forecast = model.predict(12)
+    print(forecast.to_dataframe())
+
+
+if __name__ == "__main__":
+    main()

anomx-0.2.0/mkdocs.yml

@@ -0,0 +1,8 @@
+site_name: Anomx
+site_description: Time-series forecasting and anomaly detection primitives for Anomx.
+repo_url: https://github.com/anomx/anomx
+theme:
+  name: material
+nav:
+  - Home: index.md
+  - API Outline: api.md

anomx-0.2.0/pyproject.toml

@@ -0,0 +1,118 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "anomx"
+version = "0.2.0"
+description = "Installable time-series anomaly library with forecasting, reconstruction, and representation base approaches."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "Apache-2.0"
+authors = [
+  { name = "Theo Rieken" }
+]
+keywords = [
+  "anomaly-detection",
+  "forecasting",
+  "time-series",
+  "machine-learning",
+  "observability",
+  "data-intelligence"
+]
+classifiers = [
+  "Development Status :: 2 - Pre-Alpha",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Science/Research",
+  "License :: OSI Approved :: Apache Software License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+  "Topic :: Scientific/Engineering :: Information Analysis",
+  "Typing :: Typed"
+]
+dependencies = [
+  "numpy>=1.24",
+  "pandas>=2.0",
+  "scikit-learn>=1.3"
+]
+
+[project.optional-dependencies]
+darts = [
+  "u8darts[all]>=0.30"
+]
+dev = [
+  "mypy>=1.10",
+  "pandas-stubs>=2.2",
+  "pytest>=8.0",
+  "pytest-cov>=5.0",
+  "ruff>=0.5"
+]
+release = [
+  "build>=1.2",
+  "docutils>=0.21.2,<0.22",
+  "twine>=6.2,<7.0"
+]
+docs = [
+  "mkdocs>=1.6",
+  "mkdocs-material>=9.5"
+]
+platform = [
+  "fsspec>=2024.6",
+  "pyarrow>=16.0",
+  "redis>=5.0"
+]
+
+[project.urls]
+Homepage = "https://www.anomx.io"
+Repository = "https://github.com/theorieken/anomx"
+Issues = "https://github.com/theorieken/anomx/issues"
+
+[project.scripts]
+anomx = "anomx.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/anomx"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"src/anomx/py.typed" = "anomx/py.typed"
+
+[tool.pytest.ini_options]
+addopts = "-ra"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+  "E",
+  "F",
+  "I",
+  "UP",
+  "B",
+  "SIM",
+  "ANN"
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["ANN"]
+
+[tool.mypy]
+python_version = "3.11"
+files = ["src/anomx"]
+strict = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+
+[tool.coverage.run]
+branch = true
+source = ["anomx"]
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true