fangbot 0.1.0

Clinical reasoning agent powered by OpenMedicine — fangs of the healing serpent

Fangbot

Clinical reasoning agent powered by OpenMedicine — fangs of the healing serpent.

This is NOT a diagnostic tool — it is a research platform for validating LLM-based clinical tool orchestration.

What it does

Fangbot connects to the OpenMedicine MCP server to perform deterministic, auditable clinical calculations via a ReAct (Reasoning + Acting) loop. It supports multiple LLM providers for benchmarking.

Critical constraint: The agent always calls OpenMedicine's MCP tools for clinical calculations — it never computes scores from its own knowledge.

Install

# Recommended: install as a global CLI tool
pipx install fangbot

# Or with uv
uv tool install fangbot

# With OpenAI support
pipx install "fangbot[openai]"

Quick start

# Interactive setup — configure provider, API key, test MCP connection
fangbot init

# Start a clinical reasoning session
fangbot chat

Usage

fangbot init                          # First-time setup wizard
fangbot chat                          # Interactive clinical reasoning session
fangbot run studies/config.yaml       # Batch evaluation (Phase 2)
fangbot report studies/results/       # Generate comparison report (Phase 2)

Chat commands

Inside fangbot chat, use slash commands:

Command	Description
/help	Show all commands
/status	Current provider, model, session info
/claude [model]	Switch to Claude
/openai [model]	Switch to OpenAI
/model [name]	Interactive model picker
/models	List all available models
/clear	Clear conversation history
/history	Show message count and tool calls
/compact	Compress conversation history
quit	End the session

Configuration

Fangbot stores config in ~/.fangbot/:

~/.fangbot/
├── .env          # API keys and settings
└── logs/         # JSONL audit trail

Environment variables (prefix FANGBOT_):

Variable	Default	Description
FANGBOT_PROVIDER	claude	LLM provider (claude, openai)
FANGBOT_MODEL	claude-sonnet-4-20250514	Model to use
ANTHROPIC_API_KEY	—	Anthropic API key
OPENAI_API_KEY	—	OpenAI API key

Supported providers

Provider	Models	Status
Anthropic Claude	Opus 4.6, Sonnet 4.6, Haiku 4.5, Sonnet 4, Opus 4	Supported
OpenAI	GPT-5, GPT-4o, GPT-4.1, o3, o4-mini	Supported
Google Gemini	—	Planned
Ollama (local)	—	Planned

Architecture

Gateway (CLI) → Brain (ReAct loop) → Skills (MCP tools) → Memory (audit trail)

• Gateway — CLI interface with typer + rich
• Brain — ReAct loop engine, LLM providers, clinical guardrails
• Skills — MCP client connecting to OpenMedicine server via stdio
• Memory — Session context, JSONL audit logger

Development

See CONTRIBUTING.md for development setup and guidelines.

git clone https://github.com/RamosFBC/fangbot.git
cd fangbot
uv sync --extra dev --extra openai
uv run python -m pytest -v

License

MIT — Copyright (c) 2026 RamosFBC