{"id":25911429,"url":"https://github.com/copyleftdev/1337-fish-rng","last_synced_at":"2025-03-03T09:17:30.949Z","repository":{"id":238075312,"uuid":"795817795","full_name":"copyleftdev/1337-fish-rng","owner":"copyleftdev","description":"1337-fish-rng leverages the unpredictable movements of fish to generate true randomness from live video feeds. This innovative project merges natural phenomena with digital technology to provide a unique, open-source tool for enhancing security and research.","archived":false,"fork":false,"pushed_at":"2024-05-04T06:31:33.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-05-04T07:27:45.248Z","etag":null,"topics":["entropy","experiment","natural-phenomena","random-number-generator","security"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/copyleftdev.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-05-04T06:27:14.000Z","updated_at":"2024-05-04T07:27:48.821Z","dependencies_parsed_at":"2024-05-04T07:27:48.205Z","dependency_job_id":"6a0b4fda-3e02-4d75-a125-16c774913098","html_url":"https://github.com/copyleftdev/1337-fish-rng","commit_stats":null,"previous_names":["copyleftdev/1337-fish-rng"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2F1337-fish-rng","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2F1337-fish-rng/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2F1337-fish-rng/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2F1337-fish-rng/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/copyleftdev","download_url":"https://codeload.github.com/copyleftdev/1337-fish-rng/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241637272,"owners_count":19994946,"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":["entropy","experiment","natural-phenomena","random-number-generator","security"],"created_at":"2025-03-03T09:17:30.330Z","updated_at":"2025-03-03T09:17:30.915Z","avatar_url":"https://github.com/copyleftdev.png","language":"Python","readme":"# 1337-fish-rng: RNG from Live Fish Movements\n\n## Overview\n\n1337-fish-rng is an innovative project that uses live video streams from the Monterey Bay Aquarium to generate random numbers based on fish movements. This unique approach to randomness leverages the unpredictability of natural processes in a creative and engaging way.\n\n## Concept\n\nDrawing from concepts like atmospheric noise and radioactive decay used in traditional randomness generation, 1337-fish-rng captures the chaotic movement of fish to provide a source of entropy. This method contrasts sharply with algorithmic randomness, offering a fresh perspective on generating truly random numbers.\n\n## History\n\nHistorically, the utilization of natural phenomena for generating randomness has seen applications in various scientific and encryption-related fields. The 1337-fish-rng project taps into this rich vein by observing and quantifying the random paths of fish in an aquarium environment.\n\n## Considerations for Production Use\n\n### Security and Reliability\n\n- **Entropy Source**: The randomness quality is contingent upon the continuous and stable observation of fish movements.\n- **Manipulation Risks**: Potential predictability and external influence on fish behavior pose risks.\n\n### Performance Concerns\n\n- **Computation Intensity**: Video processing demands significant computational resources, which may affect throughput and latency.\n- **Scalability Challenges**: Scaling a video analysis-based service could present unique technical challenges.\n\n### Additional Entropy Sources\n\nEnhancing the randomness involves integrating more entropy sources such as:\n- **Environmental Sensors**: Adding data from ambient environment sensors to enrich the entropy pool.\n- **Hybrid RNG Systems**: Merging fish-based randomness with other digital noise sources, like hardware random generators, can improve the robustness and security.\n\n## Docker Setup\n\n### Building the Docker Image\n\nFrom the project's root directory, build the Docker image:\n```bash\ndocker build -t 1337-fish-rng .\n```\n\n### Running the Container\n\nTo run the Docker container:\n```bash\ndocker run -p 8000:8000 1337-fish-rng\n```\n\nThis makes the application accessible at `http://localhost:8000`. API documentation is available at `http://localhost:8000/docs`.\n\n## GitHub Repository\n\nThe project is maintained on GitHub by `copyleftdev`. Visit [copyleftdev/1337-fish-rng](https://github.com/copyleftdev/1337-fish-rng) for source code, updates, and contribution guidelines.\n\n## Conclusion\n\n1337-fish-rng is a thought-provoking experiment in randomness generation. While it holds potential for educational and experimental applications, further research and development are needed for high-stakes environments such as cryptographic applications.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcopyleftdev%2F1337-fish-rng","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcopyleftdev%2F1337-fish-rng","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcopyleftdev%2F1337-fish-rng/lists"}