Graphone

Graphone is a visual workbench for serious agent work, with pi as the runtime and extensibility substrate underneath.

Today, Graphone ships primarily as a native desktop app, but the project is aimed at a broader service-capable, cross-client workbench rather than “just a GUI for pi.”

• Feature status: FEATURES.md
• Troubleshooting: TROUBLESHOOTING.md
• Contributing: CONTRIBUTING.md

What Graphone is

Graphone is being built as:

• A visual workbench for agent operations
• A human control surface over pi-backed runtimes
• An artifact-first workspace, not only a chat UI
• A platform-agnostic product that can span desktop, browser, and future clients
• A future multi-agent environment, not only a single-session shell

In the current repo, that vision is delivered as a desktop product with:

• Native desktop builds for Linux, macOS, and Windows
• Streaming chat UI with tool output rendering
• Multi-session workflow with sidebar history
• Floating session windows
• A bundled pi sidecar built automatically during Tauri builds

Platform support

| Platform | Status | Notes | | -------- | --------- | ------------------------------------------------------------------------------------- | | Linux | Supported | Native builds and release artifacts | | macOS | Supported | Local .app / .dmg builds; release artifacts published for Apple Silicon and Intel | | Windows | Supported | Cross-buildable from Linux; NSIS installer and portable .exe flows |

Quick start

npm install
npm run dev:linux

Common build commands:

npm run build:linux
npm run build:windows
npm run build:macos:local

Useful variants:

npm run build:windows:portable
npm run build:macos:local:app

Build notes

• Linux: standard Tauri build
• Windows: uses cargo-xwin for cross-compilation from Linux
• macOS: local ad-hoc signed build config at src-tauri/tauri.macos.local.conf.json
• The sidecar is compiled with bun from services/agent-host
• Linux bundles sidecar resources differently from macOS/Windows, but runtime behavior is aligned
• Tauri is the current desktop shell, not the long-term app/runtime boundary

Requirements

• Node.js 20+
• bun 1+
• Rust stable
• Tauri build prerequisites for your target OS

Linux packages commonly needed:

sudo apt install libgtk-3-dev libwebkit2gtk-4.1-dev libappindicator3-dev clang lld

Windows cross-build extras on Linux:

cargo install cargo-xwin
sudo apt install nsis llvm lld

Architecture in one line

Graphone UI -> Graphone host/service boundary -> pi runtime/extensibility layer

Current repo seams:

• Frontend: apps/desktop/web
• Desktop shell: src-tauri
• Canonical host/runtime boundary: services/agent-host

Repository layout

graphone/
├── apps/desktop/web
├── src-tauri
├── services/agent-host
└── tooling/scripts

Release artifacts

GitHub releases publish desktop artifacts, including macOS architecture-specific builds.

Star History

License

MIT — see LICENSE