PROJECT

Sidebar

• Select loads the chosen project and exposes an Export button that writes <project>.zip to ${EXPORT_APPS} using the active export-app-filter. The rest of the page (expanders described below) becomes available from this view.

• Create and Clone lets you clone either the current project or one of the templates discovered on disk. The helper normalises the name (adds the _project suffix) and rejects duplicates before cloning.

• Rename copies the selected project to the new name, removes the original folder and switches the session to the renamed project once the operation succeeds.

• Delete permanently removes the active project after you tick the confirmation box. When the folder is deleted, AGILab automatically selects a remaining project so you can keep working.

• Import restores a project archive produced by Export. You can request a clean import (strips .gitignore files) and the modal overwrite flow guards against accidentally replacing an existing project.

Main Content Area

• When Select is active the page reveals a stack of expanders backed by the in-browser code editor. Each expander streams syntax-highlighted content and writes any saved changes straight back to disk:

  • PYTHON-ENV edits the project pyproject.toml so you can manage dependencies without leaving the browser.

  • PYTHON-ENV-EXTRA surfaces uv_config.toml for supplemental dependency constraints.

  • MANAGER and WORKER expose the main orchestration modules. The editor offers class/function/attribute pickers so you can focus on specific sections before saving.

  • EXPORT-APP-FILTER controls the .gitignore rules that the export flow applies when producing the archive.

  • APP-SETTINGS opens app_settings.toml. AGILab keeps the [args] and [pages] sections in sync with the Orchestrate and Analysis pages.

  • README allows quick edits to the project README.md.

  • APP-ARGS targets app_args.py in the app package. Use it to synchronise default arguments with the Orchestrate page.

  • APP-ARGS-FORM displays (and creates if missing) the optional app_args_form.py web snippet used to render a custom parameter UI in Orchestrate.

  • PRE-PROMPT serialises pre_prompt.json so you can tailor the prompt used by the Pipeline assistant.

Troubleshooting and checks

Use these checks if Project actions do not behave as expected:

• If no projects are listed, verify the active apps directory and confirm the target project folder contains a valid README/app_manager structure.

• If Delete does not refresh the UI, re-open the page and re-select the same project; the deletion flow is asynchronous and can race with the list rebuild.

• If edits appear lost after saving, confirm you are still in the same project and that write permissions are available for the selected source file.

• If import/export fails, check free disk space and confirm ${EXPORT_APPS} and the project path are writable.

See also

• About AGILab for the global page map.

• ORCHESTRATE for orchestrating installs/distribution after project setup.

• AGILab Architecture for how project files feed workers and runtimes.

Support

Email: focus@thalesgroup.com