Jiayuan Zhang
b0ee214154
feat: streamline self-hosting with one-click setup ( #724 )
...
* feat: streamline self-hosting experience with one-click setup
- Add `make selfhost` / `make selfhost-stop` for one-command Docker deployment
- Add `multica setup` CLI command (auto-detect local server, configure, login, start daemon)
- Add `multica config local` CLI command (configure for localhost defaults)
- Restructure SELF_HOSTING.md: simplified 4-step guide, moved advanced config to SELF_HOSTING_ADVANCED.md
- Add SELF_HOSTING_AI.md for AI agents to follow
- Document 888888 master verification code for non-production environments
- Document how to stop services
- Fix brew install typo: `multica-cli` → `multica` in SELF_HOSTING.md and self-hosting.mdx
- Update README.md and README.zh-CN.md with simplified self-host instructions
- Update CLI_AND_DAEMON.md with new setup/config local commands
* feat: add one-command installer script (curl | bash)
Add scripts/install.sh that handles the full setup in one command:
Self-host (default):
curl -fsSL .../install.sh | bash
→ Checks Docker, clones repo, starts services, installs CLI, configures
Cloud (CLI only):
curl -fsSL .../install.sh | bash -s -- --cloud
→ Installs CLI via Homebrew or binary download
Features:
- OS detection (macOS/Linux) with architecture support (amd64/arm64)
- Homebrew install with binary download fallback
- Idempotent: re-running updates existing installation
- Colored output with non-TTY fallback
- Docker availability check with helpful error messages
Updated docs (README, SELF_HOSTING, self-hosting.mdx, SELF_HOSTING_AI) to
show curl | bash as the primary install method.
* refactor: default install to cloud mode, add --local for self-host
- install.sh default is now cloud (CLI only, connects to multica.ai)
- Self-host uses --local flag: curl ... | bash -s -- --local
- Restructured README following Hermes Agent style:
- Quick Install section front and center with curl | bash
- CLI command reference table
- Self-host as a callout under Quick Install
- Removed redundant "Multica Cloud" / "CLI" sections
- Updated all docs (SELF_HOSTING, self-hosting.mdx, SELF_HOSTING_AI,
README.zh-CN) to use --local flag for self-host curl command
* docs: remove redundant AI agent install snippet from README CLI section
* docs: add daemon stop command to README quick install sections
* feat: add --stop flag to install.sh for easy self-host shutdown
Users who installed via `curl ... | bash -s -- --local` can now stop
all services with `curl ... | bash -s -- --stop`. The stop command
shuts down Docker Compose services and the daemon.
Also updated SELF_HOSTING.md stopping section to show both methods.
2026-04-12 00:50:17 +08:00
Jiayuan Zhang
17ae320dd2
feat(docs): add documentation site with Fumadocs ( #634 )
...
Set up a documentation site at apps/docs using Fumadocs (Next.js App Router).
Migrated existing docs (README, SELF_HOSTING, CLI_AND_DAEMON, CLI_INSTALL,
CONTRIBUTING, AGENTS) into structured MDX content with sidebar navigation
and full-text search.
Content structure:
- Getting Started: Cloud quickstart, self-hosting guide
- CLI & Daemon: Installation, full command reference
- Guides: Quickstart, agents overview
- Developers: Contributing guide, architecture docs
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com >
2026-04-10 16:28:23 +08:00
