How titiianna/bioforge works
BioForge is a command-line DNA sequence processor. Its main workflow reads FASTA records, validates DNA, detects and translates ORFs across six reading frames, filters and annotates results, then writes a report and logs execution. The graph reflects the calls visible in the excerpts and documented capabilities; resource-file loading is shown as data flow, while the README describes annotation and reporting behavior beyond the sampled implementation details.
Main entry points: main.py Run coordinator · pipeline.py ORF pipeline · parsers.py FASTA parser · models.py Data loader
Components 15
CLI orchestration
- Run coordinator
main.py
Sequence processing
- FASTA parser
parsers.py - DNA validation
models.py - ORF pipeline
pipeline.py - ORF filters
filters.py
Data and errors
- Data loader
models.py - Codon table
data/codon_table.txt - Amino weights
data/amino_weights.txt - Domain errors
exceptions.py
Results and logging
- Report writer
report.py - Run logger
logger.py
Other components
- CLI user
- FASTA input
- Report output
- Log output
Connections 20
- CLI user → Run coordinator: invokes
README.md - Run coordinator → Run logger: sets up
main.py - Run coordinator → Data loader: loads resources
main.py - Data loader → Codon table: reads
- Data loader → Amino weights: reads
- Run coordinator → FASTA parser: parses input
main.py - FASTA input → FASTA parser: provides records
README.md - FASTA parser → DNA validation: constructs
parsers.py - FASTA parser → Domain errors: raises
parsers.py - DNA validation → Domain errors: raises
models.py - Run coordinator → ORF pipeline: processes records
main.py - Run coordinator → ORF filters: configures
main.py - Run coordinator → Data loader: supplies tables
main.py - ORF pipeline → DNA validation: converts strands
pipeline.py - ORF pipeline → ORF filters: applies
pipeline.py - ORF pipeline → Domain errors: raises
pipeline.py - Run coordinator → Report writer: writes results
main.py - Report writer → Report output: writes
report.py - Run coordinator → Run logger: records events
main.py - Run logger → Log output: appends
logger.py