Skip to content

Projects and workspace

Glossa separates application settings, workspace resources, and per-project pipeline configuration.

Three levels of state

LevelWhat lives there
AppAPI keys, Ollama connection, interface preferences, defaults
WorkspacePhrase memory, Library glossaries, translation area context
Project / pipelineLanguages, stages, prompts, glossary assignment, chunks, outputs

Practical meaning

  • Change app settings when the whole installation should behave differently.
  • Change workspace-level resources when multiple projects should share them.
  • Change project or pipeline settings when you are tuning one translation job.

Typical project workflow

  1. Create or open a project.
  2. Select the active pipeline.
  3. Configure languages and stages.
  4. Assign a glossary if needed.
  5. Import a document and run test chunks.
  6. Save as you iterate.

Shared versus local resources

ResourceScope
API keysApp-wide
Interface preferencesApp-wide
Phrase-memory storageWorkspace
Library glossariesWorkspace
Glossary assigned to pipelineProject / pipeline
Chunks, drafts, audit output, notesProject / pipeline

Naming advice

  • Name pipelines by purpose, not by provider alone
  • Rename experimental pipelines instead of overwriting the production one
  • Keep one project per coherent text or editorial unit

What should stay stable

  • Keep one provider/model combination stable inside the same project unless you have a clear reason to change it.
  • Do not mix exploratory prompts and production prompts in the same saved pipeline without renaming it.
  • Treat the workspace as shared memory, not as a dumping ground for temporary experiments.

Public documentation for the Glossa desktop app