# chiaramadera/agentes-ia architecture

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

- Interactive diagram: https://gitdiagram.com/chiaramadera/agentes-ia
- Repository: https://github.com/chiaramadera/agentes-ia

## Overview

AgentesIA is a Java desktop application that lets a user choose a code-generation or Spanish-translation agent, submit text, and receive a response from a local Ollama model. Main loads configuration and assembles the client and selected interface; agents construct task-specific prompts and use the shared LLM client. The README also documents streaming, cancellation, retries, and result export. Source excerpts were unavailable, so relationships and capabilities shown here are based on the README; unsampled implementation details are not inferred.

Main entry points: [`src/main/java/org/example/client/OllamaClient.java`](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/client/OllamaClient.java) (Ollama adapter), [`src/main/java/org/example/Main.java`](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/Main.java) (Main), [`src/main/java/org/example/agents/desarrollo/GeneratorCodeAgent.java`](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/agents/desarrollo/GeneratorCodeAgent.java) (Code generator), [`src/main/java/org/example/agents/texto/TranslatorTextAgent.java`](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/agents/texto/TranslatorTextAgent.java) (Text translator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_composition["Composition and config"]
  node_main["Main<br/>[Main.java]"]
  node_config["Config<br/>[Config.java]"]
  node_properties["App properties"]
end

subgraph group_interaction["User interfaces"]
  node_agentui["Swing UI<br/>[AgentUI.java]"]
  node_console["Console UI<br/>[Console.java]"]
end

subgraph group_agents["Agent workflow"]
  node_agenttype["Agent registry<br/>[AgentType.java]"]
  node_contract["Agent contract<br/>[IAgent.java]"]
  node_codeagent["Code generator"]
  node_codeprompt["Code prompt"]
  node_translator["Text translator"]
  node_textprompt["Translation prompt"]
end

subgraph group_model["Model integration"]
  node_llmclient["LLM client port<br/>[LlmClient.java]"]
  node_ollama["Ollama adapter<br/>[OllamaClient.java]"]
  node_requestdto["Request DTO<br/>[RequestDTO.java]"]
  node_responsedto["Response DTO<br/>[ResponseDTO.java]"]
end

node_user(("User"))
node_ollamaservice{{"Ollama model service"}}

node_user -->|"uses"| node_agentui
node_user -->|"uses"| node_console
node_main -->|"loads"| node_config
node_properties -->|"configures"| node_config
node_main -->|"assembles"| node_ollama
node_main -->|"injects into"| node_agentui
node_main -->|"injects into"| node_console
node_agentui -->|"selects via"| node_agenttype
node_console -->|"selects via"| node_agenttype
node_agenttype -->|"creates"| node_codeagent
node_agenttype -->|"creates"| node_translator
node_codeagent -->|"implements"| node_contract
node_translator -->|"implements"| node_contract
node_codeagent -->|"builds prompt"| node_codeprompt
node_translator -->|"builds prompt"| node_textprompt
node_codeagent -->|"calls"| node_llmclient
node_translator -->|"calls"| node_llmclient
node_ollama -->|"implements"| node_llmclient
node_ollama -->|"maps request"| node_requestdto
node_ollama -->|"maps response"| node_responsedto
node_ollama -->|"sends HTTP"| node_ollamaservice

click node_main "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/Main.java"
click node_config "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/config/Config.java"
click node_properties "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/resources/application.properties"
click node_agentui "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/ui/AgentUI.java"
click node_console "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/ui/Console.java"
click node_agenttype "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/agents/AgentType.java"
click node_contract "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/agents/IAgent.java"
click node_codeagent "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/agents/desarrollo/GeneratorCodeAgent.java"
click node_codeprompt "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/prompts/desarrollo/GeneratorCodePrompt.java"
click node_translator "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/agents/texto/TranslatorTextAgent.java"
click node_textprompt "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/prompts/texto/TranslatorTextPrompt.java"
click node_llmclient "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/client/LlmClient.java"
click node_ollama "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/client/OllamaClient.java"
click node_requestdto "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/dtos/RequestDTO.java"
click node_responsedto "https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/dtos/ResponseDTO.java"

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_main,node_config,node_properties,node_user toneBlue
class node_agentui,node_console toneAmber
class node_agenttype,node_contract,node_codeagent,node_codeprompt,node_translator,node_textprompt toneMint
class node_llmclient,node_ollama,node_requestdto,node_responsedto toneRose
class node_ollamaservice toneIndigo
```

## Components

### Composition and config

- [Main](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/Main.java): `src/main/java/org/example/Main.java`
- [Config](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/config/Config.java): `src/main/java/org/example/config/Config.java`
- [App properties](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/resources/application.properties): `src/main/resources/application.properties`

### User interfaces

- [Swing UI](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/ui/AgentUI.java): `src/main/java/org/example/ui/AgentUI.java`
- [Console UI](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/ui/Console.java): `src/main/java/org/example/ui/Console.java`

### Agent workflow

- [Agent registry](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/agents/AgentType.java): `src/main/java/org/example/agents/AgentType.java`
- [Agent contract](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/agents/IAgent.java): `src/main/java/org/example/agents/IAgent.java`
- [Code generator](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/agents/desarrollo/GeneratorCodeAgent.java): `src/main/java/org/example/agents/desarrollo/GeneratorCodeAgent.java`
- [Code prompt](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/prompts/desarrollo/GeneratorCodePrompt.java): `src/main/java/org/example/prompts/desarrollo/GeneratorCodePrompt.java`
- [Text translator](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/agents/texto/TranslatorTextAgent.java): `src/main/java/org/example/agents/texto/TranslatorTextAgent.java`
- [Translation prompt](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/prompts/texto/TranslatorTextPrompt.java): `src/main/java/org/example/prompts/texto/TranslatorTextPrompt.java`

### Model integration

- [LLM client port](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/client/LlmClient.java): `src/main/java/org/example/client/LlmClient.java`
- [Ollama adapter](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/client/OllamaClient.java): `src/main/java/org/example/client/OllamaClient.java`
- [Request DTO](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/dtos/RequestDTO.java): `src/main/java/org/example/dtos/RequestDTO.java`
- [Response DTO](https://github.com/chiaramadera/agentes-ia/blob/main/src/main/java/org/example/dtos/ResponseDTO.java): `src/main/java/org/example/dtos/ResponseDTO.java`

### Other components

- **User**
- **Ollama model service**

## Connections

- User → Swing UI: uses (evidence: `README.md`)
- User → Console UI: uses (evidence: `README.md`)
- Main → Config: loads (evidence: `README.md`)
- App properties → Config: configures (evidence: `README.md`)
- Main → Ollama adapter: assembles (evidence: `README.md`)
- Main → Swing UI: injects into (evidence: `README.md`)
- Main → Console UI: injects into (evidence: `README.md`)
- Swing UI → Agent registry: selects via (evidence: `README.md`)
- Console UI → Agent registry: selects via (evidence: `README.md`)
- Agent registry → Code generator: creates (evidence: `README.md`)
- Agent registry → Text translator: creates (evidence: `README.md`)
- Code generator → Agent contract: implements (evidence: `README.md`)
- Text translator → Agent contract: implements (evidence: `README.md`)
- Code generator → Code prompt: builds prompt (evidence: `README.md`)
- Text translator → Translation prompt: builds prompt (evidence: `README.md`)
- Code generator → LLM client port: calls (evidence: `README.md`)
- Text translator → LLM client port: calls (evidence: `README.md`)
- Ollama adapter → LLM client port: implements (evidence: `README.md`)
- Ollama adapter → Request DTO: maps request (evidence: `README.md`)
- Ollama adapter → Response DTO: maps response (evidence: `README.md`)
- Ollama adapter → Ollama model service: sends HTTP (evidence: `README.md`)
