# ezeabadie/argenequip-agente architecture

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

- Interactive diagram: https://gitdiagram.com/ezeabadie/argenequip-agente
- Repository: https://github.com/ezeabadie/argenequip-agente

## Overview

ArgenEquip es un asistente conversacional para que un socio gestione alquileres en lenguaje natural. El flujo principal va desde la interfaz Streamlit, a través del agente con memoria y herramientas, hasta el cliente mock o la API de ArgenEquip; las escrituras requieren aprobación humana. Las herramientas también cubren consultas de resumen e historial y la generación de contratos PDF. Las conexiones se basan en los fragmentos disponibles y en relaciones explícitas del README; no se infieren llamadas entre subsistemas no muestreados.

Main entry points: [`argenequip_client.py`](https://github.com/ezeabadie/argenequip-agente/blob/main/argenequip_client.py) (Cliente mock o API), [`app.py`](https://github.com/ezeabadie/argenequip-agente/blob/main/app.py) (Interfaz Streamlit), [`agente.py`](https://github.com/ezeabadie/argenequip-agente/blob/main/agente.py) (Agente y memoria), [`tools.py`](https://github.com/ezeabadie/argenequip-agente/blob/main/tools.py) (Herramientas conversacionales)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Interacción"]
  node_streamlit["Interfaz Streamlit<br/>[app.py]"]
  node_approval["Aprobación humana<br/>[app.py]"]
end

subgraph group_agent["Agente e IA"]
  node_agent_runtime["Agente y memoria<br/>[agente.py]"]
  node_model_factory["Modelos y rotación<br/>[model.py]"]
end

subgraph group_operations["Operaciones de alquiler"]
  node_tools["Herramientas conversacionales<br/>[tools.py]"]
  node_rental_creation["Alta de alquiler<br/>[tools.py]"]
  node_rental_queries["Resumen e historial<br/>[tools.py]"]
  node_availability["Disponibilidad de equipos<br/>[tools.py]"]
  node_contract_data["Datos del contrato<br/>[tools.py]"]
  node_pdf_generator["Generador PDF<br/>[contrato.py]"]
end

subgraph group_integrations["Integraciones"]
  node_llm_provider{{"Proveedor de modelos"}}
  node_client_selector["Cliente mock o API"]
  node_rest_backend{{"API ArgenEquip"}}
  node_mysql[("MySQL")]
end

node_partner(("Socio"))

node_partner -->|"escribe y consulta"| node_streamlit
node_streamlit -->|"envía turnos"| node_agent_runtime
node_agent_runtime -->|"emite eventos"| node_streamlit
node_streamlit -->|"presenta decisión"| node_approval
node_approval -->|"reanuda turno"| node_agent_runtime
node_agent_runtime -->|"obtiene modelos"| node_model_factory
node_model_factory -->|"consulta"| node_llm_provider
node_agent_runtime -->|"registra herramientas"| node_tools
node_tools -->|"consulta y modifica"| node_client_selector
node_rental_creation -->|"prepara alta"| node_client_selector
node_rental_queries -->|"consulta alquileres"| node_client_selector
node_availability -->|"verifica stock"| node_client_selector
node_tools -->|"prepara datos"| node_contract_data
node_contract_data -->|"genera PDF"| node_pdf_generator
node_streamlit -->|"muestra datos"| node_client_selector
node_client_selector -.->|"usa API REST"| node_rest_backend
node_rest_backend -.->|"persiste en"| node_mysql

click node_streamlit "https://github.com/ezeabadie/argenequip-agente/blob/main/app.py"
click node_approval "https://github.com/ezeabadie/argenequip-agente/blob/main/app.py"
click node_agent_runtime "https://github.com/ezeabadie/argenequip-agente/blob/main/agente.py"
click node_model_factory "https://github.com/ezeabadie/argenequip-agente/blob/main/model.py"
click node_tools "https://github.com/ezeabadie/argenequip-agente/blob/main/tools.py"
click node_rental_creation "https://github.com/ezeabadie/argenequip-agente/blob/main/tools.py"
click node_rental_queries "https://github.com/ezeabadie/argenequip-agente/blob/main/tools.py"
click node_availability "https://github.com/ezeabadie/argenequip-agente/blob/main/tools.py"
click node_contract_data "https://github.com/ezeabadie/argenequip-agente/blob/main/tools.py"
click node_pdf_generator "https://github.com/ezeabadie/argenequip-agente/blob/main/contrato.py"
click node_client_selector "https://github.com/ezeabadie/argenequip-agente/blob/main/argenequip_client.py"

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_streamlit,node_approval toneBlue
class node_agent_runtime,node_model_factory toneAmber
class node_tools,node_rental_creation,node_rental_queries,node_availability,node_contract_data,node_pdf_generator toneMint
class node_llm_provider,node_client_selector,node_rest_backend,node_mysql toneRose
class node_partner toneIndigo
```

## Components

### Interacción

- [Interfaz Streamlit](https://github.com/ezeabadie/argenequip-agente/blob/main/app.py): `app.py`
- [Aprobación humana](https://github.com/ezeabadie/argenequip-agente/blob/main/app.py): `app.py`

### Agente e IA

- [Agente y memoria](https://github.com/ezeabadie/argenequip-agente/blob/main/agente.py): `agente.py`
- [Modelos y rotación](https://github.com/ezeabadie/argenequip-agente/blob/main/model.py): `model.py`

### Operaciones de alquiler

- [Herramientas conversacionales](https://github.com/ezeabadie/argenequip-agente/blob/main/tools.py): `tools.py`
- [Alta de alquiler](https://github.com/ezeabadie/argenequip-agente/blob/main/tools.py): `tools.py`
- [Resumen e historial](https://github.com/ezeabadie/argenequip-agente/blob/main/tools.py): `tools.py`
- [Disponibilidad de equipos](https://github.com/ezeabadie/argenequip-agente/blob/main/tools.py): `tools.py`
- [Datos del contrato](https://github.com/ezeabadie/argenequip-agente/blob/main/tools.py): `tools.py`
- [Generador PDF](https://github.com/ezeabadie/argenequip-agente/blob/main/contrato.py): `contrato.py`

### Integraciones

- **Proveedor de modelos**
- [Cliente mock o API](https://github.com/ezeabadie/argenequip-agente/blob/main/argenequip_client.py): `argenequip_client.py`
- **API ArgenEquip**
- **MySQL**

### Other components

- **Socio**

## Connections

- Socio → Interfaz Streamlit: escribe y consulta (evidence: `README.md`)
- Interfaz Streamlit → Agente y memoria: envía turnos (evidence: `app.py`)
- Agente y memoria → Interfaz Streamlit: emite eventos (evidence: `README.md`)
- Interfaz Streamlit → Aprobación humana: presenta decisión (evidence: `README.md`)
- Aprobación humana → Agente y memoria: reanuda turno (evidence: `README.md`)
- Agente y memoria → Modelos y rotación: obtiene modelos (evidence: `agente.py`)
- Modelos y rotación → Proveedor de modelos: consulta (evidence: `README.md`)
- Agente y memoria → Herramientas conversacionales: registra herramientas (evidence: `agente.py`)
- Herramientas conversacionales → Cliente mock o API: consulta y modifica (evidence: `tools.py`)
- Alta de alquiler → Cliente mock o API: prepara alta (evidence: `README.md`)
- Resumen e historial → Cliente mock o API: consulta alquileres (evidence: `README.md`)
- Disponibilidad de equipos → Cliente mock o API: verifica stock (evidence: `tools.py`)
- Herramientas conversacionales → Datos del contrato: prepara datos (evidence: `tools.py`)
- Datos del contrato → Generador PDF: genera PDF (evidence: `tools.py`)
- Interfaz Streamlit → Cliente mock o API: muestra datos (evidence: `app.py`)
- Cliente mock o API → API ArgenEquip: usa API REST (evidence: `README.md`)
- API ArgenEquip → MySQL: persiste en (evidence: `README.md`)
