# ifpintac/tequila architecture

> Architecture diagram of the GitHub repository ifpintac/tequila, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ifpintac/tequila
- Repository: https://github.com/ifpintac/tequila

## Overview

Tequila is a desktop product-rendering application: users import a CAD or 3D model, edit its scene, materials, UVs, lighting and camera, then render and export images or shareable 3D output. The desktop app also exposes scripting, AI assistance and network rendering. The graph preserves major README capabilities and core indexed modules; many implementation files were not sampled, so documented relationships use README evidence and uncertain internal links are omitted.

Main entry points: [`app/src/main.rs`](https://github.com/ifpintac/tequila/blob/main/app/src/main.rs) (Tequila desktop), [`app/src/orchestrator.rs`](https://github.com/ifpintac/tequila/blob/main/app/src/orchestrator.rs) (Render orchestration), [`app/src/field.rs`](https://github.com/ifpintac/tequila/blob/main/app/src/field.rs) (Shared interface), [`crates/tequila-import/src/lib.rs`](https://github.com/ifpintac/tequila/blob/main/crates/tequila-import/src/lib.rs) (Model import)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop application"]
  node_desktop["Tequila desktop<br/>[main.rs]"]
  node_ui["Shared interface<br/>[field.rs]"]
  node_theme["Themes and icons<br/>[theme.rs]"]
end

subgraph group_scene["Scene authoring"]
  node_project["Project state<br/>[project.rs]"]
  node_import["Model import<br/>[lib.rs]"]
  node_iges["IGES reader<br/>[iges.rs]"]
  node_materials["Material graphs<br/>[graph.rs]"]
  node_library["Material library<br/>[library_tab.rs]"]
  node_uv["UV editing<br/>[mod.rs]"]
  node_lighting["Lighting and camera<br/>[lighting_tab.rs]"]
  node_studio["Studio presets<br/>[studio_tab.rs]"]
end

subgraph group_render["Rendering and output"]
  node_renderui["Render controls<br/>[cycles_view.rs]"]
  node_orchestrator["Render orchestration<br/>[orchestrator.rs]"]
  node_pathtracer["Path tracer<br/>[integrator.rs]"]
  node_cycles["Cycles renderer<br/>[translate.rs]"]
  node_outputs["Export and sharing<br/>[lib.rs]"]
  node_batch["Batch rendering<br/>[batch.rs]"]
end

subgraph group_services["Extensions and automation"]
  node_network["Network rendering<br/>[worker.rs]"]
  node_scripting["Python scripting<br/>[server.rs]"]
  node_assistant["AI assistant<br/>[assistant.rs]"]
  node_agents["Assistant agents"]
  node_plugins["Python plugins<br/>[plugins.rs]"]
end

node_user(("Product artist"))

node_user -->|"edits scene"| node_desktop
node_desktop -->|"imports models"| node_import
node_import -->|"reads IGES"| node_iges
node_desktop -->|"edits project"| node_project
node_user -->|"assigns materials"| node_materials
node_user -->|"edits UVs"| node_uv
node_user -->|"sets lighting"| node_lighting
node_user -->|"applies presets"| node_studio
node_user -->|"starts render"| node_renderui
node_renderui -->|"coordinates frames"| node_orchestrator
node_orchestrator -.->|"renders scene"| node_pathtracer
node_orchestrator -.->|"dispatches render"| node_cycles
node_user -->|"exports results"| node_outputs
node_user -->|"queues variants"| node_batch
node_user -->|"renders remotely"| node_network
node_user -->|"scripts workflow"| node_scripting
node_user -->|"requests changes"| node_assistant
node_assistant -->|"uses agents"| node_agents
node_user -->|"runs extensions"| node_plugins
node_desktop -.->|"presents controls"| node_ui
node_ui -->|"uses styling"| node_theme

click node_desktop "https://github.com/ifpintac/tequila/blob/main/app/src/main.rs"
click node_ui "https://github.com/ifpintac/tequila/blob/main/app/src/field.rs"
click node_theme "https://github.com/ifpintac/tequila/blob/main/app/src/theme.rs"
click node_project "https://github.com/ifpintac/tequila/blob/main/app/src/project.rs"
click node_import "https://github.com/ifpintac/tequila/blob/main/crates/tequila-import/src/lib.rs"
click node_iges "https://github.com/ifpintac/tequila/blob/main/crates/tequila-import/src/iges.rs"
click node_materials "https://github.com/ifpintac/tequila/blob/main/crates/tequila-materials/src/graph.rs"
click node_library "https://github.com/ifpintac/tequila/blob/main/app/src/library_tab.rs"
click node_uv "https://github.com/ifpintac/tequila/blob/main/app/src/uv_editor/mod.rs"
click node_lighting "https://github.com/ifpintac/tequila/blob/main/app/src/lighting_tab.rs"
click node_studio "https://github.com/ifpintac/tequila/blob/main/app/src/studio_tab.rs"
click node_renderui "https://github.com/ifpintac/tequila/blob/main/app/src/cycles_view.rs"
click node_orchestrator "https://github.com/ifpintac/tequila/blob/main/app/src/orchestrator.rs"
click node_pathtracer "https://github.com/ifpintac/tequila/blob/main/crates/tequila-render-core/src/integrator.rs"
click node_cycles "https://github.com/ifpintac/tequila/blob/main/crates/tequila-render-cycles/src/translate.rs"
click node_outputs "https://github.com/ifpintac/tequila/blob/main/crates/tequila-format/src/lib.rs"
click node_batch "https://github.com/ifpintac/tequila/blob/main/app/src/batch.rs"
click node_network "https://github.com/ifpintac/tequila/blob/main/crates/tequila-network/src/worker.rs"
click node_scripting "https://github.com/ifpintac/tequila/blob/main/crates/tequila-scripting/src/server.rs"
click node_assistant "https://github.com/ifpintac/tequila/blob/main/app/src/assistant.rs"
click node_agents "https://github.com/ifpintac/tequila/blob/main/app/src/assistant_agents.rs"
click node_plugins "https://github.com/ifpintac/tequila/blob/main/app/src/plugins.rs"

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_desktop,node_ui,node_theme toneBlue
class node_project,node_import,node_iges,node_materials,node_library,node_uv,node_lighting,node_studio toneAmber
class node_renderui,node_orchestrator,node_pathtracer,node_cycles,node_outputs,node_batch toneMint
class node_network,node_scripting,node_assistant,node_agents,node_plugins toneRose
class node_user toneIndigo
```

## Components

### Desktop application

- [Tequila desktop](https://github.com/ifpintac/tequila/blob/main/app/src/main.rs): `app/src/main.rs`
- [Shared interface](https://github.com/ifpintac/tequila/blob/main/app/src/field.rs): `app/src/field.rs`
- [Themes and icons](https://github.com/ifpintac/tequila/blob/main/app/src/theme.rs): `app/src/theme.rs`

### Scene authoring

- [Project state](https://github.com/ifpintac/tequila/blob/main/app/src/project.rs): `app/src/project.rs`
- [Model import](https://github.com/ifpintac/tequila/blob/main/crates/tequila-import/src/lib.rs): `crates/tequila-import/src/lib.rs`
- [IGES reader](https://github.com/ifpintac/tequila/blob/main/crates/tequila-import/src/iges.rs): `crates/tequila-import/src/iges.rs`
- [Material graphs](https://github.com/ifpintac/tequila/blob/main/crates/tequila-materials/src/graph.rs): `crates/tequila-materials/src/graph.rs`
- [Material library](https://github.com/ifpintac/tequila/blob/main/app/src/library_tab.rs): `app/src/library_tab.rs`
- [UV editing](https://github.com/ifpintac/tequila/blob/main/app/src/uv_editor/mod.rs): `app/src/uv_editor/mod.rs`
- [Lighting and camera](https://github.com/ifpintac/tequila/blob/main/app/src/lighting_tab.rs): `app/src/lighting_tab.rs`
- [Studio presets](https://github.com/ifpintac/tequila/blob/main/app/src/studio_tab.rs): `app/src/studio_tab.rs`

### Rendering and output

- [Render controls](https://github.com/ifpintac/tequila/blob/main/app/src/cycles_view.rs): `app/src/cycles_view.rs`
- [Render orchestration](https://github.com/ifpintac/tequila/blob/main/app/src/orchestrator.rs): `app/src/orchestrator.rs`
- [Path tracer](https://github.com/ifpintac/tequila/blob/main/crates/tequila-render-core/src/integrator.rs): `crates/tequila-render-core/src/integrator.rs`
- [Cycles renderer](https://github.com/ifpintac/tequila/blob/main/crates/tequila-render-cycles/src/translate.rs): `crates/tequila-render-cycles/src/translate.rs`
- [Export and sharing](https://github.com/ifpintac/tequila/blob/main/crates/tequila-format/src/lib.rs): `crates/tequila-format/src/lib.rs`
- [Batch rendering](https://github.com/ifpintac/tequila/blob/main/app/src/batch.rs): `app/src/batch.rs`

### Extensions and automation

- [Network rendering](https://github.com/ifpintac/tequila/blob/main/crates/tequila-network/src/worker.rs): `crates/tequila-network/src/worker.rs`
- [Python scripting](https://github.com/ifpintac/tequila/blob/main/crates/tequila-scripting/src/server.rs): `crates/tequila-scripting/src/server.rs`
- [AI assistant](https://github.com/ifpintac/tequila/blob/main/app/src/assistant.rs): `app/src/assistant.rs`
- [Assistant agents](https://github.com/ifpintac/tequila/blob/main/app/src/assistant_agents.rs): `app/src/assistant_agents.rs`
- [Python plugins](https://github.com/ifpintac/tequila/blob/main/app/src/plugins.rs): `app/src/plugins.rs`

### Other components

- **Product artist**

## Connections

- Product artist → Tequila desktop: edits scene (evidence: `README.md`)
- Tequila desktop → Model import: imports models (evidence: `README.md`)
- Model import → IGES reader: reads IGES (evidence: `crates/tequila-import/src/lib.rs`)
- Tequila desktop → Project state: edits project (evidence: `app/src/main.rs`)
- Product artist → Material graphs: assigns materials (evidence: `README.md`)
- Product artist → UV editing: edits UVs (evidence: `README.md`)
- Product artist → Lighting and camera: sets lighting (evidence: `README.md`)
- Product artist → Studio presets: applies presets (evidence: `README.md`)
- Product artist → Render controls: starts render (evidence: `README.md`)
- Render controls → Render orchestration: coordinates frames (evidence: `app/src/orchestrator.rs`)
- Render orchestration → Path tracer: renders scene
- Render orchestration → Cycles renderer: dispatches render
- Product artist → Export and sharing: exports results (evidence: `README.md`)
- Product artist → Batch rendering: queues variants (evidence: `README.md`)
- Product artist → Network rendering: renders remotely (evidence: `README.md`)
- Product artist → Python scripting: scripts workflow (evidence: `README.md`)
- Product artist → AI assistant: requests changes (evidence: `app/src/assistant.rs`)
- AI assistant → Assistant agents: uses agents (evidence: `app/src/assistant.rs`)
- Product artist → Python plugins: runs extensions (evidence: `README.md`)
- Tequila desktop → Shared interface: presents controls (evidence: `app/src/main.rs`)
- Shared interface → Themes and icons: uses styling (evidence: `app/src/theme.rs`)
