diff --git a/README.md b/README.md index e99fb9be0..66b0b67d8 100644 --- a/README.md +++ b/README.md @@ -1,108 +1,287 @@ -

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 + + GitHub release (latest by date) + + + CI Status + + + Stars + + + Forks +

- The Tet + Discord + Reddit + X + Documentation

-

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

+--- + +

+ Quick Start + 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 +**macOS / Linux:** +```bash curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash +``` -# For Windows +**Windows (PowerShell - Run as Administrator):** +```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 + 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 + 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 | + +
+ +--- + +

+ Why OpenHuman + Why OpenHuman? +

+ +#### 🔒 **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 + +#### 💻 **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 + +#### 🧠 **Intelligent Memory** +- **Neocortex** — local-first knowledge base that learns from your activity +- **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 + +#### ⚡ **Rich Skills & Integrations** +- One-click connections to **Gmail**, **Slack**, **Notion**, and more +- **Webhooks** for instant feedback from external systems +- No manual API wiring required + +#### 💰 **Cost Effective** +- Local-friendly architecture reduces cloud dependency +- One account consolidates multiple AI provider costs +- Ship your own AI runners where applicable + +--- + +

+ 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 | + +--- + +

+ Comparison + 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 + Installation +

+ +### Requirements + +| 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 +curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash +``` + +#### Windows -OpenHuman is an open-source agentic assistant that is designed to integrate with you in your daily life. Here's what makes OpenHuman special: +```powershell +# Run PowerShell as Administrator +irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex +``` -- **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. +### Download Directly -- **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. +Visit **[tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman)** to download the latest release for your platform. -- **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. +### Build from Source -- **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. +For development setup, see the [installation docs](docs/install.md#running-from-source). -- **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. +--- -- **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. +

+ Documentation + Documentation +

-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). +
-## Highlights +| 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 | -- **[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. +
-## OpenHuman vs other agents +--- -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. +

+ Community + Community & Support +

-| | 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 | +

+ Discord + Reddit + X + Follow Creator +

-# Star us on GitHub +--- -_Building toward AGI and artificial consciousness? Star the repo and help others find the path._ +

+ Star History + Star History +

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

-# Contributors Hall of Fame +--- -Show some love and end up in the hall of fame +

+ Contributors + Contributors +

+ +

+ + OpenHuman Contributors - Hall of Fame + +

- - OpenHuman contributors - +

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

+ +--- + +

+ License + License +

+ +

+ License +

+ +

+ 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. +

\ No newline at end of file