AltarDocker
Deploy MongoDB, MinIO, Omniboard, and AltarExtractor with Docker Compose.
Features
Map experiment folders
Select folders and map files to Sacred data types: config, results, metrics, artifacts.
Send to Sacred
Push experiment metadata, configs, results, and metrics to MongoDB Sacred.
Upload to MinIO
Send large raw data files to S3-compatible MinIO storage.
Batch send
Send multiple experiments with the same folder structure in one go.
Multiple formats
Supports JSON, CSV, and Excel files for configs, results, and metrics.
Local storage
Optionally save raw data to local or network paths instead of MinIO.
Quick start
1
Install dependencies
cd AltarSender
python -m venv .venv
.venv\Scripts\activate # Windows
# source .venv/bin/activate # Linux/macOS
pip install -r requirements.txt2
Run the app
python app.pyThe GUI window will open.
3
Configure connections
Enter your MongoDB credentials. Optionally configure MinIO for large file storage.
4
Select and send
Choose an experiment folder, map files to data types, and click Send experiment.
File categories
Config
Experiment configuration (JSON, CSV, Excel)
Results
Experiment results and outputs (JSON, CSV, Excel)
Metrics
Time series data for plotting (CSV, Excel)
Artifacts
Small files stored in MongoDB (< 50MB)
Raw data
Large files sent to MinIO or local storage
Batch sending
Send multiple experiments at once when they share the same folder structure. Configure one experiment, enable batch mode, and all sibling folders will be processed.
Parent folder/
├── 2023-04-17_Experiment1/
│ ├── config.json
│ ├── results.csv
│ └── raw_data/
│ └── video.tiff
│
└── 2023-04-17_Experiment2/
├── config.json
├── results.csv
└── raw_data/
└── video.tiffViewing results
Config
Omniboard → Config tab
Results
Omniboard → Run Info → result
Metrics
Omniboard → Metrics plot
Artifacts
Omniboard → Artifacts
Raw data
Omniboard → Run Info → dataFiles
Related tools
AltarExtractor
Browse and filter Sacred experiments with a modern web UI.