https://github.com/copyleftdev/1337-fish-rng
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.
Science Score: 13.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
○.zenodo.json file
-
○DOI references
-
○Academic publication links
-
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (11.6%) to scientific vocabulary
Keywords
Repository
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.
Basic Info
Statistics
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
- Releases: 0
Topics
Metadata Files
readme.md
1337-fish-rng: RNG from Live Fish Movements
Overview
1337-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.
Concept
Drawing 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.
History
Historically, 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.
Considerations for Production Use
Security and Reliability
- Entropy Source: The randomness quality is contingent upon the continuous and stable observation of fish movements.
- Manipulation Risks: Potential predictability and external influence on fish behavior pose risks.
Performance Concerns
- Computation Intensity: Video processing demands significant computational resources, which may affect throughput and latency.
- Scalability Challenges: Scaling a video analysis-based service could present unique technical challenges.
Additional Entropy Sources
Enhancing the randomness involves integrating more entropy sources such as: - Environmental Sensors: Adding data from ambient environment sensors to enrich the entropy pool. - Hybrid RNG Systems: Merging fish-based randomness with other digital noise sources, like hardware random generators, can improve the robustness and security.
Docker Setup
Building the Docker Image
From the project's root directory, build the Docker image:
bash
docker build -t 1337-fish-rng .
Running the Container
To run the Docker container:
bash
docker run -p 8000:8000 1337-fish-rng
This makes the application accessible at http://localhost:8000. API documentation is available at http://localhost:8000/docs.
GitHub Repository
The project is maintained on GitHub by copyleftdev. Visit copyleftdev/1337-fish-rng for source code, updates, and contribution guidelines.
Conclusion
1337-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.
Owner
- Name: Donald Johnson
- Login: copyleftdev
- Kind: user
- Location: Los Angeles
- Repositories: 39
- Profile: https://github.com/copyleftdev
GitHub Events
Total
- Watch event: 2
Last Year
- Watch event: 2
Issues and Pull Requests
Last synced: 9 months ago
All Time
- Total issues: 0
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 0
- Total pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels
Dependencies
- python 3.12-slim build
- fastapi *
- numpy *
- opencv-python *
- pafy *
- pydantic *
- pydantic-settings *
- pyjwt *
- pytube *
- streamlink *
- uvicorn *
- youtube-dl *
- annotated-types ==0.6.0
- anyio ==4.3.0
- attrs ==23.2.0
- certifi ==2024.2.2
- cffi ==1.16.0
- charset-normalizer ==3.3.2
- click ==8.1.7
- colorama ==0.4.6
- dnspython ==2.6.1
- email-validator ==2.1.1
- exceptiongroup ==1.2.1
- fastapi ==0.111.0
- fastapi-cli ==0.0.2
- h11 ==0.14.0
- httpcore ==1.0.5
- httptools ==0.6.1
- httpx ==0.27.0
- idna ==3.7
- isodate ==0.6.1
- jinja2 ==3.1.3
- lxml ==5.2.1
- markdown-it-py ==3.0.0
- markupsafe ==2.1.5
- mdurl ==0.1.2
- numpy ==1.26.4
- opencv-python ==4.9.0.80
- orjson ==3.10.3
- outcome ==1.3.0.post0
- pafy ==0.5.5
- pycountry ==23.12.11
- pycparser ==2.22
- pycryptodome ==3.20.0
- pydantic ==2.7.1
- pydantic-core ==2.18.2
- pydantic-settings ==2.2.1
- pygments ==2.17.2
- pyjwt ==2.8.0
- pysocks ==1.7.1
- python-dotenv ==1.0.1
- python-multipart ==0.0.9
- pytube ==15.0.0
- pyyaml ==6.0.1
- requests ==2.31.0
- rich ==13.7.1
- shellingham ==1.5.4
- six ==1.16.0
- sniffio ==1.3.1
- sortedcontainers ==2.4.0
- starlette ==0.37.2
- streamlink ==6.7.3
- trio ==0.25.0
- trio-websocket ==0.11.1
- typer ==0.12.3
- typing-extensions ==4.11.0
- ujson ==5.9.0
- urllib3 ==2.2.1
- uvicorn ==0.29.0
- watchfiles ==0.21.0
- websocket-client ==1.8.0
- websockets ==12.0
- wsproto ==1.2.0
- youtube-dl ==2021.12.17