Skip to content

docs(readme): sync PR #2426 managed-backend clarifications to all lan…#2526

Open
JAYcodr wants to merge 1 commit into
tinyhumansai:mainfrom
JAYcodr:fix/readme-multilang-sync-2426
Open

docs(readme): sync PR #2426 managed-backend clarifications to all lan…#2526
JAYcodr wants to merge 1 commit into
tinyhumansai:mainfrom
JAYcodr:fix/readme-multilang-sync-2426

Conversation

@JAYcodr
Copy link
Copy Markdown
Contributor

@JAYcodr JAYcodr commented May 23, 2026

Summary

  • Synchronize PR docs: clarify managed backend defaults #2426 (docs: clarify managed backend defaults) changes across all four root-level README language variants (zh-CN, de, ko, ja-JP).
  • The English README was updated to clarify the local-vs-managed boundary; non-English readers deserve the same disclosure.

What changed

1. Tagline (all 4 languages)

Updated the one-liner under the logo to match the new English phrasing that replaces "Private/Simple/Powerful" with an explicit "local memory + managed services" framing.

Language Before After
zh-CN 私密、简洁、极其强大 本地记忆,按需托管服务,简洁而强大
de Privat, schlicht und extrem mächtig Lokaler Speicher, verwaltete Dienste wo nötig, schlicht und mächtig
ko 프라이빗하고, 단순하며, 매우 강력합니다 로컬 메모리, 필요한 경우 관리형 서비스, 단순하고 강력합니다
ja-JP プライベートで、シンプルで、非常に強力 ローカルメモリ、必要に応じてマネージドサービス、シンプルで強力

2. Added the "Local + managed services, upfront" warning block (all 4 languages)

This is the most important addition from #2426 — a plain-language notice that:

  • local data (Memory Tree, vault, workspace, runtime) stays on-device
  • sign-in, model routing, search proxying, and managed OAuth still go through OpenHuman-hosted services
  • custom/local settings are available for BYOK / self-hosted paths

3. Added the managed-integration paragraph (all 4 languages)

Where the English README now has a standalone paragraph explaining that OAuth handshakes and tool calls are proxied through the managed backend by default, with an opt-in direct-mode path — this paragraph was missing entirely from all translated READMEs. Added it.

4. Updated model-routing copy (all 4 languages)

Changed from "sends each task to the right LLM under one subscription" to explicitly state that model routing uses the OpenHuman backend by default to select and proxy the right LLM.

Submission Checklist

  • Tests added or updated — N/A: docs-only change
  • Diff coverage ≥ 80%N/A: docs-only change
  • Coverage matrix updated — N/A: docs-only change
  • All affected feature IDs from the matrix are listed — N/A: docs-only change
  • No new external network dependencies introduced — N/A: docs-only change
  • Manual smoke checklist updated — N/A: docs-only change
  • Linked issue closed — N/A: follow-up to #2422 / #2426

Impact

  • No runtime/platform impact.
  • No performance/security/migration/compatibility implications.
  • Non-English GitHub visitors now see the same trust-boundary disclosure as English readers.

Related

Summary by CodeRabbit

  • Documentation
    • Updated product positioning across language-specific READMEs to emphasize local-first architecture with optional managed services integration
    • Added clarifications about local data storage (memory, vaults, configuration, runtime state) versus managed backend services (authentication, model routing, web search, integrations)
    • Included guidance for direct mode configuration options and self-hosted integration alternatives

Review Change Stack

@JAYcodr JAYcodr requested a review from a team May 23, 2026 09:28
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 23, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 64b28eb0-81f7-47d7-a39b-173f9e6aa377

📥 Commits

Reviewing files that changed from the base of the PR and between d93f834 and 9d2cdbd.

📒 Files selected for processing (4)
  • README.de.md
  • README.ja-JP.md
  • README.ko.md
  • README.zh-CN.md

📝 Walkthrough

Walkthrough

Four localized README files are updated to clarify OpenHuman's local-first + managed-services architecture. Hero taglines are reframed to emphasize local memory with on-demand managed services. New sections explain what runs locally (Memory Tree, workspace config) versus what uses the managed backend (login, model routing, search proxying, Composio integration). Feature descriptions are revised to detail Composio connector proxying, direct-mode configuration, and backend-driven model routing.

Changes

Localized README architecture messaging

Layer / File(s) Summary
Hero tagline and positioning updates
README.de.md, README.ja-JP.md, README.ko.md, README.zh-CN.md
Top-level tagline reframed across all four language READMEs from general privacy/simplicity emphasis to specific "local memory + on-demand managed services" positioning.
Local + managed services architecture explanation
README.de.md, README.ja-JP.md, README.ko.md, README.zh-CN.md
New explanatory paragraphs added to each localization detailing the component split: locally-stored Memory Tree, Obsidian-style vault, workspace configuration, and runtime state versus managed backend handling of login, model routing, web-search proxying, Composio OAuth/integration flows, and hosted-only features.
Composio and model routing feature clarifications
README.de.md, README.ja-JP.md, README.ko.md, README.zh-CN.md
Feature bullets updated across all files to specify Composio connector proxying behavior via hosted backend, direct-mode setup with user-provided API key and self-hosted webhooks, and backend-based model routing per workload with subscription coverage clarification.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • tinyhumansai/openhuman#2325: Focuses on documenting the same managed-vs-direct-mode Composio integration boundary (backend-proxied OAuth/integration calls and user-hosted trigger webhooks).
  • tinyhumansai/openhuman#2005: Updates the Japanese README by revising intro/tagline and adjusting sections about local + managed behavior and Composio proxy/direct-mode notes.
  • tinyhumansai/openhuman#2426: Updates documentation copy to clarify which components run locally versus are handled by the OpenHuman managed backend (model routing, web-search proxy, Composio/OAuth flows).

Suggested labels

working

Suggested reviewers

  • senamakel
  • graycyrus

Poem

🐰 Four languages, one message clear,
Local memory, managed just near,
Composio calls through the backend gate,
Direct mode waits if you customize fate.
OpenHuman's promise: simple, yet strong!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs(readme): sync PR #2426 managed-backend clarifications to all lan…' is directly related to the changeset. It accurately describes the main change: synchronizing managed-backend clarifications from PR #2426 to all language variants of the README files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot added the working A PR that is being worked on by the team. label May 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

working A PR that is being worked on by the team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant