open-index/open-npm huggingface dataset:
npm package: @jamiexiongr/panda
Description: Panda combined installer
Latest version: 0.1.9

# @jamiexiongr/panda

Combined installer and CLI entry for Panda.

This package is intended for end users who want to run Panda on their own machine and open it from a phone over Tailscale.

## Requirements

- Node.js `>= 20.19.0`
- A desktop installation of Tailscale with CLI access
- Your computer and phone joined to the same tailnet
- Recommended mobile browsers:
  iPhone / iPad with Safari 16.4+;
  Android with a current Chrome stable release

For the complete Chinese install and usage guide in this repository, see `docs/panda-user-guide.md`.

## Install

```bash
npm install -g @jamiexiongr/panda@latest --registry=https://registry.npmjs.org/
```

## Usage

```bash
panda hub
panda hub tailscareserv

panda agent
panda agent tailscareserv
```

`tailscareserv` and `--tailscale-serve` both enable automatic `tailscale serve` publishing.

## Notes

- `panda hub tailscareserv` is the quickest path to a mobile-installable HTTPS PWA inside your tailnet.
- `panda agent tailscareserv` makes the agent register `https/wss` direct URLs when no explicit direct URL env vars are set.
- If `tailscale serve` says it is not enabled on your tailnet, open the approval link printed by the CLI and enable Serve for that node.
npm package: @jamiexiongr/panda-agent
Description: Panda agent runtime
Latest version: 0.1.9

# @jamiexiongr/panda-agent

Published agent runtime for Panda.

## Usage

```bash
panda-agent
panda-agent tailscareserv
panda-agent tailscareserv-pub
```

`tailscareserv` and `--tailscale-serve` both enable automatic tailnet-only `tailscale serve` publishing.

`tailscareserv-pub`, `--tailscale-serve-pub`, and `tailscale-funnel` enable public `tailscale funnel` publishing.

When enabled, agent startup will:

- detect whether `tailscale` is available and online
- run `tailscale serve --bg` or `tailscale funnel --bg`
- print the generated Tailscale or public HTTPS URL in the startup log
- use the generated `https/wss` URL as the direct agent address unless you already set `PANDA_AGENT_DIRECT_BASE_URL` or `PANDA_AGENT_WS_BASE_URL`

## Environment

- `PANDA_AGENT_PORT`
  Local agent listen port. Default: `4242`
- `PANDA_HUB_URL`
  Optional hub control-plane URL
- `PANDA_AGENT_TAILSCALE_SERVE_PORT`
  Tailscale HTTPS port. Default: same as `PANDA_AGENT_PORT`
- `PANDA_AGENT_TAILSCALE_PUBLISH_MODE`
  Optional publish mode. Supports `serve` or `funnel`
- `PANDA_TAILSCALE_SERVE=1`
  Optional env alternative to the startup flag

## Notes

- Tailscale Serve publishes a tailnet HTTPS address, not a public Internet address.
- Tailscale Funnel publishes a public Internet HTTPS address and corresponding `wss` endpoint.
- If the agent and hub run on the same machine, use different Tailscale HTTPS ports to avoid collisions. The default setup is `hub -> 443`, `agent -> agent port`.
npm package: @jamiexiongr/panda-hub
Description: Panda hub runtime
Latest version: 0.1.9

# @jamiexiongr/panda-hub

Published hub runtime for Panda, including the built web UI.

## Usage

```bash
panda-hub
panda-hub tailscareserv
```

`tailscareserv` and `--tailscale-serve` both enable automatic `tailscale serve` publishing.

When enabled, hub startup will:

- detect whether `tailscale` is available and online
- run `tailscale serve --bg`
- print the generated Tailscale HTTPS URL in the startup log

## Environment

- `PANDA_HUB_PORT`
  Local hub listen port. Default: `4343`
- `PANDA_HUB_TAILSCALE_SERVE_PORT`
  Tailscale HTTPS port. Default: `443`
- `PANDA_TAILSCALE_SERVE=1`
  Optional env alternative to the startup flag

## Notes

- Tailscale Serve publishes a tailnet HTTPS address, not a public Internet address.
- This is the recommended way to run the installable PWA on mobile, because the bundled hub serves the built web assets over HTTPS.