How hello-qm/catgo-lrg works
CatGo is an AI workbench for computational materials science. A researcher opens or builds a structure, inspects and edits it, prepares calculation inputs or a visual workflow, and can submit and monitor work on their own HPC environment before reviewing scientific results. The repository combines desktop UI, Python services, scientific extensions, and workflow runtimes. The graph preserves the README’s major capabilities; unsampled feature links are documented at the product level rather than inferred from directory names.
Main entry points: workflow_engine.py Workflow API · workflow_engine_tasks.py Task API · lifecycle.py Workflow Lifecycle · App.svelte Desktop Workbench
Components 20
Research Workbench
- Desktop Workbench
desktop/App.svelte - Pane Layout
desktop/pane-tree.ts
Structure Science
- Structure Editor
src/lib/structure/atoms/atom-manager.svelte.ts - Structure Operations
server/catgo/routers/structure_ops.py - Ferrox Algorithms
extensions/rust/src/structure.rs
Workflow Execution
- Input Preparation
server/catgo/routers/build.py - Workflow Editor
src/lib/workflow/EngineTaskEditor.svelte - Workflow API
server/catgo/routers/workflow_engine.py - Task API
server/catgo/routers/workflow_engine_tasks.py - Workflow Service
server/catgo/workflow/service.py - Workflow State Store
server/catgo/workflow/db.py - Workflow Lifecycle
server/catgo/workflow/engine/lifecycle.py - Calculation Engines
server/catgo/workflow/engine/engine_builtins.py
Services And AI
- HPC Access
server/catgo/utils/hpc_client.py - CatBot Tools
server/catgo/mcp_tools/server.py - Plugin System
server/catgo/plugins/manager.py
Scientific Analysis
- Results And Monitoring
server/catgo/utils/job_parser.py - Analysis Tools
server/catgo/routers/dos.py - Catalysis Analysis
server/workflow/catalysis/energy_diagram.py
Other components
- Researcher
Connections 21
- Researcher → Desktop Workbench: uses
- Desktop Workbench → Pane Layout: manages panes
desktop/App.svelte - Researcher → Structure Editor: edits structures
- Researcher → Structure Operations: builds models
- Structure Operations → Ferrox Algorithms: uses algorithms
- Researcher → Input Preparation: prepares inputs
- Researcher → Workflow Editor: edits workflows
- Workflow Editor → Task API: loads task
src/lib/workflow/EngineTaskEditor.svelte - Researcher → Workflow API: submits workflow
- Workflow API → Workflow Service: delegates actions
server/catgo/routers/workflow_engine.py - Workflow Service → Workflow State Store: reads and writes
server/catgo/workflow/service.py - Workflow Lifecycle → Workflow State Store: persists state
- Workflow Lifecycle → Calculation Engines: dispatches tasks
- Calculation Engines → HPC Access: runs remotely
- Researcher → HPC Access: connects remotely
- Workflow API → Task API: exposes task actions
- Task API → Results And Monitoring: parses convergence
server/catgo/routers/workflow_engine_tasks.py - Researcher → CatBot Tools: requests by chat
- Researcher → Plugin System: extends tools
- Researcher → Analysis Tools: analyzes properties
- Researcher → Catalysis Analysis: reviews catalysis