Python SDK client for Nixtla's TimeGPT, a hosted pre-trained foundation model for time series forecasting and anomaly detection.
yzhao062/pyod
A Python library for anomaly detection across tabular, time series, graph, text, image and audio data, with 60+ detectors and a classic fit/predict API.
- Stars
- 10,052
- Forks
- 1,516
- Open issues
- 223
- Last commit
- 11 days ago
What is it?
PyOD is a Python library for outlier and anomaly detection. It provides a large set of detection algorithms, from classic methods such as Isolation Forest, LOF and kNN to neural approaches such as autoencoders, VAE and DeepSVDD, all behind a consistent fit/decision_function/predict interface. Detectors are grouped by data modality, covering tabular data, time series, graph data and, through foundation-model embeddings, text, images and audio.
Beyond the classic API, version 3 adds ADEngine, an orchestration layer that profiles data, plans and builds a detector, runs detection and explains the findings. It also ships an od-expert skill for Claude Code and Codex, and an MCP server that exposes ten stateless tools for MCP-compatible LLM agents. The classic fit/predict workflow remains available for users who already know which detector they need.
The project includes utilities for synthetic data generation, evaluation metrics such as Precision@n, score combination methods for ensembles, and model saving with joblib or pickle. It is installable via pip and conda-forge.
Key features
- 01Over 60 detectors spanning probabilistic, proximity, linear, ensemble and neural methods.
- 02Covers tabular, time series, graph, text, image and audio data under one API.
- 03ADEngine automates data profiling, detector selection, detection and result explanation.
- 04An MCP server and od-expert skill let AI agents drive detection workflows.
- 05Includes synthetic data generators and evaluation helpers such as Precision@n.
Use cases
- Flagging fraudulent transactions or unusual records in tabular business data.
- Detecting abnormal patterns in sensor, telemetry or time series streams.
- Finding anomalous nodes in graph data such as transaction or social networks.
- Screening text, image or audio collections for outliers using foundation model embeddings.
Quick start
- 1
Install the core library from PyPI
pip install pyod - 2
Fit a detector and read anomaly scores
Things to know
- The README's headline features (agentic skill, MCP server) are new in PyOD 3 and the stateful investigate/iterate tools are deferred.
Topics
FAQ
- What is pyod?
- A Python library for anomaly detection across tabular, time series, graph, text, image and audio data, with 60+ detectors and a classic fit/predict API. PyOD is a Python library for outlier and anomaly detection. It provides a large set of detection algorithms, from classic methods such as Isolation Forest, LOF and kNN to neural approaches such as autoencoders, VAE and DeepSVDD, all behind a consistent fit/decision_function/predict interface. Detectors are grouped by data modality, covering tabular data, time series, graph data and, through foundation-model embeddings, text, images and audio.
- Is pyod free to use? What license does it have?
- pyod is open source under the BSD-2-Clause license. Check the license terms before using it in commercial products.
- Is pyod still maintained?
- Actively maintained. The last commit to pyod was on Oct 12, 2026.
- What can I use pyod for?
- Flagging fraudulent transactions or unusual records in tabular business data. Detecting abnormal patterns in sensor, telemetry or time series streams. Finding anomalous nodes in graph data such as transaction or social networks. Screening text, image or audio collections for outliers using foundation model embeddings.
- How do I install pyod?
- Install the core library from PyPI: pip install pyod Fit a detector and read anomaly scores
- Where can I get pyod?
- The source code and installation instructions are on GitHub: https://github.com/yzhao062/pyod
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
An LLM agent framework from Microsoft that automates data-driven R&D tasks such as reading papers, implementing models and factors, and running Kaggle-style experiments.
Open-source real-time infrastructure monitoring agent with per-second metrics, auto-discovery, built-in ML anomaly detection and alerting.
A curated list of open source libraries for deploying, monitoring, versioning, scaling and securing production machine learning.
AutoML library that trains and ensembles ML models for tabular, time series, and multimodal data with a few lines of Python.
Python machine learning library built on SciPy and NumPy, offering classification, regression, clustering, and model selection tools under a BSD license.