{"id":48723006,"url":"https://github.com/78/tenbox","last_synced_at":"2026-06-01T00:01:10.787Z","repository":{"id":340471096,"uuid":"1165807635","full_name":"78/tenbox","owner":"78","description":"A lightweight x86-64 / arm64 Virtual Machine Monitor (VMM) for OpenClaw / QwenPaw / Hermes Agent","archived":false,"fork":false,"pushed_at":"2026-05-11T03:23:32.000Z","size":4350,"stargazers_count":229,"open_issues_count":15,"forks_count":46,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-11T05:21:11.587Z","etag":null,"topics":["agents","hermes","openclaw","virtualization"],"latest_commit_sha":null,"homepage":"https://tenbox.ai","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/78.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-24T15:09:56.000Z","updated_at":"2026-05-11T03:23:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/78/tenbox","commit_stats":null,"previous_names":["78/tenclaw","78/tenbox"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/78/tenbox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/78%2Ftenbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/78%2Ftenbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/78%2Ftenbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/78%2Ftenbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/78","download_url":"https://codeload.github.com/78/tenbox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/78%2Ftenbox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33753925,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","hermes","openclaw","virtualization"],"created_at":"2026-04-11T20:16:46.035Z","updated_at":"2026-06-01T00:01:10.772Z","avatar_url":"https://github.com/78.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TenBox\n\nTenBox lets you run AI agents safely on your personal computer. Each agent runs\ninside a secure, isolated virtual machine — it can only access the files you\nexplicitly authorize, keeping your privacy and data protected.\n\nUnder the hood, TenBox is a cross-platform Virtual Machine Monitor (VMM) with a\nshared C++ runtime. It runs full Linux desktop environments with\nhardware-accelerated virtualization, GPU display output, audio, shared folders,\nand clipboard integration. Windows hosts use WHVP with a Win32 manager; macOS\nhosts use Hypervisor Framework (both Apple Silicon and Intel) with a\nSwiftUI/AppKit manager; Linux hosts run `tenboxd`, a systemd daemon that manages\nVM lifecycle, exposes a local CLI, and provides optional browser-based remote\ndesktop.\n\n## Screenshots\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\" align=\"center\"\u003e\n      \u003cimg src=\"website/public/images/macos_light.png\" alt=\"TenBox on macOS\" width=\"100%\" style=\"border-radius: 12px;\" /\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"50%\" align=\"center\"\u003e\n      \u003cimg src=\"website/public/images/windows_light.png\" alt=\"TenBox on Windows\" width=\"100%\" style=\"border-radius: 12px;\" /\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Features\n\n- **Cross-platform hypervisor backends** — WHVP on Windows, Hypervisor Framework on macOS (Apple Silicon and Intel), KVM on Linux (x86_64 and arm64, including Raspberry Pi)\n- **Native GUI managers** — Win32 on Windows, SwiftUI/AppKit on macOS\n- **Linux daemon (`tenboxd`)** — systemd-managed, local RPC over `/run/tenbox/tenbox.sock`, `tenbox` system group access control\n- **`tenbox` CLI** — `doctor` / `system info` / `vm ls|create|edit|start|stop|reboot|shutdown|rm|console|logs`\n- **Linux boot support** — boots standard `vmlinuz` / `Image` kernels with `initramfs`\n- **VirtIO MMIO devices** — block, network, GPU, input, serial, sound, and filesystem\n- **qcow2 \u0026 raw disk images** — zlib and zstd compressed cluster support, copy-on-write\n- **GPU display** — virtio-gpu with SPICE protocol, resizable display window\n- **Audio output** — virtio-snd streamed to host via WASAPI on Windows and CoreAudio on macOS\n- **Shared folders** — virtiofs (virtio-fs), configurable per VM with optional read-only mode\n- **Clipboard sharing** — bidirectional host ↔ guest clipboard via SPICE vdagent protocol\n- **Guest agent** — qemu-guest-agent integration for VM lifecycle management (graceful reboot/shutdown)\n- **NAT networking** — built-in DHCP server, TCP/UDP NAT proxy, ICMP relay via lwIP\n- **Port forwarding** — host-forward (expose guest TCP services on host ports) and guest-forward (route guest traffic to host services)\n- **Multi-VM management** — create, edit, start, stop, reboot, and delete VMs; config persisted as `vm.json`\n- **Platform-specific machine models** — x86_64 (Local APIC / I/O APIC) and aarch64 (GICv3) guest support\n- **Browser remote desktop (Linux)** — daemon-embedded libdatachannel + FFmpeg H.264 (high/baseline) + Opus; dual `input-fast` / `control` DataChannels; bidirectional clipboard\n- **Cloud pairing \u0026 self-update (Linux)** — 8-digit pairing code → `https://my.tenbox.ai/pair`; daemon accepts `host.update` and runs `apt-get install --only-upgrade tenbox` in-place\n- **LLM proxy** — built-in OpenAI-compatible HTTP proxy mapping guest requests to configurable upstream providers; available in `tenboxd` on Linux and the GUI manager on Windows/macOS\n\n## Install\n\n### Linux (Debian 11+ / Ubuntu 20.04+ / Raspberry Pi OS 11+, amd64 / arm64)\n\n```bash\ncurl -fsSL https://tenbox.ai/install.sh | sudo sh\n```\n\nRequires glibc 2.31+ and `/dev/kvm`. The installer registers the TenBox apt\nrepo, installs the `tenbox` deb, adds the current user to the `tenbox` group,\nand enables `tenboxd.service`. After install, a pairing URL is printed to the\nterminal — open it (or visit `https://my.tenbox.ai/`) to claim the host.\nTested on x86_64 PCs and Raspberry Pi 5; other arm64 boards may work but are\nnot yet validated.\n\n### Windows / macOS\n\nDownload the latest installer from [tenbox.ai](https://tenbox.ai/) or the\n[GitHub Releases](https://github.com/78/tenbox/releases) page.\n\n## Documentation\n\n- **User guide** (Chinese): **[养虾教程](https://my.feishu.cn/wiki/Q96KwUH1Di3cAik2W7kcQsWKncb)** (Feishu Wiki)\n- **Build from source**: [docs/build.md](docs/build.md)\n- **Daemon architecture (Linux)**: [docs/tenboxd.md](docs/tenboxd.md)\n- **CLI reference**: [docs/cli.md](docs/cli.md)\n- **Release process**: [docs/release.md](docs/release.md)\n- **Linux update path**: [docs/linux-update.md](docs/linux-update.md)\n\n## License\n\nGPL v3 — see [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F78%2Ftenbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F78%2Ftenbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F78%2Ftenbox/lists"}