Rio - Help and Guide

## Quick Start

1. Install Rio using installer scripts or pip/pipx.
2. You will be redirected immediately to rio configure for mandatory onboarding.
3. Choose your cloud/dashboard port when prompted (default is 8080).
4. Start runtime with rio run (starts cloud + local).
5. Open dashboard at http://localhost:<port>/dashboard.

## Boot and Services

Linux setup can create user-level systemd services if you approve the start-on-boot prompt.

Generated services:

- rio-cloud.service
- rio-local.service

They are stored under ~/.config/systemd/user.

## CLI Commands

- rio config get <path> - read config value
- rio config set <path> <value> - update config value
- rio config show - print entire config
- rio configure - mandatory setup flow
- rio doctor - diagnose and auto-fix issues
- rio doctor --no-fix - report only
- rio doctor --test-api - include Gemini API probe
- rio run - run cloud + local
- rio run --foreground - local foreground mode
- rio run --background - force detached mode
- rio run --skip-configure - bypass configure gate
- rio logs --component both --lines 80 - read logs
- rio logs --component local --follow - live log tail
- rio status --component both - process health
- rio stop --component both - stop runtime
- rio stop --component both --force - force kill process tree

## Deployment Checklist

1. Run rio doctor and confirm acknowledgement.
2. Run rio run then validate with rio status and rio logs.
3. Build package: python -m build (from Rio-Agent root).
4. Validate metadata: twine check dist/*.
5. Push to GitHub and trigger publish-pypi.yml from release/workflow dispatch.

## Troubleshooting

If dashboard is not loading, confirm your selected port is available and cloud is running.

If local client does not connect, verify cloud_url in rio/config.yaml matches your chosen port.

If API calls fail, open rio/cloud/.env and check GEMINI_API_KEY.

Expected completion message: Rio is live at: http://localhost:<port>/dashboard