---
id: total-perspective-vortex
version: "3.2.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# total-perspective-vortex — A library for routing entities (jobs, users or groups) to destinations in Galaxy

License: permissive · Maintenance: active · Downloads: 90.3K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 90.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

galaxy job routing, compute destination scheduling, galaxy resource allocation, job queue management, galaxy tool routing rules, workload distribution galaxy, dynamic job scheduling, galaxy-admin, job-scheduling, bioinformatics

[View on SkillFed](https://skillfed.io/packages/total-perspective-vortex) · [View on PyPI](https://pypi.org/project/total-perspective-vortex/)