Repolode
yzhao062

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. 1

    Install the core library from PyPI

    pip install pyod
  2. 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