admin/openhuman
1
0
Fork 0
mirror of https://github.com/tinyhumansai/openhuman.git synced 2026-07-27 21:08:00 +00:00
Code Issues Packages Projects Releases Wiki Activity

Docs/overhaul readme gitbooks (#4225)

Browse Source
This commit is contained in:
Steven Enamakel
2026-06-26 13:02:55 -07:00
committed by GitHub
parent 1a676c6d44
commit 5a41a4f0d2
76 changed files with 1900 additions and 7755 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/README.de.md
+151
View File
@@ -0,0 +1,151 @@
<p align="center">
🇺🇸 <a href="../README.md">English</a> | 🇨🇳 <a href="./README.zh-CN.md">简体中文</a> | 🇯🇵 <a href="./README.ja-JP.md">日本語</a> | 🇰🇷 <a href="./README.ko.md">한국어</a> | 🇩🇪 <a href="./README.de.md">Deutsch</a> | 🇵🇰 <a href="./README.ur-pk.md">اردو</a>
</p>
<h1 align="center">OpenHuman</h1>
<p align="center">
<img src="../gitbooks/.gitbook/assets/demo.png" alt="The Tet" />
</p>
<p align="center" style="display: inline-block">
<a href="https://trendshift.io/repositories/23680" target="_blank" style="display: inline-block">
<img src="https://trendshift.io/api/badge/repositories/23680" alt="tinyhumansai%2Fopenhuman | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>
</a>
&nbsp;
<a href="https://www.producthunt.com/products/openhuman?embed=true&amp;utm_source=badge-top-post-badge&amp;utm_medium=badge&amp;utm_campaign=badge-openhuman" target="_blank" rel="noopener noreferrer">
<img alt="OpenHuman - An open source AI harness built with the human in mind | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1136902&amp;theme=light&amp;period=daily&amp;t=1778916022823">
</a>
</p>
<p align="center">
<strong>OpenHuman ist deine persönliche KI-Superintelligenz: Lokaler Speicher, verwaltete Dienste wo nötig, schlicht und mächtig.</strong>
</p>
<p align="center">
<a href="https://discord.tinyhumans.ai/">Discord</a> •
<a href="https://www.reddit.com/r/tinyhumansai/">Reddit</a> •
<a href="https://x.com/intent/follow?screen_name=tinyhumansai">X/Twitter</a> •
<a href="https://tinyhumans.gitbook.io/openhuman/">Doku</a> •
<a href="https://x.com/intent/follow?screen_name=senamakel">@senamakel folgen (Creator)</a>
</p>
<p align="center">
<img src="https://img.shields.io/badge/status-early%20beta-orange" alt="Frühe Beta" />
<a href="https://github.com/tinyhumansai/openhuman/releases/latest"><img src="https://img.shields.io/github/v/release/tinyhumansai/openhuman?label=latest" alt="Aktuellste Version" /></a>
<a href="https://github.com/tinyhumansai/openhuman/stargazers"><img src="https://img.shields.io/github/stars/tinyhumansai/openhuman?style=flat" alt="GitHub Stars" /></a>
<a href="../LICENSE"><img src="https://img.shields.io/github/license/tinyhumansai/openhuman" alt="Lizenz" /></a>
<a href="../README.md"><img src="https://img.shields.io/badge/lang-English-blue" alt="English" /></a>
<a href="./README.zh-CN.md"><img src="https://img.shields.io/badge/lang-简体中文-blue" alt="简体中文" /></a>
<a href="./README.ja-JP.md"><img src="https://img.shields.io/badge/lang-日本語-blue" alt="日本語" /></a>
<a href="./README.ko.md"><img src="https://img.shields.io/badge/lang-한국어-blue" alt="한국어" /></a>
<a href="./README.de.md"><img src="https://img.shields.io/badge/lang-Deutsch-blue" alt="Deutsch" /></a>
<a href="./README.ur-pk.md"><img src="https://img.shields.io/badge/lang-اردو-blue" alt="اردو" /></a>
</p>
> **Frühe Beta**: Wird aktiv weiterentwickelt. Mit Ecken und Kanten ist zu rechnen.
> **Lokal + verwaltete Dienste, upfront:** OpenHuman speichert seinen Memory Tree, Obsidian-Style-Markdown-Vault, Workspace-Konfiguration und lokalen Laufzeitstatus auf deiner Maschine. Die standardmäßige verwaltete Erfahrung nutzt weiterhin OpenHuman-gehostete Dienste für Account-Anmeldung, Model-Routing, Web-Search-Proxying und verwaltete Integration/OAuth-Flows über die Composio-Connector-Schicht. Wähle benutzerdefinierte/lokale Einstellungen, wenn du dein eigenes Modell, deine eigene Suche oder Composio-Credentials mitbringen möchtest; einige Echtzeit-Trigger und gehostete Funktionen erfordern weiterhin das verwaltete Backend.
Für Installation und Einstieg lade die App von [tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman?utm_source=github&utm_medium=readme) herunter oder führe im Terminal aus:
```bash
# DMG/EXE über https://tinyhumans.ai/openhuman herunterladen oder direkt im Terminal:
# macOS oder Linux x64
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
# Windows
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex
```
<!-- TODO: translate (de) — English source mirrored from README.md so non-EN readers get the same install caveats. Please translate. -->
> **Linux:** the AppImage can crash on launch under Wayland (and on Arch-based distros with `sharun: Interpreter not found!`) — see [#2463](https://github.com/tinyhumansai/openhuman/issues/2463) for the cause and env-var workarounds.
Arch Linux package maintainers can use the [`openhuman-bin` AUR recipe](../packages/arch/openhuman-bin/);
once published, Arch users can install it with `yay -S openhuman-bin`.
<!-- /TODO -->
# Was ist OpenHuman?
OpenHuman ist ein quelloffener, agentenbasierter Assistent, der sich in deinen Alltag einfügt. Jeder Punkt verlinkt auf die ausführliche Beschreibung in der [Doku](https://tinyhumans.gitbook.io/openhuman/).
- **Schlicht, UI-zuerst & menschlich** — Eine aufgeräumte Desktop-Erfahrung und kurze Onboarding-Pfade bringen dich in wenigen Klicks von der Installation zum laufenden Agenten — keine Config-First-Einrichtung, kein Terminal nötig. Der Agent hat [ein Gesicht](https://tinyhumans.gitbook.io/openhuman/features/mascot): ein Desktop-Maskottchen, das spricht, auf seine Umgebung reagiert, als echter Teilnehmer [in deinen Google-Meets sitzt](https://tinyhumans.gitbook.io/openhuman/features/mascot/meeting-agents), sich über Wochen an dich erinnert und im Hintergrund weiterdenkt, auch wenn du längst nicht mehr tippst.
- **[118+ Drittanbieter-Integrationen](https://tinyhumans.gitbook.io/openhuman/features/integrations) mit [Auto-Fetch](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch)**: Gmail, Notion, GitHub, Slack, Stripe, Calendar, Drive, Linear, Jira und der Rest deines Stacks per **Ein-Klick-OAuth** anbinden. Jede Verbindung wird dem Agenten als typisiertes Tool freigegeben, und alle zwanzig Minuten geht der Core durch jede aktive Verbindung und zieht frische Daten in den [Memory Tree](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch). Keine Prompts, keine Polling-Schleifen, die du selbst schreiben musst — der Agent hat morgens schon den Kontext für den Tag.
Verwaltete Integrationen nutzen OpenHumans Composio-Connector-Schicht. OAuth-Handshakes und Integration-Tool-Calls werden standardmäßig über das verwaltete Backend geproxied. Wenn du stattdessen Composio direkt betreiben möchtest, konfiguriere den Direktmodus mit deinem eigenen Composio-API-Key; Echtzeit-Trigger-Webhooks müssen dann von dir selbst gehostet und verkabelt werden.
- **[Memory Tree](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian-Wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)**: eine lokal-zentrierte Wissensbasis, aufgebaut aus deinen Daten und deinen Aktivitäten. Alles, was du verbindest, wird in Markdown-Chunks von ≤3k Tokens kanonisiert, bewertet und in hierarchische Zusammenfassungs-Bäume gefaltet, gespeichert in **SQLite auf deiner Maschine**. Dieselben Chunks landen als `.md`-Dateien in einem Obsidian-kompatiblen Vault, das du öffnen, durchstöbern und editieren kannst — inspiriert von Karpathys [obsidian-wiki-Workflow](https://x.com/karpathy/status/2039805659525644595).
- **Alles eingebaut**: Web-Suche, ein Web-Fetch-[Scraper](https://tinyhumans.gitbook.io/openhuman/features/native-tools), ein vollständiges Coder-Toolset (Dateisystem, Git, Lint, Test, Grep) und [native Sprache](https://tinyhumans.gitbook.io/openhuman/features/voice) (STT als Eingabe, ElevenLabs TTS als Ausgabe, Lippensynchronisation für das Maskottchen, Live-Google-Meet-Agent) sind ab Werk verdrahtet. Standardmäßig nutzt [Model-Routing](https://tinyhumans.gitbook.io/openhuman/features/model-routing) das OpenHuman-Backend, um das passende LLM für jede Workload auszuwählen und zu proxien (Reasoning, Fast oder Vision). Ein Abo umfasst alle Modelle. Keine "erst-ein-Plugin-installieren-um-Dateien-zu-lesen"-Hürde. [Optional lokale KI über Ollama](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai) für On-Device-Workloads.
- **[Smarte Token-Kompression (TokenJuice)](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: Jeder Tool-Aufruf, jedes Scrape-Ergebnis, jeder E-Mail-Text und jeder Such-Payload läuft durch eine Token-Kompressionsschicht, bevor er ein LLM-Modell erreicht. HTML wird zu Markdown konvertiert, lange URLs werden gekürzt, und ausschweifende Tool-Ausgaben werden über eine konfigurierbare Regel-Ebene dedupliziert und zusammengefasst usw. CJK, Emojis und andere Multi-Byte-Texte bleiben Graphem für Graphem erhalten — niemals abgeschnitten. Du erhältst dieselbe Information bei einem Bruchteil der Tokens. Kosten und Latenz sinken um bis zu 80%.
- **[Messaging-Kanäle](https://tinyhumans.gitbook.io/openhuman/features/integrations#messaging-channels)** und **[Privatsphäre & Sicherheit](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: ein- und ausgehend über die Kanäle, die du ohnehin nutzt — Workflow-Daten bleiben auf dem Gerät, lokal verschlüsselt, und gehören dir.
## Beitragen aus dem Quellcode
Neu hier? Beginne mit [`CONTRIBUTING.md`](../CONTRIBUTING.md) für den Fork-/PR-Workflow und die lokalen Prüfbefehle. Der kurze Weg:
1. Installiere Git, Node.js 24+, pnpm 10.10.0, Rust 1.93.0 (`rustfmt` + `clippy`), CMake, Ninja, ripgrep sowie die plattformspezifischen Desktop-Build-Voraussetzungen.
2. Forke und klone das Repo, führe dann `git submodule update --init --recursive` aus, bevor du `pnpm install` startest, damit die mitgelieferten Tauri/CEF-Quellen vorhanden sind.
3. Nutze `pnpm dev` für reine Web-UI-Arbeit, `pnpm --filter openhuman-app dev:app` für die Desktop-Shell sowie gezielte Checks wie `pnpm typecheck`, `pnpm format:check` und `cargo check -p openhuman --lib`, bevor du einen PR öffnest.
Tiefer einsteigen: [Architektur](https://tinyhumans.gitbook.io/openhuman/developing/architecture) · [Einrichtung](https://tinyhumans.gitbook.io/openhuman/developing/getting-set-up) · [Cloud-Deployment](../gitbooks/features/cloud-deploy.md).
## Kontext in Minuten, nicht in Wochen
OpenHuman ist das erste Agent-Harness, das dich in Minuten kennenlernt. Inspiriert von [Karpathys LLM-Knowledgebase](https://x.com/karpathy/status/2039805659525644595). Die meisten Agenten starten aus dem Kalten. Hermes lernt, indem er dir bei der Arbeit zusieht; OpenClaw wartet darauf, dass Plugins Kontext einspielen. So oder so vergehen Tage oder Wochen, bevor der Agent genug über deinen Stack weiß, um wirklich nützlich zu sein.
<p align="center">
<img src="../gitbooks/.gitbook/assets/image (1).png" alt="Diagramm zum OpenHuman-Kontextaufbau" />
</p>
> OpenHuman fasst all deine Dokumente, E-Mails und Chats zusammen, komprimiert sie und legt einen Memory Graph an, mit dem dein Agent sich alles über dich merken kann.
OpenHuman überspringt die Wartezeit. Verbinde deine Accounts, lass [Auto-Fetch](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch) die Daten lokal in einer 20-Minuten-Schleife abholen, und [Memory Trees](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) komprimieren alles in Markdown-Dateien, intelligent abgelegt in einem [Obsidian-Wiki im Karpathy-Stil](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki).
Nach nur einem Sync-Durchlauf hat der Agent den vollständigen (komprimierten) Kontext deines Postfachs, deines Kalenders, deiner Repos, deiner Dokumente und deiner Nachrichten. Keine Trainingsphase. Kein "gib ihm ein paar Wochen". Er wird zu dir — gesteuert von dir.
Du hostest [agentmemory](https://github.com/rohitg00/agentmemory) bereits selbst für andere Coding-Agenten? OpenHuman bringt ein optionales `Memory`-Backend mit, das dorthin proxyt — setze `memory.backend = "agentmemory"` in `config.toml`, und derselbe persistente Store treibt OpenHuman zusammen mit Claude Code, Cursor, Codex und OpenCode an. Setup-Details auf der Seite zum [agentmemory-Backend](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/agentmemory-backend).
## OpenHuman vs. andere Agent-Harnesses
Übersichtsvergleich (Produkte entwickeln sich weiter — bitte beim jeweiligen Anbieter verifizieren). OpenHuman ist darauf ausgelegt, **Vendor-Wildwuchs zu reduzieren**, **Workflow-Wissen auf dem Gerät zu halten** und dem Agenten eine **persistente Erinnerung** an deine Daten zu geben — nicht nur an den Chat.
| | Claude Cowork | OpenClaw | Hermes Agent | OpenHuman |
| ------------------- | ----------------- | ----------------- | ----------------- | ---------------------------------- |
| **Quelloffen** | 🚫 Proprietär | ✅ MIT | ✅ MIT | ✅ GNU |
| **Einfacher Einstieg** | ✅ Desktop + CLI | ⚠️ Terminal zuerst | ⚠️ Terminal zuerst | ✅ Aufgeräumte UI, in Minuten |
| **Kosten** | ⚠️ Abo + Zusatzkosten | ⚠️ BYO-Modelle | ⚠️ BYO-Modelle | ✅ Ein Abo + TokenJuice |
| **Memory** | ✅ chat-gebunden | ⚠️ plugin-abhängig | ✅ selbstlernend | 🚀 Memory Tree + Obsidian-Vault, optional [agentmemory](https://github.com/rohitg00/agentmemory)-Backend |
| **Integrationen** | ⚠️ wenige Konnektoren | ⚠️ BYO | ⚠️ BYO | 🚀 118+ über OAuth |
| **Auto-Fetch** | 🚫 keiner | 🚫 keiner | 🚫 keiner | ✅ 20-Min.-Sync ins Memory |
| **API-Wildwuchs** | 🚫 zusätzliche Keys | 🚫 BYOK | 🚫 Multi-Vendor | ✅ ein Account |
| **Model-Routing** | 🚫 nur ein Modell | ⚠️ manuell | ⚠️ manuell | ✅ eingebaut |
| **Native Tools** | ✅ nur Code | ✅ nur Code | ✅ nur Code | ✅ Code + Suche + Scraper + Sprache |
# Gib uns einen Stern auf GitHub
_Baust du auch in Richtung AGI und künstlichem Bewusstsein? Setze einen Stern und hilf anderen, den Weg zu finden._
<p align="center">
<a href="https://www.star-history.com/#tinyhumansai/openhuman&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&legend=top-left" />
</picture>
</a>
</p>
# Contributors Hall of Fame
Zeig etwas Liebe und lande in der Hall of Fame. Mitwirkende erhalten kostenloses Merch und besonderen Zugang zu unserem [Discord](https://discord.tinyhumans.ai/).
<a href="https://github.com/tinyhumansai/openhuman/graphs/contributors">
<img src="https://contrib.rocks/image?repo=tinyhumansai/openhuman" alt="OpenHuman contributors" />
</a>
docs/README.ja-JP.md
+151
View File
@@ -0,0 +1,151 @@
<h1 align="center">OpenHuman</h1>
<p align="center">
<img src="../gitbooks/.gitbook/assets/demo.png" alt="The Tet" />
</p>
<p align="center" style="display: inline-block">
<a href="https://trendshift.io/repositories/23680" target="_blank" style="display: inline-block">
<img src="https://trendshift.io/api/badge/repositories/23680" alt="tinyhumansai%2Fopenhuman | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>
</a>
&nbsp;
<a href="https://www.producthunt.com/products/openhuman?embed=true&amp;utm_source=badge-top-post-badge&amp;utm_medium=badge&amp;utm_campaign=badge-openhuman" target="_blank" rel="noopener noreferrer">
<img alt="OpenHuman - An open source AI harness built with the human in mind | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1136902&amp;theme=light&amp;period=daily&amp;t=1778916022823">
</a>
</p>
<p align="center">
<strong>OpenHuman はあなたのパーソナル AI スーパーインテリジェンスです：ローカルメモリ、必要に応じてマネージドサービス、シンプルで強力。</strong>
</p>
<p align="center">
<a href="https://discord.tinyhumans.ai/">Discord</a> •
<a href="https://www.reddit.com/r/tinyhumansai/">Reddit</a> •
<a href="https://x.com/intent/follow?screen_name=tinyhumansai">X/Twitter</a> •
<a href="https://tinyhumans.gitbook.io/openhuman/">ドキュメント</a> •
<a href="https://x.com/intent/follow?screen_name=senamakel">@senamakel（作者）をフォロー</a>
</p>
<p align="center">
🇺🇸 <a href="../README.md">English</a> | 🇨🇳 <a href="./README.zh-CN.md">简体中文</a> | 🇯🇵 <a href="./README.ja-JP.md">日本語</a> | 🇰🇷 <a href="./README.ko.md">한국어</a> | 🇩🇪 <a href="./README.de.md">Deutsch</a> | 🇵🇰 <a href="./README.ur-pk.md">اردو</a>
</p>
<p align="center">
<img src="https://img.shields.io/badge/status-early%20beta-orange" alt="Early Beta" />
<a href="https://github.com/tinyhumansai/openhuman/releases/latest"><img src="https://img.shields.io/github/v/release/tinyhumansai/openhuman?label=latest" alt="最新リリース" /></a>
<a href="https://github.com/tinyhumansai/openhuman/stargazers"><img src="https://img.shields.io/github/stars/tinyhumansai/openhuman?style=flat" alt="GitHub Stars" /></a>
<a href="../LICENSE"><img src="https://img.shields.io/github/license/tinyhumansai/openhuman" alt="ライセンス" /></a>
<a href="../README.md"><img src="https://img.shields.io/badge/lang-English-blue" alt="English" /></a>
<a href="./README.zh-CN.md"><img src="https://img.shields.io/badge/lang-简体中文-blue" alt="简体中文" /></a>
<a href="./README.ko.md"><img src="https://img.shields.io/badge/lang-한국어-blue" alt="한국어" /></a>
<a href="./README.de.md"><img src="https://img.shields.io/badge/lang-Deutsch-blue" alt="Deutsch" /></a>
<a href="./README.ur-pk.md"><img src="https://img.shields.io/badge/lang-اردو-blue" alt="اردو" /></a>
</p>
> **早期ベータ版**: 現在も活発に開発中です。荒削りな部分があることをご了承ください。
> **ローカル + マネージドサービス、upfront:** OpenHuman は Memory Tree、Obsidian スタイルの Markdown ヴォルト、ワークスペース設定、およびローカルランタイム状態をあなたのマシン上に保存します。デフォルトのマネージド体験では、アカウントサインイン、モデルルーティング、Web 検索プロキシ、および Composio コネクタレイヤーを介したマネージド統合/OAuth フローに、OpenHuman ホスト型サービスが引き続き使用されます。独自のモデル、検索、または Composio 認証情報を持ち込みたい場合は、カスタム/ローカル設定を選択してください。一部のリアルタイムトリガーおよびホスト型機能には、マネージドバックエンドが引き続き必要です。
インストールや利用開始は、ウェブサイト [tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman?utm_source=github&utm_medium=readme) からダウンロードするか、以下のコマンドを実行してください。
```bash
# DMG や EXE は https://tinyhumans.ai/openhuman からダウンロードするか、ターミナルから実行してください
# macOS または Linux x64 の場合
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
# Windows の場合
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex
```
<!-- TODO: translate (ja-JP) — English source mirrored from README.md so non-EN readers get the same install caveats. Please translate. -->
> **Linux:** the AppImage can crash on launch under Wayland (and on Arch-based distros with `sharun: Interpreter not found!`) — see [#2463](https://github.com/tinyhumansai/openhuman/issues/2463) for the cause and env-var workarounds.
Arch Linux package maintainers can use the [`openhuman-bin` AUR recipe](../packages/arch/openhuman-bin/);
once published, Arch users can install it with `yay -S openhuman-bin`.
<!-- /TODO -->
# OpenHuman とは?
OpenHuman は、あなたの日常生活に統合されるよう設計されたオープンソースのエージェント型アシスタントです。各項目は[ドキュメント](https://tinyhumans.gitbook.io/openhuman/)内の詳細な解説にリンクしています。
- **シンプル、UI ファースト、そしてヒューマン** クリーンなデスクトップ体験と短いオンボーディングパスで、インストールから動作するエージェントまで数クリックで到達できます。設定優先のセットアップも、ターミナルも不要です。エージェントには[顔があります](https://tinyhumans.gitbook.io/openhuman/features/mascot): 喋り、周囲に反応し、実際の参加者として[あなたの Google Meet に参加](https://tinyhumans.gitbook.io/openhuman/features/mascot/meeting-agents)し、数週間にわたってあなたのことを覚えており、あなたが入力をやめてもバックグラウンドで考え続けるデスクトップマスコットです。
- **[118+ のサードパーティ統合](https://tinyhumans.gitbook.io/openhuman/features/integrations) と [自動取得](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch)**: Gmail、Notion、GitHub、Slack、Stripe、Calendar、Drive、Linear、Jira などのスタックに **ワンクリック OAuth** で接続できます。すべての接続は型付きツールとしてエージェントに公開され、20 分ごとにコアがアクティブな各接続を巡回し、最新データを[メモリーツリー](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch)に取り込みます。プロンプトも、自分で書くポーリングループも不要なので、エージェントは今朝の時点で明日のコンテキストを既に持っています。
マネージド統合は OpenHuman の Composio コネクタレイヤーを使用します。OAuth ハンドシェイクおよび統合ツール呼び出しは、デフォルトでマネージドバックエンドを介してプロキシされます。代わりに Composio を直接実行したい場合は、独自の Composio API キーでダイレクトモードを構成してください。リアルタイムトリガーの Webhook は、その後あなたがホストして配線する必要があります。
- **[Memory Tree](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian Wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)**: あなたのデータとアクティビティから構築されるローカルファーストのナレッジベースです。接続したすべての情報は ≤3k トークンの Markdown チャンクへ正規化され、スコアリングされ、階層的なサマリーツリーに畳み込まれて **あなたのマシン上の SQLite** に保存されます。同じチャンクは Obsidian 互換のボルトに `.md` ファイルとして配置され、開いて閲覧・編集できます。Karpathy 氏の [obsidian-wiki ワークフロー](https://x.com/karpathy/status/2039805659525644595)にインスパイアされています。
- **電池同梱(Batteries included)**: ウェブ検索、ウェブフェッチ用[スクレイパー](https://tinyhumans.gitbook.io/openhuman/features/native-tools)、フルコーダーツールセット(ファイルシステム、git、lint、test、grep)、そして[ネイティブ音声](https://tinyhumans.gitbook.io/openhuman/features/voice)(STT 入力、ElevenLabs TTS 出力、マスコットのリップシンク、ライブ Google Meet エージェント)がデフォルトで組み込まれています。デフォルトで、[モデルルーティング](https://tinyhumans.gitbook.io/openhuman/features/model-routing)は OpenHuman バックエンドを使用して各ワークロードに適切な LLM(reasoning、fast、または vision)を選択およびプロキシします。一つのサブスクリプションですべてのモデルが含まれます。「ファイル読み込みのためにプラグインをインストール」という煩わしさはありません。デバイス上のワークロード向けに [Ollama によるオプショナルなローカル AI](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai) も利用できます。
- **[スマートトークン圧縮 (TokenJuice)](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: すべてのツール呼び出し、スクレイプ結果、メール本文、検索ペイロードは、LLM モデルに渡される前にトークン圧縮レイヤーを通過します。HTML は Markdown に変換され、長い URL は短縮され、冗長なツール出力は設定可能なルールレイヤーで重複排除と要約が行われるなど…。CJK、絵文字などのマルチバイト文字は書記素(grapheme)単位で完全に保持され、除去されることはありません。同じ情報をわずかなトークン数で得られます。コストとレイテンシを最大 80% 削減します。
- **[メッセージングチャネル](https://tinyhumans.gitbook.io/openhuman/features/integrations#messaging-channels)** と **[プライバシー & セキュリティ](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: あなたが既に使っているチャネル全体での送受信が可能で、ワークフローデータはデバイス上に留まり、ローカルで暗号化され、あなた自身のものとして扱われます。
## ソースからのコントリビュート
新しいコントリビューターの方は、まず [`CONTRIBUTING.md`](../CONTRIBUTING.md) で fork/PR ワークフローとローカル検証コマンドを確認してください。最短経路は以下のとおりです:
1. Git、Node.js 24+、pnpm 10.10.0、Rust 1.93.0(`rustfmt` + `clippy`)、CMake、Ninja、ripgrep、プラットフォーム向けデスクトップビルドの前提条件をインストールします。
2. リポジトリを fork してクローンし、`pnpm install` の前に `git submodule update --init --recursive` を実行して、ベンダー化された Tauri/CEF のソースを取得します。
3. ウェブのみの UI 作業には `pnpm dev` を、デスクトップシェルには `pnpm --filter openhuman-app dev:app` を使用し、PR を出す前に `pnpm typecheck`、`pnpm format:check`、`cargo check -p openhuman --lib` などの集中チェックを実行してください。
詳細なドキュメント: [アーキテクチャ](https://tinyhumans.gitbook.io/openhuman/developing/architecture) · [セットアップガイド](https://tinyhumans.gitbook.io/openhuman/developing/getting-set-up) · [クラウドデプロイ](../gitbooks/features/cloud-deploy.md)。
## コンテキストを数週間ではなく数分で
OpenHuman は、数分であなたのことを理解する初めてのエージェントハーネスです。[Karpathy 氏の LLM ナレッジベース](https://x.com/karpathy/status/2039805659525644595)にインスパイアされました。ほとんどのエージェントは冷えた状態から始まります。Hermes はあなたの作業を見て学習し、OpenClaw はプラグインがコンテキストを運び込むのを待ちます。いずれにせよ、エージェントがあなたのスタックを十分理解して本当に役立つようになるまで、数日から数週間を費やすことになります。
<p align="center">
<img src="../gitbooks/.gitbook/assets/image (1).png" alt="OpenHuman のコンテキスト構築図">
</p>
> OpenHuman はあなたのすべてのドキュメント、メール、チャットを要約・圧縮し、エージェントがあなたについてすべてを覚えていられるメモリーグラフを作成します。
OpenHuman はその待ち時間をスキップします。アカウントを接続し、[自動取得](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch)に 20 分ループでローカルにデータを取得させ、その後 [Memory Trees](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) ですべてを Markdown ファイルに圧縮し、[Karpathy 流の Obsidian wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki) にインテリジェントに保存します。
たった 1 回の同期パスで、エージェントはあなたの受信箱、カレンダー、リポジトリ、ドキュメント、メッセージの完全な(圧縮された)コンテキストを得ます。トレーニング期間も「数週間お待ちください」もありません。エージェントはあなたになり、あなたによって制御されます。
既に他のコーディングエージェント間で [agentmemory](https://github.com/rohitg00/agentmemory) をセルフホストしていますか? OpenHuman にはそれにプロキシするオプションの `Memory` バックエンドが同梱されています。`config.toml` で `memory.backend = "agentmemory"` を設定すれば、同じ永続ストアが Claude Code、Cursor、Codex、OpenCode と並んで OpenHuman を駆動します。セットアップ方法は [agentmemory バックエンド](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/agentmemory-backend)のページを参照してください。
## OpenHuman と他のエージェントハーネスの比較
ハイレベルな比較です(製品は進化するため、各ベンダーで確認してください)。OpenHuman は **ベンダーの乱立を最小限に抑え**、**ワークフロー知識をデバイス上に保ち**、チャットだけでなくあなたのデータに対する **永続的なメモリ** をエージェントに与えるよう構築されています。
| | Claude Cowork | OpenClaw | Hermes Agent | OpenHuman |
| -------------------- | ------------------- | ------------------- | ------------------- | -------------------------------------------------- |
| **オープンソース** | 🚫 プロプライエタリ | ✅ MIT | ✅ MIT | ✅ GNU |
| **開始が簡単** | ✅ デスクトップ + CLI | ⚠️ ターミナル中心 | ⚠️ ターミナル中心 | ✅ クリーンな UI、数分 |
| **コスト** | ⚠️ サブスク + アドオン | ⚠️ モデル持ち込み | ⚠️ モデル持ち込み | ✅ 1 つのサブスク + TokenJuice |
| **メモリ** | ✅ チャット範囲のみ | ⚠️ プラグイン依存 | ✅ 自己学習 | 🚀 Memory Tree + Obsidian ボルト、オプションの [agentmemory](https://github.com/rohitg00/agentmemory) バックエンド |
| **統合** | ⚠️ 少数のコネクター | ⚠️ 持ち込み | ⚠️ 持ち込み | 🚀 OAuth 経由で 118+ |
| **自動取得** | 🚫 なし | 🚫 なし | 🚫 なし | ✅ 20 分同期でメモリに取り込み |
| **API の乱立** | 🚫 追加キー | 🚫 BYOK | 🚫 マルチベンダー | ✅ 1 アカウント |
| **モデルルーティング** | 🚫 単一モデル | ⚠️ 手動 | ⚠️ 手動 | ✅ ビルトイン |
| **ネイティブツール** | ✅ コードのみ | ✅ コードのみ | ✅ コードのみ | ✅ コード + 検索 + スクレイパー + 音声 |
# GitHub でスターをお願いします
_AGI と人工意識への道を進んでいますか? リポジトリにスターをつけて、他の人にも道筋を見つけてもらいましょう。_
<p align="center">
<a href="https://www.star-history.com/#tinyhumansai/openhuman&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&legend=top-left" />
</picture>
</a>
</p>
# コントリビューター・ホール・オブ・フェイム
愛を示して、殿堂入りしましょう。コントリビューターには無料グッズと [Discord](https://discord.tinyhumans.ai/) への特別アクセスが提供されます。
<a href="https://github.com/tinyhumansai/openhuman/graphs/contributors">
<img src="https://contrib.rocks/image?repo=tinyhumansai/openhuman" alt="OpenHuman contributors" />
</a>
docs/README.ko.md
+150
View File
@@ -0,0 +1,150 @@
<h1 align="center">OpenHuman</h1>
<p align="center">
<img src="../gitbooks/.gitbook/assets/demo.png" alt="The Tet" />
</p>
<p align="center" style="display: inline-block">
<a href="https://trendshift.io/repositories/23680" target="_blank" style="display: inline-block">
<img src="https://trendshift.io/api/badge/repositories/23680" alt="tinyhumansai%2Fopenhuman | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>
</a>
&nbsp;
<a href="https://www.producthunt.com/products/openhuman?embed=true&amp;utm_source=badge-top-post-badge&amp;utm_medium=badge&amp;utm_campaign=badge-openhuman" target="_blank" rel="noopener noreferrer">
<img alt="OpenHuman - An open source AI harness built with the human in mind | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1136902&amp;theme=light&amp;period=daily&amp;t=1778916022823">
</a>
</p>
<p align="center">
<strong>OpenHuman은 당신의 개인용 AI 슈퍼 지능입니다: 로컬 메모리, 필요한 경우 관리형 서비스, 단순하고 강력합니다.</strong>
</p>
<p align="center">
<a href="https://discord.tinyhumans.ai/">Discord</a> •
<a href="https://www.reddit.com/r/tinyhumansai/">Reddit</a> •
<a href="https://x.com/intent/follow?screen_name=tinyhumansai">X/Twitter</a> •
<a href="https://tinyhumans.gitbook.io/openhuman/">문서</a> •
<a href="https://x.com/intent/follow?screen_name=senamakel">@senamakel(제작자) 팔로우</a>
</p>
<p align="center">
🇺🇸 <a href="../README.md">English</a> | 🇨🇳 <a href="./README.zh-CN.md">简体中文</a> | 🇯🇵 <a href="./README.ja-JP.md">日本語</a> | 🇰🇷 <a href="./README.ko.md">한국어</a> | 🇩🇪 <a href="./README.de.md">Deutsch</a> | 🇵🇰 <a href="./README.ur-pk.md">اردو</a>
</p>
<p align="center">
<img src="https://img.shields.io/badge/status-early%20beta-orange" alt="얼리 베타" />
<a href="https://github.com/tinyhumansai/openhuman/releases/latest"><img src="https://img.shields.io/github/v/release/tinyhumansai/openhuman?label=latest" alt="최신 릴리스" /></a>
<a href="https://github.com/tinyhumansai/openhuman/stargazers"><img src="https://img.shields.io/github/stars/tinyhumansai/openhuman?style=flat" alt="GitHub Stars" /></a>
<a href="../LICENSE"><img src="https://img.shields.io/github/license/tinyhumansai/openhuman" alt="라이선스" /></a>
<a href="../README.md"><img src="https://img.shields.io/badge/lang-English-blue" alt="English" /></a>
<a href="./README.zh-CN.md"><img src="https://img.shields.io/badge/lang-简体中文-blue" alt="简体中文" /></a>
<a href="./README.ja-JP.md"><img src="https://img.shields.io/badge/lang-日本語-blue" alt="日本語" /></a>
<a href="./README.ko.md"><img src="https://img.shields.io/badge/lang-한국어-blue" alt="한국어" /></a>
<a href="./README.de.md"><img src="https://img.shields.io/badge/lang-Deutsch-blue" alt="Deutsch" /></a>
<a href="./README.ur-pk.md"><img src="https://img.shields.io/badge/lang-اردو-blue" alt="اردو" /></a>
</p>
> **얼리 베타**: 활발히 개발 중입니다. 다소 미흡한 부분이 있을 수 있습니다.
> **로컬 + 관리형 서비스, upfront:** OpenHuman은 Memory Tree, Obsidian 스타일 Markdown 볼트, 워크스페이스 설정 및 로컬 런타임 상태를 사용자의 머신에 저장합니다. 기본 관리형 경험은 여전히 계정 로그인, 모델 라우팅, 웹 검색 프록시 및 Composio 커넥터 레이어를 통한 관리형 통합/OAuth 플로우에 OpenHuman 호스팅 서비스를 사용합니다. 자체 모델, 검색 또는 Composio 인증 정보를 가져오려면 사용자 지정/로컬 설정을 선택하세요. 일부 실시간 트리거 및 호스팅 기능은 여전히 관리형 백엔드를 필요로 합니다.
설치하거나 시작하려면 [tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman?utm_source=github&utm_medium=readme) 웹사이트에서 다운로드하거나 터미널에서 다음을 실행하세요.
```bash
# https://tinyhumans.ai/openhuman 에서 DMG, EXE를 다운로드하거나 터미널에서 실행하세요.
# macOS 또는 Linux x64용
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
# Windows용
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex
```
<!-- TODO: translate (ko) — English source mirrored from README.md so non-EN readers get the same install caveats. Please translate. -->
> **Linux:** the AppImage can crash on launch under Wayland (and on Arch-based distros with `sharun: Interpreter not found!`) — see [#2463](https://github.com/tinyhumansai/openhuman/issues/2463) for the cause and env-var workarounds.
Arch Linux package maintainers can use the [`openhuman-bin` AUR recipe](../packages/arch/openhuman-bin/);
once published, Arch users can install it with `yay -S openhuman-bin`.
<!-- /TODO -->
# OpenHuman이란 무엇인가요?
OpenHuman은 일상 생활에 통합되도록 설계된 오픈 소스 에이전트 어시스턴트입니다. 각 글머리 기호는 [문서](https://tinyhumans.gitbook.io/openhuman/)의 더 깊은 설명으로 연결됩니다.
- **단순함, UI 우선 및 인간 중심**: 깔끔한 데스크톱 경험과 짧은 온보딩 경로를 통해 설치 후 몇 번의 클릭만으로 작동하는 에이전트를 만날 수 있습니다. 설정 우선 방식이나 터미널이 필요하지 않습니다. 에이전트는 [얼굴](https://tinyhumans.gitbook.io/openhuman/features/mascot)을 가지고 있습니다. 말을 하고, 주변 환경에 반응하며, 실제 참가자로 [Google Meet에 참여](https://tinyhumans.gitbook.io/openhuman/features/mascot/meeting-agents)하고, 몇 주 동안 당신을 기억하며, 타이핑을 멈춘 후에도 백그라운드에서 계속 생각하는 데스크톱 마스코트입니다.
- **[118개 이상의 서드파티 통합](https://tinyhumans.gitbook.io/openhuman/features/integrations) 및 [자동 가져오기(auto-fetch)](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch)**: Gmail, Notion, GitHub, Slack, Stripe, Calendar, Drive, Linear, Jira 등 당신의 스택을 **원클릭 OAuth**로 연결하세요. 모든 연결은 유형이 지정된 도구로 에이전트에게 노출되며, 코어는 20분마다 각 활성 연결을 탐색하여 신선한 데이터를 [메모리 트리](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch)로 가져옵니다. 프롬프트나 직접 작성해야 하는 폴링 루프가 필요 없으므로, 에이전트는 오늘 아침에 이미 내일의 컨텍스트를 가지고 있습니다.
- **[메모리 트리(Memory Tree)](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian 위키](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)**: 당신의 데이터와 활동을 바탕으로 구축된 로컬 우선 지식 베이스입니다. 연결된 모든 것은 3k 토큰 이하의 Markdown 청크로 규격화되고 점수가 매겨지며, **당신의 머신에 있는 SQLite**에 저장되는 계층적 요약 트리로 접힙니다. 동일한 청크는 당신이 열고, 탐색하고, 편집할 수 있는 Obsidian 호환 볼트에 `.md` 파일로 저장됩니다. 이는 Karpathy의 [obsidian-wiki 워크플로우](https://x.com/karpathy/status/2039805659525644595)에서 영감을 받았습니다.
- **모든 것이 포함됨(Batteries included)**: 웹 검색, 웹 가져오기 [스크레이퍼](https://tinyhumans.gitbook.io/openhuman/features/native-tools), 전체 코더 툴셋(파일 시스템, git, lint, test, grep), 그리고 [네이티브 음성](https://tinyhumans.gitbook.io/openhuman/features/voice)(STT 입력, ElevenLabs TTS 출력, 마스코트 립싱크, 라이브 Google Meet 에이전트)이 기본적으로 연결되어 있습니다. 기본적으로 [모델 라우팅](https://tinyhumans.gitbook.io/openhuman/features/model-routing)은 OpenHuman 백엔드를 사용하여 각 워크로드에 적합한 LLM(추론, 고속 또는 비전)을 선택하고 프록시합니다. 하나의 구독에 모든 모델이 포함됩니다. "파일을 읽기 위해 플러그인 설치"와 같은 번거로움이 없습니다. 온디바이스 워크로드를 위해 [Ollama를 통한 선택적 로컬 AI](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai)를 지원합니다.
- **[스마트 토큰 압축(TokenJuice)](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: 모든 도구 호출, 스크레이핑 결과, 이메일 본문 및 검색 페이로드는 LLM 모델에 전달되기 전에 토큰 압축 레이어를 거칩니다. HTML은 Markdown으로 변환되고, 긴 URL은 단축되며, 장황한 도구 출력은 구성 가능한 규칙 오버레이 등을 통해 중복 제거 및 요약됩니다. CJK, 이모지 및 기타 멀티바이트 텍스트는 자소(grapheme) 단위로 보존되며 절대 삭제되지 않습니다. 동일한 정보를 훨씬 적은 토큰으로 얻을 수 있어 비용과 지연 시간을 최대 80%까지 줄일 수 있습니다.
- **[메시징 채널](https://tinyhumans.gitbook.io/openhuman/features/integrations#messaging-channels)** 및 **[개인 정보 보호 및 보안](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: 이미 사용 중인 채널을 통해 메시지를 주고받을 수 있으며, 워크플로우 데이터는 기기에 남아 로컬에서 암호화되어 당신의 것으로 관리됩니다.
## 소스에서 기여하기
새로운 기여자인가요? 포크/PR 워크플로우 및 로컬 검증 명령에 대해서는 [`CONTRIBUTING.md`](../CONTRIBUTING.md)에서 시작하세요. 빠른 경로는 다음과 같습니다.
1. Git, Node.js 24+, pnpm 10.10.0, Rust 1.93.0(`rustfmt` + `clippy`), CMake, Ninja, ripgrep 및 플랫폼 데스크톱 빌드 필수 구성 요소를 설치합니다.
2. 저장소를 포크하고 클론한 다음, `pnpm install` 전에 `git submodule update --init --recursive`를 실행하여 벤더링된 Tauri/CEF 소스가 존재하는지 확인합니다.
3. 웹 전용 UI 작업에는 `pnpm dev`를, 데스크톱 쉘에는 `pnpm --filter openhuman-app dev:app`을 사용하고, PR을 열기 전에 `pnpm typecheck`, `pnpm format:check`, `cargo check -p openhuman --lib`와 같은 집중 점검을 수행합니다.
상세 문서: [아키텍처](https://tinyhumans.gitbook.io/openhuman/developing/architecture) · [설정하기](https://tinyhumans.gitbook.io/openhuman/developing/getting-set-up) · [클라우드 배포](../gitbooks/features/cloud-deploy.md).
## 몇 주가 아닌 몇 분 만에 구축되는 컨텍스트
OpenHuman은 몇 분 만에 당신을 알게 되는 최초의 에이전트 하네스입니다. [Karpathy의 LLM 지식 베이스](https://x.com/karpathy/status/2039805659525644595)에서 영감을 받았습니다. 대부분의 에이전트는 아무런 정보 없이 시작합니다. Hermes는 당신의 작업을 지켜보며 학습하고, OpenClaw는 플러그인이 컨텍스트를 가져오기를 기다립니다. 어느 쪽이든 에이전트가 당신의 스택에 대해 충분히 알고 정말 유용해지기까지는 며칠 또는 몇 주가 걸립니다.
<p align="center">
<img src="../gitbooks/.gitbook/assets/image (1).png" alt="OpenHuman 컨텍스트 구축 다이어그램">
</p>
> OpenHuman은 당신의 모든 문서, 이메일 및 채팅을 요약하고 압축합니다. 그리고 에이전트가 당신에 대한 모든 것을 기억할 수 있도록 메모리 그래프를 생성합니다.
OpenHuman은 기다림을 생략합니다. 계정을 연결하고, [자동 가져오기](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch)가 20분 주기로 데이터를 로컬로 가져오게 한 다음, [메모리 트리](https://tinyhumans.gitbook.io/openhuman/features/memory-tree)가 모든 것을 [Karpathy 스타일의 Obsidian 위키](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)에 지능적으로 저장된 Markdown 파일로 압축하게 하세요.
단 한 번의 동기화 패스만으로 에이전트는 당신의 받은 편지함, 캘린더, 저장소, 문서, 메시지의 전체(압축된) 컨텍스트를 갖게 됩니다. 훈련 기간도, "몇 주를 기다려야 하는" 번거로움도 없습니다. 에이전트는 당신이 되고, 당신에 의해 제어됩니다.
이미 다른 코딩 에이전트에서 [agentmemory](https://github.com/rohitg00/agentmemory)를 자체 호스팅하고 있나요? OpenHuman은 이를 프록시하는 선택적 `Memory` 백엔드를 제공합니다. `config.toml`에서 `memory.backend = "agentmemory"`를 설정하면 동일한 내구성 있는 저장소가 Claude Code, Cursor, Codex, OpenCode와 함께 OpenHuman을 구동합니다. 설정 방법은 [agentmemory 백엔드](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/agentmemory-backend) 페이지를 참조하세요.
## OpenHuman vs 다른 에이전트 하네스
상위 수준 비교(제품은 진화하므로 각 벤더에 확인하세요). OpenHuman은 **벤더 분산화(sprawl)를 최소화**하고, **워크플로우 지식을 기기에 유지**하며, 채팅뿐만 아니라 당신의 데이터에 대한 **지속적인 기억**을 에이전트에게 제공하도록 구축되었습니다.
| | Claude Cowork | OpenClaw | Hermes Agent | OpenHuman |
| ------------------- | ----------------- | ----------------- | ----------------- | ---------------------------------- |
| **오픈 소스** | 🚫 독점 소스 | ✅ MIT | ✅ MIT | ✅ GNU |
| **시작하기 쉬움** | ✅ 데스크톱 + CLI | ⚠️ 터미널 우선 | ⚠️ 터미널 우선 | ✅ 깔끔한 UI, 단 몇 분 |
| **비용** | ⚠️ 구독 + 애드온 | ⚠️ 모델 직접 제공 | ⚠️ 모델 직접 제공 | ✅ 단일 구독 + TokenJuice |
| **메모리** | ✅ 채팅 범위 한정 | ⚠️ 플러그인 의존 | ✅ 자기 학습 | 🚀 메모리 트리 + Obsidian 볼트, 선택적 [agentmemory](https://github.com/rohitg00/agentmemory) 백엔드 |
| **통합** | ⚠️ 적은 커넥터 | ⚠️ 직접 구축 | ⚠️ 직접 구축 | 🚀 OAuth를 통한 118개 이상 |
| **자동 가져오기** | 🚫 없음 | 🚫 없음 | 🚫 없음 | ✅ 20분마다 메모리로 동기화 |
| **API 분산화** | 🚫 추가 키 필요 | 🚫 BYOK | 🚫 멀티 벤더 | ✅ 단일 계정 |
| **모델 라우팅** | 🚫 단일 모델 | ⚠️ 수동 | ⚠️ 수동 | ✅ 내장됨 |
| **네이티브 도구** | ✅ 코드 전용 | ✅ 코드 전용 | ✅ 코드 전용 | ✅ 코드 + 검색 + 스크레이퍼 + 음성 |
# GitHub에서 스타를 눌러주세요
_AGI와 인공 의식을 향해 나아가고 계신가요? 저장소에 스타를 눌러 다른 사람들도 이 길을 찾을 수 있도록 도와주세요._
<p align="center">
<a href="https://www.star-history.com/#tinyhumansai/openhuman&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&legend=top-left" />
</picture>
</a>
</p>
# 기여자 명예의 전당
기여를 통해 명예의 전당에 이름을 올리세요. 기여자에게는 무료 굿즈와 [Discord](https://discord.tinyhumans.ai/) 특별 권한이 제공됩니다.
<a href="https://github.com/tinyhumansai/openhuman/graphs/contributors">
<img src="https://contrib.rocks/image?repo=tinyhumansai/openhuman" alt="OpenHuman 기여자" />
</a>
docs/README.ur-pk.md
+253
View File
@@ -0,0 +1,253 @@
<div dir="rtl" lang="ur">
<p align="center">
🇺🇸 <a href="../README.md">انگریزی</a> | 🇨🇳 <a href="./README.zh-CN.md">چینی (آسان)</a> | 🇯🇵 <a href="./README.ja-JP.md">جاپانی</a> | 🇰🇷 <a href="./README.ko.md">کورین</a> | 🇩🇪 <a href="./README.de.md">جرمن</a> | 🇵🇰 <a href="./README.ur-pk.md">اردو</a>
</p>
</div>
<div dir="ltr">
<h1 align="center">OpenHuman</h1>
<p align="center">
<img src="../gitbooks/.gitbook/assets/demo.png" alt="The Tet" />
</p>
<p align="center" style="display: inline-block">
<a href="https://trendshift.io/repositories/23680" target="_blank" style="display: inline-block">
<img src="https://trendshift.io/api/badge/repositories/23680" alt="tinyhumansai%2Fopenhuman | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>
</a>
&nbsp;
<a href="https://www.producthunt.com/products/openhuman?embed=true&amp;utm_source=badge-top-post-badge&amp;utm_medium=badge&amp;utm_campaign=badge-openhuman" target="_blank" rel="noopener noreferrer">
<img alt="OpenHuman - An open source AI harness built with the human in mind | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1136902&amp;theme=light&amp;period=daily&amp;t=1778916022823">
</a>
</p>
</div>
<div dir="rtl" lang="ur">
<p align="center">
<strong>اوپن ہیومن آپ کی ذاتی مصنوعی ذہانت کی سپر انٹیلی جنس ہے: مقامی یادداشت، ضرورت کے مطابق میزبانی خدمات، سادہ مگر طاقتور۔</strong>
</p>
<p align="center">
<a href="https://discord.tinyhumans.ai/">ڈسکارڈ</a> •
<a href="https://www.reddit.com/r/tinyhumansai/">ریڈٹ</a> •
<a href="https://x.com/intent/follow?screen_name=tinyhumansai">X/ٹویٹر</a> •
<a href="https://tinyhumans.gitbook.io/openhuman/">دستاویزات</a> •
<a href="https://x.com/intent/follow?screen_name=senamakel">فالو کریں @senamakel (مصنف)</a>
</p>
</div>
<div dir="ltr">
<p align="center">
<img src="https://img.shields.io/badge/status-early%20beta-orange" alt="ابتدائی آزمائشی نسخہ" />
<a href="https://github.com/tinyhumansai/openhuman/releases/latest"><img src="https://img.shields.io/github/v/release/tinyhumansai/openhuman?label=latest" alt="تازہ ترین نسخہ" /></a>
<a href="https://github.com/tinyhumansai/openhuman/stargazers"><img src="https://img.shields.io/github/stars/tinyhumansai/openhuman?style=flat" alt="ستارے" /></a>
<a href="../LICENSE"><img src="https://img.shields.io/github/license/tinyhumansai/openhuman" alt="لائسنس" /></a>
<a href="../README.md"><img src="https://img.shields.io/badge/lang-English-blue" alt="English" /></a>
<a href="./README.ja-JP.md"><img src="https://img.shields.io/badge/lang-日本語-blue" alt="日本語" /></a>
<a href="./README.ko.md"><img src="https://img.shields.io/badge/lang-한국어-blue" alt="한국어" /></a>
<a href="./README.de.md"><img src="https://img.shields.io/badge/lang-Deutsch-blue" alt="Deutsch" /></a>
<a href="./README.ur-pk.md"><img src="https://img.shields.io/badge/lang-اردو-blue" alt="اردو" /></a>
</p>
</div>
<div dir="rtl" lang="ur">
> **ابتدائی آزمائشی نسخہ**: فعال ترقی جاری ہے، بے ضابطگیوں کی توقع کریں۔
> **مقامی + منظم خدمات:** OpenHuman اپنا Memory Tree، Obsidian-style Markdown والٹ، ورک اسپیس کنفیگریشن، اور مقامی رن ٹائم اسٹیٹ آپ کی مشین پر محفوظ کرتا ہے۔ طے شدہ منظم تجربہ اب بھی OpenHuman کی میزبان خدمات استعمال کرتا ہے اکاؤنٹ سائن ان، ماڈل روٹنگ، ویب سرچ پروکسی، اور Composio کنیکٹر پرت کے ذریعے منظم انضمام/OAuth فلو کے لیے۔ اگر آپ اپنا ماڈل، سرچ، یا Composio اسناد لانا چاہتے ہیں تو اپنی مرضی کے مطابق/مقامی سیٹنگز منتخب کریں؛ کچھ ریئل ٹائم ٹرگرز اور میزبان فیچرز اب بھی منظم بیک اینڈ کی ضرورت رکھتے ہیں۔
# انسٹال کریں
انسٹالر [tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman?utm_source=github&utm_medium=readme) سے یا [GitHub ریلیز](https://github.com/tinyhumansai/openhuman/releases/latest) صفحے سے ڈاؤن لوڈ کریں۔ ٹرمینل انسٹال کے لیے، نیچے دیے گئے مقامی پیکیج کے راستے ترجیحی ہیں — یہ آپ کے OS پیکیج مینیجر کے دستخطی سلسلے پر سوار ہوتے ہیں۔
## تجویز کردہ انسٹال (مقامی پیکیجز)
یہ راستے OS پیکیج مینیجر کے دستخطی سلسلے کے ذریعے آرٹیفیکٹ کی تصدیق کرتے ہیں (Homebrew bottle hash، signed apt repo، MSI signature)۔
**میک او ایس (ہومبریو ٹیپ):**
</div>
<div dir="ltr">
```bash
brew tap tinyhumansai/core
brew install openhuman
```
</div>
<div dir="rtl" lang="ur">
**لینکس (ڈیبین/ابونٹو — دستخط شدہ اے پی ٹی ریپو):**
</div>
<div dir="ltr">
```bash
sudo apt-get install -y --no-install-recommends gnupg2 curl ca-certificates
curl -fsSL https://tinyhumansai.github.io/openhuman/apt/KEY.gpg \
| sudo gpg --dearmor -o /etc/apt/keyrings/openhuman.gpg
echo "deb [signed-by=/etc/apt/keyrings/openhuman.gpg arch=amd64] \
https://tinyhumansai.github.io/openhuman/apt stable main" \
| sudo tee /etc/apt/sources.list.d/openhuman.list
sudo apt-get update
sudo apt-get install -y openhuman
```
</div>
<div dir="rtl" lang="ur">
**لینکس (آرچ — اے یو آر):** ریپو میں [`openhuman-bin` AUR recipe](../packages/arch/openhuman-bin/) موجود ہے۔ شائع ہونے کے بعد، آرچ صارفین `yay -S openhuman-bin` سے انسٹال کر سکتے ہیں۔
**ونڈوز:** [تازہ ترین ریلیز](https://github.com/tinyhumansai/openhuman/releases/latest) سے سائنڈ `.msi` ڈاؤن لوڈ کریں اور چلائیں۔
**دستی `.dmg` / `.deb` / `.AppImage` / `.msi`:** اپنے پلیٹ فارم کے لیے انسٹالر براہ راست [تازہ ترین ریلیز صفحے](https://github.com/tinyhumansai/openhuman/releases/latest) سے حاصل کریں۔
> **لینکس:** ایپ امیج وے لینڈ کے تحت لانچ ہوتے وقت کریش کر سکتا ہے (اور آرچ پر مبنی ڈسٹرو پر `sharun: Interpreter not found!` کے ساتھ) — وجہ اور env-var ورک‌اراؤنڈ کے لیے [#2463](https://github.com/tinyhumansai/openhuman/issues/2463) دیکھیں۔ اوپر والا `.deb` پیکیج ڈیبین/ابونٹو پر ان ناکامیوں سے بچاتا ہے۔
## متبادل: اسکرپٹ انسٹال (مربوطیت کی تصدیق نہیں)
> **انتباہ — غیر تصدیق شدہ انسٹال۔** یہ اسکرپٹس براہ راست `raw.githubusercontent.com` سے پیش کی جاتی ہیں اور **الگ سے** کوئی دستخط فراہم نہیں کرتیں، اس لیے `curl … | bash` اور `irm … | iex` میں اسکرپٹ بائٹس کی چھیڑ چھاڑ کا پتہ لگانے کا کوئی طریقہ نہیں ہے۔ جب ممکن ہو اوپر والے **مقامی پیکیج** کے راستوں کو ترجیح دیں۔ اگر اسکرپٹ استعمال کرنا ضروری ہو تو نیچے "تصدیق شدہ اسکرپٹ انسٹال" دیکھیں۔
</div>
<div dir="ltr">
```bash
# macOS یا Linux x64
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex
```
</div>
<div dir="rtl" lang="ur">
## تصدیق شدہ اسکرپٹ انسٹال کی حیثیت
الگ سے دستخط شدہ اسکرپٹ انسٹال کا راستہ فی الحال دستیاب نہیں ہے۔ مقامی پیکیج کے راستوں کو فروغ دینے کے بعد [#2620](https://github.com/tinyhumansai/openhuman/issues/2620) بند کر دیا گیا ہے، لیکن موجودہ ریلیز اثاثوں میں پہلے سے عملدرآمد کی اسکرپٹ تصدیق کے لیے `install.sh.asc` / `install.ps1.asc` شامل نہیں ہیں۔ اسکرپٹ انسٹال کے راستے کو غیر تصدیق شدہ سمجھیں اور جب ممکن ہو اوپر والے مقامی پیکیج کے اختیارات کو ترجیح دیں۔
# OpenHuman کیا ہے؟
OpenHuman ایک اوپن سورس ایجنٹک اسسٹنٹ ہے جو آپ کی روزمرہ زندگی میں آپ کے ساتھ ضم ہونے کے لیے ڈیزائن کیا گیا ہے۔ ہر بلیٹ [دستاویزات](https://tinyhumans.gitbook.io/openhuman/) میں گہرائی سے تحریر کی طرف جاتا ہے۔
- **سادہ، یوزر انٹرفیس اول اور انسانی** — ایک صاف ڈیسک ٹاپ تجربہ اور مختصر آن بورڈنگ راستے آپ کو انسٹال سے ایک کام کرنے والے ایجنٹ تک چند کلکس میں لے جاتے ہیں — کوئی پہلے کنفیگر نہیں، کوئی ٹرمینل ضروری نہیں۔ ایجنٹ کا [ایک چہرہ](https://tinyhumans.gitbook.io/openhuman/features/mascot) ہے: ایک ڈیسک ٹاپ مسکاٹ جو بولتا ہے، اپنے ماحول پر ردعمل دیتا ہے، [Google Meet میں](https://tinyhumans.gitbook.io/openhuman/features/mascot/meeting-agents) ایک حقیقی شریک کے طور پر شامل ہوتا ہے، ہفتوں تک آپ کو یاد رکھتا ہے، اور پس منظر میں سوچتا رہتا ہے چاہے آپ نے ٹائپ کرنا چھوڑ دیا ہو۔
- **[118+ تیسرے فریق کے انضمام](https://tinyhumans.gitbook.io/openhuman/features/integrations) + [خودکار لانا](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch)**: **ایک کلک OAuth** کے ساتھ Gmail، Notion، GitHub، Slack، Stripe، Calendar، Drive، Linear، Jira اور اپنے باقی اسٹیک میں پلگ ان کریں۔ ہر کنیکشن ایجنٹ کو ایک ٹائپڈ ٹول کے طور پر ظاہر ہوتا ہے، اور ہر بیس منٹ میں کور ہر فعال کنیکشن پر چلتا ہے اور تازہ ڈیٹا کو [میموری ٹری](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch) میں کھینچتا ہے۔ کوئی پرامپٹ نہیں، کوئی پولنگ لوپ نہیں جو آپ کو لکھنا پڑے، اس لیے ایجنٹ کے پاس آج صبح ہی کل کا سیاق و سباق ہوتا ہے۔
منظم انضمام OpenHuman کے Composio کنیکٹر پرت کا استعمال کرتے ہیں۔ OAuth مصافحہ اور انضمام ٹول کالز ڈیفالٹ طور پر منظم بیک اینڈ کے ذریعے پروکسی ہوتی ہیں۔ اگر آپ براہ راست Composio چلانا چاہتے ہیں تو اپنی Composio API کلید کے ساتھ ڈائریکٹ موڈ کنفیگر کریں؛ ریئل ٹائم ٹرگر ویب ہکس کو پھر آپ کو خود میزبانی اور وائر کرنا ہوگا۔
- **[میموری ٹری](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian Wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)**: ایک مقامی اول علم کا ذخیرہ جو آپ کے ڈیٹا اور سرگرمی سے بنایا گیا ہے۔ آپ جو کچھ بھی جوڑتے ہیں وہ ≤3k-token کے Markdown ٹکڑوں میں معیاری ہو جاتا ہے، اسکور کیا جاتا ہے، اور درجہ بندی کے خلاصے کے درختوں میں جوڑ دیا جاتا ہے جو **آپ کی مشین پر SQLite** میں محفوظ ہوتے ہیں۔ وہی ٹکڑے Obsidian-مطابق والٹ میں `.md` فائلوں کے طور پر اترتے ہیں جسے آپ کھول سکتے ہیں، براؤز اور ایڈٹ کر سکتے ہیں، کارپیتھی کے [obsidian-wiki ورک فلو](https://x.com/karpathy/status/2039805659525644595) سے متاثر۔
- **سب کچھ شامل ہے**: ویب سرچ، ایک ویب فیچ [سکریپر](https://tinyhumans.gitbook.io/openhuman/features/native-tools)، ایک مکمل کوڈر ٹول سیٹ (فائل سسٹم، گٹ، لنٹ، ٹیسٹ، گریپ)، اور [مقامی آواز](https://tinyhumans.gitbook.io/openhuman/features/voice) (STT ان پٹ، ElevenLabs TTS آؤٹ پٹ، مسکاٹ لپ سنک، لائیو Google Meet ایجنٹ) ڈیفالٹ طور پر وائرڈ ہیں۔ ڈیفالٹ طور پر، [ماڈل روٹنگ](https://tinyhumans.gitbook.io/openhuman/features/model-routing) ہر ورک لوڈ (reasoning، fast، یا vision) کے لیے صحیح LLM کو منتخب اور پروکسی کرنے کے لیے OpenHuman بیک اینڈ استعمال کرتی ہے۔ ایک سبسکرپشن میں تمام ماڈلز شامل ہیں۔ کوئی "فائل پڑھنے کے لیے پلگ ان انسٹال کریں" رگڑ نہیں۔ تعاون یافتہ ڈیوائس پر ورک لوڈز کے لیے [Ollama کے ذریعے اختیاری مقامی AI](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai) استعمال کریں۔
- **[اسمارٹ ٹوکن کمپریشن (TokenJuice)](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: ہر ٹول کال، سکریپ نتیجہ، ای میل باڈی، اور سرچ پے لوڈ کسی بھی LLM ماڈل کو چھونے سے پہلے ٹوکن کمپریشن پرت سے گزرتا ہے۔ HTML کو Markdown میں تبدیل کیا جاتا ہے، لمبے URLs کو چھوٹا کیا جاتا ہے، اور لمبے ٹول آؤٹ پٹ کو ایک قابل ترتیب اصول اوورلے وغیرہ کے ذریعے ڈیڈپ اور خلاصہ کیا جاتا ہے... CJK، ایموجی، اور دیگر ملٹی بائٹ ٹیکسٹ گرافیم بہ گرافیم محفوظ رہتے ہیں — کبھی نہیں ہٹائے جاتے۔ آپ کو وہی معلومات ملتی ہیں لیکن ٹوکنز کے ایک حصے میں۔ لاگت اور تاخیر کو 80% تک کم کرنا۔
- **[میسجنگ چینلز](https://tinyhumans.gitbook.io/openhuman/features/integrations#messaging-channels)** اور **[پرائیویسی اور سیکیورٹی](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: ان چینلز پر اندر/باہر جنہیں آپ پہلے سے استعمال کرتے ہیں، ورک فلو ڈیٹا کے ساتھ جو ڈیوائس پر رہتا ہے، مقامی طور پر انکرپٹڈ، آپ کا سمجھا جاتا ہے۔
## سورس سے تعاون
نیا تعاون کنندہ؟ fork/PR ورک فلو اور مقامی تصدیقی کمانڈز کے لیے [`CONTRIBUTING.md`](../CONTRIBUTING.md) سے شروع کریں۔ مختصر راستہ:
1. Git، Node.js 24+، pnpm 10.10.0، Rust 1.93.0 (`rustfmt` + `clippy`)، CMake، Ninja، ripgrep، اور پلیٹ فارم ڈیسک ٹاپ بلڈ کی ضروریات انسٹال کریں۔
2. ریپو کو fork اور کلون کریں، پھر `pnpm install` سے پہلے `git submodule update --init --recursive` چلائیں تاکہ وینڈرڈ Tauri/CEF سورس موجود ہوں۔
3. ویب صرف UI کام کے لیے `pnpm dev`، ڈیسک ٹاپ شیل کے لیے `pnpm --filter openhuman-app dev:app`، اور PR کھولنے سے پہلے فوکسڈ چیکس جیسے `pnpm typecheck`، `pnpm format:check`، اور `cargo check -p openhuman --lib` استعمال کریں۔
مزید دستاویزات: [آرکیٹیکچر](https://tinyhumans.gitbook.io/openhuman/developing/architecture) · [سیٹ اپ](https://tinyhumans.gitbook.io/openhuman/developing/getting-set-up) · [کلاؤڈ ڈیپلائے](../gitbooks/features/cloud-deploy.md)۔
## منٹوں میں سیاق و سباق، ہفتوں میں نہیں
OpenHuman پہلا ایجنٹ ہارنس ہے جو منٹوں میں آپ کو جان لیتا ہے۔ کارپیتھی کے [LLM Knowledgebase](https://x.com/karpathy/status/2039805659525644595) سے متاثر۔ زیادہ تر ایجنٹ سرد شروع ہوتے ہیں۔ Hermes آپ کو کام کرتے دیکھ کر سیکھتا ہے؛ OpenClaw پلگ انز کا سیاق و سباق لانے کا انتظار کرتا ہے۔ کسی بھی طرح، آپ دن یا ہفتے گزارتے ہیں اس سے پہلے کہ ایجنٹ آپ کے اسٹیک کے بارے میں کافی جانے تاکہ حقیقی طور پر مفید ہو۔
</div>
<div dir="ltr">
<p align="center">
<img src="../gitbooks/.gitbook/assets/image (1).png" alt="OpenHuman سیاق و سباق بنانے کا خاکہ" />
</p>
</div>
<div dir="rtl" lang="ur">
> OpenHuman آپ کی تمام دستاویزات، ای میلز اور چیٹس کا خلاصہ اور کمپریس کرتا ہے؛ اور ایک میموری گراف بناتا ہے جو آپ کے ایجنٹ کو آپ کے بارے میں سب کچھ یاد رکھنے دیتا ہے۔
OpenHuman انتظار چھوڑ دیتا ہے۔ اپنے اکاؤنٹس جوڑیں، [خودکار لانے](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch) کو 20 منٹ کے لوپ پر مقامی طور پر ڈیٹا کھینچنے دیں، اور پھر [میموری ٹریز](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) کو ہر چیز کو Markdown فائلوں میں کمپریس کرنے دیں جو [Karpathy-style Obsidian wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki) میں ذخیرہ ہوتی ہیں۔
صرف ایک سنک پاس میں، ایجنٹ کے پاس آپ کے ان باکس، کیلنڈر، ریپوز، دستاویزات، پیغامات کا مکمل (کمپریسڈ) سیاق و سباق ہوتا ہے۔ کوئی تربیتی مدت نہیں۔ کوئی "اسے کچھ ہفتے دو" نہیں۔ یہ آپ بن جاتا ہے، آپ کے کنٹرول میں۔
پہلے سے دوسرے کوڈنگ ایجنٹس میں [agentmemory](https://github.com/rohitg00/agentmemory) سیلف ہوسٹ کر رہے ہیں؟ OpenHuman ایک اختیاری `Memory` بیک اینڈ بھیجتا ہے جو اسے پروکسی کرتا ہے — `config.toml` میں `memory.backend = "agentmemory"` سیٹ کریں اور وہی پائیدار اسٹور OpenHuman کے ساتھ Claude Code، Cursor، Codex، اور OpenCode کو طاقت دیتا ہے۔ سیٹ اپ کے لیے [agentmemory بیک اینڈ](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/agentmemory-backend) صفحہ دیکھیں۔
## OpenHuman بمقابلہ دوسرے ایجنٹ ہارنسز
اعلیٰ سطحی موازنہ (مصنوعات تیار ہوتی ہیں، اس لیے ہر وینڈر کے خلاف تصدیق کریں)۔ OpenHuman کو **وینڈر پھیلاؤ کو کم سے کم کرنے**، **ورک فلو کے علم کو ڈیوائس پر رکھنے**، اور ایجنٹ کو آپ کے ڈیٹا کی **مستقل یادداشت** دینے کے لیے بنایا گیا ہے، نہ کہ صرف چیٹ۔
</div>
<div dir="ltr">
| | Claude Cowork | OpenClaw | Hermes Agent | OpenHuman |
| ------------------- | ----------------- | ----------------- | ----------------- | ---------------------------------- |
| **اوپن سورس** | 🚫 ملکیتی | ✅ MIT | ✅ MIT | ✅ GNU |
| **شروع کرنا آسان** | ✅ ڈیسک ٹاپ + کمانڈ لائن | ⚠️ پہلے ٹرمینل | ⚠️ پہلے ٹرمینل | ✅ صاف یوزر انٹرفیس، منٹوں میں |
| **لاگت** | ⚠️ سبسکرپشن + ایڈ آنز | ⚠️ اپنے ماڈل | ⚠️ اپنے ماڈل | ✅ ایک سبسکرپشن + TokenJuice |
| **یادداشت** | ✅ چیٹ تک محدود | ⚠️ پلگ ان پر انحصار | ✅ خود سیکھنا | 🚀 میموری ٹری + Obsidian والٹ، اختیاری [agentmemory](https://github.com/rohitg00/agentmemory) بیک اینڈ |
| **انضمام** | ⚠️ چند کنیکٹر | ⚠️ خود لائیں | ⚠️ خود لائیں | 🚀 118+ OAuth کے ذریعے |
| **خودکار لانا** | 🚫 کوئی نہیں | 🚫 کوئی نہیں | 🚫 کوئی نہیں | ✅ 20 منٹ سنک میموری میں |
| **API پھیلاؤ** | 🚫 اضافی چابیاں | 🚫 اپنی چابیاں | 🚫 کئی وینڈر | ✅ ایک اکاؤنٹ |
| **ماڈل روٹنگ** | 🚫 ایک ماڈل | ⚠️ دستی | ⚠️ دستی | ✅ بلٹ ان |
| **مقامی ٹولز** | ✅ صرف کوڈ | ✅ صرف کوڈ | ✅ صرف کوڈ | ✅ کوڈ + سرچ + سکریپر + آواز |
</div>
<div dir="rtl" lang="ur">
# GitHub پر ہمیں اسٹار کریں
_AGI اور مصنوعی شعور کی طرف بڑھ رہے ہیں؟ ریپو کو اسٹار کریں اور دوسروں کو راستہ تلاش کرنے میں مدد کریں۔_
</div>
<div dir="ltr">
<p align="center">
<a href="https://www.star-history.com/#tinyhumansai/openhuman&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&legend=top-left" />
</picture>
</a>
</p>
</div>
<div dir="rtl" lang="ur">
# شراکت داروں کا ہال آف فیم
کچھ محبت دکھائیں اور ہال آف فیم میں جگہ پائیں۔ شراکت داروں کو مفت مرچ اور ہمارے [ڈسکارڈ](https://discord.tinyhumans.ai/) تک خصوصی رسائی ملتی ہے۔
</div>
<div dir="ltr">
<a href="https://github.com/tinyhumansai/openhuman/graphs/contributors">
<img src="https://contrib.rocks/image?repo=tinyhumansai/openhuman" alt="OpenHuman شراکت دار" />
</a>
</div>
docs/README.zh-CN.md
+149
View File
@@ -0,0 +1,149 @@
<p align="center">
🇺🇸 <a href="../README.md">English</a> | 🇨🇳 <a href="./README.zh-CN.md">简体中文</a> | 🇯🇵 <a href="./README.ja-JP.md">日本語</a> | 🇰🇷 <a href="./README.ko.md">한국어</a> | 🇩🇪 <a href="./README.de.md">Deutsch</a> | 🇵🇰 <a href="./README.ur-pk.md">اردو</a>
</p>
<h1 align="center">OpenHuman</h1>
<p align="center">
<img src="../gitbooks/.gitbook/assets/demo.png" alt="The Tet" />
</p>
<p align="center" style="display: inline-block">
<a href="https://trendshift.io/repositories/23680" target="_blank" style="display: inline-block">
<img src="https://trendshift.io/api/badge/repositories/23680" alt="tinyhumansai%2Fopenhuman | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>
</a>
&nbsp;
<a href="https://www.producthunt.com/products/openhuman?embed=true&amp;utm_source=badge-top-post-badge&amp;utm_medium=badge&amp;utm_campaign=badge-openhuman" target="_blank" rel="noopener noreferrer">
<img alt="OpenHuman - An open source AI harness built with the human in mind | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1136902&amp;theme=light&amp;period=daily&amp;t=1778916022823">
</a>
</p>
<p align="center">
<strong>OpenHuman 是你的个人 AI 超级智能：本地记忆，按需托管服务，简洁而强大。</strong>
</p>
<p align="center">
<a href="https://discord.tinyhumans.ai/">Discord</a> •
<a href="https://www.reddit.com/r/tinyhumansai/">Reddit</a> •
<a href="https://x.com/intent/follow?screen_name=tinyhumansai">X/Twitter</a> •
<a href="https://tinyhumans.gitbook.io/openhuman/">文档</a> •
<a href="https://x.com/intent/follow?screen_name=senamakel">关注 @senamakel（作者）</a>
</p>
<p align="center">
<img src="https://img.shields.io/badge/status-early%20beta-orange" alt="早期测试版" />
<a href="https://github.com/tinyhumansai/openhuman/releases/latest"><img src="https://img.shields.io/github/v/release/tinyhumansai/openhuman?label=latest" alt="最新版本" /></a>
<a href="https://github.com/tinyhumansai/openhuman/stargazers"><img src="https://img.shields.io/github/stars/tinyhumansai/openhuman?style=flat" alt="GitHub Stars" /></a>
<a href="../LICENSE"><img src="https://img.shields.io/github/license/tinyhumansai/openhuman" alt="许可证" /></a>
<a href="../README.md"><img src="https://img.shields.io/badge/lang-English-blue" alt="English" /></a>
<a href="./README.ja-JP.md"><img src="https://img.shields.io/badge/lang-日本語-blue" alt="日本語" /></a>
<a href="./README.ko.md"><img src="https://img.shields.io/badge/lang-한국어-blue" alt="한국어" /></a>
<a href="./README.de.md"><img src="https://img.shields.io/badge/lang-Deutsch-blue" alt="Deutsch" /></a>
<a href="./README.ur-pk.md"><img src="https://img.shields.io/badge/lang-اردو-blue" alt="اردو" /></a>
</p>
> **早期测试版**：正在积极开发中，可能存在不完善之处。
> **本地 + 托管服务，upfront：** OpenHuman 将记忆树、Obsidian 风格 Markdown 仓库、工作区配置和本地运行时状态存储在你的机器上。默认的托管体验仍然使用 OpenHuman 托管服务进行账户登录、模型路由、网页搜索代理，以及通过 Composio 连接器层的托管集成/OAuth 流程。如果你想自带模型、搜索或 Composio 凭据，请选择自定义/本地设置；某些实时触发器和托管功能仍然需要托管后端。
要安装或开始使用，请从 [tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman?utm_source=github&utm_medium=readme) 下载，或在终端中运行：
```bash
# 从 https://tinyhumans.ai/openhuman 下载 DMG、EXE，或在终端中运行
# macOS 或 Linux x64
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
# Windows
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex
```
<!-- TODO: translate (zh-CN) — English source mirrored from README.md so non-EN readers get the same install caveats. Please translate. -->
> **Linux:** the AppImage can crash on launch under Wayland (and on Arch-based distros with `sharun: Interpreter not found!`) — see [#2463](https://github.com/tinyhumansai/openhuman/issues/2463) for the cause and env-var workarounds.
Arch Linux package maintainers can use the [`openhuman-bin` AUR recipe](../packages/arch/openhuman-bin/);
once published, Arch users can install it with `yay -S openhuman-bin`.
<!-- /TODO -->
# 什么是 OpenHuman？
OpenHuman 是一个开源智能助手，旨在融入你的日常生活。以下每条链接都指向[文档](https://tinyhumans.gitbook.io/openhuman/)中更详细的说明。
- **简洁、UI 优先、人性化** — 清爽的桌面体验和简短的入门流程让你从安装到拥有一个可用的智能体仅需几次点击——无需先配置，无需终端。智能体有[一张脸](https://tinyhumans.gitbook.io/openhuman/features/mascot)：一个桌面吉祥物，会说话、能感知周围环境、可作为真实参与者[加入你的 Google Meet 会议](https://tinyhumans.gitbook.io/openhuman/features/mascot/meeting-agents)、跨周记住你，即使你停止输入后仍在后台持续思考。
- **[118+ 第三方集成](https://tinyhumans.gitbook.io/openhuman/features/integrations) + [自动拉取](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch)**：通过**一键 OAuth** 接入 Gmail、Notion、GitHub、Slack、Stripe、Calendar、Drive、Linear、Jira 以及你技术栈中的其他服务。每个连接都以类型化工具的形式暴露给智能体，核心每 20 分钟遍历每个活跃连接并将新数据拉入[记忆树](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch)中。无需提示词，无需手动编写轮询循环，智能体在每天早上就已经拥有当天的上下文。
托管集成使用 OpenHuman 的 Composio 连接器层。OAuth 握手和集成工具调用默认通过托管后端代理。如果你想直接运行 Composio，请使用你自己的 Composio API key 配置直连模式；实时触发器 webhook 则需要由你自行托管和接入。
- **[记忆树](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian Wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)**：一个基于你的数据和活动构建的本地优先知识库。你连接的所有内容都被规范化为不超过 3k token 的 Markdown 片段，经过评分后折叠成层级化的摘要树，存储在**你本机的 SQLite** 中。同样的片段以 `.md` 文件形式落地到兼容 Obsidian 的仓库中，你可以打开、浏览和编辑，灵感来源于 Karpathy 的 [obsidian-wiki 工作流](https://x.com/karpathy/status/2039805659525644595)。
- **开箱即用**：默认内置网络搜索、网页抓取[爬虫](https://tinyhumans.gitbook.io/openhuman/features/native-tools)、完整的编码工具集（文件系统、git、lint、test、grep）以及[原生语音](https://tinyhumans.gitbook.io/openhuman/features/voice)（STT 输入、ElevenLabs TTS 输出、吉祥物口型同步、实时 Google Meet 智能体）。默认情况下，[模型路由](https://tinyhumans.gitbook.io/openhuman/features/model-routing)使用 OpenHuman 后端来选择和代理每个工作负载的合适 LLM（推理型、快速型或视觉型）。一个订阅包含所有模型。没有"安装插件才能读文件"的摩擦。[可选通过 Ollama 使用本地 AI](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai) 处理端侧工作负载。
- **[智能 Token 压缩（TokenJuice）](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**：每个工具调用、抓取结果、邮件正文和搜索载荷在触达任何 LLM 模型之前都会经过 token 压缩层处理。HTML 被转换为 Markdown，长 URL 被缩短，冗长的工具输出会通过可配置的规则层去重并摘要等等。中文、emoji 等多字节字符按字形（grapheme）完整保留，绝不丢弃。你获得相同的信息，但 token 消耗仅为原来的几分之一。最多可降低 80% 的成本和延迟。
- **[消息渠道](https://tinyhumans.gitbook.io/openhuman/features/integrations#messaging-channels)** 与 **[隐私与安全](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**：通过你日常使用的渠道进行收发，工作流数据保留在设备上，本地加密，始终属于你。
## 从源码贡献
新贡献者？从 [`CONTRIBUTING.md`](../CONTRIBUTING.md) 了解 fork/PR 工作流和本地验证命令。快速路径：
1. 安装 Git、Node.js 24+、pnpm 10.10.0、Rust 1.93.0（`rustfmt` + `clippy`）、CMake、Ninja、ripgrep，以及各平台桌面构建的前置依赖。
2. Fork 并克隆仓库，然后运行 `git submodule update --init --recursive` 之后再执行 `pnpm install`，确保内置的 Tauri/CEF 源码就位。
3. 使用 `pnpm dev` 进行纯 Web UI 开发，`pnpm --filter openhuman-app dev:app` 用于桌面壳，在提交 PR 之前运行针对性的检查如 `pnpm typecheck`、`pnpm format:check` 和 `cargo check -p openhuman --lib`。
更多文档：[架构](https://tinyhumans.gitbook.io/openhuman/developing/architecture) · [环境搭建](https://tinyhumans.gitbook.io/openhuman/developing/getting-set-up) · [云端部署](../gitbooks/features/cloud-deploy.md)。
## 几分钟内建立上下文，而非数周
OpenHuman 是首个能在几分钟内了解你的智能体框架。灵感来源于 [Karpathy 的 LLM 知识库](https://x.com/karpathy/status/2039805659525644595)。大多数智能体从零开始——Hermes 通过观察你的工作来学习；OpenClaw 等待插件输送上下文。无论哪种方式，你都需要花费数天甚至数周时间，智能体才能对你的技术栈有足够的了解从而真正发挥作用。
<p align="center">
<img src="../gitbooks/.gitbook/assets/image (1).png" alt="OpenHuman 上下文构建示意图" />
</p>
> OpenHuman 将你的所有文档、邮件和聊天记录进行摘要和压缩，并创建一个记忆图谱，让你的智能体记住关于你的一切。
OpenHuman 跳过了等待期。连接你的账户，让[自动拉取](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch)以 20 分钟为周期将数据拉到本地，然后由[记忆树](https://tinyhumans.gitbook.io/openhuman/features/memory-tree)将所有内容压缩为 Markdown 文件，智能存储在一个 [Karpathy 风格的 Obsidian wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki) 中。
仅需一次同步，智能体就拥有了你收件箱、日历、仓库、文档、消息的完整（压缩后的）上下文。无需训练期，无需"给它几周时间"。它成为你，由你掌控。
已经在其他编码智能体中自托管 [agentmemory](https://github.com/rohitg00/agentmemory)？OpenHuman 提供可选的 `Memory` 后端来代理它——在 `config.toml` 中设置 `memory.backend = "agentmemory"`，同一个持久化存储将同时服务于 OpenHuman 和 Claude Code、Cursor、Codex、OpenCode。详见 [agentmemory 后端](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/agentmemory-backend)页面。
## OpenHuman vs 其他智能体框架
高层次对比（产品持续演进，请以各厂商最新情况为准）。OpenHuman 的设计目标是**减少供应商碎片化**、将**工作流知识保留在设备上**、为智能体提供对你数据的**持久记忆**，而不仅仅是对话。
| | Claude Cowork | OpenClaw | Hermes Agent | OpenHuman |
| ------------------- | ----------------- | ----------------- | ----------------- | ---------------------------------- |
| **开源** | 🚫 闭源 | ✅ MIT | ✅ MIT | ✅ GNU |
| **易上手** | ✅ 桌面 + CLI | ⚠️ 终端优先 | ⚠️ 终端优先 | ✅ 清爽 UI，几分钟上手 |
| **成本** | ⚠️ 订阅 + 附加项 | ⚠️ 自带模型 | ⚠️ 自带模型 | ✅ 单一订阅 + TokenJuice |
| **记忆** | ✅ 对话范围 | ⚠️ 依赖插件 | ✅ 自学习 | 🚀 记忆树 + Obsidian 仓库，可选 [agentmemory](https://github.com/rohitg00/agentmemory) 后端 |
| **集成** | ⚠️ 少量连接器 | ⚠️ 自行接入 | ⚠️ 自行接入 | 🚀 118+ 通过 OAuth |
| **自动拉取** | 🚫 无 | 🚫 无 | 🚫 无 | ✅ 20 分钟同步到记忆 |
| **API 碎片化** | 🚫 额外密钥 | 🚫 自带密钥 | 🚫 多供应商 | ✅ 一个账户 |
| **模型路由** | 🚫 单一模型 | ⚠️ 手动 | ⚠️ 手动 | ✅ 内置 |
| **原生工具** | ✅ 仅代码 | ✅ 仅代码 | ✅ 仅代码 | ✅ 代码 + 搜索 + 抓取 + 语音 |
# 在 GitHub 上为我们加星
_致力于 AGI 和人工意识？为仓库加星，帮助更多人找到这条路。_
<p align="center">
<a href="https://www.star-history.com/#tinyhumansai/openhuman&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&legend=top-left" />
</picture>
</a>
</p>
# 贡献者名人堂
贡献一份力量，进入名人堂。贡献者可获得免费周边以及我们 [Discord](https://discord.tinyhumans.ai/) 的专属访问权限。
<a href="https://github.com/tinyhumansai/openhuman/graphs/contributors">
<img src="https://contrib.rocks/image?repo=tinyhumansai/openhuman" alt="OpenHuman contributors" />
</a>