{"id":25972052,"url":"https://github.com/jshulgach/neurobridge","last_synced_at":"2026-04-08T22:32:03.315Z","repository":{"id":280572792,"uuid":"942367596","full_name":"Jshulgach/NeuroBridge","owner":"Jshulgach","description":"NeuroBridge: Where AI perception meets real-time robotics control","archived":false,"fork":false,"pushed_at":"2025-03-04T05:59:40.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-04T06:32:47.485Z","etag":null,"topics":["ai","arduino","artificial-intelligence","computer-vision","gpt4","grounding-dino","llama","llama3","llm","python","raspberry-pi","robot","robotics","sam"],"latest_commit_sha":null,"homepage":"","language":null,"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/Jshulgach.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}},"created_at":"2025-03-04T02:10:52.000Z","updated_at":"2025-03-04T05:59:43.000Z","dependencies_parsed_at":"2025-03-04T06:32:50.398Z","dependency_job_id":"8175e5c7-13d8-4cc5-ab98-6a4d1865abca","html_url":"https://github.com/Jshulgach/NeuroBridge","commit_stats":null,"previous_names":["jshulgach/neurobridge"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jshulgach%2FNeuroBridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jshulgach%2FNeuroBridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jshulgach%2FNeuroBridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jshulgach%2FNeuroBridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jshulgach","download_url":"https://codeload.github.com/Jshulgach/NeuroBridge/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241940873,"owners_count":20045950,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["ai","arduino","artificial-intelligence","computer-vision","gpt4","grounding-dino","llama","llama3","llm","python","raspberry-pi","robot","robotics","sam"],"created_at":"2025-03-05T00:18:57.071Z","updated_at":"2026-04-08T22:32:03.307Z","avatar_url":"https://github.com/Jshulgach.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# NeuroBridge\n\nNeuroBridge is the open-source runtime project for the assistive exoskeleton AI stack.\n\nIt hosts the conversation runtime, safety/policy pipeline, deployment bundle system, telemetry channels, and operator-facing tools for NML Hand Exo workflows.\n\n## Highlights\n\n- Runtime-first architecture with configurable providers and safety validation.\n- Deployment bundles (`config/bundles`) for reproducible adapter + policy defaults.\n- Simulation-first defaults for safer onboarding (`simulate_exo: true`, `dry_run: true` in default bundle).\n- CLI, GUI, and visualizer entrypoints.\n- Local source fallback support for cross-repo development with `NML_Hand_Exo`.\n\n## Repository Layout\n\n- `src/neurobridge_assist/`: lightweight launcher and bootstrap.\n- `src/nml_hand_exo/`: runtime package (assistant app, adapters, policy, telemetry, UI).\n- `config/`: bundles, adapter configs, policy profiles, skill packs.\n- `legacy_archive/`: preserved legacy files for reference (not active runtime path).\n- `docs/`: project documentation and contributor references.\n\n## Quick Start\n\nFrom repository root:\n\n```powershell\npython -m pip install -e .\nneurobridge-assist --bundle nml_default --command \"status\"\n```\n\nRun the direct entrypoints:\n\n```powershell\nnml-ai-assist --bundle nml_default --command \"status\"\nnml-ai-assist-gui\nnml-exo-state-visualizer\n```\n\nOr call the thin launcher module:\n\n```powershell\npython main.py --bundle nml_default --command \"status\"\n```\n\n## Typical Two-Terminal Workflow (Simulator)\n\nTerminal A (conversation loop):\n\n```powershell\nnml-ai-assist --bundle nml_default --conversation-mode --simulate-exo --dry-run\n```\n\nTerminal B (state visualizer):\n\n```powershell\nnml-exo-state-visualizer\n```\n\nFor live simulated execution (state-changing commands), explicitly disable dry-run:\n\n```powershell\nnml-ai-assist --bundle nml_default --command \"close the hand\" --simulate-exo --no-dry-run --auto-confirm\n```\n\nIf telemetry appears stale, ensure only one listener is attached to the same telemetry port or pick an isolated port:\n\n```powershell\nnml-ai-assist --bundle nml_default --conversation-mode --simulate-exo --no-dry-run --telemetry-port 9877\nnml-exo-state-visualizer\n```\n\n## Configuration Model\n\n- Bundle: `--bundle \u003cname\u003e` or `--bundle-file \u003cpath\u003e`\n- Policy profile: `--policy-profile \u003cname\u003e` or `--policy-profile-file \u003cpath\u003e`\n- Adapter selection: `--robot-adapter nml_hand_exo|virtual_openclaw`\n- Adapter config: `--robot-config \u003cpath\u003e`\n\nUseful discovery commands:\n\n```powershell\nnml-ai-assist --list-bundles\nnml-ai-assist --list-policy-profiles\nnml-ai-assist --list-robot-adapters\n```\n\n## Optional AI Extras\n\nInstall optional speech/provider extras:\n\n```powershell\npython -m pip install -e .[ai]\n```\n\n## Fallback Import Behavior\n\n`neurobridge-assist` resolves runtime imports in this order:\n\n1. Local NeuroBridge source (`src/nml_hand_exo`)\n2. `NML_HAND_EXO_PATH` environment override (expected to point to `NML_Hand_Exo/src`)\n3. Sibling fallback path `../NML_Hand_Exo/src`\n\n## Documentation\n\n- [docs/QUICKSTART.md](docs/QUICKSTART.md)\n- [docs/CONFIGURATION.md](docs/CONFIGURATION.md)\n- [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)\n- [docs/RELEASES.md](docs/RELEASES.md)\n- [MIGRATION_NOTES.md](MIGRATION_NOTES.md)\n\n## Contributing and Community\n\n- [CONTRIBUTING.md](CONTRIBUTING.md)\n- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)\n- [SECURITY.md](SECURITY.md)\n- [SUPPORT.md](SUPPORT.md)\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjshulgach%2Fneurobridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjshulgach%2Fneurobridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjshulgach%2Fneurobridge/lists"}