{"id":24639420,"url":"https://github.com/netboxlabs/diode","last_synced_at":"2025-04-05T06:02:13.375Z","repository":{"id":249317261,"uuid":"747327201","full_name":"netboxlabs/diode","owner":"netboxlabs","description":"Diode data ingestion for NetBox, from NetBox Labs","archived":false,"fork":false,"pushed_at":"2025-03-28T16:40:22.000Z","size":2017,"stargazers_count":77,"open_issues_count":15,"forks_count":6,"subscribers_count":4,"default_branch":"develop","last_synced_at":"2025-03-28T17:44:07.674Z","etag":null,"topics":["automation","discovery","ingestion","netbox"],"latest_commit_sha":null,"homepage":"https://netboxlabs.com","language":"Go","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/netboxlabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-23T17:59:23.000Z","updated_at":"2025-03-21T12:18:10.000Z","dependencies_parsed_at":"2024-07-20T02:22:33.314Z","dependency_job_id":"79c425e9-1de8-4a5b-8cfd-dbf13c46b1f8","html_url":"https://github.com/netboxlabs/diode","commit_stats":null,"previous_names":["netboxlabs/diode"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netboxlabs%2Fdiode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netboxlabs%2Fdiode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netboxlabs%2Fdiode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netboxlabs%2Fdiode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netboxlabs","download_url":"https://codeload.github.com/netboxlabs/diode/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247294514,"owners_count":20915340,"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":["automation","discovery","ingestion","netbox"],"created_at":"2025-01-25T11:11:29.813Z","updated_at":"2025-04-05T06:02:13.357Z","avatar_url":"https://github.com/netboxlabs.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Diode\n\nDiode is a NetBox data ingestion service that greatly simplifies and enhances the process to add and update network data\nin NetBox, ensuring your network source of truth is always accurate and can be trusted to power your network automation\npipelines. Our guiding principle in designing Diode has been to make it as easy as possible to get data into NetBox,\nremoving as much burden as possible from the user while shifting that effort to technology.\n\nTo achieve this, Diode sits in front of NetBox and provides an API purpose built for ingestion of complex network data.\nDiode eliminates the need to preprocess data to make it conform to the strict object hierarchy imposed by the NetBox\ndata model. This allows data to be sent to NetBox in a more freeform manner, in blocks that are intuitive for network\nengineers (such as by device or by interface) with much of the related information treated as attributes or properties\nof these components of interest. Then, Diode takes care of the heavy lifting, automatically transforming the data to\nalign it with NetBox’s structured and comprehensive data model. Diode can even create placeholder objects to compensate\nfor missing information, which means even fragmented information about the network can be captured in NetBox.\n\n## Project status\n\nThe Diode project is currently in the _Public Preview_ stage. Please\nsee [NetBox Labs Product and Feature Lifecycle](https://docs.netboxlabs.com/product_feature_lifecycle/) for more\ndetails. We actively welcome feedback to help identify and prioritize bugs, new features and areas of improvement.\n\n## Get started\n\nDiode runs as a sidecar service to NetBox and can run anywhere with network connectivity to NetBox, whether on the same\nhost or elsewhere. The overall Diode service is delivered through three main components (and a fourth optional\ncomponent):\n\n1. Diode plugin - see how to [install the Diode plugin](https://github.com/netboxlabs/diode-netbox-plugin)\n2. Diode server - see how\n   to [run the Diode server](https://github.com/netboxlabs/diode/tree/develop/diode-server#readme)\n3. Diode SDK - see how\n   to [install the Diode Python client SDK](https://github.com/netboxlabs/diode-sdk-python), [download Diode Python script examples](https://github.com/netboxlabs/netbox-learning/tree/develop/diode)\n   and [use the Diode SDK Go](https://github.com/netboxlabs/diode-sdk-go)\n4. Diode agent (optional) - see how\n   to [install and run the Diode NAPALM discovery agent](https://github.com/netboxlabs/diode-agent/tree/develop/diode-napalm-agent)\n\n## Related Projects\n\n- [diode-netbox-plugin](https://github.com/netboxlabs/diode-netbox-plugin) - The Diode NetBox plugin is a NetBox plugin\n  and a required component of the Diode ingestion service.\n- [diode-sdk-python](https://github.com/netboxlabs/diode-sdk-python) - Diode SDK Python is a Python library for\n  interacting with the Diode ingestion service utilizing gRPC.\n- [diode-sdk-go](https://github.com/netboxlabs/diode-sdk-go) - Diode SDK Go is a Go module for interacting with the\n  Diode ingestion service utilizing gRPC.\n- [diode-agent](https://github.com/netboxlabs/diode-agent) - A collection of agents that leverage the Diode SDK to\n  interact with the Diode server.\n\n## License\n\nDistributed under the PolyForm Shield License 1.0.0 License. See [LICENSE.md](./LICENSE.md) for more information.\n\nDiode protocol buffers are distributed under the Apache 2.0 License. See [LICENSE.txt](./diode-proto/LICENSE.txt) for\nmore information.\n\n## Required Notice\n\nCopyright NetBox Labs, Inc.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetboxlabs%2Fdiode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetboxlabs%2Fdiode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetboxlabs%2Fdiode/lists"}