mirror of https://github.com/agentscope-ai/ReMe.git synced 2026-08-28 05:25:04 +00:00

refactor(packaging): reorganize published packages (#495 )

* refactor(packaging): reorganize published packages

* fix(packaging): install AgentScope extra in wheel smoke

* docs: align package guides and documentation site

* ci(workflow): add core dependency verification step in Python package build

- Add a workflow step to verify released core dependencies by installing the wheel with core extras
- Assert the presence of the static index.html file to ensure proper package contents
- Create and use a temporary virtual environment for isolation during verification
- Keep existing artifacts upload step intact and conditional on inputs.upload_artifacts flag

* fix(ci): update package installation dependencies in Windows workflow

- Change pip install from editable reme_studio and core to only dev and as extras
- Remove installation of reme_studio and core to streamline dependency setup
- Ensure Windows CI uses the correct extras for testing environment

* fix(tests): add missing commas in toml file reads in package version tests

- Added trailing commas in the tomllib.loads calls for auto-fin and daily_paper configs
- Ensured consistent syntax to prevent potential tuple misinterpretation
- Improved readability and correctness of the test setup code

* fix(packaging): protect qwenpaw releases and test Studio health

2026-08-27 14:02:09 +08:00

2.9 KiB

Raw Blame History

ReMe GitHub Pages

This directory contains the standalone Vite documentation site published at https://reme.agentscope.io. The GitHub Pages fallback is https://agentscope-ai.github.io/ReMe/. It does not depend on the ReMe Studio application in reme_studio/.

Requirements

Node.js 22.13 or newer
npm

Local development

From the repository root:

cd github-pages
npm install
npm run dev

Open the URL printed by Vite, normally http://localhost:5173/. The development server watches the frontend source. When a repository Markdown file changes, restart the development command to regenerate the documentation content.

For subsequent installs or CI-compatible dependency installation, use:

npm ci

Preview the production build

Build and start the preview server:

npm run build
npm run preview

Open the URL printed by Vite, normally http://localhost:4173/. Production assets use relative paths so the same build works on both the custom domain and the GitHub Pages project path.

The generated dist/ and .generated/ directories are disposable build output and are excluded from Git.

Documentation sources

The build script reads the canonical repository files directly. Do not edit generated copies under .generated/ or dist/.

README.md and README_ZH.md: project introductions
docs/en/ and docs/zh/: English and Chinese guides
docs/figure/: documentation images
reme_studio/README.md and reme_studio/README_ZH.md: ReMe Studio guide
typescript/README.md and typescript/README_ZH.md: TypeScript client, DeepSeek Harness, and OpenClaw integration guide
plugins/*/README*.md: plugin guides
benchmark/{beam,longmemeval,pibench,toolmemory}/README*.md: benchmark guides and results
AGENTS.md: repository development guide

To add or reorganize a document in the site navigation, update scripts/generate-content.mjs. Presentation and interaction code lives in src/.

Project structure

github-pages/
├── index.html
├── package.json
├── scripts/
│   └── generate-content.mjs
├── src/
│   ├── main.js
│   └── styles.css
└── vite.config.js

Deployment

The repository workflow .github/workflows/deploy-docs.yml builds this directory and publishes dist/ to GitHub Pages. It runs after relevant documentation or site files change on main, and it can also be started manually from the GitHub Actions page.

The repository's Settings → Pages → Build and deployment → Source must be set to GitHub Actions. Its custom domain must be set to reme.agentscope.io; public/CNAME preserves that domain in the published artifact.

Useful links:

ReMe documentation: https://reme.agentscope.io
GitHub Pages fallback: https://agentscope-ai.github.io/ReMe/
ReMe repository: https://github.com/agentscope-ai/ReMe

2.9 KiB Raw Blame History