OpenTester Distribution Guide

March 8, 2026 ยท View on GitHub

This document describes practical ways to distribute OpenTester for local usage and CI environments.

Python Package (PyPI)

Install:

pip install opentester

Publish (maintainers):

cd backend
python -m build
twine upload dist/*

Source Installation

git clone https://github.com/kznr02/OpenTester.git
cd OpenTester
uv pip install ./backend

Standalone Executable (PyInstaller)

cd backend
pip install pyinstaller
pyinstaller opentester.spec

Output:

  • Windows: dist/opentester.exe
  • Linux/macOS: dist/opentester

Runtime Service Modes

  • Foreground mode: opentester start
  • Daemon mode: opentester start --daemon
  • API only: opentester start --api
  • MCP only: opentester start --mcp

Environment

  • FastAPI default: http://localhost:8000
  • MCP default: http://localhost:8001/mcp
  • Data directory: XDG-compliant platform path

Verification Checklist

  1. opentester doctor passes
  2. opentester start or opentester start --daemon starts services
  3. opentester status shows expected running services
  4. MCP endpoint responds from configured client