MTF — My Theorist Friend

A multi-agent AI system for experimental physicists. Describe an unexplained phenomenon; MTF searches the literature, fits your data, and delivers a peer-reviewed report — all driven by the Anthropic API.

Getting Started

• Installation
  • pip (recommended)
  • conda
  • API key
  • Optional extras
• Quick Start
  • Browser GUI
  • CLI
  • Python API

Usage

• CLI Reference
  • Flags
  • Examples
• Browser GUI
  • Sidebar controls
  • Workflow
  • Architecture note
• Python API
  • Minimal example
  • With data and images
  • MTFConfig parameters
• Providing Images and PDFs
  • Images (PNG, JPG, GIF, WebP)
  • PDFs
  • CLI
  • Python API
  • Interactive mode
• Providing Data (Toolkit)
  • Registration
  • Interactive supply
  • Image-extracted data

Architecture

• Architecture Overview
  • Pipeline
  • Phase 0: File Digest
  • Phase 1: Literature
  • Phase 2: Fitting
  • Phase 3: Review
  • Phase 4: Follow-up Chat
  • Debate Engine internals
  • Key design decisions
  • File layout
• Agents
  • BaseAgent
  • FileDigestSubagent
  • ImageDigestAgent
  • LiteratureAgent
  • FittingAgent
  • QualitativeEvaluationAgent
  • ReviewerAgent
  • ProposalAgent
  • FollowUpChatAgent
  • ToolBuilderAgent
• Shared Memory
  • Data model
  • MemoryKind values
  • Context injection
  • Accumulation order
  • Thread safety
• GPD Physics Verification
  • GPD servers
  • Physics-first ranking
  • Auto domain classification
  • Convention locking and pre-exec validation
  • Literature plausibility screening
  • Cross-session pattern memory
  • Usage
  • Python API

Reference

• API Reference