- Follow @senamakel (Creator)
+ The age of super intelligence is here.
+ OpenHuman is your Personal AI super intelligence.
+ Private, Simple and extremely powerful.
- "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
+**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?
+
+
+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 |
+
+
+
+---
+
+
+
+ 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
+
+
+| 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 |
+
+---
+
+
+
+### 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
+
-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.
+