Skip to content

feat(install): streamline installation and model onboarding - #1529

Draft
PsiACE wants to merge 5 commits into
masterfrom
codex/install-and-onboarding-docs
Draft

feat(install): streamline installation and model onboarding#1529
PsiACE wants to merge 5 commits into
masterfrom
codex/install-and-onboarding-docs

Conversation

@PsiACE

@PsiACE PsiACE commented Sep 9, 2026

Copy link
Copy Markdown
Member

Which issue or RFC does this PR close?

Related to #1408. This PR adds a focused installation and onboarding path.

Rationale for this change

New users should be able to install PowerContext without preparing Python manually. Users who already have uv should also have a short, platform-independent installation path. The onboarding flow must explain that the Server uses its own model configuration before users start it.

What changes are included in this PR?

  • Add a macOS/Linux installer that reuses compatible uv and Python installations, bootstraps missing components, preserves uv configuration, and supports an explicit package index.
  • Document three first-run paths: the macOS/Linux installer, the experimental Windows PowerShell path, and direct uv tool install on macOS, Linux, or Windows.
  • Update the English, Chinese, and Japanese READMEs and the English and Chinese onboarding guides with version selection, package-index guidance, model configuration, and verification.
  • Align the onboarding text with current master: server run discovers the current directory's .env, and the optional Dashboard is disabled by default at /dashboard/home.
  • Exercise the public installer and documented uv commands with real uv, Python, and the wheel built from the current commit on Linux, macOS, and Windows CI.

Are there any user-facing changes?

PowerContext now has operating-system installer instructions and a direct uv tool install --python ">=3.11,<4" "powercontext[cli,server]==0.2.0" path. The guides also lead users through generation-model setup before automatic Memory extraction. The pip installation path remains available.

How was this change tested?

  • make check
  • make docs-test, including link checks for 191 public pages and 262 repository files, plus verification of 781 exported pages
  • make test (2,084 passed, 66 skipped)
  • Built a release-shaped wheel and ran the Bash installer scenarios plus the documented existing-uv installation against it (5 passed)
  • GitHub Actions passed on Python 3.11, 3.12, 3.13, and 3.14, including Linux systemd, macOS LaunchAgent, Windows Task Scheduler, and SQLite/OceanBase acceptance coverage

AI usage statement

Codex assisted with implementation, documentation, conflict resolution, and validation.

# Conflicts:
#	docs/en/docs/get-started/configure-models.md
#	docs/en/docs/get-started/configure-server-environment.md
#	docs/en/docs/get-started/install-and-run.md
#	docs/en/docs/get-started/quickstart.md
#	docs/zh/docs/get-started/configure-models.md
#	docs/zh/docs/get-started/configure-server-environment.md
#	docs/zh/docs/get-started/install-and-run.md
#	docs/zh/docs/get-started/quickstart.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant