How wqx1999/pepforge works
PepForge is a HELM-native peptide-generation platform with a web GUI and CLI. Its principal workflow accepts a generation request, runs layout, content, and connection generation, then validates and optionally scores candidates before returning results. The repository also documents constrained generation, AMP and ADMET prediction, and custom predictor plugins. The graph combines README-described capabilities with relationships visible in the supplied source excerpts and SOURCE INDEX; unsampled route and integration details are not inferred.
Main entry points: pipeline.py Inference pipeline · routes API routes · generation_pipeline_runner.py Generation pipeline runner · App.tsx GUI application
Components 22
Web interface
- GUI application
App/frontend/src/App.tsx - Generation and prediction hooks
App/frontend/src/hooks - API client
App/frontend/src/api/client.ts
Application API
- FastAPI application
App/main.py - API routes
App/backend/routes - Background task manager
App/backend/tasks/task_manager.py - Generation service
App/backend/services/generation_service.py - Batch prediction service
App/backend/services/batch_predict_service.py - Monomer library service
App/backend/services/monomer_service.py
Inference orchestration
- Inference CLI
Pipelines/Inference.py - Inference pipeline
Scripts/Inference/pipeline.py - Model loader
Scripts/Inference/model_loader.py - Candidate postprocessing
Scripts/Inference/postprocess.py - Results output
Scripts/Inference/output.py
Hierarchical generation
- Layout generation
Scripts/Generation_Model/Inference/infer_layout.py - Content generation
Scripts/Generation_Model/Inference/infer_content.py - Connection generation
Scripts/Generation_Model/Inference/infer_connections.py - Generation pipeline runner
Scripts/Generation_Model/Utils/generation_pipeline_runner.py
Prediction
- AMP ensemble
Scripts/Inference/ensemble.py - PeptiVerse ADMET
Scripts/Inference/PeptiVerse/predictor.py - External predictor plugin
Configs/Inference/External_predictor_template/adapter.py
Other components
- User
Connections 23
- User → GUI application: submits request
- GUI application → Generation and prediction hooks: uses hooks
App/frontend/src/App.tsx - Generation and prediction hooks → API client: calls API
App/frontend/src/hooks/useGeneration.ts - API client → FastAPI application: sends requests
App/frontend/src/api/client.ts - FastAPI application → API routes: registers routes
App/main.py - API routes → Generation service: dispatches generation
- API routes → Batch prediction service: dispatches batches
- API routes → Monomer library service: serves library
- Generation service → Inference pipeline: runs pipeline
App/backend/services/generation_service.py - Batch prediction service → Inference pipeline: uses inference
App/backend/services/batch_predict_service.py - Inference CLI → Inference pipeline: runs inference
Pipelines/Inference.py - Inference pipeline → Model loader: loads models
Scripts/Inference/pipeline.py - Inference pipeline → Layout generation: generates layout
Scripts/Inference/pipeline.py - Inference pipeline → Content generation: generates content
Scripts/Inference/pipeline.py - Inference pipeline → Connection generation: predicts connections
Scripts/Inference/pipeline.py - Inference pipeline → Candidate postprocessing: postprocesses candidates
Scripts/Inference/postprocess.py - Inference pipeline → AMP ensemble: scores AMP
- Inference pipeline → PeptiVerse ADMET: scores ADMET
- Inference pipeline → External predictor plugin: supports plugins
- Inference pipeline → Results output: writes results
Scripts/Inference/pipeline.py - Generation pipeline runner → Layout generation: invokes stage
Scripts/Generation_Model/Utils/generation_pipeline_runner.py - Generation pipeline runner → Content generation: invokes stage
Scripts/Generation_Model/Utils/generation_pipeline_runner.py - Generation pipeline runner → Connection generation: invokes stage
Scripts/Generation_Model/Utils/generation_pipeline_runner.py