tsa-shiny-agent / README.md
mmrech's picture
Initial deployment of TSA Shiny Agent
026774a verified
metadata
title: TSA Shiny Agent
emoji: πŸ“Š
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
pinned: false
license: mit

TSA Shiny Agent

Trial Sequential Analysis with AI Assistant

A modern R Shiny web interface for Trial Sequential Analysis (TSA) with an integrated Claude AI assistant.

Features

  • Meta-Analysis: Fixed and random effects models (DerSimonian-Laird, Sidik-Jonkman)
  • Effect Measures: Odds Ratio, Relative Risk, Risk Difference, Mean Difference
  • TSA Boundaries: O'Brien-Fleming, Pocock, Haybittle-Peto alpha spending
  • Visualizations: Z-curve plots, Forest plots, Funnel plots
  • AI Assistant: Claude-powered chat for statistical guidance

Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                   Docker Container                       β”‚
β”‚                                                          β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”                      β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚  Shiny App  │◄────── rJava ──────► β”‚   TSA.jar    β”‚  β”‚
β”‚  β”‚  (port 7860)β”‚                      β”‚  (Java)      β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”˜                      β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β”‚         β”‚                                               β”‚
β”‚         β”‚ HTTP                                          β”‚
β”‚         β–Ό                                               β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     localhost:8000   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚ Agent Chat  │◄───────────────────► β”‚ Plumber API  β”‚  β”‚
β”‚  β”‚  (Claude)   β”‚                      β”‚  (R Bridge)  β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜                      β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Usage

  1. Create Meta-Analysis: Set effect model and measure
  2. Add Trials: Enter dichotomous or continuous trial data
  3. Calculate Boundaries: Configure TSA parameters
  4. View Results: Interactive graphs and statistics
  5. Ask AI: Get explanations and guidance

Environment Variables

Variable Description Required
ANTHROPIC_API_KEY Claude API key for AI chat Optional

Local Development

# With Docker
docker-compose up

# Without Docker
./start_tsa.sh

Credits

  • TSA algorithms: Copenhagen Trial Unit
  • AI: Claude by Anthropic
  • Framework: R Shiny + rJava