explaingit

fathom-lab/styxx

Analysis updated 2026-05-18

5PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A Python library that watches AI agents while they run and flags reasoning faults like hallucination, drift, and sycophancy.

Mindmap

mindmap
  root((styxx))
    What it does
      Profiles LLM reasoning
      Detects fault categories
      Self-healing reflex
    Tech stack
      Python
      MCP server
      pip
    Use cases
      Hallucination detection
      Tool-call drift detection
      Auto self-correction
    Audience
      Developers
      AI safety engineers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add cognitive observability to an existing LLM agent with a single decorator.

USE CASE 2

Detect hallucination, tool-call drift, or sycophancy using standalone CPU-only detectors.

USE CASE 3

Let a model automatically audit and rewrite its own flawed output via the self-healing reflex.

What is it built with?

PythonMCPpip

How does it compare?

fathom-lab/styxx1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedeveloperops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Installs via pip, optional extras needed for MCP server and NLI-based deception detection.

In plain English

styxx is a Python library for monitoring the reliability of AI language model agents. Existing tools can tell you when an agent's execution trace broke, but not why. styxx adds cognitive observability, a set of measurements that characterize how a model is reasoning, so problems can be detected and categorized. The main entry point is a @styxx.profile decorator you add to any function that calls a language model. When the decorated function runs, styxx measures outputs step by step and flags fault categories such as drift (when the model's direction shifts mid-task), confabulation (invented facts), refusal, sycophancy (agreeing too readily with the user), and incoherence. Results can be exported as a self-contained HTML flamegraph or forwarded to external monitoring services. Beyond the runtime profiler, styxx includes nine standalone cognometric instruments, dedicated text-only detectors, each targeting a specific failure mode such as hallucination detection or tool-call drift. These run on plain Python using CPU alone with no language model required, and achieve published accuracy benchmarks on standard evaluation datasets. A feature called the self-healing reflex (F10) lets a model audit its own output and rewrite it when a fault is detected. An MCP server ships inside the library, exposing twelve cognometric tools over a standard interface compatible with Claude Desktop, Claude Code, Cursor, and Cline. The library installs via pip and requires no fine-tuning or retraining of any underlying model. It is pure Python, MIT-licensed. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Show me how to add the @styxx.profile decorator to my existing LLM agent function.
Prompt 2
Explain what fault categories styxx's runtime profiler detects and what they mean.
Prompt 3
Help me set up styxx's MCP server so Claude Code can use its cognometric tools.
Prompt 4
Walk me through using styxx's self-healing reflex to auto-correct a model's output.

Frequently asked questions

What is styxx?

A Python library that watches AI agents while they run and flags reasoning faults like hallucination, drift, and sycophancy.

What language is styxx written in?

Mainly Python. The stack also includes Python, MCP, pip.

How hard is styxx to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is styxx for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.