Files
openhuman/README.md
T
a5788b88e3 fix(autocomplete): reliability bugs and in-app ghost text (#107) (#179)
* fix(autocomplete): add 30s timeout to inference HTTP client

reqwest::Client::new() creates a client with no timeout, causing
inference calls to block indefinitely when Ollama is slow or
unreachable. Admin endpoints had explicit timeouts but inference
did not.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(autocomplete): improve engine reliability and suppress in-app notifications

- Wrap engine loop refresh() in 15s tokio timeout to prevent blocking
- Handle AX error -1728 (Electron apps) gracefully as idle, not error
- Clear stale state (last_error, suggestion, context) on stop()
- Add skip_apply flag to AutocompleteAcceptParams so frontend can
  accept without triggering AppleScript text insertion
- Skip AX-based Tab accept and overlay when OpenHuman is focused
- Guard all show_overflow_badge calls with app_name check to suppress
  Script Editor notifications when typing in the chat composer
- Cache inference results: skip Ollama call when context is unchanged
  and a suggestion already exists

Closes #107

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(autocomplete): add skip_apply to AutocompleteAcceptParams type

Frontend passes skip_apply: true when accepting ghost text so the
backend only persists for personalization without AppleScript insertion.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(autocomplete): fix ghost text display, alignment, and acceptance

- Fix getInlineCompletionSuffix to handle backend's continuation
  suffix format (not just full-string format)
- Add 120s safety timeout to clear isSending if no response arrives
- Match textarea CSS to overlay div (leading-normal, whitespace-pre-wrap,
  break-words, font-sans) so ghost text aligns on multi-line wrap
- Pass skip_apply: true when accepting to prevent double text insertion
- Add Right Arrow key acceptance when cursor is at end of input

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* style: apply prettier + cargo fmt formatting

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* format

* Update README.md to enhance installation instructions and clarify project overview

- Added installation commands for MacOS/Linux and Windows users.
- Removed redundant download section and streamlined the project description.
- Updated the GitHub star section to be commented out for clarity.

This update improves user onboarding by providing clear installation steps and a concise project overview.

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Steven Enamakel <enamakel@tinyhumans.ai>
2026-04-01 16:18:47 -07:00

7.1 KiB
Raw Blame History

OpenHuman

The age of super intelligence is here. OpenHuman is your Personal AI super intelligence. Private, Simple and extremely powerful.

DiscordRedditX/TwitterDocs

Early Beta Platforms: desktop only Latest Release

The Tet

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

Early Beta — Under active development. Expect rough edges.

To install or get started, either download from the website over at tinyhumans.ai/openhuman or run

# For MacOS/Linux
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

# For Windows
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

What is OpenHuman?

OpenHuman is an open-source agentic assistant that is designed to integrate with you in your daily life. Here's what makes OpenHuman special:

  • One subscription, many providers — One assistant wired to skills and backend models so you are not juggling a separate subscription stack for every integration surface.

  • Incredible memoryRust-side memory (store / recall / namespaces) plus optional TinyHumans Neocortex-backed context when configured, so the agent can retain and retrieve more than a single chat window. Channels and ongoing conversations feed the same loop so day-to-day context does not reset every session.

  • Screen intelligence — Regular screen capture (on a cadence or when triggered) feeds an on-device pipeline that understands what is on screen, distills it into memory (facts, UI state, workflows), and can propose actions the agent executes for you. OS permissions and capture APIs vary by platform; the goal is your machine first, not shipping raw frames to the cloud by default.

  • Voice & meetings — A Local-model speech stack (listen / TTS) let the assistant talk back and capture or work with meeting audio with a privacy-first default when you route inference locally. Transcripts and summaries land in the same memory + agent loop so OpenHuman can follow up: tasks, drafts, calendar nudges, or skill-backed workflows—without treating a meeting as a one-off chat.

  • Memory-aware autocompleteKeyboard autocomplete is built for right-context suggestions: it consults memory namespaces and recent context so completions stay aligned with you, your workspace, and prior sessions—not a blank model every keystroke.

  • Runs a 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.

  • Simple or advancedSkill setup wizards and defaults for common tools, with room to go deeper via settings, credentials, and core RPC when you need control and privacy.

Architecture: docs/ARCHITECTURE.md. Contributor orientation: CONTRIBUTING.md.

Under the hood (Architecture)

OpenHuman is a desktop monorepo: Rust owns business logic and execution; the UI owns interaction, layout, and OS integration.

Rust (openhuman / openhuman_core). The repo root src/ crate is the brain: JSON-RPC over HTTP (core_server), domain modules (auth, config, memory, skills, channels, screen intelligence, local AI, cron, …), and a QuickJS runtime for sandboxed JavaScript skills. The openhuman binary is built and staged next to the Tauri app so the desktop shell can spawn it as a sidecar. Heavy work—SQLite, sockets, crypto, skill lifecycle—runs there under Tokio, not in the WebView.

UI (app/). Vite + React (TypeScript) implements screens, onboarding, settings, and realtime UX. Redux Toolkit holds client state; Socket.io and the MCP-style client stack stay in sync with the cores realtime surface. Tauri v2 (app/src-tauri/) is a thin Rust host: windowing, filesystem hooks where needed, and core_rpc_relay—forwarding JSON-RPC from the WebView to the openhuman process so the UI never re-implements domain rules.

Controllers and the RPC surface. Features are exposed as registered controllers: each domain declares schemas (namespace, function name, parameter shapes) and a handler. At runtime, calls are validated, dispatched by method name (e.g. openhuman.auth_get_state, openhuman.local_ai_agent_chat), and return structured outcomes. CLI and HTTP share the same controller catalog, so automation, tests, and the app all hit one contract.

What ties it together: one registry of controllers, one sidecar process for execution, Tauri IPC for shell-only capabilities, and HTTP JSON-RPC for everything else—plus skills and dual-socket behavior documented in the architecture guide.

Read more: docs/ARCHITECTURE.md · Frontend tree: docs/src/README.md · Tauri commands: docs/src-tauri/README.md

Contributors Hall of Fame

Show some love and end up in the hall of fame

OpenHuman contributors