Bride of Frankensystem

A Python-based framework for researchers who need to build online experiments that are more than just basic surveys. Create sophisticated online experiments with JSON-defined questionnaires, custom task integration, and real-time participant monitoring.

Quick Start

1 pip install bride-of-frankensystem
2 Download example projects
3 bofs minimal.toml -d
4 Visit http://localhost:5000
Full Tutorial

Why Bride of Frankensystem?

Many researchers face a difficult choice: use inflexible survey tools that aren't designed with complex study designs in mind, or spend months learning JavaScript frameworks like jsPsych. BOF bridges this gap.

vs. Survey Tools (Qualtrics, SurveyMonkey)

✓ Handle complex multi-session studies
✓ Embed custom tasks and games
✓ Integrate data processing

vs. JavaScript Frameworks (jsPsych)

✓ Python-based (familiar to many researchers)
✓ Built-in participant management
✓ No client-side programming required

vs. Building from Scratch

✓ Handles authentication, data storage, routing
✓ Pre-built questionnaire system
✓ Focus on your research, not infrastructure

Built for Experimenters

Python-Powered Flexibility

Built on Flask, BOF gives you the familiarity of Python with the power of web deployment. Extend with custom routes, integrate any Python library, or embed Unity games without needing to be a web developer.

JSON-Defined Questionnaires

Write surveys once, use everywhere. BOF's JSON format for defining questionnaires allows you to define questionnaires that are automatically scored remaining human-readable and version-controllable.

Complex Study Designs Made Simple

Run between-subjects experiments, longitudinal studies, or multi-session designs with automatic participant assignment and session management.

Reusable Modules

Build a library of questionnaires, instruction pages, and custom tasks. Share components across studies or with colleagues—everything is modular and portable.

How It Works

Explore Example Projects

These demos showcase how flexible BOF can be across different types of studies.

Simple Survey

A demo showing all available question types and a questionnaire with score calculations, all defined within JSON files.

Video Game Tasks

Shows how to embed a Unity WebGL game with pre/post questionnaires, integrated data collection, and automatic processing of experimental and survey data into format that can be analyzed immediately.

Longitudinal Study

Demonstrates how participants can complete an experiment over multiple sessions, being assigned to the same treatment group each time.

Coming Soon

Hosting For Your BOF Experiments

Soon, you'll be able to build and run BOF experiments directly in the cloud—no server setup required. Upload your project and get a public link to share with participants. All the flexibility of BOF, without any infrastructure hassles.

  • Secure, scalable hosting for BOF studies
  • Built-in data export and dashboard access
  • One-click deployment from your browser

This service is in development and will launch soon. Stay tuned! Join us on Discord or our mailing list for updates.

Join Discord