{ "info": { "author": "Jadiel de Armas", "author_email": "jadielam@gmail.com", "bugtrack_url": null, "classifiers": [ "Intended Audience :: Developers", "Intended Audience :: Education", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3.6", "Topic :: Software Development :: Libraries", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "# Videoflow\n\n![Videoflow](assets/videoflow_logo_small.png)\n\n[![Build Status](https://travis-ci.org/videoflow/videoflow.svg?branch=master)](https://travis-ci.org/videoflow/videoflow)\n[![license](https://img.shields.io/github/license/mashape/apistatus.svg?maxAge=2592000)](https://github.com/videoflow/videoflow/blob/master/LICENSE)\n\n**Videoflow** is a Python framework for video stream processing. The library is designed to facilitate easy and quick definition of computer vision stream processing pipelines. It empowers developers to build applications and systems with self-contained Deep Learning and Computer Vision capabilities using simple and few lines of code. It contains off-the-shelf reference components for object detection, object tracking, human pose estimation, etc, and it is easy to extend with your own.\n\nThe complete documentation to the project is located in [**docs.videoflow.dev**](https://docs.videoflow.dev)\n\n[1.2]: http://i.imgur.com/wWzX9uB.png\n[1]: http://www.twitter.com/videoflow_py\n\n\n## Installing the framework\n### Requirements\nBefore installing, be sure that you have `cv2` and `tensorflow >= 1.12` already installed. Python 2 is **NOT SUPPORTED**. Requires Python 3.6+. There are some [known issues](https://github.com/videoflow/videoflow/issues/56) to run it on Windows too\n\n### Installation\nYou can install directly using **pip** by doing `pip3 install videoflow`\n\nAlternatively, you can install by:\n\n1. Clone this repository\n2. Inside the repository folder, execute `pip3 install . --user`\n\n**Usage with docker**\n```bash\n# clone repo\ndocker build -t repo/videoflow:latest .\n# runs examples/object_detector.py by default\ndocker run -u $(id -u):$(id -g) -v $(pwd):/usr/src/app repo/videoflow\n# or mount the volume from your code directory to /usr/src/app\ndocker run -u $(id -u):$(id -g) -v $(pwd):/usr/src/app repo/videoflow python /usr/src/app/yourown.py\n```\n## Contributing:\nA tentative [roadmap](ROADMAP.md) of where we are headed.\n\n[Contribution rules](CONTRIBUTING.md).\n\nIf you have new processors, producers or consumers that you can to create, check the [videoflow-contrib](https://github.com/videoflow/videoflow-contrib) project. We want \nto keep videoflow succinct, clean, and simple, with as minimal dependencies to third-party libraries as necessaries. [videoflow-contrib](https://github.com/videoflow/videoflow-contrib) is better suited for adding new components that require new library \ndependencies.\n\n## Sample Videoflow application:\nBelow a sample videoflow application that detects automobiles in an intersection. For more examples see the [examples](examples/) folder. It uses detection model published by [tensorflow/models](https://github.com/tensorflow/models/tree/master/research/object_detection)\n\n[![IMAGE ALT TEXT HERE](https://img.youtube.com/vi/TYGMllb7fHM/0.jpg)](https://www.youtube.com/watch?v=TYGMllb7fHM)\n\n```python\nimport videoflow\nimport videoflow.core.flow as flow\nfrom videoflow.core.constants import BATCH\nfrom videoflow.consumers import VideofileWriter\nfrom videoflow.producers import VideofileReader\nfrom videoflow.processors.vision.detectors import TensorflowObjectDetector\nfrom videoflow.processors.vision.annotators import BoundingBoxAnnotator\nfrom videoflow.utils.downloader import get_file\n\nURL_VIDEO = \"https://github.com/videoflow/videoflow/releases/download/examples/intersection.mp4\"\n\nclass FrameIndexSplitter(videoflow.core.node.ProcessorNode):\n def __init__(self):\n super(FrameIndexSplitter, self).__init__()\n\n def process(self, data):\n index, frame = data\n return frame\n\ninput_file = get_file(\"intersection.mp4\", URL_VIDEO)\noutput_file = \"output.avi\"\nreader = VideofileReader(input_file)\nframe = FrameIndexSplitter()(reader)\ndetector = TensorflowObjectDetector()(frame)\nannotator = BoundingBoxAnnotator()(frame, detector)\nwriter = VideofileWriter(output_file, fps = 30)(annotator)\nfl = flow.Flow([reader], [writer], flow_type = BATCH)\nfl.run()\nfl.join()\n```\n\nThe output of the application is an annotated video:\n\n\n## The Structure of a flow application\n\nA flow application usually consists of three parts:\n\n1. In the first part of the application you define a directed acyclic graph of computation nodes. There are 3 different kinds of nodes: producers, processors and consumers. Producer nodes create data (commonly they will get the data from a source that is external to the flow). Processors receive data as input and produce data as output. Consumers read data and do not produce any output. You usually use a consumer when you want to write results to a log file, or when you want to push results to an external source (rest API, S3 bucket, etc.)\n\n2. To create a flow object, you need to pass to it your list of producers and your list of consumers. Once a flow is defined you can start it. Starting the flow means that the producers start putting data into the flow and processors and consumers start receiving data. Starting the flow also means allocating resources for producers, processors and consumers. For simplicity for now we can say that each producer, processor and consumer will run on its own process space.\n\n3. Once the flow starts, you can also stop it. When you stop the flow, it will happen organically. Producers will stop producing data. The rest of the nodes in the flow will continue running until the pipes run dry. The resources used in the flow are deallocated progressively, as each node stops producing/processing/consuming data.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/videoflow/videoflow", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "videoflow", "package_url": "https://pypi.org/project/videoflow/", "platform": "", "project_url": "https://pypi.org/project/videoflow/", "project_urls": { "Homepage": "https://github.com/videoflow/videoflow" }, "release_url": "https://pypi.org/project/videoflow/0.2.5/", "requires_dist": [ "numpy (>=1.9.1)", "opencv-python", "filterpy", "six (>=1.9.0)", "scikit-learn" ], "requires_python": "", "summary": "Python video stream processing library", "version": "0.2.5" }, "last_serial": 5616007, "releases": { "0.1.5": [ { "comment_text": "", "digests": { "md5": "744eaac5727058fd654d101aa92b1b02", "sha256": "32d53071ca9a1a51f7502bd7d309b722e384c9f0df754938060ac5e7bc8989bb" }, "downloads": -1, "filename": "videoflow-0.1.5-py2-none-any.whl", "has_sig": false, "md5_digest": "744eaac5727058fd654d101aa92b1b02", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 29854, "upload_time": "2019-05-15T17:25:20", "url": "https://files.pythonhosted.org/packages/28/1c/4caa56665d4402965298ab20fda8cc59ba1ff86a4b5d813f39598bf469c7/videoflow-0.1.5-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e9295b10aa6cfe3b803c0cc794c985df", "sha256": "4b95e1d235b73b78792af77de2fbb7983615862d36ed29de45844c15ec400494" }, "downloads": -1, "filename": "videoflow-0.1.5.tar.gz", "has_sig": false, "md5_digest": "e9295b10aa6cfe3b803c0cc794c985df", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21375, "upload_time": "2019-05-15T17:25:21", "url": "https://files.pythonhosted.org/packages/b6/3d/ee8c9627a3072f5ba773d054441c01450e8d2687d795d3d9521bd0c8d872/videoflow-0.1.5.tar.gz" } ], "0.1.6": [ { "comment_text": "", "digests": { "md5": "77609415cbdd459ce5e26981e82508a3", "sha256": "ff3d2c58190cfb63f50ad00f0b1a738bfdbdc8f33e13e15060668062b1524de8" }, "downloads": -1, "filename": "videoflow-0.1.6-py2-none-any.whl", "has_sig": false, "md5_digest": "77609415cbdd459ce5e26981e82508a3", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 36399, "upload_time": "2019-05-17T18:02:02", "url": "https://files.pythonhosted.org/packages/c2/ec/9487482bcd3fc821d818933c4aaa1dc2f8d6a69c184a18d481a9649b0065/videoflow-0.1.6-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "533e1095ee010b984b839a7da04e642a", "sha256": "3318640c740f7cce6ce8b5c51eebd7b6a8e85a49831e57dce15c1d1a01f6e2b0" }, "downloads": -1, "filename": "videoflow-0.1.6.tar.gz", "has_sig": false, "md5_digest": "533e1095ee010b984b839a7da04e642a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 26733, "upload_time": "2019-05-17T18:02:04", "url": "https://files.pythonhosted.org/packages/84/d4/c0f04072e95d001bc9efe44d134411b4b8da5316182ba88a275fdb6b4671/videoflow-0.1.6.tar.gz" } ], "0.1.7": [ { "comment_text": "", "digests": { "md5": "5b769c8fa3ea65a4c212005bbe4bd6b9", "sha256": "f537739af5617fb12c81ada3fd9002ea67f488b058d87256394042f6fd1bb3d1" }, "downloads": -1, "filename": "videoflow-0.1.7-py2-none-any.whl", "has_sig": false, "md5_digest": "5b769c8fa3ea65a4c212005bbe4bd6b9", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 36486, "upload_time": "2019-05-17T18:59:32", "url": "https://files.pythonhosted.org/packages/28/b3/089abcea732eb4084a8c43440f8f8045752c60b4e87039803037daed802a/videoflow-0.1.7-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d8ad5be0e1168a3a615a3d8bb4a1047e", "sha256": "04358af48d7afce5ec7ed8a5781be167178ba56160fbe02349205e9eeed2ffae" }, "downloads": -1, "filename": "videoflow-0.1.7.tar.gz", "has_sig": false, "md5_digest": "d8ad5be0e1168a3a615a3d8bb4a1047e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 26900, "upload_time": "2019-05-17T18:59:33", "url": "https://files.pythonhosted.org/packages/46/a2/bbbee2bb98d6abd64bba6e1f456abcd99748ec5dbd3d237114796bf3ded5/videoflow-0.1.7.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "e8f00f6696cc0057d741dab58780e928", "sha256": "b737de1638584bc40a05a81805cb4a99ddc66642673f41ed26671dbf028557bb" }, "downloads": -1, "filename": "videoflow-0.2.1-py2-none-any.whl", "has_sig": false, "md5_digest": "e8f00f6696cc0057d741dab58780e928", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 39829, "upload_time": "2019-05-25T11:02:57", "url": "https://files.pythonhosted.org/packages/1f/08/2f0080ff63258f1418c96129b6aa38de44c622d7cf47fabc40f530e9313e/videoflow-0.2.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a7061c2c74e66acda1a81cf4b6995d19", "sha256": "1877e8abe41e08cb5523dc1b9b6e1b8e4d8c8bad826be7f0bab86ab9056edc8f" }, "downloads": -1, "filename": "videoflow-0.2.1.tar.gz", "has_sig": false, "md5_digest": "a7061c2c74e66acda1a81cf4b6995d19", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29796, "upload_time": "2019-05-25T11:02:59", "url": "https://files.pythonhosted.org/packages/c6/93/148ba179cf5e2b1764435d875664185fa030cc46481f506527de64c2a66b/videoflow-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "827099e34f78f0dd1bbcd4d2135e0e86", "sha256": "aec654695448b02a50a7c0c2e54bf9d4b655e5f7af4f67e5ce35d3058b59b87a" }, "downloads": -1, "filename": "videoflow-0.2.2-py2-none-any.whl", "has_sig": false, "md5_digest": "827099e34f78f0dd1bbcd4d2135e0e86", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 43946, "upload_time": "2019-05-29T01:28:40", "url": "https://files.pythonhosted.org/packages/76/c6/ff309abe7e634222696b6e3395fcf93c1db17d8ba8fc7c4073cc1c1424b7/videoflow-0.2.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "23e40816d98da651a830ac6ab82d2be7", "sha256": "9255e60e497a30be82216fcefa0d1ab830e92008bc0761991ac1e8b93f78987d" }, "downloads": -1, "filename": "videoflow-0.2.2.tar.gz", "has_sig": false, "md5_digest": "23e40816d98da651a830ac6ab82d2be7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 32583, "upload_time": "2019-05-29T01:28:41", "url": "https://files.pythonhosted.org/packages/6b/99/f7fb367cb3072e8fd6342273806bb97d0410c60794bcfbac55cfd5ad0d74/videoflow-0.2.2.tar.gz" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "d2aee94529c5484656008a4eebd674d5", "sha256": "6929c431881420623900abbb37f6e431d9e11fd34e234bb2bd9baf4c1b7654e5" }, "downloads": -1, "filename": "videoflow-0.2.3-py2-none-any.whl", "has_sig": false, "md5_digest": "d2aee94529c5484656008a4eebd674d5", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 51943, "upload_time": "2019-06-26T02:58:31", "url": "https://files.pythonhosted.org/packages/0c/46/df0dc0832d7ba08b451e63dbb16d92a3e7098849dc0490ff989fffd1ea52/videoflow-0.2.3-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "886e1fb809f0f1be3081dbc9ada2dc09", "sha256": "a95ed3db091d64dd55dc26cb5ae568995af5b3dba65d14e46ef821c40986308e" }, "downloads": -1, "filename": "videoflow-0.2.3.tar.gz", "has_sig": false, "md5_digest": "886e1fb809f0f1be3081dbc9ada2dc09", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 38434, "upload_time": "2019-06-26T02:58:33", "url": "https://files.pythonhosted.org/packages/fe/61/0fd6df0aa436cae8f8445b080c8b0a3c00c11535923d5f2add4d54a7f212/videoflow-0.2.3.tar.gz" } ], "0.2.5": [ { "comment_text": "", "digests": { "md5": "bf0b46c022876c88f2aabcf13730013f", "sha256": "83382ba70abb1a10b12c07515ec9e0f4bc496a825a468b9491464fe1c81c5024" }, "downloads": -1, "filename": "videoflow-0.2.5-py2-none-any.whl", "has_sig": false, "md5_digest": "bf0b46c022876c88f2aabcf13730013f", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 55596, "upload_time": "2019-07-31T23:35:23", "url": "https://files.pythonhosted.org/packages/01/9a/1906f9a5e54a2e9ca50cf16de28682bed2eaa2da117f1c0cd5920c6d51f0/videoflow-0.2.5-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "34619f57054598f7afa7649b5686375b", "sha256": "b6b223fb9c809203b25518a96af8d1780ca077e0caa86b63777ad4a71b302db9" }, "downloads": -1, "filename": "videoflow-0.2.5.tar.gz", "has_sig": false, "md5_digest": "34619f57054598f7afa7649b5686375b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 41514, "upload_time": "2019-07-31T23:35:24", "url": "https://files.pythonhosted.org/packages/0e/bc/6efa069f2a27328a5324527f48cc7048fa63c03a4229ce2a3dea7da400ae/videoflow-0.2.5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "bf0b46c022876c88f2aabcf13730013f", "sha256": "83382ba70abb1a10b12c07515ec9e0f4bc496a825a468b9491464fe1c81c5024" }, "downloads": -1, "filename": "videoflow-0.2.5-py2-none-any.whl", "has_sig": false, "md5_digest": "bf0b46c022876c88f2aabcf13730013f", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 55596, "upload_time": "2019-07-31T23:35:23", "url": "https://files.pythonhosted.org/packages/01/9a/1906f9a5e54a2e9ca50cf16de28682bed2eaa2da117f1c0cd5920c6d51f0/videoflow-0.2.5-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "34619f57054598f7afa7649b5686375b", "sha256": "b6b223fb9c809203b25518a96af8d1780ca077e0caa86b63777ad4a71b302db9" }, "downloads": -1, "filename": "videoflow-0.2.5.tar.gz", "has_sig": false, "md5_digest": "34619f57054598f7afa7649b5686375b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 41514, "upload_time": "2019-07-31T23:35:24", "url": "https://files.pythonhosted.org/packages/0e/bc/6efa069f2a27328a5324527f48cc7048fa63c03a4229ce2a3dea7da400ae/videoflow-0.2.5.tar.gz" } ] }