Skip to content

Evanaxander/BioLab-Studio

Repository files navigation

BioLab Studio Pro - Advanced Interactive Microbiology & Biotechnology Learning Platform

https://bio-lab-studio-xrn5.vercel.app/

Overview

BioLab Studio Pro is a comprehensive, production-grade educational platform designed for microbiology and biotechnology students. The system features full three-dimensional molecular visualization, AI-powered co-scientist assistance, functional model building capabilities, advanced simulation engines, and progressive difficulty scaling from beginner through research-level expertise.

System Architecture

The application is built on a Node.js/Express backend serving a sophisticated HTML5/Three.js frontend. All features are fully functional and ready for deployment in educational settings.

Installation Instructions

Prerequisites

You must have Node.js installed on your system. Download the latest Long Term Support (LTS) version from nodejs.org. The installation includes npm, which you will use to manage project dependencies.

Step 1: Navigate to Project Directory

Open your terminal or command prompt and navigate to the BioLab Studio Pro project folder.

cd path/to/biolab-studio-pro

Step 2: Install Dependencies

Run the following command to install all required packages specified in package.json:

npm install

This will download Three.js, Express, CORS, and compression middleware into the node_modules directory.

Step 3: Start the Development Server

Launch the application with:

npm start

You will see output confirming the server is running:

╔════════════════════════════════════════════════════════╗
║   BioLab Studio Pro - Advanced Learning Platform       ║
╚════════════════════════════════════════════════════════╝

✓ Server running at: http://localhost:3000
✓ Open your browser and navigate to: http://localhost:3000
✓ Press Ctrl+C to stop the server

Step 4: Access the Application

Open your web browser and navigate to http://localhost:3000. The full BioLab Studio Pro interface will load. The application requires no additional configuration.

Core Features

Three-Dimensional Molecular Visualization

The primary canvas renders fully interactive three-dimensional molecular structures using Three.js. All structures are rendered with dynamic lighting, shadow mapping, and interactive object selection. You can rotate the view by moving your mouse, zoom using scroll, and click any molecular component to view detailed information.

Eight Complete Educational Modules

The platform includes complete modules covering Cell Structure and Organelles, DNA and RNA Structures, Protein Folding and Structure, Viral Particles and Dynamics, Enzyme Kinetics, Cell Division and Mitosis, Antibody-Antigen Binding, and CRISPR-Cas9 Gene Editing systems. Each module contains detailed three-dimensional representations of molecular structures with scientifically accurate information.

Progressive Difficulty Scaling

Three difficulty levels adapt content complexity. Beginner level presents fundamental structures and basic mechanisms. Intermediate level introduces advanced mechanisms, detailed quantitative properties, and complex molecular interactions. Expert level provides research-grade content including kinetic parameters, thermodynamic values, and current scientific literature references.

Four Operational Modes

The Visualize mode displays interactive three-dimensional models with click-to-learn functionality. The Build Model mode allows students to construct custom biological systems by adding components to a blank canvas. The Simulate mode enables parameter adjustment for temperature, pH, and molecular concentration with real-time animation showing how conditions affect molecular behavior. The AI Experiment Designer mode provides intelligent hypothesis generation, experimental protocol design, and data analysis recommendations.

AI Co-Scientist System

The AI assistant generates testable hypotheses based on the current module and difficulty level. It designs complete experimental protocols including sample preparation procedures and measurement methodologies. The system provides data analysis frameworks appropriate to the student's learning level.

Functional Model Builder

Students can add individual biological components to a custom canvas, position them relative to each other, and save their constructed models to browser storage. The builder includes components such as nucleus, mitochondria, proteins, DNA, ribosomes, and enzymes.

Complete Simulation Engine

Students adjust temperature between 25 and 45 degrees Celsius, pH from 4 to 9, and molecular concentration from 0 to 100 percent. The simulator runs real-time animations showing molecular behavior responding to these parameter changes. Simulation state can be paused and resumed.

Project File Structure

The project is organized as follows:

biolab-studio-pro/
├── package.json           (Project dependencies and metadata)
├── server.js              (Express server with API endpoints)
├── public/
│   ├── index.html         (Main HTML application interface)
│   └── app.js             (Complete JavaScript application logic)
└── README.md              (This file)

API Endpoints

The server provides REST API endpoints for AI-powered features:

POST /api/ai/hypothesis - Generate testable hypotheses based on module and difficulty level POST /api/ai/experiment - Design experimental protocols with detailed procedures POST /api/ai/analysis - Generate data analysis frameworks and recommendations POST /api/simulation - Run molecular behavior simulations with specified parameters POST /api/model/save - Persist constructed models to server storage GET /api/model/:modelId - Retrieve previously saved models

Browser Compatibility

The application requires a modern web browser supporting WebGL, ES6 JavaScript, and the Fetch API. Recommended browsers include Google Chrome version 90 or later, Mozilla Firefox version 88 or later, Safari version 14 or later, or Microsoft Edge version 90 or later. Internet Explorer is not supported.

Performance Considerations

The application renders complex three-dimensional molecular structures in real-time. For optimal performance, ensure your system has adequate GPU resources. On systems with integrated graphics, the application may render more slowly but remains fully functional. Disable other resource-intensive applications if you experience performance issues.

Troubleshooting

If the application does not start, verify that Node.js is correctly installed by running node --version in your terminal. If dependencies fail to install, delete the node_modules directory and package-lock.json file, then run npm install again. If you see a "port already in use" error, another application is using port 3000. Either close that application or modify the PORT variable in server.js to use an alternative port.

If the Three.js canvas appears blank, ensure your browser supports WebGL. Test WebGL support at webglreport.com. If WebGL is unavailable, update your graphics drivers or use a different browser.

Educational Usage

The platform is designed for self-directed learning and instructor-led classroom instruction. Students can progress through modules at their own pace, with difficulty levels scaffolding from fundamental concepts to advanced research topics. Teachers can use the module structure to align with curriculum objectives and assign specific modules for targeted learning outcomes.

Development and Customization

The application is intentionally modular to facilitate customization. New modules can be added by extending the modules object in public/app.js, following the established structure for component definitions and descriptions. The Three.js rendering system can accommodate additional geometry types by extending the renderComponents function. The AI backend is designed to integrate with more sophisticated AI systems through the established API structure.

Support and Documentation

For additional information about the scientific concepts presented in each module, consult peer-reviewed biochemistry textbooks such as "Lehninger Principles of Biochemistry" or "Molecular Biology of the Gene". For Three.js documentation, visit threejs.org. For Express server documentation, see expressjs.com.

License

This educational platform is provided for instructional use. Modification and redistribution are permitted with appropriate attribution to the original authors.

Version Information

BioLab Studio Pro Version 1.0.0 - Production Release Release Date: 2025 Compatibility: Node.js 16.0 or later


This comprehensive learning platform represents the state-of-the-art in interactive microbiology and biotechnology education. Every feature has been thoroughly tested and is production-ready for deployment in educational institutions worldwide.

About

BioLab Studio Pro is a self-contained educational web app for microbiology and biotechnology.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors