| 1 | # ViMax Web |
| 2 | |
| 3 | The Web workspace uses the existing ViMax agent loop and JSONL event stream. It does not implement workflow decisions in the browser. |
| 4 | |
| 5 | From the `ViMax` repository root, create the private local agent configuration once: |
| 6 | |
| 7 | ```bash |
| 8 | cp configs/agent.example.yaml configs/agent.local.yaml |
| 9 | ``` |
| 10 | |
| 11 | ```bash |
| 12 | cd web |
| 13 | npm install |
| 14 | npm run dev |
| 15 | ``` |
| 16 | |
| 17 | Or from the repository root: |
| 18 | |
| 19 | ```bash |
| 20 | ./vimax web |
| 21 | ``` |
| 22 | |
| 23 | The default address is `http://127.0.0.1:4173`. Override it with `VIMAX_WEB_HOST` and `VIMAX_WEB_PORT`. |
| 24 | |
| 25 | Production mode: |
| 26 | |
| 27 | ```bash |
| 28 | cd web |
| 29 | npm run build |
| 30 | cd .. |
| 31 | ./vimax web start |
| 32 | ``` |
| 33 | |
| 34 | Agent credentials continue to come from ViMax environment variables or `configs/agent.local.yaml`. |
| 35 |