How tharik1305/kallvettu works
Kallvettu is a scholarly epigraphy platform: researchers submit an inscription image or curated/manual reading, enhance the image, compare OCR evidence, review the transcription, and obtain translations and historical interpretation. The workbench also supports lexical analysis, research storage and review, search, visual exploration, geographic context, and scholarly exports. The README documents the broad workflow and capabilities; sampled source supports key module responsibilities, but not every runtime connection, so uncertain subsystem links are omitted.
Main entry points: app.py Inscription workbench · api/app.py Research API · provider_manager.py OCR provider manager · repository.py Research repository
Components 21
Workbench and workflow
- Inscription workbench
app.py
Image reading and language
- Image restoration
restoration_engine.py - OCR provider manager
services/ai/common/provider_manager.py - OCR providers
services/ai - OCR comparison
services/ai/common/comparison_engine.py - Evidence fusion
services/ocr_fusion/fusion_engine.py - Scholar adjudication
services/ocr_fusion/researcher_review.py - Tamil NLP and translation
nlp_translation_engine.py
Scholarly research
- Classical dictionary
services/nlp/classical_dictionary.py - Research database
services/database/models.py - Research repository
services/database/repository.py - Collaborative review
services/collaboration/review_service.py - Glyph dataset
services/research/historical_glyph_dataset.py - Research evaluation
services/evaluation/research_benchmark.py
Exploration and export
- Epigraphical search
services/search/search_engine.py - Historical knowledge graph
services/knowledge_graph/graph_engine.py - Geographic atlas
services/geo_atlas - IIIF deep zoom
services/iiif/viewer_component.py - EpiDoc and research bundles
services/epidoc/bundle.py - Research API
services/api/app.py
Other components
- Researcher
Connections 23
- Researcher → Inscription workbench: submits inscription
- Inscription workbench → Image restoration: restores image
app.py - Inscription workbench → OCR provider manager: requests OCR
app.py - OCR provider manager → OCR providers: dispatches to
services/ai/common/provider_manager.py - Inscription workbench → OCR comparison: compares readings
app.py - Inscription workbench → Evidence fusion: fuses evidence
- Inscription workbench → Scholar adjudication: supports adjudication
app.py - Inscription workbench → Tamil NLP and translation: translates and interprets
app.py - Inscription workbench → Classical dictionary: offers lexical analysis
- Inscription workbench → Research repository: records research
- Research repository → Research database: persists records
services/database/repository.py - Inscription workbench → Collaborative review: supports review
- Inscription workbench → Glyph dataset: supports annotation
- Inscription workbench → Research evaluation: runs benchmarks
- Inscription workbench → Epigraphical search: searches corpus
- Inscription workbench → Historical knowledge graph: visualizes context
- Inscription workbench → Geographic atlas: maps sites
app.py - Inscription workbench → IIIF deep zoom: opens deep zoom
app.py - Inscription workbench → EpiDoc and research bundles: exports archives
app.py - Researcher → Research API: queries catalog
services/api/app.py - Research API → Epigraphical search: provides search
services/api/app.py - Research API → EpiDoc and research bundles: serves bundles
services/api/app.py - Research API → IIIF deep zoom: serves manifests
services/api/app.py