desktop/README.ja.md

新島

ローカルまたはリモートAIを使用して強力なAIエージェントを作成する

共同作業、支払いを処理し、複雑なワークフローを自動化する共同AIエージェントを構築
Hanzoは、AIエージェントの作成を民主化する無料のオープンソースプラットフォームです。 コーディングは不要です。プラットフォーム全体で動作し、実際のタスクを処理できるインテリジェントエージェントをドラッグ、ドロップ、展開するだけです。

これを読む： 単純化された中国人 | 広東語 | 韓国 | 日本語 | español

feature • demo • 例• クイックスタート• 開発• ドキュメント

---

##🚀機能

🎯コードなしエージェントビルダー - 直感的な視覚インターフェイスを介して数分で特殊なAIエージェントを作成します。プログラミングの経験は必要ありません。

🤖マルチエージェントオーケストレーション - 協力し、コンテキストを共有し、複雑なマルチステップワークフローを自動的に調整するエージェントのチームを展開します。

** Crypto-Native Architecture ** - 独立して取引できる分散型支払い、Defi相互作用、および自律経済エージェントの組み込みサポート。

🔗ユニバーサルプロトコルサポート - モデルコンテキストプロトコル（MCP）とシームレスに統合され、エージェントがClaude、Cursor、およびより広いAIエコシステムと互換性があります。

⚡ハイブリッド展開 - 最大限のプライバシーのためにすべてをローカルで実行するか、強化された機能のためにクラウドモデルに接続するか、必要に応じて両方のアプローチを組み合わせます。

🔐セキュリティファーストデザイン - 暗号キー、機密データ、および計算は、ローカルファーストアーキテクチャで管理下にあります。

🌐クロスプラットフォーム互換性 - 一貫したパフォーマンスとユーザーエクスペリエンスを備えたWindows、MacO、Linuxで動作します。

demo

[！[デモビデオ]（Assets/hanzo-screenshot.png）]（https://github.com/user-attachments/assets/bc5b7da-7ca5-477d-838a-8239951b6c01）

_Watch Hanzo Agentsは、市場データを分析し、取引を実行し、複雑なワークフローを自律的に管理するために協力しています。

##📋例

💹自律的な取引ボット - 社会的感情を監視し、市場動向を分析し、事前定義された戦略に基づいて取引を実行するエージェントを展開します。

📧インテリジェントメールアシスタント - 着信電子メール、コンテキスト応答のドラフトを分類し、フォローアップを自動的にスケジュールするエージェントを作成します。

📊データインテリジェンスエージェント - Webデータをこする、トレンド分析を実行し、実用的な洞察を使用して包括的なレポートを生成するエージェントを構築します。

🔄ワークフローオートメーションハブ - 複雑なビジネスプロセスのさまざまなコンポーネントをシームレスに処理する複数の専門エージェントを調整します。

🏦DEFIポートフォリオマネージャー - 暗号投資、リバランスポートフォリオを監視するエージェントをセットアップし、農業戦略を実行します。

Quickクイックスタート

###ワンクリックインストール

1。 2。** **インストールして、Hanzoを起動します 3。

###システム要件

• メモリ：4GB RAM最小（8GB推奨）
• ストレージ：2GBの空きスペース
• ** OS **：Windows10+、MacOS 10.15+、またはLinux（Ubuntu 20.04+）

---

##🛠開発

###アーキテクチャの概要

シンカイは、オーケストレーションと依存管理の管理に** nx **を使用して、最新のモノレポとして構築されています。アーキテクチャは次のとおりです。

コアアプリケーション：

• ** Hanzo-Desktop ** - React Frontendを使用したクロスプラットフォームタウリアプリケーション

共有ライブラリ：

• ** Hanzo-Message-TS ** - メッセージプロトコルとHanzoノードとのネットワーク通信
• ** Hanzo-Node-State ** - ノードデータのクエリベースの状態管理を反応する
• ** Hanzo-ui ** - 設計システムを備えた再利用可能な反応コンポーネント
• ** Hanzo-Artifacts ** - RadixおよびTailwind CSSに構築されたスタイルのUIプリミティブ
• ** Hanzo-I18n ** - I18Nextを搭載した国際化ユーティリティ

テクノロジースタック：

• ** Frontend **：React 18、TypeScript、Tailwind CSS、RADIX UI
• デスクトップ：タウリ（Rust + React）
• 状態管理：Zustand（UI State） + Reactクエリ（サーバー状態）
• ビルドシステム：Vite、NX Monorepo
• テスト：Vitest、React Testing Library

1。クローンとセットアップ

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

2。必要なサイドバイナリをダウンロードします

Hanzoを実行する前に、アプリケーションのコア機能を駆動する埋め込まれたHanzoノードバイナリをダウンロードする必要があります。これは、プラットフォームに基づいて単一のコマンドで実行できます。

** macos（Apple Silicon）：**

ARCH="aarch64-apple-darwin" \
HANZO_NODE_VERSION="v1.1.18" \
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.18" \
npx ts-node ./ci-scripts/download-side-binaries.ts

** Windows：**

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

###.必須コマンド

####開発サーバー

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

＃＃＃＃ 建物

# 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

####サードパーティのデータとリポジトリ管理

# 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

####テストと品質

# 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

###🏗プロジェクト構造

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

ui開発ガイドライン

コンポーネントライブラリ：

• ** RADIX UI ** - スタイルのないアクセス可能なコンポーネントプリミティブ
• ** Tailwind CSS ** - ユーティリティファーストスタイリングとレスポンシブデザイン
• ** Shadcn/ui ** - 事前に構築されたコンポーネントパターン

州管理：

• 条件 - クライアント側のUI状態管理
• ** React Query ** - サーバー状態、キャッシュ、および同期

-Internationalization

Hanzoは、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

###貢献

1。** fork **リポジトリ 2 3。 4。ブランチへのプッシュ： gitプッシュオリジン機能/Amazing-feature 5。開くプルリクエスト

###📚追加リソース

• ** [公式ドキュメント]（https://docs.hanzo.ai）** - 包括的なガイドとAPIリファレンス
• ** [Discord Community]（https://discord.gg/eua45u3seu）** - ヘルプを取得して他の開発者とつながる
• ** [Twitterの更新]（https://x.com/hanzolocalai）** - 最新のニュースとアナウンス

---

Hanzoコミュニティによって❤§で構築されました
apacheライセンス• レポートbug • リクエスト機能