The Bio-Engine is an asynchronous backend service designed to handle heavy bioinformatics computational tasks for PS Analyzer. It acts as an integration layer between the main web application and native bioinformatics tools like tracy, executing alignments, variant calling, and sequence annotations (HGVS, VEP).
- Asynchronous Job Management: Jobs are executed in isolated background threads.
- Tracy Wrapper: Advanced DNA sequence decomposition, basecalling, and alignment using the tracy C++ framework.
- Variant Recoder & VEP: Genomic consequence prediction via the Ensembl REST API with built-in batch handling and fallback strategies.
- HGVS Notation: Accurate nomenclature mapping powered by Universal Transcript Archive (UTA).
- Python >= 3.10
- Tracy CLI API: Must be installed and available in the system
PATH. samtoolsandbgzip: Needed for auto-indexing very large reference files (>50Kbp).
You can install the dependencies via pip:
pip install -r requirements.txt(Alternatively, use pip install . to install via pyproject.toml)
Start the FastAPI server via Uvicorn:
uvicorn main:app --host 127.0.0.1 --port 8000Or simply:
python main.pyThe Bio-Engine can be deployed as a standalone API server using Docker. This is ideal for centralized deployments where multiple PS Analyzer instances (or the web-based version) connect to a shared analysis backend.
- Build the image:
docker build -t bio-engine -f Dockerfile.server . - Run the container:
docker run -p 8000:8000 -v $(pwd)/data:/app/data bio-engine
Dockerfile.server: A production-ready image that includes all necessary bioinformatics tools (samtools,tabix,tracy) and runs the FastAPI server.Dockerfile: Used for building the static binaries (sidecars) for the Tauri desktop application.
Once the server is running, the Swagger UI is available at http://127.0.0.1:8000/docs, where you can explore and interact with the endpoints.
This codebase follows PEP8 guidelines enforced by ruff. To check style errors, run:
ruff check .And to automatically format your changes:
ruff format .