{"id":41664715,"url":"https://github.com/birdnet-team/birdnet-tiny-forge","last_synced_at":"2026-01-24T17:15:59.380Z","repository":{"id":268356935,"uuid":"894222311","full_name":"birdnet-team/BirdNET-Tiny-Forge","owner":"birdnet-team","description":"Create your own birdsong logger, powered by BirdNET-Tiny.","archived":false,"fork":false,"pushed_at":"2025-09-26T05:29:52.000Z","size":585,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-09-26T07:16:07.101Z","etag":null,"topics":["ai","birdsong","edge-computing","embedded","kedro","machine-learning"],"latest_commit_sha":null,"homepage":"","language":"Python","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/birdnet-team.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-11-26T01:10:55.000Z","updated_at":"2025-09-26T05:29:56.000Z","dependencies_parsed_at":"2025-06-16T02:30:31.463Z","dependency_job_id":"0f47308c-3d4f-4809-ae54-05ede757b677","html_url":"https://github.com/birdnet-team/BirdNET-Tiny-Forge","commit_stats":null,"previous_names":["birdnet-team/birdnet-tiny-forge"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/birdnet-team/BirdNET-Tiny-Forge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/birdnet-team%2FBirdNET-Tiny-Forge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/birdnet-team%2FBirdNET-Tiny-Forge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/birdnet-team%2FBirdNET-Tiny-Forge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/birdnet-team%2FBirdNET-Tiny-Forge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/birdnet-team","download_url":"https://codeload.github.com/birdnet-team/BirdNET-Tiny-Forge/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/birdnet-team%2FBirdNET-Tiny-Forge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28732308,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T10:24:43.181Z","status":"ssl_error","status_checked_at":"2026-01-24T10:24:36.112Z","response_time":89,"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":["ai","birdsong","edge-computing","embedded","kedro","machine-learning"],"created_at":"2026-01-24T17:15:59.296Z","updated_at":"2026-01-24T17:15:59.373Z","avatar_url":"https://github.com/birdnet-team.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BirdNET-Tiny Forge\n[![Powered by Kedro](https://img.shields.io/badge/powered_by-kedro-ffc900?logo=kedro)](https://kedro.org)\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/birdnet-team/BirdNET-Tiny-Forge/refs/heads/master/img/birdnet-tiny-forge.png\" width=\"128\" alt=\"BirdNET-Tiny logo, an 8-bit image of a bird on an anvil\"\u003e\n\u003c/p\u003e\n\nBirdNET-Tiny Forge simplifies the training of BirdNET-Tiny models and their deployment on embedded devices.\n\nBirdNET-Tiny Forge is a collaboration between\n[BirdNET](https://birdnet.cornell.edu/)\nand [fold ecosystemics](https://fold.eco).\n\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://birdnet.cornell.edu/\"\u003e\u003cimg src=\"https://github.com/birdnet-team/BirdNET-Analyzer/blob/main/docs/_static/logo_birdnet_big.png?raw=true\" width=\"80px\" alt=\"BirdNET logo\"\u003e\u003c/a\u003e\n\u003ca href=\"https://fold.eco\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/birdnet-team/BirdNET-Tiny-Forge/refs/heads/master/img/fold-ecosystemics.png\" height=\"80px\" alt=\"fold ecosystemics logo\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n## Documentation\nPlease find the documentation [here](https://birdnet-tiny-forge.readthedocs.io/en/latest/).\n\n## Supported devices\n\n### Active\n\n- [ESP32-S3-Korvo-2 V3.0](https://docs.espressif.com/projects/esp-adf/en/latest/design-guide/dev-boards/user-guide-esp32-s3-korvo-2.html)\n\n### Planned\n- BirdWatcher PUC\n\n\n## ⚠️ Development Status ⚠️\n\nThis project is in early development stage, and not recommended for production use:\n- APIs may change without notice\n- Features might be incomplete\n- Documentation may be outdated\n\n## System requirements\n- Ubuntu 24.04 LTS. Other Debian-based OSs and Ubuntu versions will most likely work with minimal tweaks if any, but are not officially supported.\n- Python 3.10 or 3.11 and corresponding `python-dev` library (`python3.10-dev` and `python3.11-dev` in Ubuntu apt repository)\n- [bazel](https://bazel.build/install/bazelisk) (needed to build a patched python wheel of tflite-micro)\n- [docker](https://docs.docker.com/engine/install/ubuntu/)\n\n\n## Installation\n\n```bash\n# Download and build patched version of tflite (it makes custom signal ops available, and pins the tensorflow version to the one used in this repo)\n./build_tflite.sh tflite-micro\n\n# Project uses poetry for python dependency management\npip install poetry\n\n# Finally, install all deps\npoetry install\n```\n\n## Prepare your data\n### Xenocanto\nIf using [xeno-canto](https://xeno-canto.org) data to train your network, please make sure to review its [terms](https://xeno-canto.org/about/terms) to check your usage is compatible with them.\n\n- Please create an account on https://xeno-canto.org, which grants you the API key we will use to download bird recordings to train our network.\n\n- Create a `species.txt` file, where each line contains the scientific name of a species you want to train on.\n\n- Call `xc-download --api-key \u003cyour API key\u003e --species-file \u003cpath to species file\u003e --n-recs \u003cnumber of recordings per species to download\u003e`\n\n### AudioSet\n\n- Create a `audioset.txt` file, with each line being a class in AudioSet you wish to download data for.\n- Run `audioset-download --labels-file \u003cpath to audioset labels\u003e --limit \u003cmax number of files to download per class\u003e`\n\n### Custom data\nIf you have your own recordings you'd like to train on, first isolate the bird calls you're interested in, creating audio clips. Place your clips in `data/01_raw/audio_clips`, with the following structure:\n\n```\naudio_clips\n├── \u003clabel, e.g. Apteryx mantelli\u003e\n│  ├── \u003crecording, e.g. abc123.wav\u003e\n│  ├── ...\n├── \u003clabel, e.g. Apteryx owenii\u003e\n├── ...\n```\n\n## Run the pipeline\n\n\n## Development setup\n\n```bash\npoetry install --with dev\n```\n\n## License\n\nSee [LICENSE file](https://github.com/birdnet-team/BirdNET-Tiny-Forge/blob/master/LICENSE) at project root.\n\n## Contributing\n\nSee our [contribution documentation](https://github.com/birdnet-team/BirdNET-Tiny-Forge/blob/master/CONTRIBUTING.MD).\n\n## Funding\n\nThis project is supported by Jake Holshuh (Cornell class of ’69) and The Arthur Vining Davis Foundations. Our work in the K. Lisa Yang Center for Conservation Bioacoustics is made possible by the generosity of K. Lisa Yang to advance innovative conservation technologies to inspire and inform the conservation of wildlife and habitats.\n\nThe development of BirdNET is supported by the German Federal Ministry of Education and Research through the project “BirdNET+” (FKZ 01|S22072). The German Federal Ministry for the Environment, Nature Conservation and Nuclear Safety contributes through the “DeepBirdDetect” project (FKZ 67KI31040E). In addition, the Deutsche Bundesstiftung Umwelt supports BirdNET through the project “RangerSound” (project 39263/01).\n\n## Partners\n\nBirdNET is a joint effort of partners from academia and industry.\nWithout these partnerships, this project would not have been possible.\nThank you!\n\n![Our partners](https://tuc.cloud/index.php/s/KSdWfX5CnSRpRgQ/download/box_logos.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbirdnet-team%2Fbirdnet-tiny-forge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbirdnet-team%2Fbirdnet-tiny-forge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbirdnet-team%2Fbirdnet-tiny-forge/lists"}