This is the umbrella repository for the ePIC streaming workflow testbed: the streaming workflow application of the swf platform. Its production peer is swf-epicprod; both ride the common platform in swf-monitor and swf-common-lib.
- ePIC WFMS Documentation - Official system-level documentation for the ePIC Workflow Management System, of which the testbed is the streaming implementation front
- Release Notes - What's new in each version
- Preparing a Release - Scope and procedure for an SWF vNN release
- Installation Guide - Complete setup instructions
- Architecture Overview - System design and components
- swf-testbed Host Inventory - Host paths, network boundaries, deployments and operational access
- Running the Testbed - Starting, stopping, and monitoring services
- Workflow Orchestration - Running and managing workflows
- The E0-E1 Interface - The interface as understood in 2026: architecture, definitions, open questions, development path
- The E0-E1 State Machine - The datataking state model at the E0-E1 interface
- Monitor Integration - Web interface and API usage
- MCP Integration - Model Context Protocol for LLM interaction
- PCS (Physics Configuration System) - Production configuration and campaign records, in the swf-epicprod production domain
- SSE Real-Time Streaming - Remote workflow event monitoring via HTTPS
- Production Deployment - Apache production deployment guide
This repository includes .mcp.json which automatically configures Claude Code to connect to the testbed's MCP service. When you open this project in Claude Code, the swf-testbed MCP server is available for natural language queries about system state, agents, workflows, and logs.
On the swf-testbed host it uses the loopback endpoint with the shared token
(SWF_MONITOR_MCP_TOKEN, see installation); Claude Code
2.1.304 and later refuse the certificate chain of the host's public address,
whatever NODE_EXTRA_CA_CERTS holds. To add it manually:
claude mcp add --transport http swf-testbed http://127.0.0.1:8001/swf-monitor/mcp/ --header 'Authorization: Bearer ${SWF_MONITOR_MCP_TOKEN}'Elsewhere, use the external endpoint with a per-user token from https://epic-devcloud.org/prod/account/tokens/:
claude mcp add --transport http swf-devcloud https://epic-devcloud.org/prod/mcp/ --header "Authorization: Bearer <token>"- Development Guide - Contributing and development workflow
- AI Memory - Cross-session dialogue persistence (experimental)