{"id":34875050,"url":"https://github.com/wendylabsinc/wendy-agent","last_synced_at":"2026-05-16T00:21:42.694Z","repository":{"id":286266958,"uuid":"960357174","full_name":"wendylabsinc/wendy-agent","owner":"wendylabsinc","description":"A CLI and App Manager for WendyOS","archived":false,"fork":false,"pushed_at":"2026-05-02T03:22:14.000Z","size":32430,"stargazers_count":46,"open_issues_count":15,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-02T03:31:59.857Z","etag":null,"topics":["edge","edge-compuing","iot","jetson","nvidia","physical","swift"],"latest_commit_sha":null,"homepage":"https://wendy.sh/docs/","language":"Swift","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":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-04T09:45:50.000Z","updated_at":"2026-05-02T02:55:04.000Z","dependencies_parsed_at":"2025-04-05T11:25:13.638Z","dependency_job_id":"e69ede3a-6e77-45da-b993-832145fae5a7","html_url":"https://github.com/wendylabsinc/wendy-agent","commit_stats":null,"previous_names":["apache-edge/edge-agent","edgeengineer/edge-agent","wendylabsinc/wendy-agent"],"tags_count":480,"template":false,"template_full_name":null,"purl":"pkg:github/wendylabsinc/wendy-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wendylabsinc%2Fwendy-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wendylabsinc%2Fwendy-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wendylabsinc%2Fwendy-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wendylabsinc%2Fwendy-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wendylabsinc","download_url":"https://codeload.github.com/wendylabsinc/wendy-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wendylabsinc%2Fwendy-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32608333,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"ssl_error","status_checked_at":"2026-05-04T10:08:02.005Z","response_time":58,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":"2025-12-26T00:46:14.406Z","updated_at":"2026-05-04T13:05:43.652Z","avatar_url":"https://github.com/wendylabsinc.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wendy Agent \u0026 Wendy CLI\n\n## Installing the 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\nAlso available via [Homebrew, .deb, .rpm, and AUR](INSTALL.md).\n\n## Installing the Agent\n\nInstall or update the `wendy-agent` on a Linux device (x86_64 and ARM64):\n\n```sh\ncurl -fsSL https://install.wendy.sh/agent.sh | bash\n```\n\nSupports Debian/Ubuntu, Fedora/RHEL, and Arch Linux. Also available via [system packages](INSTALL.md).\n\n## Building from Source\n\n### CLI (Go)\n\nThe CLI is written in Go. To build from source:\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\nusing the 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 (Go)\n\nTo build and run the agent locally:\n\n```sh\ncd go\ngo build -o wendy-agent ./cmd/wendy-agent\n```\n\n### Local Developer Tip\n\nAdd a `wendy-dev` alias to your shell profile (`~/.zshrc` or `~/.bashrc`) so you can quickly iterate on CLI changes without overwriting your installed `wendy`:\n\n```sh\nwendy-dev() {\n  (cd /path/to/wendy-agent/go \u0026\u0026 go run ./cmd/wendy \"$@\")\n}\n```\n\nThen use `wendy-dev` anywhere you'd 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/wendy-agent/go \u0026\u0026 go run ./cmd/wendy-agent \"$@\")\n}\n```\n\n## Setting Up the Device\n\nThe device needs to run the `wendy-agent`. We provide pre-built [WendyOS](https://wendy.sh) images for the Raspberry Pi and the NVIDIA Jetson Orin Nano. These are preconfigured for remote debugging and have the wendy-agent preinstalled.\n\n### Network Manager Support\n\nWendyAgent supports both NetworkManager and ConnMan for WiFi configuration. The agent will automatically detect which network manager is available on the system:\n\n- **ConnMan** is preferred for embedded/IoT devices due to its lighter resource usage\n- **NetworkManager** is supported for desktop and server environments\n- The agent will automatically detect and use the available network manager\n\n#### Configuration\n\nYou can configure the network manager preference using the `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\nIf no environment variable is set, the agent will auto-detect the available network manager.\n\n#### Manual Setup\n\nThe `wendy` CLI communicates with a `wendy-agent`. The agent uses containerd for running your apps.\nOn a Debian (or Ubuntu) based OS, you can do the following:\n\n```sh\n# Install containerd\nsudo apt install containerd\n# Start containerd and keep running across reboots\nsudo systemctl start containerd\nsudo systemctl enable containerd\n```\n\nThen install the agent using the install script above, or download a build from the [releases page](https://github.com/wendylabsinc/wendy-agent/releases).\n\n## Examples\n\n### Hello, world!\n\n```sh\ncd Examples/HelloWorld\nwendy run\n```\n\n### Hello HTTP\n\nA more advanced example demonstrating HTTP server capabilities:\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, `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 the developer experience. Analytics helps us understand which commands are used most, identify common errors, and prioritize improvements.\n\n### What's Collected\n\n- Command names and success/failure status\n- Sanitized error types (no sensitive data)\n- CLI version and operating system\n- Anonymous identifier (UUID)\n\nWe **never** collect file paths, hostnames, project names, code, or any personally identifiable information.\n\n### Managing Analytics\n\nCheck current analytics status:\n```bash\nwendy analytics status\n```\n\nDisable analytics:\n```bash\nwendy analytics disable\n# Or set environment variable\nexport WENDY_ANALYTICS=false\n```\n\nRe-enable analytics:\n```bash\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%2Fwendy-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwendylabsinc%2Fwendy-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwendylabsinc%2Fwendy-agent/lists"}