# ganarajpr/sanskrit-translator-dspy architecture

> Architecture diagram of the GitHub repository ganarajpr/sanskrit-translator-dspy, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ganarajpr/sanskrit-translator-dspy
- Repository: https://github.com/ganarajpr/sanskrit-translator-dspy

## Overview

This is a Sanskrit-to-English translation app whose documented workflow compiles a DSPy translation module with MIPRO and Ollama, then uses the compiled translator for translation. The source also shows example loading and cosine-similarity evaluation, plus a separate translation-accuracy metric. The FastAPI file excerpt only creates an app; it does not show a request route, so no API-to-translation flow is asserted. The graph covers documented capabilities, but some implementation details outside the excerpts remain unverified.

Main entry points: [`compile.py`](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/compile.py) (MIPRO compilation), [`evaluate.py`](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/evaluate.py) (Model evaluation), [`modules/TranslationModule.py`](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/modules/TranslationModule.py) (Translation module), [`setup.py`](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/setup.py) (Similarity metric)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_translation["Translation"]
  node_app["FastAPI app<br/>[main.py]"]
  node_module["Translation module"]
  node_signature["Translation signature"]
  node_ollama["Ollama model"]
end

subgraph group_optimization["Compilation"]
  node_compile["MIPRO compilation<br/>[compile.py]"]
  node_examples["Translation examples<br/>[translations.json]"]
  node_setup["Model and data helpers<br/>[setup.py]"]
  node_artifact["Compiled translator"]
end

subgraph group_evaluation["Evaluation"]
  node_checker["Accuracy signature"]
  node_similarity["Similarity metric<br/>[setup.py]"]
  node_embeddings["Ollama embeddings"]
  node_evaluate["Model evaluation<br/>[evaluate.py]"]
  node_savedmodels["Saved translators<br/>[translator.json]"]
end

node_user(("Translator user"))

node_module -->|"runs ChainOfThought"| node_signature
node_compile -->|"initializes model"| node_setup
node_compile -->|"loads examples"| node_examples
node_compile -->|"builds examples"| node_setup
node_compile -->|"compiles module"| node_module
node_compile -->|"configures task model"| node_ollama
node_compile -->|"checks accuracy"| node_checker
node_compile -->|"scores similarity"| node_similarity
node_similarity -->|"requests embeddings"| node_embeddings
node_compile -->|"saves program"| node_artifact
node_evaluate -->|"initializes model"| node_setup
node_evaluate -->|"loads evaluation set"| node_examples
node_evaluate -->|"evaluates translator"| node_module
node_evaluate -->|"loads translator"| node_savedmodels
node_evaluate -->|"loads compiled model"| node_artifact
node_evaluate -->|"scores similarity"| node_similarity
node_user -.->|"submits text"| node_app
node_user -.->|"requests translation"| node_module

click node_app "https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/main.py"
click node_module "https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/modules/TranslationModule.py"
click node_signature "https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/signatures/TranslationSignature.py"
click node_compile "https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/compile.py"
click node_examples "https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/examples/translations.json"
click node_setup "https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/setup.py"
click node_checker "https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/signatures/CheckTranslationSignature.py"
click node_similarity "https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/setup.py"
click node_artifact "https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/translator-mipro.json"
click node_evaluate "https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/evaluate.py"
click node_savedmodels "https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/translator.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_module,node_signature,node_ollama,node_user toneBlue
class node_compile,node_examples,node_setup,node_artifact toneAmber
class node_checker,node_similarity,node_embeddings,node_evaluate,node_savedmodels toneMint
```

## Components

### Translation

- [FastAPI app](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/main.py): `main.py`
- [Translation module](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/modules/TranslationModule.py): `modules/TranslationModule.py`
- [Translation signature](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/signatures/TranslationSignature.py): `signatures/TranslationSignature.py`
- **Ollama model**

### Compilation

- [MIPRO compilation](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/compile.py): `compile.py`
- [Translation examples](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/examples/translations.json): `examples/translations.json`
- [Model and data helpers](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/setup.py): `setup.py`
- [Compiled translator](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/translator-mipro.json): `translator-mipro.json`

### Evaluation

- [Accuracy signature](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/signatures/CheckTranslationSignature.py): `signatures/CheckTranslationSignature.py`
- [Similarity metric](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/setup.py): `setup.py`
- **Ollama embeddings**
- [Model evaluation](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/evaluate.py): `evaluate.py`
- [Saved translators](https://github.com/ganarajpr/sanskrit-translator-dspy/blob/master/translator.json): `translator.json`

### Other components

- **Translator user**

## Connections

- Translation module → Translation signature: runs ChainOfThought (evidence: `modules/TranslationModule.py`)
- MIPRO compilation → Model and data helpers: initializes model (evidence: `compile.py`)
- MIPRO compilation → Translation examples: loads examples (evidence: `compile.py`)
- MIPRO compilation → Model and data helpers: builds examples (evidence: `compile.py`)
- MIPRO compilation → Translation module: compiles module (evidence: `compile.py`)
- MIPRO compilation → Ollama model: configures task model
- MIPRO compilation → Accuracy signature: checks accuracy (evidence: `compile.py`)
- MIPRO compilation → Similarity metric: scores similarity (evidence: `compile.py`)
- Similarity metric → Ollama embeddings: requests embeddings (evidence: `setup.py`)
- MIPRO compilation → Compiled translator: saves program (evidence: `compile.py`)
- Model evaluation → Model and data helpers: initializes model (evidence: `evaluate.py`)
- Model evaluation → Translation examples: loads evaluation set (evidence: `evaluate.py`)
- Model evaluation → Translation module: evaluates translator (evidence: `evaluate.py`)
- Model evaluation → Saved translators: loads translator (evidence: `evaluate.py`)
- Model evaluation → Compiled translator: loads compiled model (evidence: `evaluate.py`)
- Model evaluation → Similarity metric: scores similarity (evidence: `evaluate.py`)
- Translator user → FastAPI app: submits text
- Translator user → Translation module: requests translation (evidence: `README.md`)
