V0.1.0 PUBLIC BETA

The Surprising
Fact is Observed.

A Logic Harness for abductive inference.
Anomaly in → Hypothesis out.

GET STARTED VIEW ON GITHUB
THE PROCESS

Observe. Hypothesize. Evaluate.

OBSERVE

Register the surprising fact (C).

→
HYPO-

Generate candidate explanations (A).

→
EVAL-

Inference to best explanation.

"The surprising fact, C, is observed.
But if A were true, C would be a matter of course.
Hence, there is reason to suspect that A is true."
— Charles Sanders Peirce, Collected Papers 5.189
THE TOOLS

Three Phases. Five Critics.

PHASE 1

observe_anomaly

Register the surprising fact. Analyze what makes it surprising and why it violates expectations.

→ anomaly JSON
PHASE 2

generate_hypotheses

Generate diverse, testable explanations. Each hypothesis must make C "a matter of course."

→ hypotheses JSON
PHASE 3

evaluate_via_ibe

Select the best explanation using IBE criteria: explanatory power, parsimony, testability.

→ evaluation JSON
THE COUNCIL

Five Critics. One Verdict.

E

Empiricist

Evidence & testability

L

Logician

Consistency & parsimony

P

Pragmatist

Actionability

$

Economist

Cost-benefit

?

Skeptic

Falsification

QUICKSTART

Up and Running in 60 Seconds.

01

Install

pip install peircean-abduction
02

Configure MCP

# Claude Code
claude mcp add peircean -- python -m peircean.mcp.server

# Claude Desktop
peircean-setup-mcp --write
03

Use It

"Use Peircean abduction to analyze why our
database queries are suddenly 3x slower
despite no code changes"
DOCUMENTATION

Learn More.

README → MCP Integration Guide → Quick Start → User Guide →