desktop/README.es.md

Hanzo

Crear poderosos agentes de IA usando AIS locales o remotos

construir agentes de IA colaborativos que trabajen juntos, manejen pagos y automatice flujos de trabajo complejos
Hanzo es una plataforma gratuita de código abierto que democratiza la creación de agentes de IA. No se requiere codificación: solo arrastre, suelte e implementa agentes inteligentes que puedan trabajar en plataformas y manejar tareas del mundo real.

Lea esto en: chino simplificado | cantonés | coreano | japonés | Español

características • demo • ejemplos • inicio rápido • desarrollo • Documentación

---

🚀 Características

** 🎯 🎯 Corriente de agentes sin código **: cree agentes de IA especializados en minutos a través de una interfaz visual intuitiva.No se necesita experiencia de programación.

** 🤖 Orquestación de múltiples agentes **: implementa equipos de agentes que colaboran, comparten contexto y coordinan flujos de trabajo múltiples complejos automáticamente.

** 💰 Arquitectura cripto-nativa **-Soporte incorporado para pagos descentralizados, interacciones defi y agentes económicos autónomos que pueden realizar transacciones de forma independiente.

** 🔗 Soporte de protocolo universal ** - Se integra perfectamente con el Protocolo de contexto del modelo (MCP), lo que hace que sus agentes compatibles con Claude, el cursor y el ecosistema de IA más amplio.

** ⚡ Implementación híbrida ** - Ejecute todo localmente para obtener la máxima privacidad, conectarse a modelos en la nube para capacidades mejoradas o combinar ambos enfoques según sea necesario.

** 🔐 Diseño de seguridad **: sus claves criptográficas, datos confidenciales y cálculos permanecen bajo su control con la arquitectura local primero.

** 🌐 Compatibilidad multiplataforma **-funciona en Windows, MacOS y Linux con rendimiento constante y experiencia en el usuario.

🎬 demostración

/

_ Los agentes de Hanzo de observación colaboran para analizar los datos del mercado, ejecutar operaciones y administrar flujos de trabajo complejos de forma autónoma.

📋 Ejemplos

** 💹 Bot de comercio autónomo **: implementa un agente que monitorea el sentimiento social, analiza las tendencias del mercado y ejecuta operaciones basadas en estrategias predefinidas.

** 📧 Asistente de correo electrónico inteligente **: cree un agente que clasifique los correos electrónicos entrantes, redacte las respuestas contextuales y programen automáticamente los seguimientos.

** 📊 Agente de inteligencia de datos **: construya agentes que raspe los datos web, realicen análisis de tendencias y generen informes integrales con información procesable.

** Hub de automatización de flujo de trabajo ** - Orquestan múltiples agentes especializados que manejan diferentes componentes de procesos comerciales complejos sin problemas.

** 🏦 Defi Portfolio Manager ** - Configurar agentes que monitorean sus inversiones criptográficas, carteras de reequilibrio y ejecutan estrategias de agricultura de rendimiento.

🚀 Inicio rápido

Instalación de un solo clic

1. ** Descargar ** La última versión para su plataforma desde nuestra [página de comunicados] (https://github.com/dcspark/hanzo-desktop/releases)
2. ** Instalar ** y lanzar Hanzo
3. ** Crear ** Su primer agente de IA usando nuestra interfaz guiada paso a paso

Requisitos del sistema

• ** Memoria **: Mínimo de 4 GB de RAM (recomendado 8GB)
• ** Almacenamiento **: espacio libre de 2 GB
• ** OS **: Windows 10+, MacOS 10.15+ o Linux (Ubuntu 20.04+)

---

🛠 Desarrollo

Descripción general de la arquitectura

Hanzo se construye como un monoreso moderno que usa ** nx ** para la orquestación y la gestión de dependencias.La arquitectura consiste en:

** Aplicaciones centrales: **

-** Hanzo-desktop **-Aplicación Tauri de plataforma cruzada con React Frontend

** Bibliotecas compartidas: **

-** Hanzo-Message-TS -Protocolos de mensajes y comunicación de red con Hanzo Node - Hanzo-Node-State **-Gestión de estado basada en consultas de reacción para datos de nodo

• ** Hanzo-ui **- Componentes reactivos reutilizables con sistema de diseño
• ** Hanzo-Artifacts **- Primitivas de usuario de estilo construidas en Radix y CSS de viento de cola
• ** Hanzo-i18n **- Utilidades de internacionalización impulsadas por i18Next

** Pila de tecnología: **

• ** Frontend **: React 18, mecanografiado, Tailwind CSS, Radix UI
• ** Desktop **: Tauri (Rust + React)
• ** Gestión de estado **: Zustand (UI State) + React Consulter (Estado del servidor)
• ** Sistema de construcción **: VITE, NX MONOREPO
• ** Pruebas **: Biblioteca de pruebas de reacción de Vitest, React

🚀 Comenzando

1. Clon y configuración

git clone https://github.com/hanzo-ai/hanzo-desktop
cd hanzo-desktop
nvm use
npm ci

2. Descargue los binarios laterales requeridos

Antes de ejecutar Hanzo, deberá descargar el binario de nodo Hanzo incrustado que alimenta la funcionalidad central de la aplicación.Esto se puede hacer con un solo comando basado en su plataforma:

** MacOS (Silicón de Apple): **

ARCH="aarch64-apple-darwin" \
HANZO_NODE_VERSION="v1.1.20" \
OLLAMA_VERSION="v0.12.3" \
npx ts-node ./ci-scripts/download-side-binaries.ts

** Linux: **

ARCH="x86_64-unknown-linux-gnu" \
OLLAMA_VERSION="v0.12.3" \
HANZO_NODE_VERSION="v1.1.20" \
npx ts-node ./ci-scripts/download-side-binaries.ts

** Windows: **

$ENV:OLLAMA_VERSION="v0.12.3"
$ENV:HANZO_NODE_VERSION="v1.1.20"
$ENV:ARCH="x86_64-pc-windows-msvc"
npx ts-node ./ci-scripts/download-side-binaries.ts

📦 Comandos esenciales

Servidor de desarrollo

# Run desktop app (recommended for development)
npx nx serve:tauri hanzo-desktop

Edificio

# Build desktop application
npx nx build hanzo-desktop

# Create development build
NODE_OPTIONS="--max_old_space_size=8192" npx nx build hanzo-desktop --config="./src-tauri/tauri.conf.development.json"

# Build all projects
npx nx run-many --target=build

Datos de terceros y gestión de repositorio

# Update the built-in Ollama models repository. This repository contains model definitions, tags and metadata for all supported AI models. The command below regenerates the repository files to ensure compatibility with the latest Ollama version and model updates
npx ts-node ./ci-scripts/generate-ollama-models-repository.ts

# Generate Composio apps repository - This script regenerates the repository of pre-built Composio apps and templates that users can import into Hanzo. It ensures the app catalog stays up-to-date with the latest official releases.
deno run -A ./ci-scripts/composio-repository/main.ts

# Generate translations for all languages (EN, ES, etc.)
# This command uses AI to automatically generate translations for all supported languages based on the primary i18n source file (English).
# It ensures consistent translations across the entire application while maintaining natural language quality.

npx nx run hanzo-i18n:i18n

Prueba y calidad

# Run tests
npx nx test [project-name]
npx nx run-many --target=test

# Lint code
npx nx lint [project-name]
npx nx run-many --target=lint

🏗 Estructura del proyecto

hanzo-desktop/
├── apps/
│   └── hanzo-desktop/          # Main desktop application
├── libs/
│   ├── hanzo-message-ts/       # Core messaging protocol
│   ├── hanzo-node-state/       # State management
│   ├── hanzo-ui/               # Component library
│   ├── hanzo-artifacts/        # UI primitives
│   └── hanzo-i18n/             # Internationalization
├── ci-scripts/                   # Build and deployment scripts
└── tools/                        # Development utilities

🎨 Directrices de desarrollo de la interfaz de usuario

** Bibliotecas de componentes: **

• ** Radix UI ** - Primitivas de componentes sin estilo y accesibles
• ** CSS **- Utilidad de estilo y diseño receptivo
• ** shadcn/ui **- Patrones de componentes previos a la construcción

** Gestión estatal: **

• ** Condición **- Gestión de estado de la interfaz de usuario del lado del cliente
• ** React Consulty ** - Estado del servidor, almacenamiento en caché y sincronización

🌍 Internacionalización

Hanzo admite múltiples idiomas a través de nuestro sistema i18n:

# Add new translation keys
# Edit files in libs/hanzo-i18n/locales/

# Generate updated translation types
npx nx run hanzo-i18n:i18n

# Supported languages: en-US, es-ES, zh-CN, zh-HK, ko-KR, ja-JP, id-ID, tr-TR

🤝 Contribuir

1. ** Hornada ** El repositorio
2. ** Crear ** Una rama de características: Git Checkout -B Feature/Amazing -Fature
3. ** Commit ** Sus cambios: `git commit -m 'agregue la función sorprendente' '
4. ** Push ** a la rama: Feature de origen de push Git/Amazing-Fature
5. ** Abierto ** Una solicitud de extracción

📚 Recursos adicionales

• ** [Documentación oficial] (https://docs.hanzo.ai) ** - Guías integrales y referencia de API
• ** [Discord Community] (https://discord.gg/eua45u3seu) ** - Obtenga ayuda y conéctese con otros desarrolladores
• ** [Actualizaciones de Twitter] (https://x.com/hanzolocalai) ** - Últimas noticias y anuncios

---

construido con ❤️ por la comunidad Hanzo
Licencia Apache • Informe de informe • función de solicitud