total-perspective-vortex

What it is and what it does

Total Perspective Vortex is a routing engine for Galaxy, the bioinformatics workflow platform. It reads YAML configuration files that define rules for directing computational jobs, users, and roles to specific execution destinations (local queues, HPC clusters, cloud providers, etc.). TPV integrates directly into Galaxy and is typically installed automatically as part of Galaxy's environment, though it can also be installed standalone via pip.

The package solves the problem of dynamic workload distribution in Galaxy: instead of static job configuration, TPV lets administrators write declarative rules that match job characteristics (tool name, user, resource requirements) to appropriate destinations. It depends on pydantic for configuration validation, ruamel.yaml for YAML parsing, requests for HTTP operations, jinja2 for templating, and watchdog for file monitoring—all standard Python libraries. The project maintains a companion shared database of pre-built routing rules to accelerate typical deployments.

Use it for:

• Route long-running bioinformatics tools to a dedicated HPC cluster while keeping quick jobs on local resources
• Enforce per-user or per-group memory and CPU limits by writing YAML rules that match user metadata
• Automatically scale job destinations based on tool resource requirements without editing Galaxy config files
• Implement priority-based job queuing where certain user roles get preferential scheduling
• Migrate existing static Galaxy job configuration to dynamic rules without downtime

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Total Perspective Vortex (TPV) provides dynamic job routing rules for Galaxy that direct tools, users, and roles to appropriate compute destinations based on configurable YAML policies.

Yes, if you operate a Galaxy instance and need flexible job routing. TPV is actively maintained, has no known vulnerabilities, uses a permissive license, and low install friction. It's designed to integrate seamlessly into Galaxy and the shared rule database significantly reduces configuration effort. Install it if Galaxy's static job configuration is limiting your deployment; skip it if you run a minimal single-machine Galaxy.

Install

total-perspective-vortex on PyPI

pip install total-perspective-vortex

uv add total-perspective-vortex

poetry add total-perspective-vortex

Installing total-perspective-vortex

Before you install

Low install friction with a pure-Python wheel. Active maintenance with a recent commit (2026-08-14) and no known vulnerabilities. Nine runtime dependencies including pydantic, requests, and ruamel.yaml are all standard ecosystem packages.

License in practice

MIT license is permissive—you can use, modify, and distribute TPV with minimal restrictions, making it suitable for both open-source and commercial Galaxy deployments.

Quickstart

pip install total-perspective-vortex

from total_perspective_vortex import TPVRouter
router = TPVRouter(config_file='tpv_config.yaml')
destination = router.route_job(tool_id='bwa', user='alice')

Requires Python >=3.10 and a Galaxy instance configured to use TPV for job routing; standalone testing may require additional Galaxy dependencies.

Verify before relying

• Whether TPV requires a running Galaxy instance to function or can be tested in isolation
• Performance characteristics when routing large numbers of concurrent jobs
• Whether the shared default resource database is automatically fetched or requires manual configuration

Package facts

Evidence: total_perspective_vortex-3.2.1-py3-none-any.whl

Tags

More Distributed Computing packages

Further reading