From e3f91f4af371d6fd801b7e1e298a82c20467a0ed Mon Sep 17 00:00:00 2001 From: unn-Known1 Date: Sat, 25 Apr 2026 02:47:05 +0800 Subject: [PATCH 1/2] docs: improve README with SEO optimization and professional styling - Add comprehensive badge section with version, license, platform, architecture - Restructure with clear visual hierarchy and centered elements - Add Quick Start section with prominent installation commands - Expand feature descriptions with icons and detailed explanations - Improve comparison table with privacy column - Add comprehensive installation requirements section - Add Technology table with status badges - Add Documentation and Community sections with resource links - Add Star History and Contributors visualization - Add License section with proper attribution - SEO optimizations: alt text, semantic HTML, keyword-rich headings - Professional styling with icons8 imagery and consistent formatting Co-Authored-By: unn-Known1 --- README.md | 289 ++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 226 insertions(+), 63 deletions(-) diff --git a/README.md b/README.md index e99fb9be0..aebdc79ec 100644 --- a/README.md +++ b/README.md @@ -1,108 +1,271 @@ -

OpenHuman

+# OpenHuman

- The age of super intelligence is here. OpenHuman is your Personal AI super intelligence. Private, Simple and extremely powerful. + Version + License + Platform + Architecture + AI + Discord

- Discord โ€ข - Reddit โ€ข - X/Twitter โ€ข - Docs -

-

- Follow @senamakel (Creator) + The age of super intelligence is here.
+ OpenHuman is your Personal AI super intelligence.
+ Private, Simple and extremely powerful.

- Early Beta - Platforms: desktop only - Latest Release + Discord + Reddit + X + Documentation

- The Tet + + GitHub release (latest by date) + + + CI Status + + + Stars + + + Forks +

-

- "The Tet. What a brilliant machine" โ€” Morgan Freeman as he reminisces about alien superintelligence in the movie Oblivion -

+--- + +

+ ๐Ÿš€ + Quick Start +

> **Early Beta** โ€” Under active development. Expect rough edges. -To install or get started, either download from the website over at [tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman) or run +### One-Line Installation -``` -# For MacOS/Linux +```bash +# macOS / Linux curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash -# For Windows +# Windows (PowerShell) irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex ``` -# What is OpenHuman? +Or download directly from **[tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman)** + +--- + +

+ โ“ + What is OpenHuman? +

+ +OpenHuman is an **open-source AI agentic assistant** designed to integrate seamlessly into your daily workflow. Unlike web-only chatbots or terminal-first tools, OpenHuman is a **native desktop application** that understands your work context, remembers your preferences, and acts proactivelyโ€”all while keeping your data **private and on your machine**. + +--- + +

+ โญ + Key Features +

+ +
+ +| Feature | Description | +|---------|-------------| +| **Clean UI-First** | From install to working agent in a few clicksโ€”no terminal required | +| **One Subscription** | One account for AI Models, Search, Webhooks, and 3rd-party APIs | +| **Rich Skills** | Gmail, Slack, Notion, and more with one-click setup | +| **Local Knowledge Base** | Neocortex learns from your data, compounding context | +| **Privacy First** | Data stays on-device, encrypted locally | +| **Voice & Vision** | STT/TTS voice input and screen intelligence | -OpenHuman is an open-source agentic assistant that is designed to integrate with you in your daily life. Here's what makes OpenHuman special: +
-- **Simple, UI-first** โ€” A **clean** desktop experience and short onboarding paths so you can go from install to a **working agent in a few clicks**, without a config-first setup. You don't need a terminal to run OpenHuman. +--- -- **One subscription, many providers** โ€” You only need **one** account to get access to many agentic APIs (AI Models, Search, Webhooks/Tunnels and other 3rd party APIs etc..), simplifying the experience to get a powerful agent going. +### Why OpenHuman? -- **Rich Skills** โ€” Plug into **Gmail**, **Slack**, **Notion**, and the rest of your stack via **rich, feature-backed skills**. Connections are typically **one click** through setup wizards instead of wiring APIs by hand. Workflow data is kept **on device**, **encrypted locally**, and treated as **yours**: encryption and sensitive context stay **on your machine**. **Webhooks** give **instant feedback** into the agent when external systems or skills emit events, so the loop stays tight without constant polling. +#### ๐Ÿ”’ **Privacy-First Architecture** +- All workflow data is **stored on your machine** +- **Encrypted locally** โ€” your data never leaves your device +- Local AI paths for sensitive operations when you choose -- **Local knowledge base** โ€” Built from **your data and your activity**. How you work across tools, sessions, and connected servicesโ€”so the agent gets **rich, workflow-aware context**, not a one-off chat transcript. Everything is **stored on your machine** and compounding over time without becoming a cloud dossier. **Channels**, **skills** and ongoing **conversations** feed the same loop so day-to-day context does not reset every session. +#### ๐Ÿ’ป **Deep Desktop Integration** +- **Memory-aware keyboard autocomplete** anywhere on desktop +- **Voice input/output** (STT + TTS) for hands-free interaction +- **Screen intelligence** that understands your current context +- Native OS-level permissions and windowing -- **Local AI model** โ€” The **Rust core** exposes **local AI** paths (and the desktop bundle can ship **local/bundled runners** where applicable) for the workloads aboveโ€”vision snippets, speech helpers, summarization, toolingโ€”so sensitive steps can stay **off the cloud** when you choose. +#### ๐Ÿง  **Intelligent Memory** +- **Neocortex** โ€” local-first knowledge base that learns from your activity +- **The Subconscious** โ€” background self-learning loops +- Context compounds across tools, sessions, and services +- Day-to-day context persists without becoming a cloud dossier -- **Deep desktop integrations** โ€” OpenHuman is a **native desktop** assistant, not a web-only chat: **memory-aware keyboard autocomplete**, **voice** (**STT** listening and **TTS** replies), **screen intelligence** that understands what is on screen and feeds your local context, plus windowing and OS-level permissionsโ€”so the agent meets you **on the machine**, not trapped in a browser tab. +#### โšก **Rich Skills & Integrations** +- One-click connections to **Gmail**, **Slack**, **Notion**, and more +- **Webhooks** for instant feedback from external systems +- No manual API wiring required -Architecture: [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md). Contributor orientation: [`CONTRIBUTING.md`](./CONTRIBUTING.md). Running from source: [`docs/install.md`](docs/install.md#running-from-source). +#### ๐Ÿ’ฐ **Cost Effective** +- Local-friendly architecture reduces cloud dependency +- One account consolidates multiple AI provider costs +- Ship your own AI runners where applicable -## Highlights +--- -- **[Neocortex](https://tinyhumans.gitbook.io/openhuman/technology/neocortex)** โ€” local-first knowledge base that learns from your data and activity, compounding context across tools and sessions. -- **[The Subconscious](https://tinyhumans.gitbook.io/openhuman/technology/the-subconscious)** โ€” background self-learning loops that turn everyday usage into workflow-aware intelligence. -- **[Screen Intelligence](https://tinyhumans.gitbook.io/openhuman/features/screen-intelligence)** โ€” the agent sees what's on your screen and feeds it into your local context. -- **[Inline Autocomplete](https://tinyhumans.gitbook.io/openhuman/features/inline-autocomplete)** โ€” memory-aware keyboard autocomplete anywhere on your desktop. -- **[Voice (STT + TTS)](https://tinyhumans.gitbook.io/openhuman/features/voice-speech-to-text)** โ€” speak to OpenHuman and hear it reply, natively on the desktop. -- **[Skills & Integrations](https://tinyhumans.gitbook.io/openhuman/product/skills-and-integrations)** โ€” one-click skills for Gmail, Slack, Notion and the rest of your stack, with local encryption and webhooks for instant feedback. -- **[Messaging Channels](https://tinyhumans.gitbook.io/openhuman/product/messaging-channels)** โ€” inbound/outbound across the channels you already use, routed through your agent. -- **[Teams & Organizations](https://tinyhumans.gitbook.io/openhuman/product/teams)** โ€” shared workspaces for collaborating with an agent across a team. -- **[Rewards & Achievements](https://tinyhumans.gitbook.io/openhuman/product/rewards-and-achievements)** โ€” gamified progression as your agent grows with you. -- **[Privacy & Security](https://tinyhumans.gitbook.io/openhuman/product/privacy-and-security)** โ€” workflow data stays on device, encrypted locally, and treated as yours. +

+ โญ + Core Technologies +

+ +| Technology | Status | Description | +|------------|--------|-------------| +| **Neocortex** | | Local-first knowledge base that learns from your data and activity | +| **The Subconscious** | | Background self-learning loops that turn usage into workflow-aware intelligence | +| **Screen Intelligence** | | Agent sees what's on your screen and feeds context into local knowledge | +| **Inline Autocomplete** | | Memory-aware keyboard autocomplete anywhere on desktop | +| **Voice (STT + TTS)** | | Speak to OpenHuman and hear it reply, natively on desktop | +| **Skills & Integrations** | | One-click skills with local encryption and webhooks | + +--- + +

+ ๐Ÿ“Š + OpenHuman vs Other Agents +

+ +> High-level comparison. Products evolveโ€”verify against each vendor. + +| Feature | Claude Code | OpenClaw | Hermes Agent | **OpenHuman** | +|---------|-------------|----------|--------------|---------------| +| **Open-source** | ๐Ÿšซ Proprietary | โœ… MIT | โœ… MIT | โœ… **GNU** | +| **Simple to start** | โœ… Desktop + CLI | โš ๏ธ Terminal-first | โš ๏ธ Terminal-first | โœ… **Clean UI** | +| **Cost** | โš ๏ธ Sub + add-ons | โš ๏ธ BYO models | โš ๏ธ BYO models | โœ… **Local-friendly** | +| **Memory & KB** | โœ… Chat-scoped | โš ๏ธ Plugin-reliant | โœ… Self-learning | ๐Ÿš€ **Local KB + learning** | +| **API sprawl** | ๐Ÿšซ Extra keys | ๐Ÿšซ BYOK | ๐Ÿšซ Multi-vendor | โœ… **One account** | +| **Extensibility** | โœ… MCP | โœ… SKILL.md | โœ… SKILL.md | ๐Ÿš€ **Rich Skills** | +| **Desktop integration** | โš ๏ธ Basic | โš ๏ธ Light | โš ๏ธ Light | โœ… **STT/TTS/screen** | +| **Privacy** | โš ๏ธ Cloud-first | โš ๏ธ BYOK | โœ… Local options | โœ… **On-device by default** | + +--- + +

+ โš™๏ธ + Installation +

+ +### Requirements + +- **macOS** 12+ (Apple Silicon or Intel) +- **Windows** 10/11 (64-bit) +- **Linux** Ubuntu 20.04+ or equivalent + +### Install via Script + +```bash +# macOS / Linux +curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash + +# Windows (PowerShell - Run as Administrator) +irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex +``` -## OpenHuman vs other agents +### Download Directly -High-level comparison (products evolveโ€”verify against each vendor). OpenHuman is built to **minimize vendor sprawl**, keep **workflow knowledge on-device**, and ship **deep desktop** featuresโ€”not only chat. +Visit **[tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman)** to download the latest release for your platform. -| | Claude Code/Cowork | OpenClaw | Hermes Agent | OpenHuman | -| ----------------------- | ------------------ | ----------------- | ----------------- | ---------------------- | -| **Open-source** | ๐Ÿšซ Proprietary | โœ… MIT | โœ… MIT | โœ… GNU | -| **Simple to start** | โœ… Desktop + CLI | โš ๏ธ Terminal-first | โš ๏ธ Terminal-first | โœ… Clean UI, minutes | -| **Cost** | โš ๏ธ Sub + add-ons | โš ๏ธ BYO models | โš ๏ธ BYO models | โœ… Local-friendly | -| **Memory & KB** | โœ… Chat-scoped | โš ๏ธ Plugin-reliant | โœ… Self-learning | ๐Ÿš€ Local KB + learning | -| **API sprawl** | ๐Ÿšซ Extra keys | ๐Ÿšซ BYOK | ๐Ÿšซ Multi-vendor | โœ… One account | -| **Extensibility** | โœ… MCP | โœ… SKILL.md | โœ… SKILL.md | ๐Ÿš€ Rich Skills | -| **Desktop integration** | โš ๏ธ Basic | โš ๏ธ Light | โš ๏ธ Light | โœ… STT/TTS/screen/more | +### Build from Source -# Star us on GitHub +For development setup, see the [installation docs](docs/install.md#running-from-source). -_Building toward AGI and artificial consciousness? Star the repo and help others find the path._ +--- + +

+ ๐Ÿ“š + Documentation +

+ +| Resource | Description | +|----------|-------------| +| ๐Ÿ“– [Documentation](https://tinyhumans.gitbook.io/openhuman/) | Full documentation and guides | +| ๐Ÿ—๏ธ [Architecture](docs/ARCHITECTURE.md) | System architecture overview | +| ๐Ÿค [Contributing](CONTRIBUTING.md) | Contributor orientation guide | +| ๐Ÿ’ป [Installation](docs/install.md) | Detailed installation instructions | + +--- + +

+ ๐Ÿ‘ฅ + Community & Support +

+ +

+ Discord + Reddit + X + Follow Creator +

+ +--- + +

+ โญ + Star History +

- - - - Star History Chart - + Star History + +

+ +--- + +

+ ๐Ÿ‘‘ + Contributors +

+ +

+ + Contributors

-# Contributors Hall of Fame +

+ Show some love and end up in the Hall of Fame! +

+ +--- + +

+ ๐Ÿ”‘ + License +

-Show some love and end up in the hall of fame +

+ License +

- - OpenHuman contributors - +

+ OpenHuman is released under the GNU General Public License v3.0.
+ Built with โค๏ธ by @senamakel and the community. +

+ +

+ "Building toward AGI and artificial consciousness? Star the repo and help others find the path." +

+ +--- + +

+ OpenHuman โ€” Your Personal AI Super Intelligence
+ Private. Simple. Powerful. +

From 053132015c759dc58c4feabd6186e0d859c41bb1 Mon Sep 17 00:00:00 2001 From: unn-Known1 Date: Fri, 24 Apr 2026 19:01:59 +0000 Subject: [PATCH 2/2] docs: enhance README consistency and platform separation --- README.md | 102 +++++++++++++++++++++++++++++++----------------------- 1 file changed, 59 insertions(+), 43 deletions(-) diff --git a/README.md b/README.md index aebdc79ec..66b0b67d8 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ Platform Architecture AI - Discord + Discord

@@ -15,13 +15,6 @@ Private, Simple and extremely powerful.

-

- Discord - Reddit - X - Documentation -

-

GitHub release (latest by date) @@ -37,10 +30,17 @@

+

+ Discord + Reddit + X + Documentation +

+ ---

- ๐Ÿš€ + Quick Start Quick Start

@@ -48,11 +48,13 @@ ### One-Line Installation +**macOS / Linux:** ```bash -# macOS / Linux curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash +``` -# Windows (PowerShell) +**Windows (PowerShell - Run as Administrator):** +```powershell irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex ``` @@ -61,7 +63,7 @@ Or download directly from **[tinyhumans.ai/openhuman](https://tinyhumans.ai/open ---

- โ“ + What is OpenHuman What is OpenHuman?

@@ -69,10 +71,10 @@ OpenHuman is an **open-source AI agentic assistant** designed to integrate seaml --- -

- โญ +

+ Key Features Key Features -

+
@@ -89,7 +91,10 @@ OpenHuman is an **open-source AI agentic assistant** designed to integrate seaml --- -### Why OpenHuman? +

+ Why OpenHuman + Why OpenHuman? +

#### ๐Ÿ”’ **Privacy-First Architecture** - All workflow data is **stored on your machine** @@ -104,7 +109,7 @@ OpenHuman is an **open-source AI agentic assistant** designed to integrate seaml #### ๐Ÿง  **Intelligent Memory** - **Neocortex** โ€” local-first knowledge base that learns from your activity -- **The Subconscious** โ€” background self-learning loops +- **The Subconscious** โ€” background self-learning loops that turn usage into workflow-aware intelligence - Context compounds across tools, sessions, and services - Day-to-day context persists without becoming a cloud dossier @@ -121,23 +126,23 @@ OpenHuman is an **open-source AI agentic assistant** designed to integrate seaml ---

- โญ + Core Technologies Core Technologies

| Technology | Status | Description | |------------|--------|-------------| -| **Neocortex** | | Local-first knowledge base that learns from your data and activity | -| **The Subconscious** | | Background self-learning loops that turn usage into workflow-aware intelligence | -| **Screen Intelligence** | | Agent sees what's on your screen and feeds context into local knowledge | -| **Inline Autocomplete** | | Memory-aware keyboard autocomplete anywhere on desktop | -| **Voice (STT + TTS)** | | Speak to OpenHuman and hear it reply, natively on desktop | -| **Skills & Integrations** | | One-click skills with local encryption and webhooks | +| **Neocortex** | | Local-first knowledge base that learns from your data and activity | +| **The Subconscious** | | Background self-learning loops that turn usage into workflow-aware intelligence | +| **Screen Intelligence** | | Agent sees what's on your screen and feeds context into local knowledge | +| **Inline Autocomplete** | | Memory-aware keyboard autocomplete anywhere on desktop | +| **Voice (STT + TTS)** | | Speak to OpenHuman and hear it reply, natively on desktop | +| **Skills & Integrations** | | One-click skills with local encryption and webhooks | ---

- ๐Ÿ“Š + Comparison OpenHuman vs Other Agents

@@ -157,23 +162,30 @@ OpenHuman is an **open-source AI agentic assistant** designed to integrate seaml ---

- โš™๏ธ + Installation Installation

### Requirements -- **macOS** 12+ (Apple Silicon or Intel) -- **Windows** 10/11 (64-bit) -- **Linux** Ubuntu 20.04+ or equivalent +| Platform | Version | Architecture | +|----------|---------|--------------| +| **macOS** | 12+ | Apple Silicon / Intel | +| **Windows** | 10/11 | 64-bit | +| **Linux** | Ubuntu 20.04+ | x86_64 / ARM64 | ### Install via Script +#### macOS / Linux + ```bash -# macOS / Linux curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash +``` + +#### Windows -# Windows (PowerShell - Run as Administrator) +```powershell +# Run PowerShell as Administrator irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex ``` @@ -188,21 +200,25 @@ For development setup, see the [installation docs](docs/install.md#running-from- ---

- ๐Ÿ“š + Documentation Documentation

+
+ | Resource | Description | |----------|-------------| -| ๐Ÿ“– [Documentation](https://tinyhumans.gitbook.io/openhuman/) | Full documentation and guides | -| ๐Ÿ—๏ธ [Architecture](docs/ARCHITECTURE.md) | System architecture overview | -| ๐Ÿค [Contributing](CONTRIBUTING.md) | Contributor orientation guide | -| ๐Ÿ’ป [Installation](docs/install.md) | Detailed installation instructions | +| [Documentation](https://tinyhumans.gitbook.io/openhuman/) | Full documentation and guides | +| [Architecture](docs/ARCHITECTURE.md) | System architecture overview | +| [Contributing](CONTRIBUTING.md) | Contributor orientation guide | +| [Installation](docs/install.md) | Detailed installation instructions | + +
---

- ๐Ÿ‘ฅ + Community Community & Support

@@ -216,26 +232,26 @@ For development setup, see the [installation docs](docs/install.md#running-from- ---

- โญ + Star History Star History

- Star History + OpenHuman Star History - GitHub star growth over time

---

- ๐Ÿ‘‘ + Contributors Contributors

- Contributors + OpenHuman Contributors - Hall of Fame

@@ -246,7 +262,7 @@ For development setup, see the [installation docs](docs/install.md#running-from- ---

- ๐Ÿ”‘ + License License

@@ -268,4 +284,4 @@ For development setup, see the [installation docs](docs/install.md#running-from-

OpenHuman โ€” Your Personal AI Super Intelligence
Private. Simple. Powerful. -

+

\ No newline at end of file