connectonion-studio

A local test cockpit for ConnectOnion agents.

Click toolkits to build an agent · scan its QR from the iOS app · watch live logs

Install

pipx install connectonion-studio      # or: pip install connectonion-studio
co-studio                             # opens http://127.0.0.1:9900

That's it. The first launch auto-creates your identity and activates your managed model key (needs internet — it's your own key, one per user). Offline on first run? Just run co auth once you're back online.

Desktop app (macOS)

A native macOS app (SwiftUI + WKWebView) lives in macos/ — the same cockpit in a real window with the traffic-light chrome and app icon. Build and run it from Xcode (macos/ConnectOnionStudio/); a signed .dmg for one-click install is on the way.

What it does


🧩 Create	Form: name · model · toolkit checkboxes → identity + QR ready instantly
▶️ Run	One process per agent, health-polled every 5 s, live state over WebSocket
📱 QR	Encodes `connectonion://add?address&name&endpoint` — one scan fills all three iOS "Add agent" fields (direct LAN endpoint, bypasses the relay)
📜 Logs	Master–detail cockpit: per-agent live console (this run only), stat tiles, follow / errors-only, reveal-in-Finder
🩺 Copy for Claude	Paste-ready markdown diagnostics bundle, one click
🗑️ Delete	Two-step confirm, then a permanent delete — identity, keys, and logs are removed for good

Toolkits: utility · web · files · shell (approval-gated) · image

Requirements

Python 3.11+ · macOS, Linux, or Windows (WSL recommended)

API reference

Method	Path	Returns
`GET`	`/api/agents`	`{"agents": [AgentSummary]}`
`POST`	`/api/agents`	AgentDetail — body `{name, model, toolkits, trust}`
`GET`	`/api/agents/{slug}`	AgentDetail
`POST`	`/api/agents/{slug}/start` · `/stop` · `/restart`	`{"state": …}`
`POST`	`/api/agents/{slug}/rename`	AgentSummary — body `{name}`
`DELETE`	`/api/agents/{slug}`	`204` (stops the agent, then permanently deletes it)
`GET`	`/api/agents/{slug}/qr.svg`	SVG QR of the `connectonion://add` deep link (address · name · endpoint)
`POST`	`/api/agents/{slug}/reveal-logs`	Opens the agent's `runs/` folder in the OS file browser (local)
`GET`	`/api/agents/{slug}/diagnostics`	Markdown bundle
`GET`	`/api/setup/status`	Doctor checks
`GET`	`/api/setup/update`	PyPI update check — `{current, latest, update_available}`
`WS`	`/ws/status`	Status frames (each change + every 5 s)
`WS`	`/ws/agents/{slug}/logs`	`{"source": "stdout", "line": …}` — the current run, from its first line

Storage & internals

~/.co-studio/agents/<slug>/   meta.json · agent.py · .env · .co/ · runs/<timestamp>.log

One stdout log per run under runs/; the live console (and diagnostics) read only the current run.
Agent ports 8000–8099, allocated by socket probe (busy ports skipped, re-probed at start).
agent.py is standalone — eject it anywhere and python agent.py still works (the announce IP-trim patch is inlined).

Development (from source)

git clone https://github.com/EvanYifanYang/connectonion-studio && cd connectonion-studio
./install.sh
.venv/bin/co-studio

Env	Effect
`CONNECTONION_PATH=~/repo/connectonion ./install.sh`	Install the framework from a local checkout instead of PyPI
`PYTHON=python3.12 ./install.sh`	Pick the interpreter

Security

The manager binds 127.0.0.1:9900 only.
Agent ports are unauthenticated and exposed on your LAN by host() — that is how the phone connects. Don't run on hostile networks.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

connectonion_studio-0.1.8.tar.gz (294.0 kB view details)

Uploaded Aug 1, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

connectonion_studio-0.1.8-py3-none-any.whl (303.0 kB view details)

Uploaded Aug 1, 2026 Python 3

File details

Details for the file connectonion_studio-0.1.8.tar.gz.

File metadata

Download URL: connectonion_studio-0.1.8.tar.gz
Upload date: Aug 1, 2026
Size: 294.0 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.12.7

File hashes

Hashes for connectonion_studio-0.1.8.tar.gz
Algorithm	Hash digest
SHA256	`1348f686d545551134cac3ff15e8b5ccc2643aa1c60c3191a7de9e13cba77d77`
MD5	`77d52fe4ff7bd2013785aefb3c9323ec`
BLAKE2b-256	`857a18281722fb2bc2893a3cbbdb9f2a461cebb3681db2edbc8b9004c2925589`

See more details on using hashes here.

File details

Details for the file connectonion_studio-0.1.8-py3-none-any.whl.

File metadata

Download URL: connectonion_studio-0.1.8-py3-none-any.whl
Upload date: Aug 1, 2026
Size: 303.0 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.12.7

File hashes

Hashes for connectonion_studio-0.1.8-py3-none-any.whl
Algorithm	Hash digest
SHA256	`08dcd348740a378ad9d34ef79dc85b5804611138d87ee239ef0a82e04d683626`
MD5	`aa527b1be66a7f5f76ae31c5cd0c26f2`
BLAKE2b-256	`7b52496fe40c386ee921d01bcd6901e18870f9f7dc38aa4e5af97dcd53a7da0c`