How masdos/khemeia-eln works
Khemeia ELN is a local-first chemistry electronic lab notebook. Researchers use its desktop interface to organize projects and protocols, record and search experiments, trace reagent and equipment use, attach files, and export records. A separate report workflow uses a local Ollama model to draft reports for saving and export. The map follows the documented UI, service, repository, and SQLite layers; some page and integration links rely on README or source-index references because those implementations were not excerpted.
Main entry points: router.py Page router · export_service.py Document export · experiment_detail.py Experiment pages · connection.py SQLite store
Components 27
Desktop interface
- App startup
main.py - Page router
app/ui/router.py - Experiment pages
app/ui/pages/experiment_detail.py - Dashboard
app/ui/pages/dashboard.py - Inventory pages
app/ui/pages/inventory.py - Project pages
app/ui/pages/project_detail.py - Protocol pages
app/ui/pages/protocol_detail.py - Report pages
app/ui/pages/reports.py
Lab workflows
- Experiment workflow
app/services/experiment_service.py - Inventory traceability
app/services/inventory_service.py - Project management
app/services/project_service.py - Protocol management
app/services/protocol_service.py - Saved reports
app/services/report_service.py
Persistence and files
- SQLite store
app/database/connection.py - Experiment records
app/repositories/experiment_repository.py - Reagent and equipment records
app/repositories/reagent_repository.py - Project records
app/repositories/project_repository.py - Protocol records
app/repositories/protocol_repository.py - Report records
app/repositories/report_repository.py - Attachments
app/repositories/attachment_repository.py
Local AI and export
- AI report generator
app/ui/pages/ai_report_generator.py - AI drafting
app/services/ai_service.py - Ollama client
app/services/ollama_client.py - Document export
app/services/export_service.py
Other components
- Researcher
- Local Ollama model
- Markdown PDF DOCX
Connections 41
- Researcher → App startup: starts app
- App startup → Page router: sets up
main.py - Researcher → Page router: navigates
- Page router → Dashboard: renders
app/ui/router.py - Page router → Experiment pages: renders
app/ui/router.py - Page router → Inventory pages: renders
app/ui/router.py - Page router → Project pages: renders
app/ui/router.py - Page router → Protocol pages: renders
app/ui/router.py - Page router → Report pages: renders
app/ui/router.py - Page router → AI report generator: renders
app/ui/router.py - Dashboard → Experiment workflow: lists experiments
app/ui/pages/dashboard.py - Experiment pages → Experiment workflow: edits experiments
app/ui/pages/experiment_detail.py - Experiment pages → Inventory traceability: links resources
app/ui/pages/experiment_detail.py - Experiment pages → Project management: loads project
app/ui/pages/experiment_detail.py - Experiment pages → Protocol management: loads protocol
app/ui/pages/experiment_detail.py - Experiment pages → Document export: exports experiment
app/ui/pages/experiment_detail.py - Inventory pages → Inventory traceability: manages stock
app/ui/pages/inventory.py - Project pages → Project management: manages projects
app/ui/pages/project_detail.py - Protocol pages → Protocol management: manages protocols
- Report pages → Saved reports: manages reports
app/ui/pages/reports.py - AI report generator → AI drafting: requests drafts
app/ui/pages/ai_report_generator.py - AI report generator → Document export: exports reports
app/ui/pages/ai_report_generator.py - Experiment workflow → Experiment records: reads and writes
app/services/experiment_service.py - Inventory traceability → Reagent and equipment records: reads and writes
app/services/inventory_service.py - Project management → Project records: reads and writes
app/services/project_service.py - Protocol management → Protocol records: reads and writes
app/services/protocol_service.py - Saved reports → Report records: reads and writes
app/services/report_service.py - Experiment records → SQLite store: queries
app/repositories/experiment_repository.py - Reagent and equipment records → SQLite store: queries
app/repositories/reagent_repository.py - Project records → SQLite store: queries
- Protocol records → SQLite store: queries
- Report records → SQLite store: queries
- AI drafting → Ollama client: uses client
app/services/ai_service.py - Ollama client → Local Ollama model: sends prompts
- Document export → Experiment records: reads experiment
app/services/export_service.py - Document export → Reagent and equipment records: reads resources
app/services/export_service.py - Document export → Project records: reads project
app/services/export_service.py - Document export → Protocol records: reads protocol
app/services/export_service.py - Document export → Attachments: reads attachments
app/services/export_service.py - Document export → Report records: reads reports
app/services/export_service.py - Document export → Markdown PDF DOCX: writes files
app/services/export_service.py