OpenComputers

OpenComputers connects a computer you own to the MIOSA control plane using the OSA host agent. The host opens one outbound WebSocket, authenticates with a one-time oc_host_* key, and then appears in MIOSA as a managed computer.

This repository is the open-source home for the OpenComputers install wrappers, wire protocol, examples, and contribution process. The canonical host agent is OSA, maintained in Miosa-osa/OSA. The MIOSA cloud control plane and web application live in separate repositories.

Current Status

OpenComputers is in early integration. The supported path is:

1. Provision a host in the MIOSA web app.
2. Copy the one-time oc_host_* install command.
3. Run the command on macOS, Linux, or Windows.
4. OSA installs, writes ~/.osa/open_computers.toml, enables host mode, and connects to wss://api.miosa.ai/api/v1/opencomputers/hosts/ws.

The protocol and installer are open for review. Alternate host agents are welcome, but they must implement the protocol in docs/protocol.md.

Quick Start

From MIOSA, open OpenComputers -> Connect a Computer and copy the generated command. It will look like this:

curl -fsSL https://api.miosa.ai/install-host.sh | bash -s -- \
  --key oc_host_... \
  --region default \
  --control-url wss://api.miosa.ai/api/v1/opencomputers/hosts/ws

Windows uses PowerShell:

& ([scriptblock]::Create((iwr -UseBasicParsing https://api.miosa.ai/install-host.ps1))) `
  -Key oc_host_... `
  -Region default `
  -ControlUrl wss://api.miosa.ai/api/v1/opencomputers/hosts/ws

For local testing from this repository, the wrapper scripts are in scripts/.

./scripts/install.sh --key oc_host_... --control-url wss://api.miosa.ai/api/v1/opencomputers/hosts/ws

.\scripts\install.ps1 -Key oc_host_... -ControlUrl wss://api.miosa.ai/api/v1/opencomputers/hosts/ws

Architecture

Customer host
  OSA
    OpenComputers session
      hello + heartbeat + exec/fs/desktop/tunnel frames
        |
        | outbound WSS, TLS, subprotocol miosa-opencomputers-v1
        v
MIOSA control plane
  Engine.OpenComputers
    host authentication
    fingerprint pinning
    host process registry
    job/frame routing
        |
        v
MIOSA web app
  host list
  connection wizard
  terminal/files/desktop/workflows as they are enabled

No inbound ports are opened on the host. The control plane cannot dial into the machine directly; the host owns the connection.

What Is In This Repo

Path	Purpose
scripts/install.sh	OSS macOS/Linux wrapper around the current OSA install + OpenComputers login flow
scripts/install.ps1	OSS Windows wrapper around the current OSA install + OpenComputers login flow
docs/getting-started.md	Current install and troubleshooting guide
docs/protocol.md	Host/control-plane wire protocol
docs/architecture.md	System boundaries and security model
docs/roadmap.md	What is supported now and what is planned
examples/	API and CLI examples

Related Repositories

Repository	Role
Miosa-osa/OSA	Canonical host agent and osa opencomputers runtime
Miosa-osa/miosa-compute	MIOSA backend API, installers served by the platform, and WebSocket endpoint
Miosa-osa/MiosaOS	MIOSA frontend connection wizard
Miosa-osa/OpenComputers	Public protocol, install wrappers, docs, and examples

Contributing

The most useful contributions are:

• protocol clarifications based on real client implementations
• installer fixes for macOS, Linux, or Windows
• alternate host-agent implementations in Rust, Go, Python, or another runtime
• accurate examples that work against the public MIOSA API

See CONTRIBUTING.md.

License

Apache 2.0. See LICENSE.