How abd19990044-commits/chemistry-web-lab works
Chemistry Lab is a computational-chemistry web platform. Its primary workflow is to prepare a molecule or reaction, choose local/HPC execution (recommended) or optional Kaggle execution, submit an ORCA calculation, then parse and analyze results. The graph also preserves the documented molecular studio, reaction thermochemistry, spectroscopy, and dataset-export capabilities. Some feature branches are documented in the README but their implementation was not sampled; those links are shown only where the documentation supports them.
Main entry points: app.py Web application · service.py Kaggle orchestration · io.py ORCA file reader · main.py FastAPI layer
Components 23
Web platform
- Web application
app.py - FastAPI layer
api/main.py - Identity and access
services/auth_service.py
Chemistry workflows
- Molecule studio
chem_core.py - Structure drawing
chem_core/drawing.py - Reaction workflow
services/reaction_workflow_service.py
Execution backends
- Agent registry
services/local_agent_service.py - Companion agent
local_agent/agent.py - HPC schedulers
local_agent/hpc - Local ORCA service
services/local_orca_service.py - Local job worker
services/local_orca_worker.py
Scientific analysis
- ORCA file reader
orca_engine/src/orca_engine/io.py - Output parser
orca_engine/src/orca_engine/parser.py - Scientific data models
orca_engine/src/orca_engine/models.py - Spectroscopy analysis
orca_engine/src/orca_engine/nmr.py - AI dataset export
tools/export_training_jsonl.py
Cloud and persistence
- Kaggle runner
kaggle_runner.py - Kaggle orchestration
orca_orchestrator/service.py - Job state store
orca_orchestrator/store.py - Cloud control plane
cloudflare-control-plane/src/index.ts - Kaggle service
services/kaggle_service.py
Other components
- Researcher
- ORCA software
Connections 25
- Researcher → Web application: uses
README.md - Researcher → FastAPI layer: calls API
README.md - FastAPI layer → Web application: mounts legacy app
api/main.py - Web application → Identity and access: authenticates
app.py - Web application → Molecule studio: uses chemistry tools
app.py - Structure drawing → ORCA file reader: exports structures
chem_core/drawing.py - Web application → Reaction workflow: runs reaction workflows
app.py - Reaction workflow → ORCA file reader: loads ORCA results
services/reaction_workflow_service.py - Web application → Agent registry: pairs agents
app.py - Agent registry → Companion agent: dispatches jobs
README.md - Companion agent → HPC schedulers: submits HPC jobs
README.md - HPC schedulers → ORCA software: runs calculations
README.md - Web application → Local ORCA service: configures local runs
app.py - Local ORCA service → Local job worker: enqueues jobs
services/local_orca_worker.py - Local job worker → ORCA software: launches
services/local_orca_worker.py - Web application → Kaggle service: requests cloud runs
app.py - Kaggle service → Kaggle orchestration: delegates orchestration
- Kaggle orchestration → Kaggle runner: submits kernels
- Kaggle orchestration → Job state store: persists job state
orca_orchestrator/service.py - Kaggle orchestration → Cloud control plane: syncs metadata
- ORCA file reader → Output parser: parses output
orca_engine/src/orca_engine/io.py - Output parser → Scientific data models: builds records
orca_engine/src/orca_engine/parser.py - Web application → ORCA file reader: loads analysis inputs
app.py - Web application → Spectroscopy analysis: presents spectroscopy
README.md - Web application → AI dataset export: exports training data
README.md