{"id":49659235,"url":"https://github.com/wendylabsinc/wendyos","last_synced_at":"2026-06-28T23:00:44.733Z","repository":{"id":286266958,"uuid":"960357174","full_name":"wendylabsinc/WendyOS","owner":"wendylabsinc","description":"A CLI and App Manager for WendyOS","archived":false,"fork":false,"pushed_at":"2026-06-22T14:17:11.000Z","size":85027,"stargazers_count":57,"open_issues_count":35,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-22T14:30:04.322Z","etag":null,"topics":["edge","edge-compuing","iot","jetson","nvidia","physical","swift"],"latest_commit_sha":null,"homepage":"https://docs.wendy.dev/latest","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wendylabsinc.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":".github/CODEOWNERS","security":"security/THREAT_MODEL.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-04-04T09:45:50.000Z","updated_at":"2026-06-22T14:20:45.000Z","dependencies_parsed_at":"2025-04-05T11:25:13.638Z","dependency_job_id":"e69ede3a-6e77-45da-b993-832145fae5a7","html_url":"https://github.com/wendylabsinc/WendyOS","commit_stats":null,"previous_names":["apache-edge/edge-agent","edgeengineer/edge-agent","wendylabsinc/wendy-agent","wendylabsinc/wendyos"],"tags_count":628,"template":false,"template_full_name":null,"purl":"pkg:github/wendylabsinc/WendyOS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wendylabsinc%2FWendyOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wendylabsinc%2FWendyOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wendylabsinc%2FWendyOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wendylabsinc%2FWendyOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wendylabsinc","download_url":"https://codeload.github.com/wendylabsinc/WendyOS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wendylabsinc%2FWendyOS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34906700,"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-06-28T02:00:05.809Z","response_time":54,"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":["edge","edge-compuing","iot","jetson","nvidia","physical","swift"],"created_at":"2026-05-06T11:02:33.416Z","updated_at":"2026-06-28T23:00:44.704Z","avatar_url":"https://github.com/wendylabsinc.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/media/demo.gif\" alt=\"Wendy on NVIDIA Jetson\" width=\"360\"\u003e\n\u003c/p\u003e\n\nVisit our developer docs at https://wendy.sh/docs\n\n# Install\n\nWendyOS is like iOS for developing, deploying, and debugging\napps on edge devices such as NVIDIA Jetson, AGX, Thor, Raspberry Pi, and Linux machines.\nThis repository contains the `wendy` CLI and the `wendy-agent` runtime service.\n\nWendyOS images _already_ include `wendy-agent`. If you are looking for the\nYocto image build system, it lives in\n[wendylabsinc/WendyOS-Builder](https://github.com/wendylabsinc/WendyOS-Builder).\n\n## Install the Wendy CLI\n\nInstall or update the `wendy` CLI on macOS or Linux (x86_64 and ARM64):\n\n```sh\ncurl -fsSL https://install.wendy.sh/cli.sh | bash\n```\n\nOn Windows:\n\n```powershell\nwinget install WendyLabs.Wendy\n```\n\nSome local setup scripts are unsigned, so Windows may block them even when you trust the repository. If you need to run a local, trusted PowerShell setup script, use a one-time bypass only after reviewing the script:\n\n```powershell\nGet-Content .\\set-up-windows.ps1\npowershell -ExecutionPolicy Bypass -File .\\set-up-windows.ps1\n```\n\nThe bypass applies only to that PowerShell invocation. Run it from a non-elevated (standard-user) PowerShell window. If a specific step fails with an access-denied error, review that section of the script before re-running as Administrator.\n\nPackage-specific options are available via\n[Homebrew, .deb, .rpm, and AUR](INSTALL.md).\n\n## Install WendyOS on a Device\n\nUse the CLI to install WendyOS on supported hardware:\n\n```sh\nwendy os install\n```\n\nThe installer can download WendyOS images, write them to the selected target\ndrive, and pre-seed device configuration such as WiFi credentials. WendyOS\nimages come preconfigured for remote development and include `wendy-agent`.\n\nTo discover a WendyOS device after it boots:\n\n```sh\nwendy discover\n```\n\nTo build and run an app on a discovered WendyOS device:\n\n```sh\nwendy run\n```\n\n## (Optional) Install wendy-agent\n\nYou do not need to install `wendy-agent` separately on WendyOS. WendyOS\n_already_ has `wendy-agent` installed and configured.\n\nInstall `wendy-agent` only when you want to turn a standard Linux machine into a\nWendy target, such as Ubuntu x86_64, Arch Linux, Fedora, Debian, RHEL-compatible\nLinux, or other distributions.\n\n```sh\ncurl -fsSL https://install.wendy.sh/agent.sh | bash\n```\n\nThe installer supports Linux x86_64 and ARM64. It uses native packages on\nDebian/Ubuntu, Fedora/RHEL, and Arch Linux when available, with a binary\nfallback for other Linux distributions. See [INSTALL.md](INSTALL.md) for manual\npackage installation.\n\n`wendy-agent` uses containerd to run apps. On a manual Linux setup, make sure\ncontainerd is installed and running:\n\n```sh\nsudo systemctl enable --now containerd\n```\n\n## Building from Source\n\n### CLI\n\nThe CLI is written in Go:\n\n```sh\ncd go\ngo build -o wendy ./cmd/wendy\n```\n\nOn macOS, CGO is required for CoreBluetooth. It is enabled by default when using\nthe standard Go toolchain, but if you have explicitly disabled it:\n\n```sh\ncd go\nCGO_ENABLED=1 go build -o wendy ./cmd/wendy\n```\n\n### Agent\n\nBuild the agent from source:\n\n```sh\ncd go\ngo build -o wendy-agent ./cmd/wendy-agent\n```\n\n### Local Developer Tip\n\nAdd a `wendy-dev` shell function to your shell profile (`~/.zshrc` or\n`~/.bashrc`) so you can quickly iterate on CLI changes without overwriting your\ninstalled `wendy`:\n\n```sh\nwendy-dev() {\n  (cd /path/to/WendyOS/go \u0026\u0026 go run ./cmd/wendy \"$@\")\n}\n```\n\nThen use `wendy-dev` anywhere you would normally use `wendy`:\n\n```sh\nwendy-dev run\nwendy-dev discover --json\n```\n\nYou can do the same for the agent:\n\n```sh\nwendy-agent-dev() {\n  (cd /path/to/WendyOS/go \u0026\u0026 go run ./cmd/wendy-agent \"$@\")\n}\n```\n\n## Network Manager Support\n\n`wendy-agent` supports both NetworkManager and ConnMan for WiFi configuration.\nThe agent automatically detects which network manager is available:\n\n- ConnMan is preferred for embedded and IoT devices due to its lighter resource usage.\n- NetworkManager is supported for desktop and server environments.\n- The agent automatically detects and uses the available network manager.\n\nYou can configure the network manager preference using the\n`WENDY_NETWORK_MANAGER` environment variable on the agent:\n\n```sh\n# Auto-detect (default)\nexport WENDY_NETWORK_MANAGER=auto\n\n# Prefer ConnMan if available, fall back to NetworkManager\nexport WENDY_NETWORK_MANAGER=connman\n\n# Prefer NetworkManager if available\nexport WENDY_NETWORK_MANAGER=networkmanager\n\n# Force ConnMan (will fail if not available)\nexport WENDY_NETWORK_MANAGER=force-connman\n\n# Force NetworkManager (will fail if not available)\nexport WENDY_NETWORK_MANAGER=force-networkmanager\n```\n\n## Examples\n\n### Hello, World\n\n```sh\ncd Examples/HelloWorld\nwendy run\n```\n\n### Hello HTTP\n\n```sh\ncd Examples/HelloHTTP\nwendy run\n```\n\n### Debugging\n\nTo debug an app, use the `--debug` flag:\n\n```sh\nwendy run --debug\n```\n\nThis enables host networking for remote debugger access. For Python apps,\n`debugpy` is automatically injected and listens on port `5678`.\n\n## Analytics\n\nThe Wendy CLI includes privacy-first anonymous usage analytics to help improve\nthe developer experience. Analytics helps us understand which commands are used\nmost, identify common errors, and prioritize improvements.\n\n### What's Collected\n\n- Command names and success/failure status\n- Sanitized error types, with no sensitive data\n- CLI version and operating system\n- Anonymous identifier (UUID)\n\nWe never collect file paths, hostnames, project names, code, or personally\nidentifiable information.\n\n### Managing Analytics\n\nCheck current analytics status:\n\n```sh\nwendy analytics status\n```\n\nDisable analytics:\n\n```sh\nwendy analytics disable\nexport WENDY_ANALYTICS=false\n```\n\nRe-enable analytics:\n\n```sh\nwendy analytics enable\n```\n\nAnalytics is automatically disabled in CI environments.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwendylabsinc%2Fwendyos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwendylabsinc%2Fwendyos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwendylabsinc%2Fwendyos/lists"}