Skip to content

Hello-QM/catgo-LRG / server/catgo/workflow

catgo-workflow

Verified

Create and manage computational chemistry workflows with CatGo. Supports VASP, CP2K, ORCA, MLP, LAMMPS. Build OER/HER/CO2RR workflows, geometry optimization, frequency analysis, Gibbs energy calculations.

FileKindSize
SKILL.mdskill md3.8 KB
__init__.pyscript1.1 KB
builtins.pyscript4.7 KB
builtins_impl.pyscript21.2 KB
config.pyscript6.5 KB
db.pyscript25.3 KB
engine/__init__.pyscript615 B
engine/advancer.pyscript9.3 KB
engine/ai_diagnosis.pyscript3.8 KB
engine/batch_submitter.pyscript9.7 KB
engine/broadcast.pyscript1.8 KB
engine/collector.pyscript8.3 KB
engine/control_flow.pyscript5.7 KB
engine/engine_builtins.pyscript19.6 KB
engine/engine_registry.pyscript1.5 KB
engine/error_handler.pyscript3.6 KB
engine/hpc_utils.pyscript4.0 KB
engine/job_script.pyscript11.6 KB
engine/lifecycle.pyscript10.8 KB
engine/orca_progress.pyscript3.4 KB
engine/poller.pyscript11.7 KB
engine/resolver.pyscript2.7 KB
engine/result_collector.pyscript56.3 KB
engine/result_handler.pyscript5.6 KB
engine/scanner.pyscript52.0 KB
engine/smart_recovery.pyscript3.6 KB
engine/submitter.pyscript26.2 KB
engine/v1_monitor.pyscript2.7 KB
engine/vasp_submission.pyscript29.0 KB
graph_converter.pyscript6.5 KB
mcp_tools.pyscript7.5 KB
provenance.pyscript5.8 KB
reference.pyscript1.1 KB
service.pyscript4.0 KB
state_map.pyscript1.5 KB
states.pyscript7.5 KB
task_decorator.pyscript2.5 KB
task_ids.pyscript986 B
v1_compat.pyscript2.8 KB
workflow.pyscript12.0 KB

task_decorator.py

View on GitHub
"""@task decorator and global task registry."""

from __future__ import annotations
from dataclasses import dataclass, field
from typing import Any, Callable

_TASK_REGISTRY: dict[str, TaskDefinition] = {}


@dataclass
class TaskDefinition:
    """Metadata about a registered task type."""
    task_type: str
    software: str | None = None
    outputs: list[str] = field(default_factory=list)
    local: bool = False
    func: Callable | None = None
    default_params: dict[str, Any] = field(default_factory=dict)


def task(
    func: Callable | None = None,
    *,
    task_type: str | None = None,
    software: str | None = None,
    outputs: list[str] | None = None,
    local: bool = False,
):
    """Register a function as a workflow task type.

    Usage:
        @task(software="vasp", task_type="geo_opt", outputs=["structure", "energy"])
        def geo_opt(structure, ENCUT=520, **params):
            pass

        @task(task_type="gibbs_energy", local=True, outputs=["gibbs"])
        def gibbs_energy(energy, frequencies, temperature=298.15):
            return compute_gibbs(energy, frequencies, temperature)
    """
    def decorator(fn: Callable) -> Callable:
        name = task_type or fn.__name__
        if name in _TASK_REGISTRY:
            raise ValueError(
                f"Task type '{name}' already registered "
                f"(by {_TASK_REGISTRY[name].func.__name__ if _TASK_REGISTRY[name].func else 'unknown'})"
            )

        # Extract default params from function signature
        import inspect
        sig = inspect.signature(fn)
        defaults = {}
        for pname, param in sig.parameters.items():
            if param.default is not inspect.Parameter.empty and pname != "params":
                defaults[pname] = param.default

        defn = TaskDefinition(
            task_type=name,
            software=software,
            outputs=outputs or [],
            local=local,
            func=fn if local else None,
            default_params=defaults,
        )
        _TASK_REGISTRY[name] = defn

        # Attach metadata to the function for Workflow.add_task()
        fn._catgo_task_type = name
        fn._catgo_definition = defn
        return fn

    if func is not None:
        return decorator(func)
    return decorator


def get_task_registry() -> dict[str, TaskDefinition]:
    """Get the global task registry (read-only view)."""
    return _TASK_REGISTRY


def get_task_definition(task_type: str) -> TaskDefinition | None:
    """Look up a task definition by type name."""
    return _TASK_REGISTRY.get(task_type)
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall